diff --git a/core/authorize.php b/core/authorize.php index 08a344a..a9b5a83 100644 --- a/core/authorize.php +++ b/core/authorize.php @@ -4,36 +4,37 @@ * @file * Administrative script for running authorized file operations. * - * Using this script, the site owner (the user actually owning the files on - * the webserver) can authorize certain file-related operations to proceed - * with elevated privileges, for example to deploy and upgrade modules or - * themes. Users should not visit this page directly, but instead use an - * administrative user interface which knows how to redirect the user to this - * script as part of a multistep process. This script actually performs the - * selected operations without loading all of Drupal, to be able to more - * gracefully recover from errors. Access to the script is controlled by a - * global killswitch in settings.php ('allow_authorize_operations') and via - * the 'administer software updates' permission. + * Using this script, the site owner (the user actually owning the files on the + * webserver) can authorize certain file-related operations to proceed with + * elevated privileges, for example to deploy and upgrade modules or themes. + * Users should not visit this page directly, but instead use an administrative + * user interface which knows how to redirect the user to this script as part of + * a multistep process. This script actually performs the selected operations + * without loading all of Drupal, to be able to more gracefully recover from + * errors. Access to the script is controlled by a global killswitch in + * settings.php ('allow_authorize_operations') and via the 'administer software + * updates' permission. * * There are helper functions for setting up an operation to run via this * system in modules/system/system.module. For more information, see: * @link authorize Authorized operation helper functions @endlink */ -// Change the directory to the Drupal root. +// Changes the directory to the Drupal root. chdir('..'); /** - * Root directory of Drupal installation. + * Defines the root directory of the Drupal installation. */ define('DRUPAL_ROOT', getcwd()); /** - * Global flag to identify update.php and authorize.php runs, and so - * avoid various unwanted operations, such as hook_init() and - * hook_exit() invokes, css/js preprocessing and translation, and - * solve some theming issues. This flag is checked on several places - * in Drupal code (not just authorize.php). + * Global flag to identify update.php and authorize.php runs. + * + * Identifies update.php and authorize.php runs, avoiding unwanted operations + * such as hook_init() and hook_exit() invokes, css/js preprocessing and + * translation, and solves some theming issues. The flag is checked in other + * places in Drupal code (not just authorize.php). */ const MAINTENANCE_MODE = 'update'; @@ -54,7 +55,7 @@ function authorize_access_denied_page() { * have access to the 'administer software updates' permission. * * @return - * TRUE if the current user can run authorize.php, otherwise FALSE. + * TRUE if current user can run authorize.php, and FALSE if it cannot. */ function authorize_access_allowed() { return variable_get('allow_authorize_operations', TRUE) && user_access('administer software updates'); diff --git a/core/install.php b/core/install.php index 3ea85ff..cfa2d44 100644 --- a/core/install.php +++ b/core/install.php @@ -5,24 +5,24 @@ * Initiates a browser-based installation of Drupal. */ -// Change the directory to the Drupal root. +// Changes directory to Drupal root. chdir('..'); /** - * Root directory of Drupal installation. + * Defines the root directory of the Drupal installation. */ define('DRUPAL_ROOT', getcwd()); /** - * Global flag to indicate that site is in installation mode. + * Sets a global flag to indicate the site is in installation mode. * - * This constant is defined using define() instead of const so that PHP - * versions older than 5.3 can display the proper PHP requirements instead of - * causing a fatal error. + * The constant is defined using define() instead of const so that PHP + * versions prior to 5.3 can display proper PHP requirements instead of causing + * a fatal error. */ define('MAINTENANCE_MODE', 'install'); -// Exit early if running an incompatible PHP version to avoid fatal errors. +// Exits early if running an incompatible PHP version to avoid fatal errors. // The minimum version is specified explicitly, as DRUPAL_MINIMUM_PHP is not // yet available. It is defined in bootstrap.inc, but it is not possible to // load that file yet as it would cause a fatal error on older versions of PHP. @@ -31,6 +31,6 @@ if (version_compare(PHP_VERSION, '5.3.3') < 0) { exit; } -// Start the installer. +// Starts the installer. require_once DRUPAL_ROOT . '/core/includes/install.core.inc'; install_drupal(); diff --git a/core/update.php b/core/update.php index b8a726d..fb5d991 100644 --- a/core/update.php +++ b/core/update.php @@ -17,15 +17,15 @@ use Symfony\Component\HttpFoundation\Request; use Symfony\Component\HttpFoundation\Response; -// Change the directory to the Drupal root. +// Changes the directory to the Drupal root. chdir('..'); /** - * Root directory of Drupal installation. + * Defines the root directory of the Drupal installation. */ define('DRUPAL_ROOT', getcwd()); -// Exit early if running an incompatible PHP version to avoid fatal errors. +// Exits early if an incompatible PHP version would cause fatal errors. // The minimum version is specified explicitly, as DRUPAL_MINIMUM_PHP is not // yet available. It is defined in bootstrap.inc, but it is not possible to // load that file yet as it would cause a fatal error on older versions of PHP. @@ -46,6 +46,9 @@ if (version_compare(PHP_VERSION, '5.3.3') < 0) { */ define('MAINTENANCE_MODE', 'update'); +/** + * Renders form with a list of available database updates. + */ function update_selection_page() { drupal_set_title('Drupal database update'); $elements = drupal_get_form('update_script_selection_form'); @@ -55,7 +58,9 @@ function update_selection_page() { return $output; } - +/** + * Form constructor for the list of available database module updates. + */ function update_script_selection_form($form, &$form_state) { $count = 0; $incompatible_count = 0; @@ -157,6 +162,9 @@ function update_script_selection_form($form, &$form_state) { return $form; } +/** + * Provides links to homepage and administration pages. + */ function update_helpful_links() { $links['front'] = array( 'title' => t('Front page'), @@ -171,6 +179,9 @@ function update_helpful_links() { return $links; } +/** + * Displays results of update script with any accompanying errors. + */ function update_results_page() { drupal_set_title('Drupal database update'); @@ -263,8 +274,8 @@ function update_info_page() { $token = drupal_get_token('update'); $output = '
Use this utility to update your database whenever a new release of Drupal or a module is installed.
For more detailed information, see the upgrading handbook. If you are unsure what these terms mean you should probably contact your hosting provider.
'; $output .= "Access denied. You are not authorized to access this page. Log in using either an account with the administer software updates permission or the site maintenance account (the account you created during installation). If you cannot log in, you will have to edit settings.php
to bypass this access check. To do this:
Access denied. You are not authorized to access this page. Log in using an account with the administer software updates permission or the site maintenance account (the account you created during installation). If you cannot log in, you will have to edit settings.php
to bypass this access check. To do this:
sites/your_site_name
if such directory exists, or else to sites/default
which applies otherwise.$update_free_access = FALSE;
. Change it to $update_free_access = TRUE;
.sites/your_site_name
if such directory exists, or else to sites/default
which applies otherwise.$update_free_access = FALSE;
. Change it to $update_free_access = TRUE;
.$update_free_access = FALSE;
.