diff --git a/composer.json b/composer.json index 9ef0dcd101..04e4b655da 100644 --- a/composer.json +++ b/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" diff --git a/composer.lock b/composer.lock index 409deb2e8f..76c20a1b93 100644 --- a/composer.lock +++ b/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", diff --git a/doc/Install.md b/doc/Install.md index 300a9c82d3..3854c32bce 100644 --- a/doc/Install.md +++ b/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. -Remove the `die('...');` line and edit the lines to suit your installation (MySQL, language, theme etc.). -Then save the file (do not rename it). +You have the following options to automatically install Friendica: +- creating a prepared config file (f.e. `prepared.ini.php`) +- using environment variables (f.e. `MYSQL_HOST`) +- using options (f.e. `--dbhost `) -Navigate to the main Friendica directory and execute the following command: - - 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. +You can combine environment variables and options, but be aware that options are prioritized over environment variables. 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 + +#### 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 ` The host of the mysql/mariadb database (env `MYSQL_HOST`) +- `-p|--dbport ` The port of the mysql/mariadb database (env `MYSQL_PORT`) +- `-U|--dbuser ` The username of the mysql/mariadb database login (env `MYSQL_USER` or `MYSQL_USERNAME`) +- `-P|--dbpass ` The password of the mysql/mariadb database login (env `MYSQL_PASSWORD`) +- `-d|--dbdata ` The name of the mysql/mariadb database (env `MYSQL_DATABASE`) +- `-b|--phppath ` The path of the PHP binary (env `FRIENDICA_PHP_PATH`) +- `-A|--admin ` The admin email address of Friendica (env `FRIENDICA_ADMIN_MAIL`) +- `-T|--tz ` The timezone of Friendica (env `FRIENDICA_TZ`) +- `-L|--land ` 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. diff --git a/doc/de/Install.md b/doc/de/Install.md index 84941d9282..05a4e1e465 100644 --- a/doc/de/Install.md +++ b/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. -Entferne die `die('...');` Zeile und bearbeite die Einstellungen so, das sie zu deinem System passen (MySQL, Sprache, Theme etc.). -Dann speichere die Datei (jedoch nicht umbenennen). +Es existieren folgende Varianten zur automatischen Installation von Friendica: +- Eine vorgefertigte Konfigurationsdatei erstellen (z.B. `prepared.ini.php`) +- Verwendung von Umgebungsvariablen (z.B. `MYSQL_HOST`) +- Verwendung von Optionen (z.B. `--dbhost `) -Gehe in den Friendica-Hauptordner und führe den Kommandozeilen Befehl aus: - - 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. +Umgebungsvariablen und Optionen können auch kombiniert werden. +Dabei ist jedoch darauf zu achten, dass etwaige Optionen immer die zugehörigen Umgebungsvariablen überschreiben. 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 + +#### 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 `)ü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 ` Der Host der MySQL/MariaDB Datenbank (env `MYSQL_HOST`) +- `-p|--dbport ` Der Port der MySQL/MariaDB Datenbank (env `MYSQL_PORT`) +- `-U|--dbuser ` Der Benutzername des MySQL/MariaDB Datenbanklogins (env `MYSQL_USER` or `MYSQL_USERNAME`) +- `-P|--dbpass ` Das Passwort der MySQL/MariaDB Datenbanklogins (env `MYSQL_PASSWORD`) +- `-d|--dbdata ` Der Name der MySQL/MariaDB Datenbank (env `MYSQL_DATABASE`) +- `-b|--phppath ` Der Pfad zur PHP-Datei (env `FRIENDICA_PHP_PATH`) +- `-A|--admin ` Die Admin E-Mail Adresse dieses Friendica Knotens (env `FRIENDICA_ADMIN_MAIL`) +- `-T|--tz ` Die Zeitzone von Friendica (env `FRIENDICA_TZ`) +- `-L|--land ` 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. diff --git a/mod/install.php b/mod/install.php index fa20fd76cb..d2d322b3b9 100644 --- a/mod/install.php +++ b/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']); diff --git a/src/App.php b/src/App.php index 55fa517342..2a5fba8541 100644 --- a/src/App.php +++ b/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->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'); + $this->reload(); 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 * diff --git a/src/Core/Console/AutomaticInstallation.php b/src/Core/Console/AutomaticInstallation.php index a8489e7c8d..f0f3def2a0 100644 --- a/src/Core/Console/AutomaticInstallation.php +++ b/src/Core/Console/AutomaticInstallation.php @@ -35,24 +35,24 @@ Options -a All setup checks are required (except .htaccess) -f|--file 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 The host of the mysql database (env MYSQL_HOST) - -p|--dbport The port of the mysql database (env MYSQL_PORT) - -d|--dbdata The name of the mysql database (env MYSQL_DATABASE) - -U|--dbuser The username of the mysql database login (env MYSQL_USER or MYSQL_USERNAME) - -P|--dbpass The password of the mysql database login (env MYSQL_PASSWORD) + -H|--dbhost The host of the mysql/mariadb database (env MYSQL_HOST) + -p|--dbport The port of the mysql/mariadb database (env MYSQL_PORT) + -d|--dbdata The name of the mysql/mariadb database (env MYSQL_DATABASE) + -U|--dbuser The username of the mysql/mariadb database login (env MYSQL_USER or MYSQL_USERNAME) + -P|--dbpass The password of the mysql/mariadb database login (env MYSQL_PASSWORD) -b|--phppath The path of the PHP binary (env FRIENDICA_PHP_PATH) -A|--admin The admin email address of Friendica (env FRIENDICA_ADMIN_MAIL) -T|--tz The timezone of Friendica (env FRIENDICA_TZ) -L|--lang 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_PORT The port of the mysql database - MYSQL_USERNAME|MYSQL_USER The username of the mysql database login (MYSQL_USERNAME is for mysql, MYSQL_USER for mariadb) - MYSQL_PASSWORD The password of the mysql database login - MYSQL_DATABASE The name of the mysql database + 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 + 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')) { - throw new RuntimeException("ERROR: Saving config file failed. Please copy '$config_file' to 'config/local.ini.php' manually.\n"); + 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 '$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, diff --git a/src/Core/Install.php b/src/Core/Install.php index e8f014618d..ba3a97ea6c 100644 --- a/src/Core/Install.php +++ b/src/Core/Install.php @@ -84,11 +84,12 @@ class Install extends BaseObject '$adminmail' => $adminmail, ]); - $result = file_put_contents('config/local.ini.php', $txt); - if (!$result) { - self::getApp()->data['txt'] = $txt; - } + $app = self::getApp(); + $result = file_put_contents($app->basepath . DIRECTORY_SEPARATOR . 'config' . DIRECTORY_SEPARATOR . 'local.ini.php', $txt); + if (!$result) { + $app->data['txt'] = $txt; + } } /** diff --git a/tests/src/Core/Console/AutomaticInstallationConsoleTest.php b/tests/src/Core/Console/AutomaticInstallationConsoleTest.php new file mode 100644 index 0000000000..79e379dcbc --- /dev/null +++ b/tests/src/Core/Console/AutomaticInstallationConsoleTest.php @@ -0,0 +1,333 @@ +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 = <<assertEquals($finished, $txt); + } + + private function assertStuckDB($txt) + { + $finished = <<assertEquals($finished, $txt); + } + + /** + * @medium + */ + public function testWithConfig() + { + $config = <<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 = << 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 The host of the mysql/mariadb database (env MYSQL_HOST) + -p|--dbport The port of the mysql/mariadb database (env MYSQL_PORT) + -d|--dbdata The name of the mysql/mariadb database (env MYSQL_DATABASE) + -U|--dbuser The username of the mysql/mariadb database login (env MYSQL_USER or MYSQL_USERNAME) + -P|--dbpass The password of the mysql/mariadb database login (env MYSQL_PASSWORD) + -b|--phppath The path of the PHP binary (env FRIENDICA_PHP_PATH) + -A|--admin The admin email address of Friendica (env FRIENDICA_ADMIN_MAIL) + -T|--tz The timezone of Friendica (env FRIENDICA_TZ) + -L|--lang 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); + } +} diff --git a/tests/src/Core/Console/ConfigConsoleTest.php b/tests/src/Core/Console/ConfigConsoleTest.php index 5512528dff..c4fd217770 100644 --- a/tests/src/Core/Console/ConfigConsoleTest.php +++ b/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 = <<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); } diff --git a/tests/src/Core/Console/ConsoleTest.php b/tests/src/Core/Console/ConsoleTest.php index fd09a79452..0cc5c63359 100644 --- a/tests/src/Core/Console/ConsoleTest.php +++ b/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('at($this->root->getChild('config')) + ->setContent(file_get_contents($file)); + } + } }