". $section['body'] ."
"; if (!empty($section['more'])) { $out .= "". $section['more'] ."
"; } } return $out; } } /** * Implementation of hook_menu(). */ function backup_migrate_menu() { $items = array(); $items['admin/content/backup_migrate'] = array( 'title' => 'Backup and Migrate', 'description' => 'Backup/restore your database or migrate data to or from another Drupal site.', 'page callback' => 'backup_migrate_menu_callback', 'page arguments' => array('', 'backup_migrate_ui_manual_backup_quick', TRUE), 'access arguments' => array('access backup and migrate'), 'type' => MENU_NORMAL_ITEM, ); $items['admin/content/backup_migrate/export'] = array( 'title' => 'Backup', 'description' => 'Backup the database.', 'page callback' => 'backup_migrate_menu_callback', 'page arguments' => array('', 'backup_migrate_ui_manual_backup_quick', TRUE), 'access arguments' => array('access backup and migrate'), 'weight' => 0, 'type' => MENU_DEFAULT_LOCAL_TASK, ); $items['admin/content/backup_migrate/export/quick'] = array( 'title' => 'Quick Backup', 'description' => 'Backup the database.', 'page callback' => 'backup_migrate_menu_callback', 'page arguments' => array('', 'backup_migrate_ui_manual_backup_quick', TRUE), 'access arguments' => array('access backup and migrate'), 'weight' => 0, 'type' => MENU_DEFAULT_LOCAL_TASK, ); $items['admin/content/backup_migrate/export/advanced'] = array( 'title' => 'Advanced Backup', 'description' => 'Backup the database.', 'page callback' => 'backup_migrate_menu_callback', 'page arguments' => array('', 'backup_migrate_ui_manual_backup_advanced', TRUE), 'access arguments' => array('perform backup'), 'weight' => 1, 'type' => MENU_LOCAL_TASK, ); $items['admin/content/backup_migrate/restore'] = array( 'title' => 'Restore', 'description' => 'Restore the database from a previous backup', 'page callback' => 'backup_migrate_menu_callback', 'page arguments' => array('', 'backup_migrate_ui_manual_restore', TRUE), 'access arguments' => array('restore from backup'), 'weight' => 1, 'type' => MENU_LOCAL_TASK, ); backup_migrate_include('crud'); $items += backup_migrate_crud_menu(); return $items; } /** * Implementation of hook_cron(). * * Takes care of scheduled backups and deletes abandoned temp files. */ function backup_migrate_cron() { // Backing up requires a full bootstrap as it uses the file functionality in // files.inc. Running poormanscron with caching on can cause cron to run without // a full bootstrap so we manually finish bootstrapping here. require_once './includes/common.inc'; _drupal_bootstrap_full(); // Set the message mode to logging. _backup_migrate_message_callback('_backup_migrate_message_log'); backup_migrate_include('schedules'); backup_migrate_schedules_run(); } /** * Implementation of hook_perm(). */ function backup_migrate_perm() { return array('access backup and migrate', 'perform backup', 'access backup files', 'delete backup files', 'restore from backup', 'administer backup and migrate'); } /** * Implementation of hook_simpletest(). */ function backup_migrate_simpletest() { $dir = drupal_get_path('module', 'backup_migrate') .'/tests'; $tests = file_scan_directory($dir, '\.test$'); return array_keys($tests); } /** * Implementation of hook_theme(). */ function backup_migrate_theme() { $themes = array( 'backup_migrate_ui_manual_quick_backup_form' => array( 'arguments' => array('form'), ), ); return $themes; } /* Menu Callbacks */ /** * A menu callback helper. Handles file includes and interactivity setting. */ function backup_migrate_menu_callback($include, $function, $interactive = TRUE) { if ($include) { backup_migrate_include($include); } // Set the message handler based on interactivity setting. _backup_migrate_message_callback($interactive ? '_backup_migrate_message_browser' : '_backup_migrate_message_log'); // Get the arguments with the first 3 removed. $args = array_slice(func_get_args(), 3); return call_user_func_array($function, $args); } /** * Include views .inc files as necessary. */ function backup_migrate_include() { static $used = array(); foreach (func_get_args() as $file) { if (!isset($used[$file])) { require_once './' . drupal_get_path('module', 'backup_migrate') . "/includes/$file.inc"; } $used[$file] = TRUE; } } /** * The menu callback for easy manual backups. */ function backup_migrate_ui_manual_backup_quick() { $out = ""; if (user_access('perform backup')) { $out .= drupal_get_form('backup_migrate_ui_manual_quick_backup_form'); } else { $out = t('You do not have permission to back up this site.'); } return $out; } /** * The menu callback for advanced manual backups. */ function backup_migrate_ui_manual_backup_advanced() { backup_migrate_include('profiles'); $out = ""; $profile_id = arg(5); $profile = _backup_migrate_profile_saved_default_profile($profile_id); $out .= drupal_get_form('backup_migrate_ui_manual_backup_load_profile_form', $profile); $out .= drupal_get_form('backup_migrate_ui_manual_backup_form', $profile); return $out; } /** * The backup/export load profile form. */ function backup_migrate_ui_manual_backup_load_profile_form(&$form_state, $profile = NULL) { $form = array(); $profile_options = _backup_migrate_get_profile_form_item_options(); if (count($profile_options) > 0) { $profile_options = array(0 => t('-- Select a Settings Profile --')) + $profile_options; $form['profile'] = array( "#title" => t("Settings Profile"), "#collapsible" => TRUE, "#collapsed" => FALSE, "#prefix" => 'Or you can restore one of the files in your saved backup destinations.
', array("!url" => url("admin/content/backup_migrate/destination"))), ); } $form['#attributes'] = array('enctype' => 'multipart/form-data'); return $form; } /** * The restore submit. Do the restore. */ function backup_migrate_ui_manual_restore_form_submit($form, &$form_state) { if ($file = file_save_upload('backup_migrate_restore_upload')) { backup_migrate_include('destinations'); backup_migrate_perform_restore('upload', $file->filepath, $form_state['values']); } $form_state['redirect'] = 'admin/content/backup_migrate/restore'; } /** * Convert an item to an 'exportable'. */ function backup_migrate_ui_export_form(&$form_state, $item) { if ($item && function_exists('ctools_var_export')) { $code = ctools_var_export($item); $form = ctools_export_form($form_state, $code); return $form; } return array(); } /** * Perform a backup with the given settings. */ function backup_migrate_perform_backup(&$settings) { backup_migrate_include('destinations', 'files', 'db', 'filters'); timer_start('backup_migrate_backup'); // If not in 'safe mode', increase the maximum execution time: if (!ini_get('safe_mode') && ini_get('max_execution_time') < 1200) { set_time_limit(variable_get('backup_migrate_backup_max_time', 1200)); } // Register shutdown callback register_shutdown_function('backup_migrate_cleanup'); if ($settings->append_timestamp && $settings->timestamp_format) { $settings->filename .= "-". date($settings->timestamp_format); } $settings->filename = _backup_migrate_clean_filename($settings->filename); $source = $settings->get_source(); if (!$source) { backup_migrate_backup_fail("Could not run backup because the source '%source' is missing.", array('%source' => $settings->source_id), $settings); return FALSE; } $file = new backup_file(array('filename' => $settings->filename)); if (!$file) { backup_migrate_backup_fail("Could not run backup because a temporary file could not be created.", array(), $settings); return FALSE; } $file = backup_migrate_db_backup($source, $file, $settings); if (!$file) { if (_backup_migrate_check_timeout()) { backup_migrate_backup_fail('Could not restore the database because the script timed out. Try increasing your PHP max_execution_time setting.', array('!url' => 'http://www.php.net/manual/en/info.configuration.php#ini.max-execution-time'), $settings); } else { backup_migrate_backup_fail("Could not backup the database.", array(), $settings); } return FALSE; } $file = backup_migrate_filters_backup($file, $settings); if (!$file) { backup_migrate_cleanup(); return FALSE; } $file = backup_migrate_destination_save_file($file, $settings); if (!$file) { backup_migrate_backup_fail("Could not run backup because the file could not be saved to the destination.", array(), $settings); return FALSE; } // Backup succeeded, $time = timer_stop('backup_migrate_backup'); $message = 'Site backed up successfully to %file in destination %dest in !time ms.'; $destination = backup_migrate_get_destination($settings->destination_id); $params = array( '%file' => $settings->filename, '%dest' => $destination->get('name'), '!time' => $time['time'], ); if ($links = $destination->get_file_links($file->file_id())) { $params['!links'] = implode(", ", $links); } backup_migrate_backup_succeed($message, $params, $settings); return $file; } /** * Restore from a file in the given destination. */ function backup_migrate_perform_restore($destination_id, $file_id, $settings = array()) { backup_migrate_include('files', 'filters'); timer_start('backup_migrate_restore'); // If not in 'safe mode', increase the maximum execution time: if (!ini_get('safe_mode') && ini_get('max_execution_time') < variable_get('backup_migrate_backup_max_time', 1200)) { set_time_limit(variable_get('backup_migrate_backup_max_time', 1200)); } // Register shutdown callback. register_shutdown_function('backup_migrate_cleanup'); // Load the file from the destination. $file = backup_migrate_destination_get_file($destination_id, $file_id); if (!$file) { _backup_migrate_message("Could not restore because the file could not be loaded from the destination.", array(), 'error'); backup_migrate_cleanup(); return FALSE; } // Filter the file before restoring. $file = backup_migrate_filters_restore($file); if (!$file) { // No error as filters should take care of that themselves. backup_migrate_cleanup(); return FALSE; } // Perform the actual restore. $num = backup_migrate_perform_restore_file($file, (object)$settings); if (!$file) { if (_backup_migrate_check_timeout()) { _backup_migrate_message('Could not restore the database because the script timed out. Try increasing your PHP max_execution_time setting.', array('!url' => 'http://www.php.net/manual/en/info.configuration.php#ini.max-execution-time'), 'error'); } else { _backup_migrate_message("Could not restore the database.", array(), 'error'); } backup_migrate_cleanup(); return FALSE; } $time = timer_stop('backup_migrate_restore'); if ($num && $destination = backup_migrate_get_destination($destination_id)) { $message = 'Database restored from %destination file %file. %num SQL commands executed in !time ms'; $params = array("%destination" => $destination->get_name(), "%num" => $num, '%file' => $file->filename(), '!time' => $time['time']); if ($destination && $destination->op('list files')) { $params['!links'] = t('Restore again', array('!restoreurl' => url('admin/content/backup_migrate/destination/list/restorefile/'. $destination_id ."/". $file->filename()))); } backup_migrate_restore_succeed($message, $params, $settings); } // Delete any temp files we've created. backup_migrate_cleanup(); // No errors. Return the file. return $file; } /** * Restore from a file in the given destination. */ function backup_migrate_perform_restore_file($file, $settings = array()) { backup_migrate_include('files', 'db'); // If not in 'safe mode', increase the maximum execution time: if (!ini_get('safe_mode') && ini_get('max_execution_time') < variable_get('backup_migrate_restore_max_time', 1200)) { set_time_limit(variable_get('backup_migrate_restore_max_time', 1200)); } $source = backup_migrate_get_destination(empty($settings->source_id) ? 'db_url:default' : $settings->source_id); $num = backup_migrate_db_restore($source, $file, $settings); return $num; } /** * Clean up when a backup operation fails. */ function backup_migrate_backup_fail($message, $params, $settings) { backup_migrate_include('files', 'filters'); _backup_migrate_message($message, $params, 'error'); backup_migrate_cleanup(); backup_migrate_filters_invoke_all('backup_fail', $settings, $message, $params); return FALSE; } /** * Clean up when a backup operation suceeds. */ function backup_migrate_backup_succeed($message, $params, $settings) { backup_migrate_include('filters', 'files'); _backup_migrate_message($message, $params, 'success'); backup_migrate_cleanup(); backup_migrate_filters_invoke_all('backup_succeed', $settings, $message, $params); return FALSE; } /** * Clean up when a restore operation fails. */ function backup_migrate_restore_fail($message, $params, $settings) { backup_migrate_include('files', 'filters'); _backup_migrate_message($message, $params, 'error'); backup_migrate_cleanup(); backup_migrate_filters_invoke_all('restore_fail', $settings, $message, $params); return FALSE; } /** * Clean up when a restore operation suceeds. */ function backup_migrate_restore_succeed($message, $params, $settings) { backup_migrate_include('filters', 'files'); _backup_migrate_message($message, $params, 'success'); backup_migrate_cleanup(); backup_migrate_filters_invoke_all('restore_succeed', $settings, $message, $params); return FALSE; } /** * Cleanup after a success or failure. */ function backup_migrate_cleanup() { // Check that the cleanup function exists. If it doesn't then we probably didn't create any files to be cleaned up. if (function_exists('_backup_migrate_temp_files_delete')) { _backup_migrate_temp_files_delete(); } } /* Actions/Workflow integration */ /** * Action to backup the drupal site. Requires actions.module. */ function action_backup_migrate_backup($op, $edit = array()) { switch ($op) { case 'do': _backup_migrate_backup_with_defaults(); watchdog('action', 'Backed up database'); break; case 'metadata': return array( 'description' => t('Backup the database with the default settings'), 'type' => t('Backup and Migrate'), 'batchable' => TRUE, 'configurable' => FALSE, ); // Return an HTML config form for the action. case 'form': return ''; // Validate the HTML form. case 'validate': return TRUE; // Process the HTML form to store configuration. case 'submit': return ''; } } /* * Implementation of hook_action_info(). */ function backup_migrate_action_info() { return array( 'backup_migrate_action_backup' => array( '#label' => t('Backup the database'), '#module' => t('Backup and Migrate'), '#description' => t('Backup the database with the default settings.'), ), ); } /* * Action callback. */ function backup_migrate_action_backup() { _backup_migrate_backup_with_defaults(); } /* Utilities */ /** * Backup the database with the default settings. */ function _backup_migrate_backup_with_defaults($destination_id = "manual") { backup_migrate_include('files', 'db', 'profiles'); $settings = _backup_migrate_profile_saved_default_profile(); $settings->destination_id = $destination_id; backup_migrate_perform_backup($settings); } /** * Helper function to set a drupal message and watchdog message depending on whether the module is being run interactively. */ function _backup_migrate_message($message, $replace = array(), $type = 'status') { // Only set a message if there is a callback handler to handle the message. if (($callback = _backup_migrate_message_callback()) && function_exists($callback)) { $callback($message, $replace, $type); } // Store the message in case it's needed (for the status notification filter for example). _backup_migrate_messages($message, $replace, $type); } /** * Helper function to set a drupal message and watchdog message depending on whether the module is being run interactively. */ function _backup_migrate_messages($message = NULL, $replace = array(), $type = 'status') { static $messages = array(); if ($message) { $messages[] = array('message' => $message, 'replace' => $replace, 'type' => 'status'); } return $messages; } /** * Send a message to the browser. The normal type of message handling for interactive use. */ function _backup_migrate_message_browser($message, $replace, $type) { // Log the message as well for admins. _backup_migrate_message_log($message, $replace, $type); // If there are links, we can display them in the browser. if (!empty($replace['!links'])) { $message .= " (!links)"; } // Use drupal_set_message to display to the user. drupal_set_message(t($message, $replace), str_replace('success', 'status', $type), FALSE); } /** * Log message if we are in a non-interactive mode such as a cron run. */ function _backup_migrate_message_log($message, $replace, $type) { // We only want to log the errors or successful completions. if (in_array($type, array('error', 'success'))) { watchdog('backup_migrate', $message, $replace, $type == 'error' ? WATCHDOG_ERROR : WATCHDOG_NOTICE); } } /** * Set or retrieve a message handler. */ function _backup_migrate_message_callback($callback = NULL) { static $current_callback = '_backup_migrate_message_log'; if ($callback !== NULL) { $current_callback = $callback; } return $current_callback; } function _backup_migrate_check_timeout() { static $timeout; // Figure out when we should stop execution. if (!$timeout) { $timeout = (!empty($_SERVER['REQUEST_TIME']) ? $_SERVER['REQUEST_TIME'] : time()) + ini_get('max_execution_time') - variable_get('backup_migrate_timeout_buffer', 5); } return (time() > $timeout); }