+++ /dev/null
-<?php
-
-namespace Drush\Boot;
-
-use Drush\Log\LogLevel;
-
-abstract class DrupalBoot extends BaseBoot {
-
- function __construct() {
- }
-
- function valid_root($path) {
- }
-
- function get_version($drupal_root) {
- }
-
- function get_profile() {
- }
-
- function conf_path($require_settings = TRUE, $reset = FALSE) {
- return conf_path($require_settings = TRUE, $reset = FALSE);
- }
-
- /**
- * Bootstrap phases used with Drupal:
- *
- * DRUSH_BOOTSTRAP_DRUSH = Only Drush.
- * DRUSH_BOOTSTRAP_DRUPAL_ROOT = Find a valid Drupal root.
- * DRUSH_BOOTSTRAP_DRUPAL_SITE = Find a valid Drupal site.
- * DRUSH_BOOTSTRAP_DRUPAL_CONFIGURATION = Load the site's settings.
- * DRUSH_BOOTSTRAP_DRUPAL_DATABASE = Initialize the database.
- * DRUSH_BOOTSTRAP_DRUPAL_FULL = Initialize Drupal fully.
- * DRUSH_BOOTSTRAP_DRUPAL_LOGIN = Log into Drupal with a valid user.
- *
- * The value is the name of the method of the Boot class to
- * execute when bootstrapping. Prior to bootstrapping, a "validate"
- * method is called, if defined. The validate method name is the
- * bootstrap method name with "_validate" appended.
- */
- function bootstrap_phases() {
- return array(
- DRUSH_BOOTSTRAP_DRUSH => 'bootstrap_drush',
- DRUSH_BOOTSTRAP_DRUPAL_ROOT => 'bootstrap_drupal_root',
- DRUSH_BOOTSTRAP_DRUPAL_SITE => 'bootstrap_drupal_site',
- DRUSH_BOOTSTRAP_DRUPAL_CONFIGURATION => 'bootstrap_drupal_configuration',
- DRUSH_BOOTSTRAP_DRUPAL_DATABASE => 'bootstrap_drupal_database',
- DRUSH_BOOTSTRAP_DRUPAL_FULL => 'bootstrap_drupal_full',
- DRUSH_BOOTSTRAP_DRUPAL_LOGIN => 'bootstrap_drupal_login');
- }
-
- /**
- * List of bootstrap phases where Drush should stop and look for commandfiles.
- *
- * For Drupal, we try at these bootstrap phases:
- *
- * - Drush preflight: to find commandfiles in any system location,
- * out of a Drupal installation.
- * - Drupal root: to find commandfiles based on Drupal core version.
- * - Drupal full: to find commandfiles defined within a Drupal directory.
- *
- * Once a command is found, Drush will ensure a bootstrap to the phase
- * declared by the command.
- *
- * @return array of PHASE indexes.
- */
- function bootstrap_init_phases() {
- return array(DRUSH_BOOTSTRAP_DRUSH, DRUSH_BOOTSTRAP_DRUPAL_ROOT, DRUSH_BOOTSTRAP_DRUPAL_FULL);
- }
-
- function enforce_requirement(&$command) {
- parent::enforce_requirement($command);
- $this->drush_enforce_requirement_drupal_dependencies($command);
- }
-
- function report_command_error($command) {
- // If we reach this point, command doesn't fit requirements or we have not
- // found either a valid or matching command.
-
- // If no command was found check if it belongs to a disabled module.
- if (!$command) {
- $command = $this->drush_command_belongs_to_disabled_module();
- }
- parent::report_command_error($command);
- }
-
- function command_defaults() {
- return array(
- 'drupal dependencies' => array(),
- 'bootstrap' => DRUSH_BOOTSTRAP_DRUPAL_LOGIN,
- );
- }
-
- /**
- * @return array of strings - paths to directories where contrib
- * modules can be found
- */
- abstract function contrib_modules_paths();
-
- /**
- * @return array of strings - paths to directories where contrib
- * themes can be found
- */
- abstract function contrib_themes_paths();
-
- function commandfile_searchpaths($phase, $phase_max = FALSE) {
- if (!$phase_max) {
- $phase_max = $phase;
- }
-
- $searchpath = array();
- switch ($phase) {
- case DRUSH_BOOTSTRAP_DRUPAL_ROOT:
- $drupal_root = drush_get_context('DRUSH_SELECTED_DRUPAL_ROOT');
- $searchpath[] = $drupal_root . '/../drush';
- $searchpath[] = $drupal_root . '/drush';
- $searchpath[] = $drupal_root . '/sites/all/drush';
- break;
- case DRUSH_BOOTSTRAP_DRUPAL_SITE:
- // If we are going to stop bootstrapping at the site, then
- // we will quickly add all commandfiles that we can find for
- // any extension associated with the site, whether it is enabled
- // or not. If we are, however, going to continue on to bootstrap
- // all the way to DRUSH_BOOTSTRAP_DRUPAL_FULL, then we will
- // instead wait for that phase, which will more carefully add
- // only those Drush commandfiles that are associated with
- // enabled modules.
- if ($phase_max < DRUSH_BOOTSTRAP_DRUPAL_FULL) {
- $searchpath = array_merge($searchpath, $this->contrib_modules_paths());
-
- // Adding commandfiles located within /profiles. Try to limit to one profile for speed. Note
- // that Drupal allows enabling modules from a non-active profile so this logic is kinda dodgy.
- $cid = drush_cid_install_profile();
- if ($cached = drush_cache_get($cid)) {
- $profile = $cached->data;
- $searchpath[] = "profiles/$profile/modules";
- $searchpath[] = "profiles/$profile/themes";
- }
- else {
- // If install_profile is not available, scan all profiles.
- $searchpath[] = "profiles";
- $searchpath[] = "sites/all/profiles";
- }
-
- $searchpath = array_merge($searchpath, $this->contrib_themes_paths());
- }
- break;
- case DRUSH_BOOTSTRAP_DRUPAL_CONFIGURATION:
- // Nothing to do here anymore. Left for documentation.
- break;
- case DRUSH_BOOTSTRAP_DRUPAL_FULL:
- // Add enabled module paths, excluding the install profile. Since we are bootstrapped,
- // we can use the Drupal API.
- $ignored_modules = drush_get_option_list('ignored-modules', array());
- $cid = drush_cid_install_profile();
- if ($cached = drush_cache_get($cid)) {
- $ignored_modules[] = $cached->data;
- }
- foreach (array_diff(drush_module_list(), $ignored_modules) as $module) {
- $filepath = drupal_get_path('module', $module);
- if ($filepath && $filepath != '/') {
- $searchpath[] = $filepath;
- }
- }
-
- // Check all enabled themes including non-default and non-admin.
- foreach (drush_theme_list() as $key => $value) {
- $searchpath[] = drupal_get_path('theme', $key);
- }
- break;
- }
-
- return $searchpath;
- }
-
- /**
- * Check if the given command belongs to a disabled module.
- *
- * @return array
- * Array with a command-like bootstrap error or FALSE if Drupal was not
- * bootstrapped fully or the command does not belong to a disabled module.
- */
- function drush_command_belongs_to_disabled_module() {
- if (drush_has_boostrapped(DRUSH_BOOTSTRAP_DRUPAL_FULL)) {
- _drush_find_commandfiles(DRUSH_BOOTSTRAP_DRUPAL_SITE, DRUSH_BOOTSTRAP_DRUPAL_CONFIGURATION);
- drush_get_commands(TRUE);
- $commands = drush_get_commands();
- $arguments = drush_get_arguments();
- $command_name = array_shift($arguments);
- if (isset($commands[$command_name])) {
- // We found it. Load its module name and set an error.
- if (is_array($commands[$command_name]['drupal dependencies']) && count($commands[$command_name]['drupal dependencies'])) {
- $modules = implode(', ', $commands[$command_name]['drupal dependencies']);
- }
- else {
- // The command does not define Drupal dependencies. Derive them.
- $command_files = commandfiles_cache()->get();
- $command_path = $commands[$command_name]['path'] . DIRECTORY_SEPARATOR . $commands[$command_name]['commandfile'] . '.drush.inc';
- $modules = array_search($command_path, $command_files);
- }
- return array(
- 'bootstrap_errors' => array(
- 'DRUSH_COMMAND_DEPENDENCY_ERROR' => dt('Command !command needs the following extension(s) enabled to run: !dependencies.', array(
- '!command' => $command_name,
- '!dependencies' => $modules,
- )),
- ),
- );
- }
- }
-
- return FALSE;
- }
-
- /**
- * Check that a command has its declared dependencies available or have no
- * dependencies.
- *
- * @param $command
- * Command to check. Any errors will be added to the 'bootstrap_errors' element.
- *
- * @return
- * TRUE if command is valid.
- */
- function drush_enforce_requirement_drupal_dependencies(&$command) {
- // If the command bootstrap is DRUSH_BOOTSTRAP_MAX, then we will
- // allow the requirements to pass if we have not successfully
- // bootstrapped Drupal. The combination of DRUSH_BOOTSTRAP_MAX
- // and 'drupal dependencies' indicates that the drush command
- // will use the dependent modules only if they are available.
- if ($command['bootstrap'] == DRUSH_BOOTSTRAP_MAX) {
- // If we have not bootstrapped, then let the dependencies pass;
- // if we have bootstrapped, then enforce them.
- if (drush_get_context('DRUSH_BOOTSTRAP_PHASE') < DRUSH_BOOTSTRAP_DRUPAL_FULL) {
- return TRUE;
- }
- }
- // If there are no drupal dependencies, then do nothing
- if (!empty($command['drupal dependencies'])) {
- foreach ($command['drupal dependencies'] as $dependency) {
- drush_include_engine('drupal', 'environment');
- if(!drush_module_exists($dependency)) {
- $command['bootstrap_errors']['DRUSH_COMMAND_DEPENDENCY_ERROR'] = dt('Command !command needs the following modules installed/enabled to run: !dependencies.', array('!command' => $command['command'], '!dependencies' => implode(', ', $command['drupal dependencies'])));
- return FALSE;
- }
- }
- }
- return TRUE;
- }
-
- /**
- * Validate the DRUSH_BOOTSTRAP_DRUPAL_ROOT phase.
- *
- * In this function, we will check if a valid Drupal directory is available.
- * We also determine the value that will be stored in the DRUSH_DRUPAL_ROOT
- * context and DRUPAL_ROOT constant if it is considered a valid option.
- */
- function bootstrap_drupal_root_validate() {
- $drupal_root = drush_get_context('DRUSH_SELECTED_DRUPAL_ROOT');
-
- if (empty($drupal_root)) {
- return drush_bootstrap_error('DRUSH_NO_DRUPAL_ROOT', dt("A Drupal installation directory could not be found"));
- }
- if (!$signature = drush_valid_root($drupal_root)) {
- return drush_bootstrap_error('DRUSH_INVALID_DRUPAL_ROOT', dt("The directory !drupal_root does not contain a valid Drupal installation", array('!drupal_root' => $drupal_root)));
- }
-
- $version = drush_drupal_version($drupal_root);
- $major_version = drush_drupal_major_version($drupal_root);
- if ($major_version <= 5) {
- return drush_set_error('DRUSH_DRUPAL_VERSION_UNSUPPORTED', dt('Drush !drush_version does not support Drupal !major_version.', array('!drush_version' => DRUSH_VERSION, '!major_version' => $major_version)));
- }
-
- drush_bootstrap_value('drupal_root', $drupal_root);
- define('DRUSH_DRUPAL_SIGNATURE', $signature);
-
- return TRUE;
- }
-
- /**
- * Bootstrap Drush with a valid Drupal Directory.
- *
- * In this function, the pwd will be moved to the root
- * of the Drupal installation.
- *
- * The DRUSH_DRUPAL_ROOT context, DRUSH_DRUPAL_CORE context, DRUPAL_ROOT, and the
- * DRUSH_DRUPAL_CORE constants are populated from the value that we determined during
- * the validation phase.
- *
- * We also now load the drushrc.php for this specific Drupal site.
- * We can now include files from the Drupal Tree, and figure
- * out more context about the platform, such as the version of Drupal.
- */
- function bootstrap_drupal_root() {
- // Load the config options from Drupal's /drush and sites/all/drush directories.
- drush_load_config('drupal');
-
- $drupal_root = drush_set_context('DRUSH_DRUPAL_ROOT', drush_bootstrap_value('drupal_root'));
- chdir($drupal_root);
- $version = drush_drupal_version();
- $major_version = drush_drupal_major_version();
-
- $core = $this->bootstrap_drupal_core($drupal_root);
-
- // DRUSH_DRUPAL_CORE should point to the /core folder in Drupal 8+ or to DRUPAL_ROOT
- // in prior versions.
- drush_set_context('DRUSH_DRUPAL_CORE', $core);
- define('DRUSH_DRUPAL_CORE', $core);
-
- _drush_preflight_global_options();
-
- drush_log(dt("Initialized Drupal !version root directory at !drupal_root", array("!version" => $version, '!drupal_root' => $drupal_root)), LogLevel::BOOTSTRAP);
- }
-
- /**
- * VALIDATE the DRUSH_BOOTSTRAP_DRUPAL_SITE phase.
- *
- * In this function we determine the URL used for the command,
- * and check for a valid settings.php file.
- *
- * To do this, we need to set up the $_SERVER environment variable,
- * to allow us to use conf_path to determine what Drupal will load
- * as a configuration file.
- */
- function bootstrap_drupal_site_validate() {
- // Define the selected conf path as soon as we have identified that
- // we have selected a Drupal site. Drush used to set this context
- // during the drush_bootstrap_drush phase.
- $drush_uri = _drush_bootstrap_selected_uri();
- drush_set_context('DRUSH_SELECTED_DRUPAL_SITE_CONF_PATH', drush_conf_path($drush_uri));
-
- $this->bootstrap_drupal_site_setup_server_global($drush_uri);
- return $this->bootstrap_drupal_site_validate_settings_present();
- }
-
- /**
- * Set up the $_SERVER globals so that Drupal will see the same values
- * that it does when serving pages via the web server.
- */
- function bootstrap_drupal_site_setup_server_global($drush_uri) {
- // Fake the necessary HTTP headers that Drupal needs:
- if ($drush_uri) {
- $drupal_base_url = parse_url($drush_uri);
- // If there's no url scheme set, add http:// and re-parse the url
- // so the host and path values are set accurately.
- if (!array_key_exists('scheme', $drupal_base_url)) {
- $drush_uri = 'http://' . $drush_uri;
- $drupal_base_url = parse_url($drush_uri);
- }
- // Fill in defaults.
- $drupal_base_url += array(
- 'path' => '',
- 'host' => NULL,
- 'port' => NULL,
- );
- $_SERVER['HTTP_HOST'] = $drupal_base_url['host'];
-
- if ($drupal_base_url['scheme'] == 'https') {
- $_SERVER['HTTPS'] = 'on';
- }
-
- if ($drupal_base_url['port']) {
- $_SERVER['HTTP_HOST'] .= ':' . $drupal_base_url['port'];
- }
- $_SERVER['SERVER_PORT'] = $drupal_base_url['port'];
-
- $_SERVER['REQUEST_URI'] = $drupal_base_url['path'] . '/';
- }
- else {
- $_SERVER['HTTP_HOST'] = 'default';
- $_SERVER['REQUEST_URI'] = '/';
- }
-
- $_SERVER['PHP_SELF'] = $_SERVER['REQUEST_URI'] . 'index.php';
- $_SERVER['SCRIPT_NAME'] = $_SERVER['PHP_SELF'];
- $_SERVER['REMOTE_ADDR'] = '127.0.0.1';
- $_SERVER['REQUEST_METHOD'] = 'GET';
-
- $_SERVER['SERVER_SOFTWARE'] = NULL;
- $_SERVER['HTTP_USER_AGENT'] = NULL;
- $_SERVER['SCRIPT_FILENAME'] = DRUPAL_ROOT . '/index.php';
- }
-
- /**
- * Validate that the Drupal site has all of the settings that it
- * needs to operated.
- */
- function bootstrap_drupal_site_validate_settings_present() {
- $site = drush_bootstrap_value('site', $_SERVER['HTTP_HOST']);
-
- $conf_path = drush_bootstrap_value('conf_path', $this->conf_path(TRUE, TRUE));
- $conf_file = "$conf_path/settings.php";
- if (!file_exists($conf_file)) {
- return drush_bootstrap_error('DRUPAL_SITE_SETTINGS_NOT_FOUND', dt("Could not find a Drupal settings.php file at !file.",
- array('!file' => $conf_file)));
- }
-
- return TRUE;
- }
-
- /**
- * Called by bootstrap_drupal_site to do the main work
- * of the drush drupal site bootstrap.
- */
- function bootstrap_do_drupal_site() {
- $drush_uri = drush_get_context('DRUSH_SELECTED_URI');
- drush_set_context('DRUSH_URI', $drush_uri);
- $site = drush_set_context('DRUSH_DRUPAL_SITE', drush_bootstrap_value('site'));
- $conf_path = drush_set_context('DRUSH_DRUPAL_SITE_ROOT', drush_bootstrap_value('conf_path'));
-
- drush_log(dt("Initialized Drupal site !site at !site_root", array('!site' => $site, '!site_root' => $conf_path)), LogLevel::BOOTSTRAP);
-
- _drush_preflight_global_options();
- }
-
- /**
- * Initialize a site on the Drupal root.
- *
- * We now set various contexts that we determined and confirmed to be valid.
- * Additionally we load an optional drushrc.php file in the site directory.
- */
- function bootstrap_drupal_site() {
- drush_load_config('site');
- $this->bootstrap_do_drupal_site();
- }
-
- /**
- * Initialize and load the Drupal configuration files.
- *
- * We process and store a normalized set of database credentials
- * from the loaded configuration file, so we can validate them
- * and access them easily in the future.
- *
- * Also override Drupal variables as per --variables option.
- */
- function bootstrap_drupal_configuration() {
- global $conf;
-
- $override = array(
- 'dev_query' => FALSE, // Force Drupal6 not to store queries since we are not outputting them.
- 'cron_safe_threshold' => 0, // Don't run poormanscron during Drush request (D7+).
- );
-
- $current_override = drush_get_option_list('variables');
- foreach ($current_override as $name => $value) {
- if (is_numeric($name) && (strpos($value, '=') !== FALSE)) {
- list($name, $value) = explode('=', $value, 2);
- }
- $override[$name] = $value;
- }
- $conf = is_array($conf) ? array_merge($conf, $override) : $conf;
- }
-
- /**
- * Validate the DRUSH_BOOTSTRAP_DRUPAL_DATABASE phase
- *
- * Attempt to make a working database connection using the
- * database credentials that were loaded during the previous
- * phase.
- */
- function bootstrap_drupal_database_validate() {
- if (!drush_valid_db_credentials()) {
- return drush_bootstrap_error('DRUSH_DRUPAL_DB_ERROR');
- }
- return TRUE;
- }
-
- /**
- * Test to see if the Drupal database has a specified
- * table or tables.
- *
- * This is a bootstrap helper function designed to be called
- * from the bootstrap_drupal_database_validate() methods of
- * derived DrupalBoot classes. If a database exists, but is
- * empty, then the Drupal database bootstrap will fail. To
- * prevent this situation, we test for some table that is needed
- * in an ordinary bootstrap, and return FALSE from the validate
- * function if it does not exist, so that we do not attempt to
- * start the database bootstrap.
- *
- * Note that we must manually do our own prefix testing here,
- * because the existing wrappers we have for handling prefixes
- * depend on bootstrapping to the "database" phase, and therefore
- * are not available to validate this same phase.
- *
- * @param $required_tables
- * Array of table names, or string with one table name
- *
- * @return TRUE if all tables in input parameter exist in
- * the database.
- */
- function bootstrap_drupal_database_has_table($required_tables) {
- try {
- $sql = drush_sql_get_class();
- $spec = $sql->db_spec();
- $prefix = isset($spec['prefix']) ? $spec['prefix'] : NULL;
- if (!is_array($prefix)) {
- $prefix = array('default' => $prefix);
- }
- $tables = $sql->listTables();
- foreach ((array)$required_tables as $required_table) {
- $prefix_key = array_key_exists($required_table, $prefix) ? $required_table : 'default';
- if (!in_array($prefix[$prefix_key] . $required_table, $tables)) {
- return FALSE;
- }
- }
- }
- catch (Exception $e) {
- // Usually the checks above should return a result without
- // throwing an exception, but we'll catch any that are
- // thrown just in case.
- return FALSE;
- }
- return TRUE;
- }
-
- /**
- * Boostrap the Drupal database.
- */
- function bootstrap_drupal_database() {
- // We presume that our derived classes will connect and then
- // either fail, or call us via parent::
- drush_log(dt("Successfully connected to the Drupal database."), LogLevel::BOOTSTRAP);
- }
-
- /**
- * Attempt to load the full Drupal system.
- */
- function bootstrap_drupal_full() {
- drush_include_engine('drupal', 'environment');
-
- $this->add_logger();
-
- // Write correct install_profile to cache as needed. Used by _drush_find_commandfiles().
- $cid = drush_cid_install_profile();
- $install_profile = $this->get_profile();
- if ($cached_install_profile = drush_cache_get($cid)) {
- // We have a cached profile. Check it for correctness and save new value if needed.
- if ($cached_install_profile->data != $install_profile) {
- drush_cache_set($cid, $install_profile);
- }
- }
- else {
- // No cached entry so write to cache.
- drush_cache_set($cid, $install_profile);
- }
-
- _drush_log_drupal_messages();
- }
-
- /**
- * Log into the bootstrapped Drupal site with a specific
- * username or user id.
- */
- function bootstrap_drupal_login() {
- $uid_or_name = drush_set_context('DRUSH_USER', drush_get_option('user', 0));
- $userversion = drush_user_get_class();
- if (!$account = $userversion->load_by_uid($uid_or_name)) {
- if (!$account = $userversion->load_by_name($uid_or_name)) {
- if (is_numeric($uid_or_name)) {
- $message = dt('Could not login with user ID !user.', array('!user' => $uid_or_name));
- if ($uid_or_name === 0) {
- $message .= ' ' . dt('This is typically caused by importing a MySQL database dump from a faulty tool which re-numbered the anonymous user ID in the users table. See !link for help recovering from this situation.', array('!link' => 'http://drupal.org/node/1029506'));
- }
- }
- else {
- $message = dt('Could not login with user account `!user\'.', array('!user' => $uid_or_name));
- }
- return drush_set_error('DRUPAL_USER_LOGIN_FAILED', $message);
- }
- }
- $userversion->setCurrentUser($account);
- _drush_log_drupal_messages();
- }
-
-}