3 * @copyright Copyright (C) 2010-2021, the Friendica project
5 * @license GNU AGPL version 3 or any later version
7 * This program is free software: you can redistribute it and/or modify
8 * it under the terms of the GNU Affero General Public License as
9 * published by the Free Software Foundation, either version 3 of the
10 * License, or (at your option) any later version.
12 * This program is distributed in the hope that it will be useful,
13 * but WITHOUT ANY WARRANTY; without even the implied warranty of
14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 * GNU Affero General Public License for more details.
17 * You should have received a copy of the GNU Affero General Public License
18 * along with this program. If not, see <https://www.gnu.org/licenses/>.
22 namespace Friendica\Module;
25 use Friendica\BaseModule;
27 use Friendica\Core\Config\ValueObject\Cache;
28 use Friendica\Core\Renderer;
29 use Friendica\Core\Theme;
31 use Friendica\Network\HTTPException;
32 use Friendica\Util\BasePath;
33 use Friendica\Util\Temporal;
35 class Install extends BaseModule
38 * Step one - System check
40 const SYSTEM_CHECK = 1;
42 * Step two - Base information
44 const BASE_CONFIG = 2;
46 * Step three - Database configuration
48 const DATABASE_CONFIG = 3;
50 * Step four - Adapt site settings
52 const SITE_SETTINGS = 4;
54 * Step five - All steps finished
59 * @var int The current step of the wizard
61 private static $currentWizardStep;
64 * @var Core\Installer The installer
66 private static $installer;
68 public static function init(array $parameters = [])
72 if (!DI::mode()->isInstall()) {
73 throw new HTTPException\ForbiddenException();
76 // route: install/testrwrite
77 // $baseurl/install/testrwrite to test if rewrite in .htaccess is working
78 if (DI::args()->get(1, '') == 'testrewrite') {
79 // Status Code 204 means that it worked without content
80 throw new HTTPException\NoContentException();
83 self::$installer = new Core\Installer();
85 // get basic installation information and save them to the config cache
86 $configCache = $a->getConfigCache();
87 $basePath = new BasePath($a->getBasePath());
88 self::$installer->setUpCache($configCache, $basePath->getPath());
90 // We overwrite current theme css, because during install we may not have a working mod_rewrite
91 // so we may not have a css at all. Here we set a static css file for the install procedure pages
92 Renderer::$theme['stylesheet'] = DI::baseUrl()->get() . '/view/install/style.css';
94 self::$currentWizardStep = ($_POST['pass'] ?? '') ?: self::SYSTEM_CHECK;
97 public static function post(array $parameters = [])
100 $configCache = $a->getConfigCache();
102 switch (self::$currentWizardStep) {
103 case self::SYSTEM_CHECK:
104 case self::BASE_CONFIG:
105 self::checkSetting($configCache, $_POST, 'config', 'php_path');
108 case self::DATABASE_CONFIG:
109 self::checkSetting($configCache, $_POST, 'config', 'php_path');
111 self::checkSetting($configCache, $_POST, 'config', 'hostname');
112 self::checkSetting($configCache, $_POST, 'system', 'ssl_policy');
113 self::checkSetting($configCache, $_POST, 'system', 'basepath');
114 self::checkSetting($configCache, $_POST, 'system', 'urlpath');
117 case self::SITE_SETTINGS:
118 self::checkSetting($configCache, $_POST, 'config', 'php_path');
120 self::checkSetting($configCache, $_POST, 'config', 'hostname');
121 self::checkSetting($configCache, $_POST, 'system', 'ssl_policy');
122 self::checkSetting($configCache, $_POST, 'system', 'basepath');
123 self::checkSetting($configCache, $_POST, 'system', 'urlpath');
125 self::checkSetting($configCache, $_POST, 'database', 'hostname', Core\Installer::DEFAULT_HOST);
126 self::checkSetting($configCache, $_POST, 'database', 'username', '');
127 self::checkSetting($configCache, $_POST, 'database', 'password', '');
128 self::checkSetting($configCache, $_POST, 'database', 'database', '');
130 // If we cannot connect to the database, return to the previous step
131 if (!self::$installer->checkDB(DI::dba())) {
132 self::$currentWizardStep = self::DATABASE_CONFIG;
138 self::checkSetting($configCache, $_POST, 'config', 'php_path');
140 self::checkSetting($configCache, $_POST, 'config', 'hostname');
141 self::checkSetting($configCache, $_POST, 'system', 'ssl_policy');
142 self::checkSetting($configCache, $_POST, 'system', 'basepath');
143 self::checkSetting($configCache, $_POST, 'system', 'urlpath');
145 self::checkSetting($configCache, $_POST, 'database', 'hostname', Core\Installer::DEFAULT_HOST);
146 self::checkSetting($configCache, $_POST, 'database', 'username', '');
147 self::checkSetting($configCache, $_POST, 'database', 'password', '');
148 self::checkSetting($configCache, $_POST, 'database', 'database', '');
150 self::checkSetting($configCache, $_POST, 'system', 'default_timezone', Core\Installer::DEFAULT_TZ);
151 self::checkSetting($configCache, $_POST, 'system', 'language', Core\Installer::DEFAULT_LANG);
152 self::checkSetting($configCache, $_POST, 'config', 'admin_email', '');
154 // If we cannot connect to the database, return to the Database config wizard
155 if (!self::$installer->checkDB(DI::dba())) {
156 self::$currentWizardStep = self::DATABASE_CONFIG;
160 if (!self::$installer->createConfig($configCache)) {
164 self::$installer->installDatabase($configCache->get('system', 'basepath'));
166 // install allowed themes to register theme hooks
167 // this is same as "Reload active theme" in /admin/themes
168 $allowed_themes = Theme::getAllowedList();
169 $allowed_themes = array_unique($allowed_themes);
170 foreach ($allowed_themes as $theme) {
171 Theme::uninstall($theme);
172 Theme::install($theme);
174 Theme::setAllowedList($allowed_themes);
180 public static function content(array $parameters = [])
183 $configCache = $a->getConfigCache();
187 $install_title = DI::l10n()->t('Friendica Communications Server - Setup');
189 switch (self::$currentWizardStep) {
190 case self::SYSTEM_CHECK:
191 $php_path = $configCache->get('config', 'php_path');
193 $status = self::$installer->checkEnvironment(DI::baseUrl()->get(), $php_path);
195 $tpl = Renderer::getMarkupTemplate('install_checks.tpl');
196 $output .= Renderer::replaceMacros($tpl, [
197 '$title' => $install_title,
198 '$pass' => DI::l10n()->t('System check'),
199 '$required' => DI::l10n()->t('Required'),
200 '$requirement_not_satisfied' => DI::l10n()->t('Requirement not satisfied'),
201 '$optional_requirement_not_satisfied' => DI::l10n()->t('Optional requirement not satisfied'),
202 '$ok' => DI::l10n()->t('OK'),
203 '$checks' => self::$installer->getChecks(),
204 '$passed' => $status,
205 '$see_install' => DI::l10n()->t('Please see the file "doc/INSTALL.md".'),
206 '$next' => DI::l10n()->t('Next'),
207 '$reload' => DI::l10n()->t('Check again'),
208 '$php_path' => $php_path,
212 case self::BASE_CONFIG:
214 App\BaseURL::SSL_POLICY_NONE => DI::l10n()->t("No SSL policy, links will track page SSL state"),
215 App\BaseURL::SSL_POLICY_FULL => DI::l10n()->t("Force all links to use SSL"),
216 App\BaseURL::SSL_POLICY_SELFSIGN => DI::l10n()->t("Self-signed certificate, use SSL for local links only \x28discouraged\x29")
219 $tpl = Renderer::getMarkupTemplate('install_base.tpl');
220 $output .= Renderer::replaceMacros($tpl, [
221 '$title' => $install_title,
222 '$pass' => DI::l10n()->t('Base settings'),
223 '$ssl_policy' => ['system-ssl_policy',
224 DI::l10n()->t("SSL link policy"),
225 $configCache->get('system', 'ssl_policy'),
226 DI::l10n()->t("Determines whether generated links should be forced to use SSL"),
228 '$hostname' => ['config-hostname',
229 DI::l10n()->t('Host name'),
230 $configCache->get('config', 'hostname'),
231 DI::l10n()->t('Overwrite this field in case the determinated hostname isn\'t right, otherweise leave it as is.'),
232 DI::l10n()->t('Required')],
233 '$basepath' => ['system-basepath',
234 DI::l10n()->t("Base path to installation"),
235 $configCache->get('system', 'basepath'),
236 DI::l10n()->t("If the system cannot detect the correct path to your installation, enter the correct path here. This setting should only be set if you are using a restricted system and symbolic links to your webroot."),
237 DI::l10n()->t('Required')],
238 '$urlpath' => ['system-urlpath',
239 DI::l10n()->t('Sub path of the URL'),
240 $configCache->get('system', 'urlpath'),
241 DI::l10n()->t('Overwrite this field in case the sub path determination isn\'t right, otherwise leave it as is. Leaving this field blank means the installation is at the base URL without sub path.'),
243 '$php_path' => $configCache->get('config', 'php_path'),
244 '$submit' => DI::l10n()->t('Submit'),
248 case self::DATABASE_CONFIG:
249 $tpl = Renderer::getMarkupTemplate('install_db.tpl');
250 $output .= Renderer::replaceMacros($tpl, [
251 '$title' => $install_title,
252 '$pass' => DI::l10n()->t('Database connection'),
253 '$info_01' => DI::l10n()->t('In order to install Friendica we need to know how to connect to your database.'),
254 '$info_02' => DI::l10n()->t('Please contact your hosting provider or site administrator if you have questions about these settings.'),
255 '$info_03' => DI::l10n()->t('The database you specify below should already exist. If it does not, please create it before continuing.'),
256 '$required' => DI::l10n()->t('Required'),
257 '$requirement_not_satisfied' => DI::l10n()->t('Requirement not satisfied'),
258 '$checks' => self::$installer->getChecks(),
259 '$hostname' => $configCache->get('config', 'hostname'),
260 '$ssl_policy' => $configCache->get('system', 'ssl_policy'),
261 '$basepath' => $configCache->get('system', 'basepath'),
262 '$urlpath' => $configCache->get('system', 'urlpath'),
263 '$dbhost' => ['database-hostname',
264 DI::l10n()->t('Database Server Name'),
265 $configCache->get('database', 'hostname'),
267 DI::l10n()->t('Required')],
268 '$dbuser' => ['database-username',
269 DI::l10n()->t('Database Login Name'),
270 $configCache->get('database', 'username'),
272 DI::l10n()->t('Required'),
274 '$dbpass' => ['database-password',
275 DI::l10n()->t('Database Login Password'),
276 $configCache->get('database', 'password'),
277 DI::l10n()->t("For security reasons the password must not be empty"),
278 DI::l10n()->t('Required')],
279 '$dbdata' => ['database-database',
280 DI::l10n()->t('Database Name'),
281 $configCache->get('database', 'database'),
283 DI::l10n()->t('Required')],
284 '$lbl_10' => DI::l10n()->t('Please select a default timezone for your website'),
285 '$php_path' => $configCache->get('config', 'php_path'),
286 '$submit' => DI::l10n()->t('Submit')
290 case self::SITE_SETTINGS:
291 /* Installed langs */
292 $lang_choices = DI::l10n()->getAvailableLanguages();
294 $tpl = Renderer::getMarkupTemplate('install_settings.tpl');
295 $output .= Renderer::replaceMacros($tpl, [
296 '$title' => $install_title,
297 '$required' => DI::l10n()->t('Required'),
298 '$checks' => self::$installer->getChecks(),
299 '$pass' => DI::l10n()->t('Site settings'),
300 '$hostname' => $configCache->get('config', 'hostname'),
301 '$ssl_policy' => $configCache->get('system', 'ssl_policy'),
302 '$basepath' => $configCache->get('system', 'basepath'),
303 '$urlpath' => $configCache->get('system', 'urlpath'),
304 '$dbhost' => $configCache->get('database', 'hostname'),
305 '$dbuser' => $configCache->get('database', 'username'),
306 '$dbpass' => $configCache->get('database', 'password'),
307 '$dbdata' => $configCache->get('database', 'database'),
308 '$adminmail' => ['config-admin_email',
309 DI::l10n()->t('Site administrator email address'),
310 $configCache->get('config', 'admin_email'),
311 DI::l10n()->t('Your account email address must match this in order to use the web admin panel.'),
312 DI::l10n()->t('Required'), 'autofocus', 'email'],
313 '$timezone' => Temporal::getTimezoneField('system-default_timezone',
314 DI::l10n()->t('Please select a default timezone for your website'),
315 $configCache->get('system', 'default_timezone'),
317 '$language' => ['system-language',
318 DI::l10n()->t('System Language:'),
319 $configCache->get('system', 'language'),
320 DI::l10n()->t('Set the default language for your Friendica installation interface and to send emails.'),
322 '$php_path' => $configCache->get('config', 'php_path'),
323 '$submit' => DI::l10n()->t('Submit')
328 $db_return_text = "";
330 if (count(self::$installer->getChecks()) == 0) {
331 $txt = '<p style="font-size: 130%;">';
332 $txt .= DI::l10n()->t('Your Friendica site database has been installed.') . EOL;
333 $db_return_text .= $txt;
336 $tpl = Renderer::getMarkupTemplate('install_finished.tpl');
337 $output .= Renderer::replaceMacros($tpl, [
338 '$title' => $install_title,
339 '$required' => DI::l10n()->t('Required'),
340 '$requirement_not_satisfied' => DI::l10n()->t('Requirement not satisfied'),
341 '$checks' => self::$installer->getChecks(),
342 '$pass' => DI::l10n()->t('Installation finished'),
343 '$text' => $db_return_text . self::whatNext(),
353 * Creates the text for the next steps
355 * @return string The text for the next steps
356 * @throws \Friendica\Network\HTTPException\InternalServerErrorException
358 private static function whatNext()
360 $baseurl = DI::baseUrl()->get();
362 DI::l10n()->t('<h1>What next</h1>')
363 . "<p>" . DI::l10n()->t('IMPORTANT: You will need to [manually] setup a scheduled task for the worker.')
364 . DI::l10n()->t('Please see the file "doc/INSTALL.md".')
366 . DI::l10n()->t('Go to your new Friendica node <a href="%s/register">registration page</a> and register as new user. Remember to use the same email you have entered as administrator email. This will allow you to enter the site admin panel.', $baseurl)
371 * Checks the $_POST settings and updates the config Cache for it
373 * @param \Friendica\Core\Config\ValueObject\Cache $configCache The current config cache
374 * @param array $post The $_POST data
375 * @param string $cat The category of the setting
376 * @param string $key The key of the setting
377 * @param null|string $default The default value
379 private static function checkSetting(Cache $configCache, array $post, $cat, $key, $default = null)
381 $configCache->set($cat, $key,
382 trim(($post[sprintf('%s-%s', $cat, $key)] ?? '') ?:
383 ($default ?? $configCache->get($cat, $key))