3 namespace Friendica\Module;
6 use Friendica\BaseModule;
8 use Friendica\Core\Config\Cache\ConfigCache;
9 use Friendica\Core\L10n;
10 use Friendica\Core\Renderer;
12 use Friendica\Network\HTTPException;
13 use Friendica\Util\BasePath;
14 use Friendica\Util\Strings;
15 use Friendica\Util\Temporal;
17 class Install extends BaseModule
20 * Step one - System check
22 const SYSTEM_CHECK = 1;
24 * Step two - Base information
26 const BASE_CONFIG = 2;
28 * Step three - Database configuration
30 const DATABASE_CONFIG = 3;
32 * Step four - Adapt site settings
34 const SITE_SETTINGS = 4;
36 * Step five - All steps finished
41 * @var int The current step of the wizard
43 private static $currentWizardStep;
46 * @var Core\Installer The installer
48 private static $installer;
50 public static function init(array $parameters = [])
54 if (!DI::mode()->isInstall()) {
55 throw new HTTPException\ForbiddenException();
58 // route: install/testrwrite
59 // $baseurl/install/testrwrite to test if rewrite in .htaccess is working
60 if (DI::args()->get(1, '') == 'testrewrite') {
61 // Status Code 204 means that it worked without content
62 throw new HTTPException\NoContentException();
65 self::$installer = new Core\Installer();
67 // get basic installation information and save them to the config cache
68 $configCache = $a->getConfigCache();
69 $basePath = new BasePath($a->getBasePath());
70 self::$installer->setUpCache($configCache, $basePath->getPath());
72 // We overwrite current theme css, because during install we may not have a working mod_rewrite
73 // so we may not have a css at all. Here we set a static css file for the install procedure pages
74 Renderer::$theme['stylesheet'] = DI::baseUrl()->get() . '/view/install/style.css';
76 self::$currentWizardStep = ($_POST['pass'] ?? '') ?: self::SYSTEM_CHECK;
79 public static function post(array $parameters = [])
82 $configCache = $a->getConfigCache();
84 switch (self::$currentWizardStep) {
85 case self::SYSTEM_CHECK:
86 case self::BASE_CONFIG:
87 self::checkSetting($configCache, $_POST, 'config', 'php_path');
90 case self::DATABASE_CONFIG:
91 self::checkSetting($configCache, $_POST, 'config', 'php_path');
93 self::checkSetting($configCache, $_POST, 'config', 'hostname');
94 self::checkSetting($configCache, $_POST, 'system', 'ssl_policy');
95 self::checkSetting($configCache, $_POST, 'system', 'basepath');
96 self::checkSetting($configCache, $_POST, 'system', 'urlpath');
99 case self::SITE_SETTINGS:
100 self::checkSetting($configCache, $_POST, 'config', 'php_path');
102 self::checkSetting($configCache, $_POST, 'config', 'hostname');
103 self::checkSetting($configCache, $_POST, 'system', 'ssl_policy');
104 self::checkSetting($configCache, $_POST, 'system', 'basepath');
105 self::checkSetting($configCache, $_POST, 'system', 'urlpath');
107 self::checkSetting($configCache, $_POST, 'database', 'hostname', Core\Installer::DEFAULT_HOST);
108 self::checkSetting($configCache, $_POST, 'database', 'username', '');
109 self::checkSetting($configCache, $_POST, 'database', 'password', '');
110 self::checkSetting($configCache, $_POST, 'database', 'database', '');
112 // If we cannot connect to the database, return to the previous step
113 if (!self::$installer->checkDB(DI::dba())) {
114 self::$currentWizardStep = self::DATABASE_CONFIG;
120 self::checkSetting($configCache, $_POST, 'config', 'php_path');
122 self::checkSetting($configCache, $_POST, 'config', 'hostname');
123 self::checkSetting($configCache, $_POST, 'system', 'ssl_policy');
124 self::checkSetting($configCache, $_POST, 'system', 'basepath');
125 self::checkSetting($configCache, $_POST, 'system', 'urlpath');
127 self::checkSetting($configCache, $_POST, 'database', 'hostname', Core\Installer::DEFAULT_HOST);
128 self::checkSetting($configCache, $_POST, 'database', 'username', '');
129 self::checkSetting($configCache, $_POST, 'database', 'password', '');
130 self::checkSetting($configCache, $_POST, 'database', 'database', '');
132 self::checkSetting($configCache, $_POST, 'system', 'default_timezone', Core\Installer::DEFAULT_TZ);
133 self::checkSetting($configCache, $_POST, 'system', 'language', Core\Installer::DEFAULT_LANG);
134 self::checkSetting($configCache, $_POST, 'config', 'admin_email', '');
136 // If we cannot connect to the database, return to the Database config wizard
137 if (!self::$installer->checkDB(DI::dba())) {
138 self::$currentWizardStep = self::DATABASE_CONFIG;
142 if (!self::$installer->createConfig($configCache)) {
146 self::$installer->installDatabase($configCache->get('system', 'basepath'));
152 public static function content(array $parameters = [])
155 $configCache = $a->getConfigCache();
159 $install_title = DI::l10n()->t('Friendica Communications Server - Setup');
161 switch (self::$currentWizardStep) {
162 case self::SYSTEM_CHECK:
163 $php_path = $configCache->get('config', 'php_path');
165 $status = self::$installer->checkEnvironment(DI::baseUrl()->get(), $php_path);
167 $tpl = Renderer::getMarkupTemplate('install_checks.tpl');
168 $output .= Renderer::replaceMacros($tpl, [
169 '$title' => $install_title,
170 '$pass' => DI::l10n()->t('System check'),
171 '$checks' => self::$installer->getChecks(),
172 '$passed' => $status,
173 '$see_install' => DI::l10n()->t('Please see the file "INSTALL.txt".'),
174 '$next' => DI::l10n()->t('Next'),
175 '$reload' => DI::l10n()->t('Check again'),
176 '$php_path' => $php_path,
180 case self::BASE_CONFIG:
182 App\BaseURL::SSL_POLICY_NONE => DI::l10n()->t("No SSL policy, links will track page SSL state"),
183 App\BaseURL::SSL_POLICY_FULL => DI::l10n()->t("Force all links to use SSL"),
184 App\BaseURL::SSL_POLICY_SELFSIGN => DI::l10n()->t("Self-signed certificate, use SSL for local links only \x28discouraged\x29")
187 $tpl = Renderer::getMarkupTemplate('install_base.tpl');
188 $output .= Renderer::replaceMacros($tpl, [
189 '$title' => $install_title,
190 '$pass' => DI::l10n()->t('Base settings'),
191 '$ssl_policy' => ['system-ssl_policy',
192 DI::l10n()->t("SSL link policy"),
193 $configCache->get('system', 'ssl_policy'),
194 DI::l10n()->t("Determines whether generated links should be forced to use SSL"),
196 '$hostname' => ['config-hostname',
197 DI::l10n()->t('Host name'),
198 $configCache->get('config', 'hostname'),
199 DI::l10n()->t('Overwrite this field in case the determinated hostname isn\'t right, otherweise leave it as is.'),
201 '$basepath' => ['system-basepath',
202 DI::l10n()->t("Base path to installation"),
203 $configCache->get('system', 'basepath'),
204 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."),
206 '$urlpath' => ['system-urlpath',
207 DI::l10n()->t('Sub path of the URL'),
208 $configCache->get('system', 'urlpath'),
209 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.'),
211 '$php_path' => $configCache->get('config', 'php_path'),
212 '$submit' => DI::l10n()->t('Submit'),
216 case self::DATABASE_CONFIG:
217 $tpl = Renderer::getMarkupTemplate('install_db.tpl');
218 $output .= Renderer::replaceMacros($tpl, [
219 '$title' => $install_title,
220 '$pass' => DI::l10n()->t('Database connection'),
221 '$info_01' => DI::l10n()->t('In order to install Friendica we need to know how to connect to your database.'),
222 '$info_02' => DI::l10n()->t('Please contact your hosting provider or site administrator if you have questions about these settings.'),
223 '$info_03' => DI::l10n()->t('The database you specify below should already exist. If it does not, please create it before continuing.'),
224 'checks' => self::$installer->getChecks(),
225 '$hostname' => $configCache->get('config', 'hostname'),
226 '$ssl_policy' => $configCache->get('system', 'ssl_policy'),
227 '$basepath' => $configCache->get('system', 'basepath'),
228 '$urlpath' => $configCache->get('system', 'urlpath'),
229 '$dbhost' => ['database-hostname',
230 DI::l10n()->t('Database Server Name'),
231 $configCache->get('database', 'hostname'),
234 '$dbuser' => ['database-username',
235 DI::l10n()->t('Database Login Name'),
236 $configCache->get('database', 'username'),
240 '$dbpass' => ['database-password',
241 DI::l10n()->t('Database Login Password'),
242 $configCache->get('database', 'password'),
243 DI::l10n()->t("For security reasons the password must not be empty"),
245 '$dbdata' => ['database-database',
246 DI::l10n()->t('Database Name'),
247 $configCache->get('database', 'database'),
250 '$lbl_10' => DI::l10n()->t('Please select a default timezone for your website'),
251 '$php_path' => $configCache->get('config', 'php_path'),
252 '$submit' => DI::l10n()->t('Submit')
256 case self::SITE_SETTINGS:
257 /* Installed langs */
258 $lang_choices = L10n::getAvailableLanguages();
260 $tpl = Renderer::getMarkupTemplate('install_settings.tpl');
261 $output .= Renderer::replaceMacros($tpl, [
262 '$title' => $install_title,
263 '$checks' => self::$installer->getChecks(),
264 '$pass' => DI::l10n()->t('Site settings'),
265 '$hostname' => $configCache->get('config', 'hostname'),
266 '$ssl_policy' => $configCache->get('system', 'ssl_policy'),
267 '$basepath' => $configCache->get('system', 'basepath'),
268 '$urlpath' => $configCache->get('system', 'urlpath'),
269 '$dbhost' => $configCache->get('database', 'hostname'),
270 '$dbuser' => $configCache->get('database', 'username'),
271 '$dbpass' => $configCache->get('database', 'password'),
272 '$dbdata' => $configCache->get('database', 'database'),
273 '$adminmail' => ['config-admin_email',
274 DI::l10n()->t('Site administrator email address'),
275 $configCache->get('config', 'admin_email'),
276 DI::l10n()->t('Your account email address must match this in order to use the web admin panel.'),
277 'required', 'autofocus', 'email'],
278 '$timezone' => Temporal::getTimezoneField('system-default_timezone',
279 DI::l10n()->t('Please select a default timezone for your website'),
280 $configCache->get('system', 'default_timezone'),
282 '$language' => ['system-language',
283 DI::l10n()->t('System Language:'),
284 $configCache->get('system', 'language'),
285 DI::l10n()->t('Set the default language for your Friendica installation interface and to send emails.'),
287 '$php_path' => $configCache->get('config', 'php_path'),
288 '$submit' => DI::l10n()->t('Submit')
293 $db_return_text = "";
295 if (count(self::$installer->getChecks()) == 0) {
296 $txt = '<p style="font-size: 130%;">';
297 $txt .= DI::l10n()->t('Your Friendica site database has been installed.') . EOL;
298 $db_return_text .= $txt;
301 $tpl = Renderer::getMarkupTemplate('install_finished.tpl');
302 $output .= Renderer::replaceMacros($tpl, [
303 '$title' => $install_title,
304 '$checks' => self::$installer->getChecks(),
305 '$pass' => DI::l10n()->t('Installation finished'),
306 '$text' => $db_return_text . self::whatNext(),
316 * Creates the text for the next steps
318 * @return string The text for the next steps
319 * @throws \Friendica\Network\HTTPException\InternalServerErrorException
321 private static function whatNext()
323 $baseurl = DI::baseUrl()->get();
325 DI::l10n()->t('<h1>What next</h1>')
326 . "<p>" . DI::l10n()->t('IMPORTANT: You will need to [manually] setup a scheduled task for the worker.')
327 . DI::l10n()->t('Please see the file "INSTALL.txt".')
329 . 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)
334 * Checks the $_POST settings and updates the config Cache for it
336 * @param ConfigCache $configCache The current config cache
337 * @param array $post The $_POST data
338 * @param string $cat The category of the setting
339 * @param string $key The key of the setting
340 * @param null|string $default The default value
342 private static function checkSetting(ConfigCache $configCache, array $post, $cat, $key, $default = null)
344 $configCache->set($cat, $key,
346 trim(($post[sprintf('%s-%s', $cat, $key)] ?? '') ?:
347 ($default ?? $configCache->get($cat, $key))