Automatic Install Tests & Doku (#5674)

* Automatic Installation Testing
- New dev-library "mikey179/vfsStream"
- created "reload" method for App-Reloads
- ConsoleTest now using virtual directory
- Adding Automatic Installation Tests
- Fixing some probable install-failures

* Updating README for Automatic Installation

* Updating README for Automatic Installation

* Bugfix normal installation

* Fixing copying of config files

composer.json

@@ -74,7 +74,8 @@
 	"require-dev": {
 		"phpunit/dbunit": "^2.0",
 		"phpdocumentor/reflection-docblock": "^3.0.2",
-		"phpunit/php-token-stream": "^1.4.2"
+		"phpunit/php-token-stream": "^1.4.2",
+		"mikey179/vfsStream": "^1.6"
 	},
 	"scripts": {
 		"test": "phpunit"

composer.lock

@@ -4,7 +4,7 @@
         "Read more about it at https://getcomposer.org/doc/01-basic-usage.md#composer-lock-the-lock-file",
         "This file is @generated automatically"
     ],
-    "content-hash": "9e24971ae9340c5d9d4d4ca477d4ec29",
+    "content-hash": "d62c3e3d6971ee63a862a22ff3cd3768",
     "packages": [
         {
             "name": "asika/simple-console",
@@ -2252,6 +2252,52 @@
             ],
             "time": "2015-06-14T21:17:01+00:00"
         },
+        {
+            "name": "mikey179/vfsStream",
+            "version": "v1.6.5",
+            "source": {
+                "type": "git",
+                "url": "https://github.com/mikey179/vfsStream.git",
+                "reference": "d5fec95f541d4d71c4823bb5e30cf9b9e5b96145"
+            },
+            "dist": {
+                "type": "zip",
+                "url": "https://api.github.com/repos/mikey179/vfsStream/zipball/d5fec95f541d4d71c4823bb5e30cf9b9e5b96145",
+                "reference": "d5fec95f541d4d71c4823bb5e30cf9b9e5b96145",
+                "shasum": ""
+            },
+            "require": {
+                "php": ">=5.3.0"
+            },
+            "require-dev": {
+                "phpunit/phpunit": "~4.5"
+            },
+            "type": "library",
+            "extra": {
+                "branch-alias": {
+                    "dev-master": "1.6.x-dev"
+                }
+            },
+            "autoload": {
+                "psr-0": {
+                    "org\\bovigo\\vfs\\": "src/main/php"
+                }
+            },
+            "notification-url": "https://packagist.org/downloads/",
+            "license": [
+                "BSD-3-Clause"
+            ],
+            "authors": [
+                {
+                    "name": "Frank Kleine",
+                    "homepage": "http://frankkleine.de/",
+                    "role": "Developer"
+                }
+            ],
+            "description": "Virtual file system to mock the real file system in unit tests.",
+            "homepage": "http://vfs.bovigo.org/",
+            "time": "2017-08-01T08:02:14+00:00"
+        },
         {
             "name": "myclabs/deep-copy",
             "version": "1.7.0",

doc/Install.md

@@ -111,30 +111,86 @@ You might wish to move/rename `config/local.ini.php` to another name and empty (
 
 ### Option B: Run the automatic install script
 
-Open the file htconfig.php in the main Friendica directory with a text editor.
+You have the following options to automatically install Friendica:
-Remove the `die('...');` line and edit the lines to suit your installation (MySQL, language, theme etc.).
+-	creating a prepared config file (f.e. `prepared.ini.php`)
-Then save the file (do not rename it).
+-	using environment variables (f.e. `MYSQL_HOST`)
+-	using options (f.e. `--dbhost <host>`)
 
-Navigate to the main Friendica directory and execute the following command:
+You can combine environment variables and options, but be aware that options are prioritized over environment variables. 
-
-    bin/console autoinstall
-
-Or if you wish to include all optional checks, execute this statement instead:
-
-    bin/console autoinstall -a
-
-At this point visit your website again, and register your personal account.
-
-*If* the automatic installation fails for any reason, check the following:
-
-* Does "config/local.ini.php" already exist? If yes, the automatic installation won't start
-* Are the settings inside "htconfig.php" correct? If not, edit the file again.
-* Is the empty MySQL-database created? If not, create it.
 
 For more information during the installation, you can use this command line option
 
     bin/console autoinstall -v
 
+If you wish to include all optional checks, use `-a` like this statement:
+
+    bin/console autoinstall -a
+    
+*If* the automatic installation fails for any reason, check the following:
+
+*	Does `config/local.ini.php` already exist? If yes, the automatic installation won't start
+*	Are the options in the `config/local.ini.php` correct? If not, edit them directly.
+*	Is the empty MySQL-database created? If not, create it.
+
+#### B.1: Config file
+
+You can use a prepared config file like [local-sample.ini.php](config/local-sample.ini.php).
+
+Navigate to the main Friendica directory and execute the following command:
+
+    bin/console autoinstall -f <prepared.ini.php>
+    
+#### B.2: Environment variables
+
+There are two types of environment variables.
+-	those you can use in normal mode too (Currently just **database credentials**)
+-	those you can only use during installation (because Friendica will normally ignore it)
+
+You can use the options during installation too and skip some of the environment variables.
+
+**Database credentials**
+
+if you don't use the option `--savedb` during installation, the DB credentials will **not** be saved in the `config/local.ini.php`.
+
+-	`MYSQL_HOST` The host of the mysql/mariadb database
+-	`MYSQL_PORT` The port of the mysql/mariadb database
+-	`MYSQL_USERNAME` The username of the mysql database login (used for mysql)
+-	`MYSQL_USER` The username of the mysql database login (used for mariadb)
+-	`MYSQL_PASSWORD` The password of the mysql/mariadb database login
+-	`MYSQL_DATABASE` The name of the mysql/mariadb database
+
+**Friendica settings**
+
+This variables wont be used at normal Friendica runtime.
+Instead, they get saved into `config/local.ini.php`. 
+
+-	`FRIENDICA_PHP_PATH` The path of the PHP binary
+-	`FRIENDICA_ADMIN_MAIL` The admin email address of Friendica (this email will be used for admin access)
+-	`FRIENDICA_TZ` The timezone of Friendica
+-	`FRIENDICA_LANG` The langauge of Friendica
+
+Navigate to the main Friendica directory and execute the following command:
+
+    bin/console autoinstall [--savedb]
+
+#### B.3: Execution options
+
+All options will be saved in the `config/local.ini.php` and are overruling the associated environment variables.
+
+-	`-H|--dbhost <host>` The host of the mysql/mariadb database (env `MYSQL_HOST`)
+-	`-p|--dbport <port>` The port of the mysql/mariadb database (env `MYSQL_PORT`)
+-	`-U|--dbuser <username>` The username of the mysql/mariadb database login (env `MYSQL_USER` or `MYSQL_USERNAME`)
+-	`-P|--dbpass <password>` The password of the mysql/mariadb database login (env `MYSQL_PASSWORD`)
+-	`-d|--dbdata <database>` The name of the mysql/mariadb database (env `MYSQL_DATABASE`)
+-	`-b|--phppath <path>` The path of the PHP binary (env `FRIENDICA_PHP_PATH`)
+-	`-A|--admin <mail>` The admin email address of Friendica (env `FRIENDICA_ADMIN_MAIL`)
+-	`-T|--tz <timezone>` The timezone of Friendica (env `FRIENDICA_TZ`)
+-	`-L|--land <language>` The language of Friendica (env `FRIENDICA_LANG`)
+
+Navigate to the main Friendica directory and execute the following command:
+
+    bin/console autoinstall [options]
+
 ### Prepare .htaccess file
 
 Copy .htaccess-dist to .htaccess (be careful under Windows) to have working mod-rewrite again. If you have installed Friendica into a sub directory, like /friendica/ set this path in RewriteBase accordingly.

doc/de/Install.md

@@ -112,29 +112,88 @@ Alle Registrierungsprobleme sollten automatisch behebbar sein.
 Wenn du irgendwelche **kritischen** Fehler zu diesen Zeitpunkt erhalten solltest, deutet das darauf hin, dass die Datenbank nicht korrekt installiert wurde.
 Du kannst bei Bedarf die Datei config/local.ini.php verschieben/umbenennen und die Datenbank leeren (als „Dropping“ bezeichnet), so dass du mit einem sauberen System neu starten kannst.
 
-### Option B: Starte das manuelle Installationsscript
+### Option B: Starte das automatische Installationsscript
 
-Öffne die Datei htconfig.php im Friendica-Hauptordner mit einem Text-Editor.
+Es existieren folgende Varianten zur automatischen Installation von Friendica:
-Entferne die `die('...');` Zeile und bearbeite die Einstellungen so, das sie zu deinem System passen (MySQL, Sprache, Theme etc.).
+-	Eine vorgefertigte Konfigurationsdatei erstellen (z.B. `prepared.ini.php`)
-Dann speichere die Datei (jedoch nicht umbenennen).
+-	Verwendung von Umgebungsvariablen (z.B. `MYSQL_HOST`)
+-	Verwendung von Optionen (z.B. `--dbhost <host>`)
 
-Gehe in den Friendica-Hauptordner und führe den Kommandozeilen Befehl aus:
+Umgebungsvariablen und Optionen können auch kombiniert werden.
-
+Dabei ist jedoch darauf zu achten, dass etwaige Optionen immer die zugehörigen Umgebungsvariablen überschreiben.
-    bin/console autoinstall
-
-Oder falls du alle optionalen Checks ausfürehn lassen möchtest, benutze diese Option:
-
-    bin/console autoinstall -a
-
-*Wenn* die automatisierte Installation aus irgendeinem Grund fehlschlägt, dann prüfe das Folgende:
-* Existiert die `config/local.ini.php`? Falls ja, wird die automatisierte Installation nicht gestartet.
-* Sind Einstellungen in der `config/local.ini.php` korrekt? Falls nicht, bitte bearbeite diese Datei erneut.
-* Ist die leere MySQL-Datenbank erstellt? Falls nicht, erstelle diese.
 
 Für mehr Informationen kannst du diese Option verwenden:
 
     bin/console autoinstall -v
 
+Falls du alle optionalen Checks ausfürehn lassen möchtest, benutze diese Option:
+
+    bin/console autoinstall -a
+
+*Wenn* die automatisierte Installation aus irgendeinem Grund fehlschlägt, dann prüfe das Folgende:
+*	Existiert die `config/local.ini.php`? Falls ja, wird die automatisierte Installation nicht gestartet.
+*	Sind Einstellungen in der `config/local.ini.php` korrekt? Falls nicht, bitte bearbeite diese Datei erneut.
+*	Ist die leere MySQL-Datenbank erstellt? Falls nicht, erstelle diese.
+
+#### B.1: Konfigurationsdatei
+
+Für diese Variante muss ein Konfigurationsdatei bereits vor der Installation fertig definiert sein (z.B. [local-sample.ini.php](config/local-sample.ini.php).
+
+Gehe im Anschluss in den Friendica-Hauptordner und führe den Kommandozeilen Befehl aus:
+
+    bin/console autoinstall -f <prepared.ini.php>
+
+#### B.2: Umgebungsvariablen
+
+Es existieren Zwei Arten von Umgebungsvariablen in Friendica:
+-	Jene, die auch im normalen Betrieb verwendet werden können (derzeit ausschließlich **Datenbank Einstellungen**)
+-	Jene, die nur während der Installation verwedent werden können (im normalen Betrieb werden sie ignoriert)
+
+Umgebungsvariablen können auch durch adäquate Optionen (z.B. `--dbhost <hostname>`)übersteuert werden.
+
+**Datenbank Einstellungen**
+
+Nur wenn die Option `--savedb` gesetzt ist, werden diese Umgebungsvariablen auch in `config/local.ini.php` gespeichert!
+
+-	`MYSQL_HOST` Der Host der MySQL/MariaDB Datenbank
+-	`MYSQL_PORT` Der Port der MySQL/MariaDB Datenbank
+-	`MYSQL_USERNAME` Der Benutzername des MySQL Datenbanklogins (MySql - Variante)
+-	`MYSQL_USER` Der Benutzername des MariaDB Datenbanklogins (MariaDB-Variante)
+-	`MYSQL_PASSWORD` Das Passwort der MySQL/MariaDB Datenbanklogins
+-	`MYSQL_DATABASE` Der Name der MySQL/MariaDB Datenbank
+
+**Friendica Einstellungen**
+
+Diese Umgebungsvariablen können nicht während des normalen Friendica Betriebs verwendet werden.
+Sie werden stattdessen direkt in `config/local.ini.php` gespeichert.
+
+-	`FRIENDICA_PHP_PATH` Der Pfad zur PHP-Datei
+-	`FRIENDICA_ADMIN_MAIL` Die Admin E-Mail Adresse dieses Friendica Knotens (wird auch für den Admin-Zugang benötigt)
+-	`FRIENDICA_TZ` Die Zeitzone von Friendica
+-	`FRIENDICA_LANG` Die Sprache von Friendica
+
+Gehe im Anschluss in den Friendica-Hauptordner und führe den Kommandozeilen Befehl aus:
+
+    bin/console autoinstall [--savedb]
+    
+#### B.3: Optionen
+
+Alle Optionen werden in `config/local.ini.php` gespeichert und überschreiben etwaige, zugehörige Umgebungsvariablen.
+
+-	`-H|--dbhost <host>` Der Host der MySQL/MariaDB Datenbank (env `MYSQL_HOST`)
+-	`-p|--dbport <port>` Der Port der MySQL/MariaDB Datenbank (env `MYSQL_PORT`)
+-	`-U|--dbuser <username>` Der Benutzername des MySQL/MariaDB Datenbanklogins (env `MYSQL_USER` or `MYSQL_USERNAME`)
+-	`-P|--dbpass <password>` Das Passwort der MySQL/MariaDB Datenbanklogins (env `MYSQL_PASSWORD`)
+-	`-d|--dbdata <database>` Der Name der MySQL/MariaDB Datenbank (env `MYSQL_DATABASE`)
+-	`-b|--phppath <path>` Der Pfad zur PHP-Datei (env `FRIENDICA_PHP_PATH`)
+-	`-A|--admin <mail>` Die Admin E-Mail Adresse dieses Friendica Knotens (env `FRIENDICA_ADMIN_MAIL`)
+-	`-T|--tz <timezone>` Die Zeitzone von Friendica (env `FRIENDICA_TZ`)
+-	`-L|--land <language>` Die Sprache von Friendica (env `FRIENDICA_LANG`)
+
+Gehe in den Friendica-Hauptordner und führe den Kommandozeilen Befehl aus:
+
+    bin/console autoinstall [options]
+
 ### Einen Worker einrichten
 
 Erstelle einen Cron job oder einen regelmäßigen Task, um den Poller alle 5-10 Minuten im Hintergrund ablaufen zu lassen.

mod/install.php

@@ -26,8 +26,6 @@ function install_init(App $a) {
 	$a->setConfigValue('system', 'value', '../install');
 	$a->theme['stylesheet'] = System::baseUrl()."/view/install/style.css";
 
-	Install::setInstallMode();
-
 	global $install_wizard_pass;
 	if (x($_POST, 'pass')) {
 		$install_wizard_pass = intval($_POST['pass']);

src/App.php

@@ -174,40 +174,7 @@ class App
 		$this->callstack['rendering'] = [];
 		$this->callstack['parser'] = [];
 
-		// The order of the following calls is important to ensure proper initialization
+		$this->reload();
-		$this->loadConfigFiles();
-
-		$this->loadDatabase();
-
-		$this->determineMode();
-
-		$this->determineUrlPath();
-
-		Config::load();
-
-		if ($this->mode & self::MODE_DBAVAILABLE) {
-			Core\Addon::loadHooks();
-
-			$this->loadAddonConfig();
-		}
-
-		$this->loadDefaultTimezone();
-
-		$this->page = [
-			'aside' => '',
-			'bottom' => '',
-			'content' => '',
-			'end' => '',
-			'footer' => '',
-			'htmlhead' => '',
-			'nav' => '',
-			'page_title' => '',
-			'right_aside' => '',
-			'template' => '',
-			'title' => ''
-		];
-
-		$this->process_id = System::processID('log');
 
 		set_time_limit(0);
 
@@ -314,6 +281,47 @@ class App
 		$this->register_template_engine('Friendica\Render\FriendicaSmartyEngine');
 	}
 
+	/**
+	 * Reloads the whole app instance
+	 */
+	public function reload()
+	{
+		// The order of the following calls is important to ensure proper initialization
+		$this->loadConfigFiles();
+
+		$this->loadDatabase();
+
+		$this->determineMode();
+
+		$this->determineUrlPath();
+
+		Config::load();
+
+		if ($this->mode & self::MODE_DBAVAILABLE) {
+			Core\Addon::loadHooks();
+
+			$this->loadAddonConfig();
+		}
+
+		$this->loadDefaultTimezone();
+
+		$this->page = [
+			'aside' => '',
+			'bottom' => '',
+			'content' => '',
+			'end' => '',
+			'footer' => '',
+			'htmlhead' => '',
+			'nav' => '',
+			'page_title' => '',
+			'right_aside' => '',
+			'template' => '',
+			'title' => ''
+		];
+
+		$this->process_id = System::processID('log');
+	}
+
 	/**
 	 * Load the configuration files
 	 *

src/Core/Console/AutomaticInstallation.php

@@ -35,24 +35,24 @@ Options
     -a                     All setup checks are required (except .htaccess)
     -f|--file <config>     prepared config file (e.g. "config/local.ini.php" itself) which will override every other config option - except the environment variables)
     -s|--savedb            Save the DB credentials to the file (if environment variables is used)
-    -h|--dbhost <host>     The host of the mysql database (env MYSQL_HOST)
+    -H|--dbhost <host>     The host of the mysql/mariadb database (env MYSQL_HOST)
-    -p|--dbport <port>     The port of the mysql database (env MYSQL_PORT)
+    -p|--dbport <port>     The port of the mysql/mariadb database (env MYSQL_PORT)
-    -d|--dbdata <database> The name of the mysql database (env MYSQL_DATABASE)
+    -d|--dbdata <database> The name of the mysql/mariadb database (env MYSQL_DATABASE)
-    -U|--dbuser <username> The username of the mysql database login (env MYSQL_USER or MYSQL_USERNAME)
+    -U|--dbuser <username> The username of the mysql/mariadb database login (env MYSQL_USER or MYSQL_USERNAME)
-    -P|--dbpass <password> The password of the mysql database login (env MYSQL_PASSWORD)
+    -P|--dbpass <password> The password of the mysql/mariadb database login (env MYSQL_PASSWORD)
     -b|--phppath <path>    The path of the PHP binary (env FRIENDICA_PHP_PATH) 
     -A|--admin <mail>      The admin email address of Friendica (env FRIENDICA_ADMIN_MAIL)
     -T|--tz <timezone>     The timezone of Friendica (env FRIENDICA_TZ)
     -L|--lang <language>   The language of Friendica (env FRIENDICA_LANG)
  
 Environment variables
-   MYSQL_HOST                  The host of the mysql database (mandatory if mysql and environment is used)
+   MYSQL_HOST                  The host of the mysql/mariadb database (mandatory if mysql and environment is used)
-   MYSQL_PORT                  The port of the mysql database
+   MYSQL_PORT                  The port of the mysql/mariadb database
-   MYSQL_USERNAME|MYSQL_USER   The username of the mysql database login (MYSQL_USERNAME is for mysql, MYSQL_USER for mariadb)
+   MYSQL_USERNAME|MYSQL_USER   The username of the mysql/mariadb database login (MYSQL_USERNAME is for mysql, MYSQL_USER for mariadb)
-   MYSQL_PASSWORD              The password of the mysql database login
+   MYSQL_PASSWORD              The password of the mysql/mariadb database login
-   MYSQL_DATABASE              The name of the mysql database
+   MYSQL_DATABASE              The name of the mysql/mariadb database
    FRIENDICA_PHP_PATH          The path of the PHP binary
-   FRIENDICA_ADMIN_MAIL        The admin email address of Friendica
+   FRIENDICA_ADMIN_MAIL        The admin email address of Friendica (this email will be used for admin access)
    FRIENDICA_TZ                The timezone of Friendica
    FRIENDICA_LANG              The langauge of Friendica
    
@@ -64,8 +64,7 @@ Examples
 		Installs Friendica with environment variables and saves them to the 'config/local.ini.php' file
 
 	bin/console autoinstall -h localhost -p 3365 -U user -P passwort1234 -d friendica
-		Installs Friendica with a local mysql database with credentials 
+		Installs Friendica with a local mysql database with credentials
-   
 HELP;
 	}
 
@@ -74,21 +73,20 @@ HELP;
 		// Initialise the app
 		$this->out("Initializing setup...\n");
 
+		$a = BaseObject::getApp();
+
 		// if a config file is set,
 		$config_file = $this->getOption(['f', 'file']);
 
 		if (!empty($config_file)) {
-			if ($config_file != 'config/local.ini.php') {
+			if ($config_file != 'config' . DIRECTORY_SEPARATOR . 'local.ini.php') {
 				// Copy config file
 				$this->out("Copying config file...\n");
-				if (!copy($config_file, 'config/local.ini.php')) {
+				if (!copy($a->basepath . DIRECTORY_SEPARATOR . $config_file, $a->basepath . DIRECTORY_SEPARATOR . 'config' . DIRECTORY_SEPARATOR . 'local.ini.php')) {
-					throw new RuntimeException("ERROR: Saving config file failed. Please copy '$config_file' to 'config/local.ini.php' manually.\n");
+					throw new RuntimeException("ERROR: Saving config file failed. Please copy '$config_file' to '$a->basepath" . DIRECTORY_SEPARATOR . "config" . DIRECTORY_SEPARATOR . "local.ini.php' manually.\n");
 				}
 			}
 
-			// load the app after copying the file
-			$a = BaseObject::getApp();
-
 			$db_host = $a->getConfigValue('database', 'hostname');
 			$db_user = $a->getConfigValue('database', 'username');
 			$db_pass = $a->getConfigValue('database', 'password');
@@ -97,12 +95,9 @@ HELP;
 			// Creating config file
 			$this->out("Creating config file...\n");
 
-			// load the app first (for the template engine)
-			$a = BaseObject::getApp();
-
 			$save_db = $this->getOption(['s', 'savedb'], false);
 
-			$db_host = $this->getOption(['h', 'dbhost'], ($save_db) ? getenv('MYSQL_HOST') : '');
+			$db_host = $this->getOption(['H', 'dbhost'], ($save_db) ? getenv('MYSQL_HOST') : '');
 			$db_port = $this->getOption(['p', 'dbport'], ($save_db) ? getenv('MYSQL_PORT') : null);
 			$db_data = $this->getOption(['d', 'dbdata'], ($save_db) ? getenv('MYSQL_DATABASE') : '');
 			$db_user = $this->getOption(['U', 'dbuser'], ($save_db) ? getenv('MYSQL_USER') . getenv('MYSQL_USERNAME') : '');
@@ -112,12 +107,9 @@ HELP;
 			$tz = $this->getOption(['T', 'tz'], (!empty('FRIENDICA_TZ')) ? getenv('FRIENDICA_TZ') : '');
 			$lang = $this->getOption(['L', 'lang'], (!empty('FRIENDICA_LANG')) ? getenv('FRIENDICA_LANG') : '');
 
-			// creating config file
-			$this->out("Creating config file...\n");
-
 			Install::createConfig(
 				$php_path,
-				$db_host,
+				((!empty($db_port)) ? $db_host . ':' . $db_port : $db_host),
 				$db_user,
 				$db_pass,
 				$db_data,

src/Core/Install.php

@@ -84,11 +84,12 @@ class Install extends BaseObject
 			'$adminmail' => $adminmail,
 		]);
 
-		$result = file_put_contents('config/local.ini.php', $txt);
+		$app = self::getApp();
-		if (!$result) {
-			self::getApp()->data['txt'] = $txt;
-		}
 
+		$result = file_put_contents($app->basepath . DIRECTORY_SEPARATOR . 'config' . DIRECTORY_SEPARATOR . 'local.ini.php', $txt);
+		if (!$result) {
+			$app->data['txt'] = $txt;
+		}
 	}
 
 	/**

tests/src/Core/Console/AutomaticInstallationConsoleTest.php

@@ -0,0 +1,333 @@
+<?php
+
+namespace Friendica\Test\src\Core\Console;
+
+use org\bovigo\vfs\vfsStream;
+
+/**
+ * @runTestsInSeparateProcesses
+ * @preserveGlobalState disabled
+ * @requires PHP 7.0
+ */
+class AutomaticInstallationConsoleTest extends ConsoleTest
+{
+	private $db_host;
+	private $db_port;
+	private $db_data;
+	private $db_user;
+	private $db_pass;
+
+	public function setUp()
+	{
+		parent::setUp();
+
+		if ($this->root->hasChild('config' . DIRECTORY_SEPARATOR . 'local.ini.php')) {
+			$this->root->getChild('config')
+				->removeChild('local.ini.php');
+		}
+
+		$this->db_host = getenv('MYSQL_HOST');
+		$this->db_port = (!empty(getenv('MYSQL_PORT'))) ? getenv('MYSQL_PORT') : null;
+		$this->db_data = getenv('MYSQL_DATABASE');
+		$this->db_user = getenv('MYSQL_USERNAME') . getenv('MYSQL_USER');
+		$this->db_pass = getenv('MYSQL_PASSWORD');
+	}
+
+	private function assertConfig($family, $key, $value)
+	{
+		$config = $this->execute(['config', $family, $key]);
+		$this->assertEquals($family . "." . $key . " => " . $value . "\n", $config);
+	}
+
+	private function assertFinished($txt, $withconfig = false, $copyfile = false)
+	{
+		$cfg = '';
+
+		if ($withconfig) {
+			$cfg = <<<CFG
+
+
+Creating config file...
+CFG;
+		}
+
+		if ($copyfile) {
+			$cfg = <<<CFG
+
+
+Copying config file...
+CFG;
+		}
+
+		$finished = <<<FIN
+Initializing setup...{$cfg}
+
+ Complete!
+
+
+Checking basic setup...
+
+ NOTICE: Not checking .htaccess/URL-Rewrite during CLI installation.
+
+ Complete!
+
+
+Checking database...
+
+ Complete!
+
+
+Inserting data into database...
+
+ Complete!
+
+
+Installing theme
+
+ Complete
+
+
+
+Installation is finished
+
+
+FIN;
+		$this->assertEquals($finished, $txt);
+	}
+
+	private function assertStuckDB($txt)
+	{
+		$finished = <<<FIN
+Initializing setup...
+
+Creating config file...
+
+ Complete!
+
+
+Checking basic setup...
+
+ NOTICE: Not checking .htaccess/URL-Rewrite during CLI installation.
+
+ Complete!
+
+
+Checking database...
+
+[Error] --------
+MySQL Connection: Failed, please check your MySQL settings and credentials.
+
+
+FIN;
+
+		$this->assertEquals($finished, $txt);
+	}
+
+	/**
+	 * @medium
+	 */
+	public function testWithConfig()
+	{
+		$config = <<<CONF
+<?php return <<<INI
+
+[database]
+hostname = 
+username = 
+password = 
+database = 
+charset = utf8mb4
+
+
+; ****************************************************************
+; The configuration below will be overruled by the admin panel.
+; Changes made below will only have an effect if the database does
+; not contain any configuration for the friendica system.
+; ****************************************************************
+
+[config]
+admin_email =
+
+sitename = Friendica Social Network
+
+register_policy = REGISTER_OPEN
+register_text =
+
+[system]
+default_timezone = UTC
+
+language = en
+INI;
+// Keep this line
+
+CONF;
+
+		vfsStream::newFile('prepared.ini.php')
+			->at($this->root)
+			->setContent($config);
+
+		$txt = $this->execute(['autoinstall', '-f', 'prepared.ini.php']);
+
+		$this->assertFinished($txt, false, true);
+
+		$this->assertTrue($this->root->hasChild('config' . DIRECTORY_SEPARATOR . 'local.ini.php'));
+	}
+
+	/**
+	 * @medium
+	 */
+	public function testWithEnvironmentAndSave()
+	{
+		$this->assertTrue(putenv('FRIENDICA_ADMIN_MAIL=admin@friendica.local'));
+		$this->assertTrue(putenv('FRIENDICA_TZ=Europe/Berlin'));
+		$this->assertTrue(putenv('FRIENDICA_LANG=de'));
+
+		$txt = $this->execute(['autoinstall', '--savedb']);
+
+		$this->assertFinished($txt, true);
+
+		$this->assertTrue($this->root->hasChild('config' . DIRECTORY_SEPARATOR . 'local.ini.php'));
+
+		$this->assertConfig('database', 'hostname', $this->db_host . (!empty($this->db_port) ? ':' . $this->db_port : ''));
+		$this->assertConfig('database', 'username', $this->db_user);
+		$this->assertConfig('database', 'database', $this->db_data);
+		$this->assertConfig('config', 'admin_email', 'admin@friendica.local');
+		$this->assertConfig('system', 'default_timezone', 'Europe/Berlin');
+		$this->assertConfig('system', 'language', 'de');
+	}
+
+
+	/**
+	 * @medium
+	 */
+	public function testWithEnvironmentWithoutSave()
+	{
+		$this->assertTrue(putenv('FRIENDICA_ADMIN_MAIL=admin@friendica.local'));
+		$this->assertTrue(putenv('FRIENDICA_TZ=Europe/Berlin'));
+		$this->assertTrue(putenv('FRIENDICA_LANG=de'));
+
+		$txt = $this->execute(['autoinstall']);
+
+		$this->assertFinished($txt, true);
+
+		$this->assertTrue($this->root->hasChild('config' . DIRECTORY_SEPARATOR . 'local.ini.php'));
+
+		$this->assertConfig('database', 'hostname', '');
+		$this->assertConfig('database', 'username', '');
+		$this->assertConfig('database', 'database', '');
+		$this->assertConfig('config', 'admin_email', 'admin@friendica.local');
+		$this->assertConfig('system', 'default_timezone', 'Europe/Berlin');
+		$this->assertConfig('system', 'language', 'de');
+	}
+
+	/**
+	 * @medium
+	 */
+	public function testWithArguments()
+	{
+		$args = ['autoinstall'];
+		array_push($args, '--dbhost');
+		array_push($args, $this->db_host);
+		array_push($args, '--dbuser');
+		array_push($args, $this->db_user);
+		if (!empty($this->db_pass)) {
+			array_push($args, '--dbpass');
+			array_push($args, $this->db_pass);
+		}
+		if (!empty($this->db_port)) {
+			array_push($args, '--dbport');
+			array_push($args, $this->db_port);
+		}
+		array_push($args, '--dbdata');
+		array_push($args, $this->db_data);
+
+		array_push($args, '--admin');
+		array_push($args, 'admin@friendica.local');
+		array_push($args, '--tz');
+		array_push($args, 'Europe/Berlin');
+		array_push($args, '--lang');
+		array_push($args, 'de');
+
+		$txt = $this->execute($args);
+
+		$this->assertFinished($txt, true);
+
+		$this->assertTrue($this->root->hasChild('config' . DIRECTORY_SEPARATOR . 'local.ini.php'));
+
+		$this->assertConfig('database', 'hostname', $this->db_host . (!empty($this->db_port) ? ':' . $this->db_port : ''));
+		$this->assertConfig('database', 'username', $this->db_user);
+		$this->assertConfig('database', 'database', $this->db_data);
+		$this->assertConfig('config', 'admin_email', 'admin@friendica.local');
+		$this->assertConfig('system', 'default_timezone', 'Europe/Berlin');
+		$this->assertConfig('system', 'language', 'de');
+	}
+
+	public function testNoDatabaseConnection()
+	{
+		$this->assertTrue(putenv('MYSQL_USERNAME='));
+		$this->assertTrue(putenv('MYSQL_PASSWORD='));
+		$this->assertTrue(putenv('MYSQL_DATABASE='));
+
+		$txt = $this->execute(['autoinstall']);
+
+		$this->assertStuckDB($txt);
+	}
+
+	public function testGetHelp()
+	{
+		// Usable to purposely fail if new commands are added without taking tests into account
+		$theHelp = <<<HELP
+Installation - Install Friendica automatically
+Synopsis
+	bin/console autoinstall [-h|--help|-?] [-v] [-a] [-f]
+
+Description
+    Installs Friendica with data based on the local.ini.php file or environment variables
+
+Notes
+    Not checking .htaccess/URL-Rewrite during CLI installation.
+
+Options
+    -h|--help|-?           Show help information
+    -v                     Show more debug information.
+    -a                     All setup checks are required (except .htaccess)
+    -f|--file <config>     prepared config file (e.g. "config/local.ini.php" itself) which will override every other config option - except the environment variables)
+    -s|--savedb            Save the DB credentials to the file (if environment variables is used)
+    -H|--dbhost <host>     The host of the mysql/mariadb database (env MYSQL_HOST)
+    -p|--dbport <port>     The port of the mysql/mariadb database (env MYSQL_PORT)
+    -d|--dbdata <database> The name of the mysql/mariadb database (env MYSQL_DATABASE)
+    -U|--dbuser <username> The username of the mysql/mariadb database login (env MYSQL_USER or MYSQL_USERNAME)
+    -P|--dbpass <password> The password of the mysql/mariadb database login (env MYSQL_PASSWORD)
+    -b|--phppath <path>    The path of the PHP binary (env FRIENDICA_PHP_PATH) 
+    -A|--admin <mail>      The admin email address of Friendica (env FRIENDICA_ADMIN_MAIL)
+    -T|--tz <timezone>     The timezone of Friendica (env FRIENDICA_TZ)
+    -L|--lang <language>   The language of Friendica (env FRIENDICA_LANG)
+ 
+Environment variables
+   MYSQL_HOST                  The host of the mysql/mariadb database (mandatory if mysql and environment is used)
+   MYSQL_PORT                  The port of the mysql/mariadb database
+   MYSQL_USERNAME|MYSQL_USER   The username of the mysql/mariadb database login (MYSQL_USERNAME is for mysql, MYSQL_USER for mariadb)
+   MYSQL_PASSWORD              The password of the mysql/mariadb database login
+   MYSQL_DATABASE              The name of the mysql/mariadb database
+   FRIENDICA_PHP_PATH          The path of the PHP binary
+   FRIENDICA_ADMIN_MAIL        The admin email address of Friendica (this email will be used for admin access)
+   FRIENDICA_TZ                The timezone of Friendica
+   FRIENDICA_LANG              The langauge of Friendica
+   
+Examples
+	bin/console autoinstall -f 'input.ini.php
+		Installs Friendica with the prepared 'input.ini.php' file
+
+	bin/console autoinstall --savedb
+		Installs Friendica with environment variables and saves them to the 'config/local.ini.php' file
+
+	bin/console autoinstall -h localhost -p 3365 -U user -P passwort1234 -d friendica
+		Installs Friendica with a local mysql database with credentials
+
+HELP;
+
+		$txt = $this->execute(['autoinstall', '-h']);
+
+		$this->assertEquals($txt, $theHelp);
+	}
+}

tests/src/Core/Console/ConfigConsoleTest.php

@@ -19,12 +19,12 @@ class ConfigConsoleTest extends ConsoleTest
 	}
 
 	private function assertGet($family, $key, $value) {
-		$config = $this->execute([__FILE__, 'config', $family, $key]);
+		$config = $this->execute(['config', $family, $key]);
 		$this->assertEquals($family . "." . $key . " => " . $value . "\n", $config);
 	}
 
 	private function assertSet($family, $key, $value) {
-		$config = $this->execute([__FILE__, 'config', $family, $key, $value]);
+		$config = $this->execute(['config', $family, $key, $value]);
 		$this->assertEquals($family . "." . $key . " <= " . $value . "\n", $config);
 	}
 
@@ -41,13 +41,13 @@ class ConfigConsoleTest extends ConsoleTest
 		$testArray = [1, 2, 3];
 		DBA::insert('config', ['cat' => 'config', 'k' => 'test', 'v' => serialize($testArray)]);
 
-		$txt = $this->execute([__FILE__, 'config', 'config', 'test', 'now']);
+		$txt = $this->execute(['config', 'config', 'test', 'now']);
 
 		$this->assertEquals("[Error] config.test is an array and can't be set using this command.\n", $txt);
 	}
 
 	function testTooManyArguments() {
-		$txt = $this->execute([__FILE__, 'config', 'config', 'test', 'it', 'now']);
+		$txt = $this->execute(['config', 'config', 'test', 'it', 'now']);
 		$assertion = '[Warning] Too many arguments';
 		$firstline = substr($txt, 0, strlen($assertion));
 
@@ -56,8 +56,9 @@ class ConfigConsoleTest extends ConsoleTest
 
 	function testVerbose() {
 		$this->assertSet('test', 'it', 'now');
+		$executable = $this->getExecutablePath();
 		$assertion = <<<CONF
-Executable: {$this->app->basepath}/tests/src/Core/Console/ConfigConsoleTest.php
+Executable: {$executable}
 Arguments: array (
   0 => 'config',
   1 => 'test',
@@ -66,7 +67,7 @@ Options: array (
   'v' => 1,
 )
 Command: config
-Executable: {$this->app->basepath}/tests/src/Core/Console/ConfigConsoleTest.php
+Executable: {$executable}
 Class: Friendica\Core\Console\Config
 Arguments: array (
   0 => 'test',
@@ -78,7 +79,7 @@ Options: array (
 it => now
 
 CONF;
-		$txt = $this->execute([__FILE__, 'config', 'test', '-v']);
+		$txt = $this->execute(['config', 'test', '-v']);
 
 		$this->assertEquals($assertion, $txt);
 	}

tests/src/Core/Console/ConsoleTest.php

@@ -4,7 +4,10 @@ namespace Friendica\Test\src\Core\Console;
 
 use Friendica\App;
 use Friendica\BaseObject;
+use Friendica\Database\DBA;
 use Friendica\Test\Util\Intercept;
+use org\bovigo\vfs\vfsStream;
+use org\bovigo\vfs\vfsStreamDirectory;
 use PHPUnit\Framework\TestCase;
 
 abstract class ConsoleTest extends TestCase
@@ -18,6 +21,11 @@ abstract class ConsoleTest extends TestCase
 	 */
 	protected $app;
 
+	/**
+	 * @var vfsStreamDirectory The Stream Directory
+	 */
+	protected $root;
+
 	protected $stdout;
 
 	protected function setUp()
@@ -30,12 +38,19 @@ abstract class ConsoleTest extends TestCase
 			$this->markTestSkipped('Please set the MYSQL_* environment variables to your test database credentials.');
 		}
 
+		$this->setUpVfsDir();
+
 		// Reusable App object
-		$this->app = BaseObject::getApp();
+		$this->app = new App($this->root->url());
+		BaseObject::setApp($this->app);
 		$this->console = new MultiUseConsole();
 	}
 
 	public function execute($args) {
+		DBA::disconnect();
+		$this->app->reload();
+
+		array_unshift($args, $this->getExecutablePath());
 		Intercept::reset();
 		$this->console->reset();
 		$this->console->parseTestArgv($args);
@@ -45,4 +60,48 @@ abstract class ConsoleTest extends TestCase
 		Intercept::reset();
 		return $returnStr;
 	}
+
+	/**
+	 * @return string returns the path to the console executable during tests
+	 */
+	protected function getExecutablePath() {
+		return $this->root->getChild('bin' . DIRECTORY_SEPARATOR . 'console.php')->url();
+	}
+
+	private function setUpVfsDir() {
+		// the used directories inside the App class
+		$structure = [
+			'config' => [],
+			'bin' => []
+		];
+
+		// create a virtual directory and copy all needed files and folders to it
+		$this->root = vfsStream::setup('friendica', null, $structure);
+
+		$this->setConfigFile('config.ini.php');
+		$this->setConfigFile('settings.ini.php');
+		$this->setConfigFile('local.ini.php');
+		$this->setConfigFile('dbstructure.json');
+
+		// fake console.php for setting an executable
+		vfsStream::newFile('console.php')
+			->at($this->root->getChild('bin'))
+			->setContent('<? php');
+	}
+
+	private function setConfigFile($filename)
+	{
+		$file = dirname(__DIR__) . DIRECTORY_SEPARATOR .
+			'..' . DIRECTORY_SEPARATOR .
+			'..' . DIRECTORY_SEPARATOR .
+			'..' . DIRECTORY_SEPARATOR .
+			'config' . DIRECTORY_SEPARATOR .
+			$filename;
+
+		if (file_exists($file)) {
+			vfsStream::newFile($filename)
+				->at($this->root->getChild('config'))
+				->setContent(file_get_contents($file));
+		}
+	}
 }