$interactive) + install_state_defaults(); try { // Begin the page request. This adds information about the current state of // the Drupal installation to the passed-in array. install_begin_request($install_state); // Based on the installation state, run the remaining tasks for this page // request, and collect any output. $output = install_run_tasks($install_state); } catch (Exception $e) { // When an installation error occurs, either send the error to the web // browser or pass on the exception so the calling script can use it. if ($install_state['interactive']) { install_display_output($e->getMessage(), $install_state); } else { throw $e; } } // After execution, all tasks might be complete, in which case // $install_state['installation_finished'] is TRUE. In case the last task // has been processed, remove the global $install_state, so other code can // reliably check whether it is running during the installer. // @see drupal_installation_attempted() $state = $install_state; if (!empty($install_state['installation_finished'])) { unset($GLOBALS['install_state']); } // All available tasks for this page request are now complete. Interactive // installations can send output to the browser or redirect the user to the // next page. if ($state['interactive']) { if ($state['parameters_changed']) { // Redirect to the correct page if the URL parameters have changed. install_goto(install_redirect_url($state)); } elseif (isset($output)) { // Display a page only if some output is available. Otherwise it is // possible that we are printing a JSON page and theme output should // not be shown. install_display_output($output, $state); } } } /** * Returns an array of default settings for the global installation state. * * The installation state is initialized with these settings at the beginning * of each page request. They may evolve during the page request, but they are * initialized again once the next request begins. * * Non-interactive Drupal installations can override some of these default * settings by passing in an array to the installation script, most notably * 'parameters' (which contains one-time parameters such as 'profile' and * 'langcode' that are normally passed in via the URL) and 'forms' (which can * be used to programmatically submit forms during the installation; the keys * of each element indicate the name of the installation task that the form * submission is for, and the values are used as the $form_state['values'] * array that is passed on to the form submission via drupal_form_submit()). * * @see drupal_form_submit() */ function install_state_defaults() { $defaults = array( // The current task being processed. 'active_task' => NULL, // The last task that was completed during the previous installation // request. 'completed_task' => NULL, // This becomes TRUE only when a valid config directory is created or // detected. 'config_verified' => FALSE, // This becomes TRUE only when Drupal's system module is installed. 'database_tables_exist' => FALSE, // This becomes TRUE only when a valid database connection can be // established. 'database_verified' => FALSE, // Whether a translation file for the selected language will be downloaded // from the translation server. 'download_translation' => FALSE, // An array of forms to be programmatically submitted during the // installation. The keys of each element indicate the name of the // installation task that the form submission is for, and the values are // used as the $form_state['values'] array that is passed on to the form // submission via drupal_form_submit(). 'forms' => array(), // This becomes TRUE only at the end of the installation process, after // all available tasks have been completed and Drupal is fully installed. // It is used by the installer to store correct information in the database // about the completed installation, as well as to inform theme functions // that all tasks are finished (so that the task list can be displayed // correctly). 'installation_finished' => FALSE, // Whether or not this installation is interactive. By default this will // be set to FALSE if settings are passed in to install_drupal(). 'interactive' => TRUE, // An array of parameters for the installation, pre-populated by the URL // or by the settings passed in to install_drupal(). This is primarily // used to store 'profile' (the name of the chosen installation profile) // and 'langcode' (the code of the chosen installation language), since // these settings need to persist from page request to page request before // the database is available for storage. 'parameters' => array(), // Whether or not the parameters have changed during the current page // request. For interactive installations, this will trigger a page // redirect. 'parameters_changed' => FALSE, // An array of information about the chosen installation profile. This will // be filled in based on the profile's .info file. 'profile_info' => array(), // An array of available installation profiles. 'profiles' => array(), // An array of server variables that will be substituted into the global // $_SERVER array via drupal_override_server_variables(). Used by // non-interactive installations only. 'server' => array(), // The server URL where the interface translation files can be downloaded. // Tokens in the pattern will be replaced by appropriate values for the // required translation file. 'server_pattern' => 'http://ftp.drupal.org/files/translations/%core/%project/%project-%version.%language.po', // This becomes TRUE only when a valid settings.php file is written // (containing both valid database connection information and a valid // config directory). 'settings_verified' => FALSE, // Installation tasks can set this to TRUE to force the page request to // end (even if there is no themable output), in the case of an interactive // installation. This is needed only rarely; for example, it would be used // by an installation task that prints JSON output rather than returning a // themed page. The most common example of this is during batch processing, // but the Drupal installer automatically takes care of setting this // parameter properly in that case, so that individual installation tasks // which implement the batch API do not need to set it themselves. 'stop_page_request' => FALSE, // Installation tasks can set this to TRUE to indicate that the task should // be run again, even if it normally wouldn't be. This can be used, for // example, if a single task needs to be spread out over multiple page // requests, or if it needs to perform some validation before allowing // itself to be marked complete. The most common examples of this are batch // processing and form submissions, but the Drupal installer automatically // takes care of setting this parameter properly in those cases, so that // individual installation tasks which implement the batch API or form API // do not need to set it themselves. 'task_not_complete' => FALSE, // A list of installation tasks which have already been performed during // the current page request. 'tasks_performed' => array(), // An array of translation files URIs available for the installation. Keyed // by the translation language code. 'translations' => array(), ); return $defaults; } /** * Begins an installation request, modifying the installation state as needed. * * This function performs commands that must run at the beginning of every page * request. It throws an exception if the installation should not proceed. * * @param $install_state * An array of information about the current installation state. This is * modified with information gleaned from the beginning of the page request. */ function install_begin_request(&$install_state) { // Add any installation parameters passed in via the URL. if ($install_state['interactive']) { $install_state['parameters'] += $_GET; } // Validate certain core settings that are used throughout the installation. if (!empty($install_state['parameters']['profile'])) { $install_state['parameters']['profile'] = preg_replace('/[^a-zA-Z_0-9]/', '', $install_state['parameters']['profile']); } if (!empty($install_state['parameters']['langcode'])) { $install_state['parameters']['langcode'] = preg_replace('/[^a-zA-Z_0-9\-]/', '', $install_state['parameters']['langcode']); } // Allow command line scripts to override server variables used by Drupal. require_once DRUPAL_ROOT . '/core/includes/bootstrap.inc'; if (!$install_state['interactive']) { drupal_override_server_variables($install_state['server']); } // The user agent header is used to pass a database prefix in the request when // running tests. However, for security reasons, it is imperative that no // installation be permitted using such a prefix. elseif (isset($_SERVER['HTTP_USER_AGENT']) && strpos($_SERVER['HTTP_USER_AGENT'], "simpletest") !== FALSE) { header($_SERVER['SERVER_PROTOCOL'] . ' 403 Forbidden'); exit; } // Initialize conf_path(). // This primes the site path to be used during installation. By not requiring // settings.php, a bare site folder can be prepared in the /sites directory, // which will be used for installing Drupal. conf_path(FALSE); drupal_bootstrap(DRUPAL_BOOTSTRAP_CONFIGURATION); // A request object from the HTTPFoundation to tell us about the request. $request = Request::createFromGlobals(); // This must go after drupal_bootstrap(), which unsets globals! global $conf; require_once DRUPAL_ROOT . '/core/modules/system/system.install'; require_once DRUPAL_ROOT . '/core/includes/common.inc'; require_once DRUPAL_ROOT . '/core/includes/file.inc'; require_once DRUPAL_ROOT . '/core/includes/install.inc'; require_once DRUPAL_ROOT . '/core/includes/schema.inc'; require_once DRUPAL_ROOT . '/' . settings()->get('path_inc', 'core/includes/path.inc'); // Load module basics (needed for hook invokes). include_once DRUPAL_ROOT . '/core/includes/module.inc'; include_once DRUPAL_ROOT . '/core/includes/session.inc'; require_once DRUPAL_ROOT . '/core/includes/entity.inc'; // Determine whether the configuration system is ready to operate. $install_state['config_verified'] = install_verify_config_directory(CONFIG_ACTIVE_DIRECTORY) && install_verify_config_directory(CONFIG_STAGING_DIRECTORY); // Check existing settings.php. $install_state['database_verified'] = install_verify_database_settings(); $install_state['settings_verified'] = $install_state['config_verified'] && $install_state['database_verified']; // If it is not, replace the configuration storage with the InstallStorage // implementation, for the following reasons: // - The first call into drupal_container() will try to set up the regular // runtime configuration storage, using the CachedStorage by default. It // calls config_get_config_directory() to retrieve the config directory to // use, but that throws an exception, since $config_directories is not // defined since there is no settings.php yet. If there is a prepared // settings.php already, then the returned directory still cannot be used, // because it does not necessarily exist. The installer ensures that it // exists and is writeable in a later step. // - The installer outputs maintenance theme pages and performs many other // operations, which try to load configuration. Since there is no active // configuration yet, and because the configuration system does not have a // notion of default values at runtime, data is missing in many places. The // lack of data does not trigger errors, but results in a broken user // interface (e.g., missing page title, etc). // - The actual configuration data to read during installation is essentially // the default configuration provided by the installation profile and // modules (most notably System module). The InstallStorage therefore reads // from the default configuration directories of extensions. // This override is reverted as soon as the config directory and the // database has been set up successfully. // @see drupal_install_config_directories() // @see install_settings_form_submit() if ($install_state['settings_verified']) { $kernel = new DrupalKernel('install', FALSE, drupal_classloader(), FALSE); $kernel->boot(); } else { // @todo Move into a proper Drupal\Core\DependencyInjection\InstallContainerBuilder. $container = new ContainerBuilder(); $container->register('event_dispatcher', 'Symfony\Component\EventDispatcher\EventDispatcher'); $container->register('config.storage', 'Drupal\Core\Config\InstallStorage'); $container->register('config.factory', 'Drupal\Core\Config\ConfigFactory') ->addArgument(new Reference('config.storage')) ->addArgument(new Reference('event_dispatcher')); // The install process cannot use the database lock backend since the database // is not fully up, so we use a null backend implementation during the // installation process. This will also speed up the installation process. // The site being installed will use the real lock backend when doing AJAX // requests but, except for a WSOD, there is no chance for a a lock to stall // (as opposed to the cache backend) so we can afford having a null // implementation here. $container->register('lock', 'Drupal\Core\Lock\NullLockBackend'); // Register a module handler for managing enabled modules. $container ->register('module_handler', 'Drupal\Core\Extension\ModuleHandler'); drupal_container($container); } // Set up $language, so t() caller functions will still work. drupal_language_initialize(); require_once DRUPAL_ROOT . '/core/includes/ajax.inc'; $module_handler = drupal_container()->get('module_handler'); if (!$module_handler->moduleExists('system')) { // Override the module list with a minimal set of modules. $module_handler->setModuleList(array('system' => 'core/modules/system/system.module')); } $module_handler->load('system'); require_once DRUPAL_ROOT . '/core/includes/cache.inc'; $conf['cache_classes'] = array('cache' => 'Drupal\Core\Cache\MemoryBackend'); // Prepare for themed output. We need to run this at the beginning of the // page request to avoid a different theme accidentally getting set. (We also // need to run it even in the case of command-line installations, to prevent // any code in the installer that happens to initialize the theme system from // accessing the database before it is set up yet.) drupal_maintenance_theme(); if ($install_state['database_verified']) { // Initialize the database system. Note that the connection // won't be initialized until it is actually requested. require_once DRUPAL_ROOT . '/core/includes/database.inc'; // Verify the last completed task in the database, if there is one. $task = install_verify_completed_task(); } else { $task = NULL; // Do not install over a configured settings.php. Check the 'db_url' // variable in addition to 'databases', since previous versions of Drupal // used that (and we do not want to allow installations on an existing site // whose settings file has not yet been updated). if (!empty($GLOBALS['databases']) || !empty($GLOBALS['db_url'])) { throw new Exception(install_already_done_error()); } } // Modify the installation state as appropriate. $install_state['completed_task'] = $task; $install_state['database_tables_exist'] = !empty($task); // Add the list of available profiles to the installation state. $install_state['profiles'] += drupal_system_listing('/^' . DRUPAL_PHP_FUNCTION_PATTERN . '\.profile$/', 'profiles'); } /** * Runs all tasks for the current installation request. * * In the case of an interactive installation, all tasks will be attempted * until one is reached that has output which needs to be displayed to the * user, or until a page redirect is required. Otherwise, tasks will be * attempted until the installation is finished. * * @param $install_state * An array of information about the current installation state. This is * passed along to each task, so it can be modified if necessary. * * @return * HTML output from the last completed task. */ function install_run_tasks(&$install_state) { do { // Obtain a list of tasks to perform. The list of tasks itself can be // dynamic (e.g., some might be defined by the installation profile, // which is not necessarily known until the earlier tasks have run), // so we regenerate the remaining tasks based on the installation state, // each time through the loop. $tasks_to_perform = install_tasks_to_perform($install_state); // Run the first task on the list. reset($tasks_to_perform); $task_name = key($tasks_to_perform); $task = array_shift($tasks_to_perform); $install_state['active_task'] = $task_name; $original_parameters = $install_state['parameters']; $output = install_run_task($task, $install_state); $install_state['parameters_changed'] = ($install_state['parameters'] != $original_parameters); // Store this task as having been performed during the current request, // and save it to the database as completed, if we need to and if the // database is in a state that allows us to do so. Also mark the // installation as 'done' when we have run out of tasks. if (!$install_state['task_not_complete']) { $install_state['tasks_performed'][] = $task_name; $install_state['installation_finished'] = empty($tasks_to_perform); if ($install_state['database_tables_exist'] && ($task['run'] == INSTALL_TASK_RUN_IF_NOT_COMPLETED || $install_state['installation_finished'])) { variable_set('install_task', $install_state['installation_finished'] ? 'done' : $task_name); } } // Stop when there are no tasks left. In the case of an interactive // installation, also stop if we have some output to send to the browser, // the URL parameters have changed, or an end to the page request was // specifically called for. $finished = empty($tasks_to_perform) || ($install_state['interactive'] && (isset($output) || $install_state['parameters_changed'] || $install_state['stop_page_request'])); } while (!$finished); return $output; } /** * Runs an individual installation task. * * @param $task * An array of information about the task to be run. * @param $install_state * An array of information about the current installation state. This is * passed in by reference so that it can be modified by the task. * * @return * The output of the task function, if there is any. */ function install_run_task($task, &$install_state) { $function = $task['function']; if ($task['type'] == 'form') { require_once DRUPAL_ROOT . '/core/includes/form.inc'; if ($install_state['interactive']) { // For interactive forms, build the form and ensure that it will not // redirect, since the installer handles its own redirection only after // marking the form submission task complete. $form_state = array( // We need to pass $install_state by reference in order for forms to // modify it, since the form API will use it in call_user_func_array(), // which requires that referenced variables be passed explicitly. 'build_info' => array('args' => array(&$install_state)), 'no_redirect' => TRUE, ); $form = drupal_build_form($function, $form_state); // If a successful form submission did not occur, the form needs to be // rendered, which means the task is not complete yet. if (empty($form_state['executed'])) { $install_state['task_not_complete'] = TRUE; return drupal_render($form); } // Otherwise, return nothing so the next task will run in the same // request. return; } else { // For non-interactive forms, submit the form programmatically with the // values taken from the installation state. Throw an exception if any // errors were encountered. $form_state = array( 'values' => !empty($install_state['forms'][$function]) ? $install_state['forms'][$function] : array(), // We need to pass $install_state by reference in order for forms to // modify it, since the form API will use it in call_user_func_array(), // which requires that referenced variables be passed explicitly. 'build_info' => array('args' => array(&$install_state)), ); drupal_form_submit($function, $form_state); $errors = form_get_errors(); if (!empty($errors)) { throw new Exception(implode("\n", $errors)); } } } elseif ($task['type'] == 'batch') { // Start a new batch based on the task function, if one is not running // already. $current_batch = variable_get('install_current_batch'); if (!$install_state['interactive'] || !$current_batch) { $batch = $function($install_state); if (empty($batch)) { // If the task did some processing and decided no batch was necessary, // there is nothing more to do here. return; } batch_set($batch); // For interactive batches, we need to store the fact that this batch // task is currently running. Otherwise, we need to make sure the batch // will complete in one page request. if ($install_state['interactive']) { variable_set('install_current_batch', $function); } else { $batch =& batch_get(); $batch['progressive'] = FALSE; } // Process the batch. For progressive batches, this will redirect. // Otherwise, the batch will complete. batch_process(install_redirect_url($install_state), install_full_redirect_url($install_state)); } // If we are in the middle of processing this batch, keep sending back // any output from the batch process, until the task is complete. elseif ($current_batch == $function) { include_once DRUPAL_ROOT . '/core/includes/batch.inc'; $output = _batch_page(); // Because Batch API now returns a JSON response for intermediary steps, // but the installer doesn't handle Response objects yet, just send the // output here and emulate the old model. // @todo Replace this when we refactor the installer to use a request- // response workflow. if ($output instanceof Response) { $output->send(); $output = NULL; } // The task is complete when we try to access the batch page and receive // FALSE in return, since this means we are at a URL where we are no // longer requesting a batch ID. if ($output === FALSE) { // Return nothing so the next task will run in the same request. variable_del('install_current_batch'); return; } else { // We need to force the page request to end if the task is not // complete, since the batch API sometimes prints JSON output // rather than returning a themed page. $install_state['task_not_complete'] = $install_state['stop_page_request'] = TRUE; return $output; } } } else { // For normal tasks, just return the function result, whatever it is. return $function($install_state); } } /** * Returns a list of tasks to perform during the current installation request. * * Note that the list of tasks can change based on the installation state as * the page request evolves (for example, if an installation profile hasn't * been selected yet, we don't yet know which profile tasks need to be run). * * @param $install_state * An array of information about the current installation state. * * @return * A list of tasks to be performed, with associated metadata. */ function install_tasks_to_perform($install_state) { // Start with a list of all currently available tasks. $tasks = install_tasks($install_state); foreach ($tasks as $name => $task) { // Remove any tasks that were already performed or that never should run. // Also, if we started this page request with an indication of the last // task that was completed, skip that task and all those that come before // it, unless they are marked as always needing to run. if ($task['run'] == INSTALL_TASK_SKIP || in_array($name, $install_state['tasks_performed']) || (!empty($install_state['completed_task']) && empty($completed_task_found) && $task['run'] != INSTALL_TASK_RUN_IF_REACHED)) { unset($tasks[$name]); } if (!empty($install_state['completed_task']) && $name == $install_state['completed_task']) { $completed_task_found = TRUE; } } return $tasks; } /** * Returns a list of all tasks the installer currently knows about. * * This function will return tasks regardless of whether or not they are * intended to run on the current page request. However, the list can change * based on the installation state (for example, if an installation profile * hasn't been selected yet, we don't yet know which profile tasks will be * available). * * @param $install_state * An array of information about the current installation state. * * @return * A list of tasks, with associated metadata. */ function install_tasks($install_state) { // Determine whether a translation file must be imported during the // 'install_import_translations' task. Import when a non-English language is // available and selected. $needs_translations = count($install_state['translations']) > 1 && !empty($install_state['parameters']['langcode']) && $install_state['parameters']['langcode'] != 'en'; // Determine whether a translation file must be downloaded during the // 'install_download_translation' task. Download when a non-English language // is selected, but no translation is yet in the translations directory. $needs_download = isset($install_state['parameters']['langcode']) && !isset($install_state['translations'][$install_state['parameters']['langcode']]) && $install_state['parameters']['langcode'] != 'en'; // Start with the core installation tasks that run before handing control // to the installation profile. $tasks = array( 'install_select_language' => array( 'display_name' => st('Choose language'), 'run' => INSTALL_TASK_RUN_IF_REACHED, ), 'install_download_translation' => array( 'run' => $needs_download ? INSTALL_TASK_RUN_IF_REACHED : INSTALL_TASK_SKIP, ), 'install_select_profile' => array( 'display_name' => st('Choose profile'), 'display' => count($install_state['profiles']) != 1, 'run' => INSTALL_TASK_RUN_IF_REACHED, ), 'install_load_profile' => array( 'run' => INSTALL_TASK_RUN_IF_REACHED, ), 'install_verify_requirements' => array( 'display_name' => st('Verify requirements'), ), 'install_settings_form' => array( 'display_name' => st('Set up database'), 'type' => 'form', // Even though the form only allows the user to enter database settings, // we still need to display it if settings.php is invalid in any way, // since the form submit handler is where settings.php is rewritten. 'run' => $install_state['settings_verified'] ? INSTALL_TASK_SKIP : INSTALL_TASK_RUN_IF_NOT_COMPLETED, ), 'install_base_system' => array( ), 'install_bootstrap_full' => array( 'run' => INSTALL_TASK_RUN_IF_REACHED, ), 'install_profile_modules' => array( 'display_name' => count($install_state['profiles']) == 1 ? st('Install site') : st('Installation profile'), 'type' => 'batch', ), 'install_import_translations' => array( 'display_name' => st('Set up translations'), 'display' => $needs_translations, 'type' => 'batch', 'run' => $needs_translations ? INSTALL_TASK_RUN_IF_NOT_COMPLETED : INSTALL_TASK_SKIP, ), 'install_configure_form' => array( 'display_name' => st('Configure site'), 'type' => 'form', ), ); // Now add any tasks defined by the installation profile. if (!empty($install_state['parameters']['profile'])) { // Load the profile install file, because it is not always loaded when // hook_install_tasks() is invoked (e.g. batch processing). $profile = $install_state['parameters']['profile']; $profile_install_file = dirname($install_state['profiles'][$profile]->uri) . '/' . $profile . '.install'; if (file_exists($profile_install_file)) { include_once $profile_install_file; } $function = $install_state['parameters']['profile'] . '_install_tasks'; if (function_exists($function)) { $result = $function($install_state); if (is_array($result)) { $tasks += $result; } } } // Finish by adding the remaining core tasks. $tasks += array( 'install_import_translations_remaining' => array( 'display_name' => st('Finish translations'), 'display' => $needs_translations, 'type' => 'batch', 'run' => $needs_translations ? INSTALL_TASK_RUN_IF_NOT_COMPLETED : INSTALL_TASK_SKIP, ), 'install_finished' => array( 'display_name' => st('Finished'), ), ); // Allow the installation profile to modify the full list of tasks. if (!empty($install_state['parameters']['profile'])) { $profile = $install_state['parameters']['profile']; $profile_file = $install_state['profiles'][$profile]->uri; if (file_exists($profile_file)) { include_once $profile_file; $function = $install_state['parameters']['profile'] . '_install_tasks_alter'; if (function_exists($function)) { $function($tasks, $install_state); } } } // Fill in default parameters for each task before returning the list. foreach ($tasks as $task_name => &$task) { $task += array( 'display_name' => NULL, 'display' => !empty($task['display_name']), 'type' => 'normal', 'run' => INSTALL_TASK_RUN_IF_NOT_COMPLETED, 'function' => $task_name, ); } return $tasks; } /** * Returns a list of tasks that should be displayed to the end user. * * The output of this function is a list suitable for sending to * theme_task_list(). * * @param $install_state * An array of information about the current installation state. * * @return * A list of tasks, with keys equal to the machine-readable task name and * values equal to the name that should be displayed. * * @see theme_task_list() */ function install_tasks_to_display($install_state) { $displayed_tasks = array(); foreach (install_tasks($install_state) as $name => $task) { if ($task['display']) { $displayed_tasks[$name] = $task['display_name']; } } return $displayed_tasks; } /** * Returns the URL that should be redirected to during an installation request. * * The output of this function is suitable for sending to install_goto(). * * @param $install_state * An array of information about the current installation state. * * @return * The URL to redirect to. * * @see install_full_redirect_url() */ function install_redirect_url($install_state) { return 'core/install.php?' . drupal_http_build_query($install_state['parameters']); } /** * Returns the complete URL redirected to during an installation request. * * @param $install_state * An array of information about the current installation state. * * @return * The complete URL to redirect to. * * @see install_redirect_url() */ function install_full_redirect_url($install_state) { global $base_url; return $base_url . '/' . install_redirect_url($install_state); } /** * Displays themed installer output and ends the page request. * * Installation tasks should use drupal_set_title() to set the desired page * title, but otherwise this function takes care of theming the overall page * output during every step of the installation. * * @param $output * The content to display on the main part of the page. * @param $install_state * An array of information about the current installation state. */ function install_display_output($output, $install_state) { drupal_page_header(); // Prevent install.php from being indexed when installed in a sub folder. // robots.txt rules are not read if the site is within domain.com/subfolder // resulting in /subfolder/install.php being found through search engines. // When settings.php is writeable this can be used via an external database // leading a malicious user to gain php access to the server. $noindex_meta_tag = array( '#tag' => 'meta', '#attributes' => array( 'name' => 'robots', 'content' => 'noindex, nofollow', ), ); drupal_add_html_head($noindex_meta_tag, 'install_meta_robots'); // Only show the task list if there is an active task; otherwise, the page // request has ended before tasks have even been started, so there is nothing // meaningful to show. if (isset($install_state['active_task'])) { // Let the theming function know when every step of the installation has // been completed. $active_task = $install_state['installation_finished'] ? NULL : $install_state['active_task']; drupal_add_region_content('sidebar_first', theme('task_list', array('items' => install_tasks_to_display($install_state), 'active' => $active_task))); } print theme('install_page', array('content' => $output)); exit; } /** * Verifies the requirements for installing Drupal. * * @param $install_state * An array of information about the current installation state. * * @return * A themed status report, or an exception if there are requirement errors. */ function install_verify_requirements(&$install_state) { // Check the installation requirements for Drupal and this profile. $requirements = install_check_requirements($install_state); // Verify existence of all required modules. $requirements += drupal_verify_profile($install_state); return install_display_requirements($install_state, $requirements); } /** * Installation task; install the base functionality Drupal needs to bootstrap. * * @param $install_state * An array of information about the current installation state. */ function install_base_system(&$install_state) { // Install system.module. drupal_install_system(); // Call file_ensure_htaccess() to ensure that all of Drupal's standard // directories (e.g., the public files directory and config directory) have // appropriate .htaccess files. These directories will have already been // created by this point in the installer, since Drupal creates them during // the install_verify_requirements() task. Note that we cannot call // file_ensure_access() any earlier than this, since it relies on // system.module in order to work. file_ensure_htaccess(); // Enable the user module so that sessions can be recorded during the // upcoming bootstrap step. module_enable(array('user'), FALSE); // Save the list of other modules to install for the upcoming tasks. // variable_set() can be used now that system.module is installed. $modules = $install_state['profile_info']['dependencies']; // The installation profile is also a module, which needs to be installed // after all the dependencies have been installed. $modules[] = drupal_get_profile(); state()->set('install_profile_modules', array_diff($modules, array('system'))); $install_state['database_tables_exist'] = TRUE; } /** * Verifies and returns the last installation task that was completed. * * @return * The last completed task, if there is one. An exception is thrown if Drupal * is already installed. */ function install_verify_completed_task() { try { if ($result = db_query("SELECT value FROM {variable} WHERE name = :name", array('name' => 'install_task'))) { $task = unserialize($result->fetchField()); } } // Do not trigger an error if the database query fails, since the database // might not be set up yet. catch (Exception $e) { } if (isset($task)) { if ($task == 'done') { throw new Exception(install_already_done_error()); } return $task; } } /** * Verifies that settings.php specifies a valid database connection. */ function install_verify_database_settings() { global $databases; if (!empty($databases)) { $database = $databases['default']['default']; drupal_static_reset('conf_path'); $settings_file = './' . conf_path(FALSE) . '/settings.php'; $errors = install_database_errors($database, $settings_file); if (empty($errors)) { return TRUE; } } return FALSE; } /** * Form constructor for a form to configure and rewrite settings.php. * * @param $install_state * An array of information about the current installation state. * * @see install_settings_form_validate() * @see install_settings_form_submit() * @ingroup forms */ function install_settings_form($form, &$form_state, &$install_state) { global $databases; $profile = $install_state['parameters']['profile']; drupal_static_reset('conf_path'); $conf_path = './' . conf_path(FALSE); $settings_file = $conf_path . '/settings.php'; $database = isset($databases['default']['default']) ? $databases['default']['default'] : array(); drupal_set_title(st('Database configuration')); $drivers = drupal_get_database_types(); $drivers_keys = array_keys($drivers); $form['driver'] = array( '#type' => 'radios', '#title' => st('Database type'), '#required' => TRUE, '#default_value' => !empty($database['driver']) ? $database['driver'] : current($drivers_keys), '#description' => st('The type of database your @drupal data will be stored in.', array('@drupal' => drupal_install_profile_distribution_name())), ); if (count($drivers) == 1) { $form['driver']['#disabled'] = TRUE; $form['driver']['#description'] .= ' ' . st('Your PHP configuration only supports a single database type, so it has been automatically selected.'); } // Add driver specific configuration options. foreach ($drivers as $key => $driver) { $form['driver']['#options'][$key] = $driver->name(); $form['settings'][$key] = $driver->getFormOptions($database); $form['settings'][$key]['#prefix'] = '

' . st('@driver_name settings', array('@driver_name' => $driver->name())) . '

'; $form['settings'][$key]['#type'] = 'container'; $form['settings'][$key]['#tree'] = TRUE; $form['settings'][$key]['advanced_options']['#parents'] = array($key); $form['settings'][$key]['#states'] = array( 'visible' => array( ':input[name=driver]' => array('value' => $key), ) ); } $form['actions'] = array('#type' => 'actions'); $form['actions']['save'] = array( '#type' => 'submit', '#value' => st('Save and continue'), '#limit_validation_errors' => array( array('driver'), array(isset($form_state['input']['driver']) ? $form_state['input']['driver'] : current($drivers_keys)), ), '#submit' => array('install_settings_form_submit'), ); $form['errors'] = array(); $form['settings_file'] = array('#type' => 'value', '#value' => $settings_file); return $form; } /** * Form validation handler for install_settings_form(). * * @see install_settings_form_submit() */ function install_settings_form_validate($form, &$form_state) { $driver = $form_state['values']['driver']; $database = $form_state['values'][$driver]; $database['driver'] = $driver; // TODO: remove when PIFR will be updated to use 'db_prefix' instead of // 'prefix' in the database settings form. $database['prefix'] = $database['db_prefix']; unset($database['db_prefix']); $form_state['storage']['database'] = $database; $errors = install_database_errors($database, $form_state['values']['settings_file']); foreach ($errors as $name => $message) { form_set_error($name, $message); } } /** * Checks a database connection and returns any errors. */ function install_database_errors($database, $settings_file) { global $databases; $errors = array(); // Check database type. $database_types = drupal_get_database_types(); $driver = $database['driver']; if (!isset($database_types[$driver])) { $errors['driver'] = st("In your %settings_file file you have configured @drupal to use a %driver server, however your PHP installation currently does not support this database type.", array('%settings_file' => $settings_file, '@drupal' => drupal_install_profile_distribution_name(), '%driver' => $driver)); } else { // Run driver specific validation $errors += $database_types[$driver]->validateDatabaseSettings($database); // Run tasks associated with the database type. Any errors are caught in the // calling function. $databases['default']['default'] = $database; // Just changing the global doesn't get the new information processed. // We need to close any active connections and tell the Database class to // re-parse $databases. if (Database::isActiveConnection()) { Database::closeConnection(); } Database::parseConnectionInfo(); try { db_run_tasks($driver); } catch (TaskException $e) { // These are generic errors, so we do not have any specific key of the // database connection array to attach them to; therefore, we just put // them in the error array with standard numeric keys. $errors[$driver . '][0'] = $e->getMessage(); } } return $errors; } /** * Form submission handler for install_settings_form(). * * @see install_settings_form_validate() */ function install_settings_form_submit($form, &$form_state) { global $install_state; // Update global settings array and save. $settings['databases'] = array( 'value' => array('default' => array('default' => $form_state['storage']['database'])), 'required' => TRUE, ); $settings['drupal_hash_salt'] = array( 'value' => drupal_hash_base64(drupal_random_bytes(55)), 'required' => TRUE, ); drupal_rewrite_settings($settings); // Add the config directories to settings.php. drupal_install_config_directories(); // Indicate that the settings file has been verified, and check the database // for the last completed task, now that we have a valid connection. This // last step is important since we want to trigger an error if the new // database already has Drupal installed. $install_state['settings_verified'] = TRUE; $install_state['config_verified'] = TRUE; $install_state['database_verified'] = TRUE; $install_state['completed_task'] = install_verify_completed_task(); } /** * Selects which profile to install. * * @param $install_state * An array of information about the current installation state. The chosen * profile will be added here, if it was not already selected previously, as * will a list of all available profiles. * * @return * For interactive installations, a form allowing the profile to be selected, * if the user has a choice that needs to be made. Otherwise, an exception is * thrown if a profile cannot be chosen automatically. */ function install_select_profile(&$install_state) { if (empty($install_state['parameters']['profile'])) { // Try to find a profile. $profile = _install_select_profile($install_state['profiles']); if (empty($profile)) { // We still don't have a profile, so display a form for selecting one. // Only do this in the case of interactive installations, since this is // not a real form with submit handlers (the database isn't even set up // yet), rather just a convenience method for setting parameters in the // URL. if ($install_state['interactive']) { include_once DRUPAL_ROOT . '/core/includes/form.inc'; drupal_set_title(st('Select an installation profile')); $form = drupal_get_form('install_select_profile_form', $install_state); return drupal_render($form); } else { throw new Exception(install_no_profile_error()); } } else { $install_state['parameters']['profile'] = $profile; } } } /** * Selects an installation profile. * * A profile will be selected if: * - Only one profile is available, * - A profile was submitted through $_POST, * - Exactly one of the profiles is marked as "exclusive". * If multiple profiles are marked as "exclusive" then no profile will be * selected. * * @param array $profiles * An associative array of profiles with the machine-readable names as keys. * * @return * The machine-readable name of the selected profile or NULL if no profile was * selected. */ function _install_select_profile($profiles) { // Don't need to choose profile if only one available. if (count($profiles) == 1) { $profile = array_pop($profiles); return $profile->name; } elseif (!empty($_POST['profile']) && isset($profiles[$_POST['profile']])) { return $profiles[$_POST['profile']]->name; } // Check for a profile marked as "exclusive" and ensure that only one // profile is marked as such. $exclusive_profile = NULL; foreach ($profiles as $profile) { $profile_info = install_profile_info($profile->name); if (!empty($profile_info['exclusive'])) { if (empty($exclusive_profile)) { $exclusive_profile = $profile->name; } else { // We found a second "exclusive" profile. There's no way to choose // between them, so we ignore the property. return; } } } return $exclusive_profile; } /** * Form constructor for the profile selection form. * * @param array $install_state * An array of information about the current installation state. * * @ingroup forms */ function install_select_profile_form($form, &$form_state, $install_state) { $profiles = array(); $names = array(); foreach ($install_state['profiles'] as $profile) { $details = install_profile_info($profile->name); // Don't show hidden profiles. This is used by to hide the testing profile, // which only exists to speed up test runs. if ($details['hidden'] === TRUE) { continue; } $profiles[$profile->name] = $details; // Determine the name of the profile; default to file name if defined name // is unspecified. $name = isset($details['name']) ? $details['name'] : $profile->name; $names[$profile->name] = $name; } // Display radio buttons alphabetically by human-readable name, but always // put the core profiles first (if they are present in the filesystem). natcasesort($names); if (isset($names['minimal'])) { // If the expert ("Minimal") core profile is present, put it in front of // any non-core profiles rather than including it with them alphabetically, // since the other profiles might be intended to group together in a // particular way. $names = array('minimal' => $names['minimal']) + $names; } if (isset($names['standard'])) { // If the default ("Standard") core profile is present, put it at the very // top of the list. This profile will have its radio button pre-selected, // so we want it to always appear at the top. $names = array('standard' => $names['standard']) + $names; } foreach ($names as $profile => $name) { // The profile name and description are extracted for translation from the // .info file, so we can use st() on them even though they are dynamic data // at this point. $form['profile'][$name] = array( '#type' => 'radio', '#value' => 'standard', '#return_value' => $profile, '#title' => st($name), '#description' => isset($profiles[$profile]['description']) ? st($profiles[$profile]['description']) : '', '#parents' => array('profile'), ); } $form['actions'] = array('#type' => 'actions'); $form['actions']['submit'] = array( '#type' => 'submit', '#value' => st('Save and continue'), ); return $form; } /** * Finds all .po files that are useful to the installer. * * @return * An associative array of file URIs keyed by language code. URIs as * returned by file_scan_directory(). * * @see file_scan_directory() */ function install_find_translations() { $translations = array(); $files = install_find_translation_files(); // English does not need a translation file. array_unshift($files, (object) array('name' => 'en')); foreach ($files as $uri => $file) { // Strip off the file name component before the language code. $langcode = preg_replace('!^(.+\.)?([^\.]+)$!', '\2', $file->name); // Language codes cannot exceed 12 characters to fit into the {language} // table. if (strlen($langcode) <= 12) { $translations[$langcode] = $uri; } } return $translations; } /** * Finds installer translations either for a specific langcode or all languages. * * @param $langcode * (optional) The language code corresponding to the language for which we * want to find translation files. If omitted, information on all available * files will be returned. * * @return * An associative array of file information objects keyed by file URIs as * returned by file_scan_directory(). * * @see file_scan_directory() */ function install_find_translation_files($langcode = NULL) { $directory = variable_get('locale_translate_file_directory', conf_path() . '/files/translations'); $files = file_scan_directory($directory, '!drupal-\d+\.\d+\.' . (!empty($langcode) ? preg_quote($langcode, '!') : '[^\.]+') . '\.po$!', array('recurse' => FALSE)); return $files; } /** * Selects which language to use during installation. * * @param $install_state * An array of information about the current installation state. The chosen * langcode will be added here, if it was not already selected previously, as * will a list of all available languages. * * @return * For interactive installations, a form or other page output allowing the * language to be selected or providing information about language selection, * if a language has not been chosen. Otherwise, an exception is thrown if a * language cannot be chosen automatically. */ function install_select_language(&$install_state) { include_once DRUPAL_ROOT . '/core/includes/standard.inc'; // Find all available translation files. $files = install_find_translations(); $install_state['translations'] += $files; // If a valid language code is set, continue with the next installation step. // When translations from the localization server are used, any language code // is accepted because the standard language list is kept in sync with the // langauges available at http://localize.drupal.org. // When files from the translation directory are used, we only accept // languages for which a file is available. if (!empty($_POST['langcode'])) { $standard_languages = standard_language_list(); $langcode = $_POST['langcode']; if ($langcode == 'en' || isset($files[$langcode]) || isset($standard_languages[$langcode])) { $install_state['parameters']['langcode'] = $langcode; return; } } if (empty($install_state['parameters']['langcode'])) { // If we are performing an interactive installation, we display a form to // select a right language. If no translation files were found in the // translations directory, the form shows a list of standard languages. If // translation files were found the form shows a select list of the // corresponding languages to choose from. if ($install_state['interactive']) { drupal_set_title(st('Choose language')); include_once DRUPAL_ROOT . '/core/includes/form.inc'; $elements = drupal_get_form('install_select_language_form', count($files) > 1 ? $files : array()); return drupal_render($elements); } // If we are performing a non-interactive installation. If only one language // (English) is available, assume the user knows what he is doing. Otherwise // thow an error. else { if (count($files) == 1) { $install_state['parameters']['langcode'] = array_shift(array_keys($files)); return; } else { throw new Exception(st('Sorry, you must select a language to continue the installation.')); } } } } /** * Form constructor for the language selection form. * * @param array $files * (optional) An associative array of file URIs keyed by language code as * returned by file_scan_directory(). Defaults to all standard languages. * * @see file_scan_directory() * @ingroup forms */ function install_select_language_form($form, &$form_state, $files = array()) { include_once DRUPAL_ROOT . '/core/includes/standard.inc'; include_once DRUPAL_ROOT . '/core/modules/language/language.module'; include_once DRUPAL_ROOT . '/core/modules/language/language.negotiation.inc'; $standard_languages = standard_language_list(); $select_options = array(); $browser_options = array(); // Build a select list with language names in native language for the user // to choose from. And build a list of available languages for the browser // to select the language default from. if (count($files)) { // Select lists based on available language files. foreach ($files as $langcode => $uri) { $select_options[$langcode] = isset($standard_languages[$langcode]) ? $standard_languages[$langcode][1] : $langcode; $browser_options[$langcode] = new Language(array( 'langcode' => $langcode, )); } } else { // Select lists based on all standard languages. foreach ($standard_languages as $langcode => $language_names) { $select_options[$langcode] = $language_names[1]; $browser_options[$langcode] = new Language(array( 'langcode' => $langcode, )); } } $browser_langcode = language_from_browser($browser_options); $form['langcode'] = array( '#type' => 'select', '#options' => $select_options, // Use the browser detected language as default or English if nothing found. '#default_value' => !empty($browser_langcode) ? $browser_langcode : 'en', ); if (empty($files)) { $form['help'] = array( '#markup' => '

Translations will be downloaded from the Drupal Translation website. ' . 'If you do not want this, select English and continue the installation. For more information, see the online handbook.

', ); } $form['actions'] = array('#type' => 'actions'); $form['actions']['submit'] = array( '#type' => 'submit', '#value' => st('Save and continue'), ); return $form; } /** * Download a translation file for the selected langaguage. * * @param array $install_state * An array of information about the current installation state. * * @return string * A themed status report, or an exception if there are requirement errors. * Upon successfull download the page is reloaded and no output is returned. */ function install_download_translation(&$install_state) { // Check whether all conditions are met to download. Download the translation // if possible. $requirements = install_check_translations($install_state); if ($output = install_display_requirements($install_state, $requirements)) { return $output; } // The download was successfull, reload the page in the new lanagage. install_goto(install_redirect_url($install_state)); } /** * Attempts to get a file using drupal_http_request and to store it locally. * * @param string $uri * The URI of the file to grab. * @param string $destination * Stream wrapper URI specifying where the file should be placed. If a * directory path is provided, the file is saved into that directory under its * original name. If the path contains a filename as well, that one will be * used instead. * * @return boolean * TRUE on success, FALSE on failure. */ function install_retrieve_file($uri, $destination) { $parsed_url = parse_url($uri); if (is_dir(drupal_realpath($destination))) { // Prevent URIs with triple slashes when gluing parts together. $path = str_replace('///', '//', "$destination/") . drupal_basename($parsed_url['path']); } else { $path = $destination; } $result = drupal_http_request($uri); if ($result->code != 200) { return FALSE; } if (file_put_contents($path, $result->data) === FALSE) { return FALSE; } return TRUE; } /** * Checks if the localization server can be contacted. * * @param string $uri * The URI to contact. * * @return string * URI of the server if the localization server was contacted successfully. * FALSE if not. */ function install_check_localization_server($uri) { $result = drupal_http_request($uri, array('method' => 'HEAD')); return (!isset($result->error) && $result->code == 200); } /** * Gets the core release version for localization. * * In case core has a development version we fall back to the latest stable * release. e.g. 8.2-dev falls back to 8.1. 8.0-dev falls back to 7.0. Fallback * is required because the localization server only provides translation files * for stable releases. * * @return array * Associative array containing 'core' and 'version' of the release. */ function install_get_localization_release() { if (strpos(VERSION, 'dev')) { list($version, ) = explode('-', VERSION); list($major, $minor) = explode('.', $version); // Calculate the major and minor release numbers to fall back to. // E.g. 8.0-dev falls back to 7.0 and 8.2-dev falls back to 8.1. if ($minor == 0) { $major--; } else { $minor--; } $release = "$major.$minor"; } else { $release = VERSION; } return array( 'core' => "$major.x", 'version' => $release, ); } /** * Indicates that there are no profiles available. */ function install_no_profile_error() { drupal_set_title(st('No profiles available')); return st('We were unable to find any installation profiles. Installation profiles tell us what modules to enable and what schema to install in the database. A profile is necessary to continue with the installation process.'); } /** * Indicates that Drupal has already been installed. */ function install_already_done_error() { global $base_url; drupal_set_title(st('Drupal already installed')); return st('', array('@base-url' => $base_url)); } /** * Loads information about the chosen profile during installation. * * @param $install_state * An array of information about the current installation state. The loaded * profile information will be added here, or an exception will be thrown if * the profile cannot be loaded. */ function install_load_profile(&$install_state) { $profile = $install_state['parameters']['profile']; $profile_file = $install_state['profiles'][$profile]->uri; if (file_exists($profile_file)) { include_once $profile_file; $install_state['profile_info'] = install_profile_info($install_state['parameters']['profile'], $install_state['parameters']['langcode']); } else { throw new Exception(st('Sorry, the profile you have chosen cannot be loaded.')); } } /** * Performs a full bootstrap of Drupal during installation. * * @param $install_state * An array of information about the current installation state. */ function install_bootstrap_full(&$install_state) { // The early stages of the installer override the cache backend since Drupal // isn't fully set up yet. Here the override is removed so that the standard // cache backend will be used again. unset($GLOBALS['conf']['cache_classes']['cache']); drupal_static_reset('cache'); drupal_bootstrap(DRUPAL_BOOTSTRAP_FULL); } /** * Installs required modules via a batch process. * * @param $install_state * An array of information about the current installation state. * * @return * The batch definition. */ function install_profile_modules(&$install_state) { $modules = state()->get('install_profile_modules') ?: array(); $files = system_rebuild_module_data(); state()->delete('install_profile_modules'); // Always install required modules first. Respect the dependencies between // the modules. $required = array(); $non_required = array(); // Although the profile module is marked as required, it needs to go after // every dependency, including non-required ones. So clear its required // flag for now to allow it to install late. $files[$install_state['parameters']['profile']]->info['required'] = FALSE; // Add modules that other modules depend on. foreach ($modules as $module) { if ($files[$module]->requires) { $modules = array_merge($modules, array_keys($files[$module]->requires)); } } $modules = array_unique($modules); foreach ($modules as $module) { if (!empty($files[$module]->info['required'])) { $required[$module] = $files[$module]->sort; } else { $non_required[$module] = $files[$module]->sort; } } arsort($required); arsort($non_required); $operations = array(); foreach ($required + $non_required as $module => $weight) { $operations[] = array('_install_module_batch', array($module, $files[$module]->info['name'])); } $batch = array( 'operations' => $operations, 'title' => st('Installing @drupal', array('@drupal' => drupal_install_profile_distribution_name())), 'error_message' => st('The installation has encountered an error.'), 'finished' => '_install_profile_modules_finished', ); return $batch; } /** * Imports languages via a batch process during installation. * * @param $install_state * An array of information about the current installation state. * * @return * The batch definition, if there are language files to import. */ function install_import_translations(&$install_state) { include_once DRUPAL_ROOT . '/core/modules/locale/locale.bulk.inc'; include_once DRUPAL_ROOT . '/core/includes/standard.inc'; $langcode = $install_state['parameters']['langcode']; $standard_languages = standard_language_list(); if (!isset($standard_languages[$langcode])) { // Drupal does not know about this language, so we prefill its values with // our best guess. The user will be able to edit afterwards. $language = new Language(array( 'langcode' => $langcode, 'name' => $langcode, 'default' => TRUE, )); language_save($language); } else { // A known predefined language, details will be filled in properly. $language = new Language(array( 'langcode' => $langcode, 'default' => TRUE, )); language_save($language); } // If a non-English language was selected, remove English and import the // translations. if ($langcode != 'en') { language_delete('en'); // Set up a batch to import translations for the newly added language. _install_prepare_import(); module_load_include('fetch.inc', 'locale'); if ($batch = locale_translation_batch_fetch_build(array(), array($langcode))) { return $batch; } } } /** * Tells the translation import process that Drupal core is installed. */ function _install_prepare_import() { global $install_state; $release = install_get_localization_release(); db_insert('locale_project') ->fields(array( 'name' => 'drupal', 'project_type' => 'module', 'core' => $release['core'], 'version' => $release['version'], 'server_pattern' => $install_state['server_pattern'], 'status' => 1, )) ->execute(); module_load_include('compare.inc', 'locale'); locale_translation_check_projects_local(array('drupal'), array($install_state['parameters']['langcode'])); } /** * Form constructor for a form to configure the new site. * * @param $install_state * An array of information about the current installation state. * * @see install_configure_form_validate() * @see install_configure_form_submit() * @ingroup forms */ function install_configure_form($form, &$form_state, &$install_state) { drupal_set_title(st('Configure site')); // Warn about settings.php permissions risk $settings_dir = conf_path(); $settings_file = $settings_dir . '/settings.php'; // Check that $_POST is empty so we only show this message when the form is // first displayed, not on the next page after it is submitted. (We do not // want to repeat it multiple times because it is a general warning that is // not related to the rest of the installation process; it would also be // especially out of place on the last page of the installer, where it would // distract from the message that the Drupal installation has completed // successfully.) if (empty($_POST) && (!drupal_verify_install_file(DRUPAL_ROOT . '/' . $settings_file, FILE_EXIST|FILE_READABLE|FILE_NOT_WRITABLE) || !drupal_verify_install_file(DRUPAL_ROOT . '/' . $settings_dir, FILE_NOT_WRITABLE, 'dir'))) { drupal_set_message(st('All necessary changes to %dir and %file have been made, so you should remove write permissions to them now in order to avoid security risks. If you are unsure how to do so, consult the online handbook.', array('%dir' => $settings_dir, '%file' => $settings_file, '@handbook_url' => 'http://drupal.org/server-permissions')), 'warning'); } drupal_add_library('system', 'drupal.system'); // Add JavaScript time zone detection. drupal_add_library('system', 'drupal.timezone'); // We add these strings as settings because JavaScript translation does not // work during installation. drupal_add_js(array('copyFieldValue' => array('edit-site-mail' => array('edit-account-mail'))), 'setting'); // Cache a fully-built schema. This is necessary for any invocation of // index.php because: (1) setting cache table entries requires schema // information, (2) that occurs during bootstrap before any module are // loaded, so (3) if there is no cached schema, drupal_get_schema() will // try to generate one but with no loaded modules will return nothing. // // @todo Move this to the 'install_finished' task? drupal_get_schema(NULL, TRUE); // Return the form. return _install_configure_form($form, $form_state, $install_state); } /** * Finishes importing files at end of installation. * * If other projects besides Drupal core have been installed, their translation * will be imported here. * * @param $install_state * An array of information about the current installation state. * * @return * The batch definition, if there are language files to import. */ function install_import_translations_remaining(&$install_state) { module_load_include('fetch.inc', 'locale'); module_load_include('compare.inc', 'locale'); // Build a fresh list of installed projects. When more projects than core are // installed, their translations will be downloaded (if required) and imported // using a batch. $projects = locale_translation_build_projects(); if (count($projects) > 1) { $options = _locale_translation_default_update_options(); if ($batch = locale_translation_batch_update_build(array(), array($install_state['parameters']['langcode']), $options)) { return $batch; } } } /** * Performs final installation steps and displays a 'finished' page. * * @param $install_state * An array of information about the current installation state. * * @return * A message informing the user that the installation is complete. */ function install_finished(&$install_state) { $profile = drupal_get_profile(); // Remember the profile which was used. variable_set('install_profile', $profile); // Installation profiles are always loaded last. module_set_weight($profile, 1000); // Flush all caches to ensure that any full bootstraps during the installer // do not leave stale cached data, and that any content types or other items // registered by the installation profile are registered correctly. drupal_flush_all_caches(); drupal_set_title(st('@drupal installation complete', array('@drupal' => drupal_install_profile_distribution_name())), PASS_THROUGH); $messages = drupal_set_message(); $output = '

' . st('Congratulations, you installed @drupal!', array('@drupal' => drupal_install_profile_distribution_name())) . '

'; $output .= '

' . (isset($messages['error']) ? st('Review the messages above before visiting your new site.', array('@url' => url(''))) : st('Visit your new site.', array('@url' => url('')))) . '

'; // Run cron to populate update status tables (if available) so that users // will be warned if they've installed an out of date Drupal version. // Will also trigger indexing of profile-supplied content or feeds. drupal_cron_run(); return $output; } /** * Batch callback for batch installation of modules. */ function _install_module_batch($module, $module_name, &$context) { // Install and enable the module right away, so that the module will be // loaded by drupal_bootstrap in subsequent batch requests, and other // modules possibly depending on it can safely perform their installation // steps. module_enable(array($module), FALSE); $context['results'][] = $module; $context['message'] = st('Installed %module module.', array('%module' => $module_name)); } /** * 'Finished' callback for module installation batch. */ function _install_profile_modules_finished($success, $results, $operations) { // Flush all caches to complete the module installation process. Subsequent // installation tasks will now have full access to the profile's modules. drupal_flush_all_caches(); } /** * Checks installation requirements and reports any errors. */ function install_check_translations($install_state) { include_once DRUPAL_ROOT . '/core/includes/standard.inc'; $requirements = array(); $readable = FALSE; $writable = FALSE; $executable = FALSE; $files_directory = variable_get('file_public_path', conf_path() . '/files'); $translations_directory = variable_get('locale_translate_file_directory', conf_path() . '/files/translations'); $translations_directory_exists = FALSE; $online = FALSE; $server_available = FALSE; $translation_available = FALSE; // First attempt to create or make writable the files directory. file_prepare_directory($files_directory, FILE_CREATE_DIRECTORY | FILE_MODIFY_PERMISSIONS); // Then, attempt to create or make writable the translations directory. file_prepare_directory($translations_directory, FILE_CREATE_DIRECTORY | FILE_MODIFY_PERMISSIONS); // Get values so the requirements errors can be specific. if (drupal_verify_install_file($translations_directory, FILE_EXIST|FILE_WRITABLE, 'dir')) { $readable = is_readable($translations_directory); $writable = is_writable($translations_directory); $executable = is_executable($translations_directory); $translations_directory_exists = TRUE; } // Build URLs for the translation file and the translation server. $release = install_get_localization_release(); $langcode = $install_state['parameters']['langcode']; $variables = array( '%project' => 'drupal', '%version' => $release['version'], '%core' => $release['core'], '%language' => $langcode, ); $translation_url = strtr($install_state['server_pattern'], $variables); $elements = parse_url($translation_url); $server_url = $elements['scheme'] . '://' . $elements['host']; // Build the language name for display. $languages = standard_language_list(); $language = isset($languages[$langcode]) ? $languages[$langcode][0] : $langcode; // Check if the desirered translation file is available and if the translation // server can be reached, or in other words if we have an internet connection. if ($translation_available = install_check_localization_server($translation_url)) { $online = TRUE; $server_available = TRUE; } else { if ($server_available = install_check_localization_server($server_url)) { $online = TRUE; } } // If the translations directory does not exists, throw an error. if (!$translations_directory_exists) { $requirements['translations directory exists'] = array( 'title' => st('Translations directory'), 'value' => st('The translations directory does not exist.'), 'severity' => REQUIREMENT_ERROR, 'description' => st('The installer requires that you create a translations directory as part of the installation process. Create the directory %translations_directory . More details about installing Drupal are available in INSTALL.txt.', array('%translations_directory' => $translations_directory, '@install_txt' => base_path() . 'core/INSTALL.txt')), ); } else { $requirements['translations directory exists'] = array( 'title' => st('Translations directory'), 'value' => st('The diretory %translations_directory exists.', array('%translations_directory' => $translations_directory)), ); // If the translations directory is not readable, throw an error. if (!$readable) { $requirements['translations directory readable'] = array( 'title' => st('Translations directory'), 'value' => st('The translations directory is not readable.'), 'severity' => REQUIREMENT_ERROR, 'description' => st('The installer requires read permissions to %translations_directory at all times. If you are unsure how to grant file permissions, consult the online handbook.', array('%translations_directory' => $translations_directory, '@handbook_url' => 'http://drupal.org/server-permissions')), ); } // If translations directory is not writable, throw an error. if (!$writable) { $requirements['translations directory writable'] = array( 'title' => st('Translations directory'), 'value' => st('The translations directory is not writable.'), 'severity' => REQUIREMENT_ERROR, 'description' => st('The installer requires write permissions to %translations_directory during the installation process. If you are unsure how to grant file permissions, consult the online handbook.', array('%translations_directory' => $translations_directory, '@handbook_url' => 'http://drupal.org/server-permissions')), ); } else { $requirements['translations directory writable'] = array( 'title' => st('Translations directory'), 'value' => st('The translations directory is writable.'), ); } // If translations directory is not executable, throw an error. if (!$executable) { $requirements['translations directory executable'] = array( 'title' => st('Translations directory'), 'value' => st('The translations directory is not executable.'), 'severity' => REQUIREMENT_ERROR, 'description' => st('The installer requires execute permissions to %translations_directory during the installation process. If you are unsure how to grant file permissions, consult the online handbook.', array('%translations_directory' => $translations_directory, '@handbook_url' => 'http://drupal.org/server-permissions')), ); } } // If the translations server can not be contacted, throw an error. if (!$online) { $requirements['online'] = array( 'title' => st('Internet'), 'value' => st('The translation server is offline.'), 'severity' => REQUIREMENT_ERROR, 'description' => st('The installer requires to contact the translation server to download a translation file. Check your internet connection and verify that your website can reach the translation server at !server_url.', array('!server_url' => $server_url)), ); } else { $requirements['online'] = array( 'title' => st('Internet'), 'value' => st('The translation server is online.'), ); // If translation file is not found at the translation server, throw an // error. if (!$translation_available) { $requirements['translation available'] = array( 'title' => st('Translation'), 'value' => st('The %language translation is not available.', array('%language' => $language)), 'severity' => REQUIREMENT_ERROR, 'description' => st('The %language translation file is not available at the translation server. Choose a different language or select English and translate your website later.', array('%language' => $language, '!url' => check_url($_SERVER['SCRIPT_NAME']))), ); } else { $requirements['translation available'] = array( 'title' => st('Translation'), 'value' => st('The %language translation is available.', array('%language' => $language)), ); } } if ($translations_directory_exists && $readable && $writable && $executable && $translation_available) { $translation_downloaded = install_retrieve_file($translation_url, $translations_directory); if (!$translation_downloaded) { $requirements['translation downloaded'] = array( 'title' => st('Translation'), 'value' => st('The %language translation could not be downloaded.', array('%language' => $language)), 'severity' => REQUIREMENT_ERROR, 'description' => st('The %language translation file could not be downloaded. Choose a different language or select English and translate your website later.', array('%language' => $language, '!url' => check_url($_SERVER['SCRIPT_NAME']))), ); } } return $requirements; } /** * Checks installation requirements and reports any errors. */ function install_check_requirements($install_state) { $profile = $install_state['parameters']['profile']; // Check the profile requirements. $requirements = drupal_check_profile($profile, $install_state); // If Drupal is not set up already, we need to create a settings file. if (!$install_state['settings_verified']) { $readable = FALSE; $writable = FALSE; $conf_path = './' . conf_path(FALSE, TRUE); $settings_file = $conf_path . '/settings.php'; $default_settings_file = './sites/default/default.settings.php'; $file = $conf_path; $exists = FALSE; // Verify that the directory exists. if (drupal_verify_install_file($conf_path, FILE_EXIST, 'dir')) { // Check if a settings.php file already exists. $file = $settings_file; if (drupal_verify_install_file($settings_file, FILE_EXIST)) { // If it does, make sure it is writable. $readable = drupal_verify_install_file($settings_file, FILE_READABLE); $writable = drupal_verify_install_file($settings_file, FILE_WRITABLE); $exists = TRUE; } } // If default.settings.php does not exist, or is not readable, throw an // error. if (!drupal_verify_install_file($default_settings_file, FILE_EXIST|FILE_READABLE)) { $requirements['default settings file exists'] = array( 'title' => st('Default settings file'), 'value' => st('The default settings file does not exist.'), 'severity' => REQUIREMENT_ERROR, 'description' => st('The @drupal installer requires that the %default-file file not be modified in any way from the original download.', array('@drupal' => drupal_install_profile_distribution_name(), '%default-file' => $default_settings_file)), ); } // Otherwise, if settings.php does not exist yet, we can try to copy // default.settings.php to create it. elseif (!$exists) { $copied = drupal_verify_install_file($conf_path, FILE_EXIST|FILE_WRITABLE, 'dir') && @copy($default_settings_file, $settings_file); if ($copied) { // If the new settings file has the same owner as default.settings.php, // this means default.settings.php is owned by the webserver user. // This is an inherent security weakness because it allows a malicious // webserver process to append arbitrary PHP code and then execute it. // However, it is also a common configuration on shared hosting, and // there is nothing Drupal can do to prevent it. In this situation, // having settings.php also owned by the webserver does not introduce // any additional security risk, so we keep the file in place. if (fileowner($default_settings_file) === fileowner($settings_file)) { $readable = drupal_verify_install_file($settings_file, FILE_READABLE); $writable = drupal_verify_install_file($settings_file, FILE_WRITABLE); $exists = TRUE; } // If settings.php and default.settings.php have different owners, this // probably means the server is set up "securely" (with the webserver // running as its own user, distinct from the user who owns all the // Drupal PHP files), although with either a group or world writable // sites directory. Keeping settings.php owned by the webserver would // therefore introduce a security risk. It would also cause a usability // problem, since site owners who do not have root access to the file // system would be unable to edit their settings file later on. We // therefore must delete the file we just created and force the // administrator to log on to the server and create it manually. else { $deleted = @drupal_unlink($settings_file); // We expect deleting the file to be successful (since we just // created it ourselves above), but if it fails somehow, we set a // variable so we can display a one-time error message to the // administrator at the bottom of the requirements list. We also try // to make the file writable, to eliminate any conflicting error // messages in the requirements list. $exists = !$deleted; if ($exists) { $settings_file_ownership_error = TRUE; $readable = drupal_verify_install_file($settings_file, FILE_READABLE); $writable = drupal_verify_install_file($settings_file, FILE_WRITABLE); } } } } // If settings.php does not exist, throw an error. if (!$exists) { $requirements['settings file exists'] = array( 'title' => st('Settings file'), 'value' => st('The settings file does not exist.'), 'severity' => REQUIREMENT_ERROR, 'description' => st('The @drupal installer requires that you create a settings file as part of the installation process. Copy the %default_file file to %file. More details about installing Drupal are available in INSTALL.txt.', array('@drupal' => drupal_install_profile_distribution_name(), '%file' => $file, '%default_file' => $default_settings_file, '@install_txt' => base_path() . 'core/INSTALL.txt')), ); } else { $requirements['settings file exists'] = array( 'title' => st('Settings file'), 'value' => st('The %file file exists.', array('%file' => $file)), ); // If settings.php is not readable, throw an error. if (!$readable) { $requirements['settings file readable'] = array( 'title' => st('Settings file'), 'value' => st('The settings file is not readable.'), 'severity' => REQUIREMENT_ERROR, 'description' => st('@drupal requires read permissions to %file at all times. If you are unsure how to grant file permissions, consult the online handbook.', array('@drupal' => drupal_install_profile_distribution_name(), '%file' => $file, '@handbook_url' => 'http://drupal.org/server-permissions')), ); } // If settings.php is not writable, throw an error. if (!$writable) { $requirements['settings file writable'] = array( 'title' => st('Settings file'), 'value' => st('The settings file is not writable.'), 'severity' => REQUIREMENT_ERROR, 'description' => st('The @drupal installer requires write permissions to %file during the installation process. If you are unsure how to grant file permissions, consult the online handbook.', array('@drupal' => drupal_install_profile_distribution_name(), '%file' => $file, '@handbook_url' => 'http://drupal.org/server-permissions')), ); } else { $requirements['settings file'] = array( 'title' => st('Settings file'), 'value' => st('The settings file is writable.'), ); } if (!empty($settings_file_ownership_error)) { $requirements['settings file ownership'] = array( 'title' => st('Settings file'), 'value' => st('The settings file is owned by the web server.'), 'severity' => REQUIREMENT_ERROR, 'description' => st('The @drupal installer failed to create a settings file with proper file ownership. Log on to your web server, remove the existing %file file, and create a new one by copying the %default_file file to %file. More details about installing Drupal are available in INSTALL.txt. If you have problems with the file permissions on your server, consult the online handbook.', array('@drupal' => drupal_install_profile_distribution_name(), '%file' => $file, '%default_file' => $default_settings_file, '@install_txt' => base_path() . 'core/INSTALL.txt', '@handbook_url' => 'http://drupal.org/server-permissions')), ); } } } return $requirements; } /** * Displays installation requirements. * * @param array $install_state * An array of information about the current installation state. * @param array $requirements * An array of requirements, in the same format as is returned by * hook_requirements(). * * @return * A themed status report, or an exception if there are requirement errors. * If there are only requirement warnings, a themed status report is shown * initially, but the user is allowed to bypass it by providing 'continue=1' * in the URL. Otherwise, no output is returned, so that the next task can be * run in the same page request. * * @thows \Exception */ function install_display_requirements($install_state, $requirements) { // Check the severity of the requirements reported. $severity = drupal_requirements_severity($requirements); // If there are errors, always display them. If there are only warnings, skip // them if the user has provided a URL parameter acknowledging the warnings // and indicating a desire to continue anyway. See drupal_requirements_url(). if ($severity == REQUIREMENT_ERROR || ($severity == REQUIREMENT_WARNING && empty($install_state['parameters']['continue']))) { if ($install_state['interactive']) { drupal_set_title(st('Requirements problem')); $status_report = theme('status_report', array('requirements' => $requirements)); $status_report .= st('Check the messages and try again.', array('!url' => check_url(drupal_requirements_url($severity)))); return $status_report; } else { // Throw an exception showing any unmet requirements. $failures = array(); foreach ($requirements as $requirement) { // Skip warnings altogether for non-interactive installations; these // proceed in a single request so there is no good opportunity (and no // good method) to warn the user anyway. if (isset($requirement['severity']) && $requirement['severity'] == REQUIREMENT_ERROR) { $failures[] = $requirement['title'] . ': ' . $requirement['value'] . "\n\n" . $requirement['description']; } } if (!empty($failures)) { throw new \Exception(implode("\n\n", $failures)); } } } } /** * Form constructor for a site configuration form. * * @param $install_state * An array of information about the current installation state. * * @see install_configure_form() * @see install_configure_form_validate() * @see install_configure_form_submit() * @ingroup forms */ function _install_configure_form($form, &$form_state, &$install_state) { $form['site_information'] = array( '#type' => 'details', '#title' => st('Site information'), '#collapsible' => FALSE, ); $form['site_information']['site_name'] = array( '#type' => 'textfield', '#title' => st('Site name'), '#required' => TRUE, '#weight' => -20, ); $form['site_information']['site_mail'] = array( '#type' => 'email', '#title' => st('Site e-mail address'), '#default_value' => ini_get('sendmail_from'), '#description' => st("Automated e-mails, such as registration information, will be sent from this address. Use an address ending in your site's domain to help prevent these e-mails from being flagged as spam."), '#required' => TRUE, '#weight' => -15, ); $form['admin_account'] = array( '#type' => 'details', '#title' => st('Site maintenance account'), '#collapsible' => FALSE, ); $form['admin_account']['account']['#tree'] = TRUE; $form['admin_account']['account']['name'] = array('#type' => 'textfield', '#title' => st('Username'), '#maxlength' => USERNAME_MAX_LENGTH, '#description' => st('Spaces are allowed; punctuation is not allowed except for periods, hyphens, and underscores.'), '#required' => TRUE, '#weight' => -10, '#attributes' => array('class' => array('username')), ); $form['admin_account']['account']['mail'] = array( '#type' => 'email', '#title' => st('E-mail address'), '#required' => TRUE, '#weight' => -5, ); $form['admin_account']['account']['pass'] = array( '#type' => 'password_confirm', '#required' => TRUE, '#size' => 25, '#weight' => 0, ); $form['server_settings'] = array( '#type' => 'details', '#title' => st('Server settings'), '#collapsible' => FALSE, ); $countries = country_get_list(); $form['server_settings']['site_default_country'] = array( '#type' => 'select', '#title' => st('Default country'), '#empty_value' => '', '#default_value' => config('system.date')->get('country.default'), '#options' => $countries, '#description' => st('Select the default country for the site.'), '#weight' => 0, ); $form['server_settings']['date_default_timezone'] = array( '#type' => 'select', '#title' => st('Default time zone'), '#default_value' => date_default_timezone_get(), '#options' => system_time_zones(), '#description' => st('By default, dates in this site will be displayed in the chosen time zone.'), '#weight' => 5, '#attributes' => array('class' => array('timezone-detect')), ); $form['update_notifications'] = array( '#type' => 'details', '#title' => st('Update notifications'), '#collapsible' => FALSE, ); $form['update_notifications']['update_status_module'] = array( '#type' => 'checkboxes', '#options' => array( 1 => st('Check for updates automatically'), 2 => st('Receive e-mail notifications'), ), '#default_value' => array(1, 2), '#description' => st('The system will notify you when updates and important security releases are available for installed components. Anonymous information about your site is sent to Drupal.org.', array('@drupal' => 'http://drupal.org')), '#weight' => 15, ); $form['update_notifications']['update_status_module'][2] = array( '#states' => array( 'visible' => array( 'input[name="update_status_module[1]"]' => array('checked' => TRUE), ), ), ); $form['actions'] = array('#type' => 'actions'); $form['actions']['submit'] = array( '#type' => 'submit', '#value' => st('Save and continue'), '#weight' => 15, ); return $form; } /** * Form validation handler for install_configure_form(). * * @see install_configure_form_submit() */ function install_configure_form_validate($form, &$form_state) { if ($error = user_validate_name($form_state['values']['account']['name'])) { form_error($form['admin_account']['account']['name'], $error); } } /** * Form submission handler for install_configure_form(). * * @see install_configure_form_validate() */ function install_configure_form_submit($form, &$form_state) { global $user; config('system.site') ->set('name', $form_state['values']['site_name']) ->set('mail', $form_state['values']['site_mail']) ->save(); config('system.timezone') ->set('default', $form_state['values']['date_default_timezone']) ->save(); config('system.date') ->set('country.default', $form_state['values']['site_default_country']) ->save(); // Enable update.module if this option was selected. if ($form_state['values']['update_status_module'][1]) { module_enable(array('file', 'update'), FALSE); // Add the site maintenance account's email address to the list of // addresses to be notified when updates are available, if selected. if ($form_state['values']['update_status_module'][2]) { config('update.settings')->set('notification.emails', array($form_state['values']['account']['mail']))->save(); } } // We precreated user 1 with placeholder values. Let's save the real values. $account = user_load(1); $account->init = $account->mail = $form_state['values']['account']['mail']; $account->roles = !empty($account->roles) ? $account->roles : array(); $account->status = 1; $account->timezone = $form_state['values']['date_default_timezone']; $account->pass = $form_state['values']['account']['pass']; $account->name = $form_state['values']['account']['name']; $account->save(); // Load global $user and perform final login tasks. $user = user_load(1); user_login_finalize(); // Record when this install ran. variable_set('install_time', $_SERVER['REQUEST_TIME']); }