"''" * in the $attributes array. If NOT NULL and DEFAULT are set the PostgreSQL * version will set values of the added column in old rows to the * DEFAULT value. * * @param $ret * Array to which results will be added. * @param $table * Name of the table, without {} * @param $column * Name of the column * @param $type * Type of column * @param $attributes * Additional optional attributes. Recognized attributes: * not null => TRUE|FALSE * default => NULL|FALSE|value (the value must be enclosed in '' marks) * @return * nothing, but modifies $ret parameter. */ function db_add_column(&$ret, $table, $column, $type, $attributes = array()) { if (array_key_exists('not null', $attributes) and $attributes['not null']) { $not_null = 'NOT NULL'; } if (array_key_exists('default', $attributes)) { if (is_null($attributes['default'])) { $default_val = 'NULL'; $default = 'default NULL'; } elseif ($attributes['default'] === FALSE) { $default = ''; } else { $default_val = "$attributes[default]"; $default = "default $attributes[default]"; } } $ret[] = update_sql("ALTER TABLE {". $table ."} ADD $column $type"); if (!empty($default)) { $ret[] = update_sql("ALTER TABLE {". $table ."} ALTER $column SET $default"); } if (!empty($not_null)) { if (!empty($default)) { $ret[] = update_sql("UPDATE {". $table ."} SET $column = $default_val"); } $ret[] = update_sql("ALTER TABLE {". $table ."} ALTER $column SET NOT NULL"); } } /** * Change a column definition using syntax appropriate for PostgreSQL. * Save result of SQL commands in $ret array. * * Remember that changing a column definition involves adding a new column * and dropping an old one. This means that any indices, primary keys and * sequences from serial-type columns are dropped and might need to be * recreated. * * @param $ret * Array to which results will be added. * @param $table * Name of the table, without {} * @param $column * Name of the column to change * @param $column_new * New name for the column (set to the same as $column if you don't want to change the name) * @param $type * Type of column * @param $attributes * Additional optional attributes. Recognized attributes: * not null => TRUE|FALSE * default => NULL|FALSE|value (with or without '', it won't be added) * @return * nothing, but modifies $ret parameter. */ function db_change_column(&$ret, $table, $column, $column_new, $type, $attributes = array()) { if (array_key_exists('not null', $attributes) and $attributes['not null']) { $not_null = 'NOT NULL'; } if (array_key_exists('default', $attributes)) { if (is_null($attributes['default'])) { $default_val = 'NULL'; $default = 'default NULL'; } elseif ($attributes['default'] === FALSE) { $default = ''; } else { $default_val = "$attributes[default]"; $default = "default $attributes[default]"; } } $ret[] = update_sql("ALTER TABLE {". $table ."} RENAME $column TO ". $column ."_old"); $ret[] = update_sql("ALTER TABLE {". $table ."} ADD $column_new $type"); $ret[] = update_sql("UPDATE {". $table ."} SET $column_new = ". $column ."_old"); if ($default) { $ret[] = update_sql("ALTER TABLE {". $table ."} ALTER $column_new SET $default"); } if ($not_null) { $ret[] = update_sql("ALTER TABLE {". $table ."} ALTER $column_new SET NOT NULL"); } $ret[] = update_sql("ALTER TABLE {". $table ."} DROP ". $column ."_old"); } /** * If the schema version for Drupal core is stored in the variables table * (4.6.x and earlier) move it to the schema_version column of the system * table. * * This function may be removed when update 156 is removed, which is the last * update in the 4.6 to 4.7 migration. */ function update_fix_schema_version() { if ($update_start = variable_get('update_start', FALSE)) { // Some updates were made to the 4.6 branch and 4.7 branch. This sets // temporary variables to prevent the updates from being executed twice and // throwing errors. switch ($update_start) { case '2005-04-14': variable_set('update_132_done', TRUE); break; case '2005-05-06': variable_set('update_132_done', TRUE); variable_set('update_135_done', TRUE); break; case '2005-05-07': variable_set('update_132_done', TRUE); variable_set('update_135_done', TRUE); variable_set('update_137_done', TRUE); break; } // The schema_version column (added below) was changed during 4.7beta. // Update_170 is only for those beta users. variable_set('update_170_done', TRUE); $sql_updates = array( '2004-10-31: first update since Drupal 4.5.0 release' => 110, '2004-11-07' => 111, '2004-11-15' => 112, '2004-11-28' => 113, '2004-12-05' => 114, '2005-01-07' => 115, '2005-01-14' => 116, '2005-01-18' => 117, '2005-01-19' => 118, '2005-01-20' => 119, '2005-01-25' => 120, '2005-01-26' => 121, '2005-01-27' => 122, '2005-01-28' => 123, '2005-02-11' => 124, '2005-02-23' => 125, '2005-03-03' => 126, '2005-03-18' => 127, '2005-03-21' => 128, // The following three updates were made on the 4.6 branch '2005-04-14' => 128, '2005-05-06' => 128, '2005-05-07' => 128, '2005-04-08: first update since Drupal 4.6.0 release' => 129, '2005-04-10' => 130, '2005-04-11' => 131, '2005-04-14' => 132, '2005-04-24' => 133, '2005-04-30' => 134, '2005-05-06' => 135, '2005-05-08' => 136, '2005-05-09' => 137, '2005-05-10' => 138, '2005-05-11' => 139, '2005-05-12' => 140, '2005-05-22' => 141, '2005-07-29' => 142, '2005-07-30' => 143, '2005-08-08' => 144, '2005-08-15' => 145, '2005-08-25' => 146, '2005-09-07' => 147, '2005-09-18' => 148, '2005-09-27' => 149, '2005-10-15' => 150, '2005-10-23' => 151, '2005-10-28' => 152, '2005-11-03' => 153, '2005-11-14' => 154, '2005-11-27' => 155, '2005-12-03' => 156, ); // Add schema version column switch ($GLOBALS['db_type']) { case 'pgsql': $ret = array(); db_add_column($ret, 'system', 'schema_version', 'smallint', array('not null' => TRUE, 'default' => -1)); break; case 'mysql': case 'mysqli': db_query('ALTER TABLE {system} ADD schema_version smallint(3) not null default -1'); break; } // Set all enabled (contrib) modules to schema version 0 (installed) db_query('UPDATE {system} SET schema_version = 0 WHERE status = 1'); // Set schema version for core drupal_set_installed_schema_version('system', $sql_updates[$update_start]); variable_del('update_start'); } } /** * System update 130 changes the sessions table, which breaks the update * script's ability to use session variables. This changes the table * appropriately. * * This code, including the 'update_sessions_fixed' variable, may be removed * when update 130 is removed. It is part of the Drupal 4.6 to 4.7 migration. */ function update_fix_sessions() { $ret = array(); if (drupal_get_installed_schema_version('system') < 130 && !variable_get('update_sessions_fixed', FALSE)) { if ($GLOBALS['db_type'] == 'mysql') { db_query("ALTER TABLE {sessions} ADD cache int(11) NOT NULL default '0' AFTER timestamp"); } elseif ($GLOBALS['db_type'] == 'pgsql') { db_add_column($ret, 'sessions', 'cache', 'int', array('default' => 0, 'not null' => TRUE)); } variable_set('update_sessions_fixed', TRUE); } } /** * System update 115 changes the watchdog table, which breaks the update * script's ability to use logging. This changes the table appropriately. * * This code, including the 'update_watchdog_115_fixed' variable, may be removed * when update 115 is removed. It is part of the Drupal 4.5 to 4.7 migration. */ function update_fix_watchdog_115() { if (drupal_get_installed_schema_version('system') < 115 && !variable_get('update_watchdog_115_fixed', FALSE)) { if ($GLOBALS['db_type'] == 'mysql') { $ret[] = update_sql("ALTER TABLE {watchdog} ADD severity tinyint(3) unsigned NOT NULL default '0'"); } else if ($GLOBALS['db_type'] == 'pgsql') { $ret[] = update_sql('ALTER TABLE {watchdog} ADD severity smallint'); $ret[] = update_sql('UPDATE {watchdog} SET severity = 0'); $ret[] = update_sql('ALTER TABLE {watchdog} ALTER COLUMN severity SET NOT NULL'); $ret[] = update_sql('ALTER TABLE {watchdog} ALTER COLUMN severity SET DEFAULT 0'); } variable_set('update_watchdog_115_fixed', TRUE); } } /** * System update 142 changes the watchdog table, which breaks the update * script's ability to use logging. This changes the table appropriately. * * This code, including the 'update_watchdog_fixed' variable, may be removed * when update 142 is removed. It is part of the Drupal 4.6 to 4.7 migration. */ function update_fix_watchdog() { if (drupal_get_installed_schema_version('system') < 142 && !variable_get('update_watchdog_fixed', FALSE)) { switch ($GLOBALS['db_type']) { case 'pgsql': $ret = array(); db_add_column($ret, 'watchdog', 'referer', 'varchar(128)', array('not null' => TRUE, 'default' => "''")); break; case 'mysql': case 'mysqli': db_query("ALTER TABLE {watchdog} ADD COLUMN referer varchar(128) NOT NULL"); break; } variable_set('update_watchdog_fixed', TRUE); } } /** * Perform one update and store the results which will later be displayed on * the finished page. * * @param $module * The module whose update will be run. * @param $number * The update number to run. * @param $context * The batch context array */ function update_do_one($module, $number, &$context) { $function = $module .'_update_'. $number; if (function_exists($function)) { $ret = $function($context['sandbox']); } if (isset($ret['#finished'])) { $context['finished'] = $ret['#finished']; unset($ret['#finished']); } if (!isset($context['results'][$module])) { $context['results'][$module] = array(); } if (!isset($context['results'][$module][$number])) { $context['results'][$module][$number] = array(); } $context['results'][$module][$number] = array_merge($context['results'][$module][$number], $ret);; if ($context['finished'] == 1) { // Update the installed version drupal_set_installed_schema_version($module, $number); } $context['message'] = t('Updating @module module', array('@module' => $module)); } function update_selection_page() { $output = '
The version of Drupal you are updating from has been automatically detected. You can select a different version, but you should not need to.
'; $output .= 'Click Update to start the update process.
'; drupal_set_title('Drupal database update'); $output .= drupal_get_form('update_script_selection_form'); update_task_list('select'); return $output; } function update_script_selection_form() { $form = array(); $form['start'] = array( '#tree' => TRUE, '#type' => 'fieldset', '#title' => 'Select versions', '#collapsible' => TRUE, '#collapsed' => TRUE, ); // Ensure system.module's updates appear first $form['start']['system'] = array(); foreach (module_list() as $module) { $updates = drupal_get_schema_versions($module); if ($updates !== FALSE) { $updates = drupal_map_assoc($updates); $updates[] = 'No updates available'; $default = drupal_get_installed_schema_version($module); foreach (array_keys($updates) as $update) { if ($update > $default) { $default = $update; break; } } $form['start'][$module] = array( '#type' => 'select', '#title' => $module .' module', '#default_value' => $default, '#options' => $updates, ); } } $form['has_js'] = array( '#type' => 'hidden', '#default_value' => FALSE, '#attributes' => array('id' => 'edit-has_js'), ); $form['submit'] = array( '#type' => 'submit', '#value' => 'Update', ); return $form; } function update_batch() { global $base_url; $operations = array(); // Set the installed version so updates start at the correct place. foreach ($_POST['start'] as $module => $version) { drupal_set_installed_schema_version($module, $version - 1); $updates = drupal_get_schema_versions($module); $max_version = max($updates); if ($version <= $max_version) { foreach ($updates as $update) { if ($update >= $version) { $operations[] = array('update_do_one', array($module, $update)); } } } } $batch = array( 'operations' => $operations, 'title' => 'Updating', 'init_message' => 'Starting updates', 'error_message' => 'An unrecoverable error has occurred. You can find the error message below. It is advised to copy it to the clipboard for reference.', 'finished' => 'update_finished', ); batch_set($batch); batch_process($base_url .'/update.php?op=results', $base_url .'/update.php'); } function update_finished($success, $results, $operations) { // clear the caches in case the data has been updated. cache_clear_all('*', 'cache', TRUE); cache_clear_all('*', 'cache_page', TRUE); cache_clear_all('*', 'cache_filter', TRUE); drupal_clear_css_cache(); drupal_clear_js_cache(); $_SESSION['update_results'] = $results; $_SESSION['update_success'] = $success; $_SESSION['updates_remaining'] = $operations; } function update_results_page() { drupal_set_title('Drupal database update'); // NOTE: we can't use l() here because the URL would point to 'update.php?q=admin'. $links[] = 'Main page'; $links[] = 'Administration pages'; update_task_list(); // Report end result if ($_SESSION['update_success']) { $output = 'Updates were attempted. If you see no failures below, you may proceed happily to the administration pages. Otherwise, you may need to update your database manually. All errors have been logged.
'; } else { list($module, $version) = array_pop(reset($_SESSION['updates_remaining'])); $output = 'The update process was aborted prematurely while running update #'. $version .' in '. $module .'.module. All other errors have been logged. You may need to check the watchdog
database table manually.
Reminder: don't forget to set the \$update_free_access
value in your settings.php
file back to FALSE
.
Use this utility to update your database whenever a new release of Drupal or a module is installed.
For more detailed information, see the Installation and upgrading handbook. If you are unsure what these terms mean you should probably contact your hosting provider.
'; $output .= "When you have performed the steps above, you may proceed.
\n"; $output .= ''; $output .= "\n"; return $output; } function update_access_denied_page() { drupal_set_title('Access denied'); return 'Access denied. You are not authorized to access this page. Please log in as the admin user (the first user you created). 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;
.$update_free_access = FALSE;
.