283 lines
13 KiB
PHP
283 lines
13 KiB
PHP
<?php
|
|
|
|
use Drush\Log\LogLevel;
|
|
use Webmozart\PathUtil\Path;
|
|
|
|
/**
|
|
* Implementation of hook_drush_command().
|
|
*/
|
|
function sqlsync_drush_command() {
|
|
$items['sql-sync'] = array(
|
|
'description' => 'Copies the database contents from a source site to a target site. Transfers the database dump via rsync.',
|
|
'bootstrap' => DRUSH_BOOTSTRAP_NONE,
|
|
'drush dependencies' => array('sql', 'core'), // core-rsync.
|
|
'package' => 'sql',
|
|
'examples' => array(
|
|
'drush sql-sync @source @target' => 'Copy the database from the site with the alias "source" to the site with the alias "target".',
|
|
'drush sql-sync prod dev' => 'Copy the database from the site in /sites/prod to the site in /sites/dev (multisite installation).',
|
|
),
|
|
'arguments' => array(
|
|
'source' => 'A site-alias or the name of a subdirectory within /sites whose database you want to copy from.',
|
|
'target' => 'A site-alias or the name of a subdirectory within /sites whose database you want to replace.',
|
|
),
|
|
'required-arguments' => TRUE,
|
|
'options' => drush_sql_get_table_selection_options() + array(
|
|
// 'cache' => 'Skip dump if result file exists and is less than "cache" hours old. Optional; default is 24 hours.',
|
|
// 'no-cache' => 'Do not cache the sql-dump file.',
|
|
'no-dump' => 'Do not dump the sql database; always use an existing dump file.',
|
|
'no-sync' => 'Do not rsync the database dump file from source to target.',
|
|
'runner' => 'Where to run the rsync command; defaults to the local site. Can also be "source" or "destination".',
|
|
'source-db-url' => 'Database specification for source system to dump from.',
|
|
'source-remote-port' => 'Override sql database port number in source-db-url. Optional.',
|
|
'source-remote-host' => 'Remote machine to run sql-dump file on. Optional; default is local machine.',
|
|
'source-dump' => array(
|
|
'description' => 'The destination for the dump file, or the path to the dump file when --no-dump is specified.',
|
|
'example-value' => '/dumpdir/db.sql',
|
|
),
|
|
'source-database' => 'A key in the $db_url (D6) or $databases (D7+) array which provides the data.',
|
|
'source-target' => array(
|
|
'description' => 'A key within the SOURCE database identifying a particular server in the database group.',
|
|
'example-value' => 'key',
|
|
// Gets unhidden in help_alter(). We only want to show to D7+ users but have to
|
|
// declare it here since this command does not bootstrap fully.
|
|
'hidden' => TRUE,
|
|
),
|
|
'target-db-url' => '',
|
|
'target-remote-port' => '',
|
|
'target-remote-host' => '',
|
|
'target-dump' => array(
|
|
'description' => 'A path for saving the dump file on target. Mandatory when using --no-sync.',
|
|
'example-value' => '/dumpdir/db.sql.gz',
|
|
),
|
|
'target-database' => 'A key in the $db_url (D6) or $databases (D7+) array which shall receive the data.',
|
|
'target-target' => array(
|
|
'description' => 'Oy. A key within the TARGET database identifying a particular server in the database group.',
|
|
'example-value' => 'key',
|
|
// Gets unhidden in help_alter(). We only want to show to D7+ users but have to
|
|
// declare it here since this command does not bootstrap fully.
|
|
'hidden' => TRUE,
|
|
),
|
|
'create-db' => 'Create a new database before importing the database dump on the target machine.',
|
|
'db-su' => array(
|
|
'description' => 'Account to use when creating a new database. Optional.',
|
|
'example-value' => 'root',
|
|
),
|
|
'db-su-pw' => array(
|
|
'description' => 'Password for the "db-su" account. Optional.',
|
|
'example-value' => 'pass',
|
|
),
|
|
// 'no-ordered-dump' => 'Do not pass --ordered-dump to sql-dump. sql-sync orders the dumpfile by default in order to increase the efficiency of rsync.',
|
|
'sanitize' => 'Obscure email addresses and reset passwords in the user table post-sync.',
|
|
),
|
|
'sub-options' => array(
|
|
'sanitize' => drupal_sanitize_options() + array(
|
|
'confirm-sanitizations' => 'Prompt yes/no after importing the database, but before running the sanitizations',
|
|
),
|
|
),
|
|
'topics' => array('docs-aliases', 'docs-policy', 'docs-example-sync-via-http', 'docs-example-sync-extension'),
|
|
);
|
|
return $items;
|
|
}
|
|
|
|
/**
|
|
* Implements hook_drush_help_alter().
|
|
*/
|
|
function sqlsync_drush_help_alter(&$command) {
|
|
// Drupal 7+ only options.
|
|
if (drush_drupal_major_version() >= 7) {
|
|
if ($command['command'] == 'sql-sync') {
|
|
unset($command['options']['source-target']['hidden'], $command['options']['target-target']['hidden']);
|
|
}
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Command argument complete callback.
|
|
*
|
|
* @return
|
|
* Array of available site aliases.
|
|
*/
|
|
function sql_sql_sync_complete() {
|
|
return array('values' => array_keys(_drush_sitealias_all_list()));
|
|
}
|
|
|
|
/*
|
|
* Implements COMMAND hook init.
|
|
*/
|
|
function drush_sql_sync_init($source, $destination) {
|
|
// Try to get @self defined when --uri was not provided.
|
|
drush_bootstrap_max(DRUSH_BOOTSTRAP_DRUPAL_SITE);
|
|
|
|
// Preflight destination in case it defines the alias used by the source
|
|
_drush_sitealias_get_record($destination);
|
|
|
|
// After preflight, get source and destination settings
|
|
$source_settings = drush_sitealias_get_record($source);
|
|
$destination_settings = drush_sitealias_get_record($destination);
|
|
|
|
// Apply command-specific options.
|
|
drush_sitealias_command_default_options($source_settings, 'source-');
|
|
drush_sitealias_command_default_options($destination_settings, 'target-');
|
|
}
|
|
|
|
/*
|
|
* A command validate callback.
|
|
*/
|
|
function drush_sqlsync_sql_sync_validate($source, $destination) {
|
|
// Get destination info for confirmation prompt.
|
|
$source_settings = drush_sitealias_overlay_options(drush_sitealias_get_record($source), 'source-');
|
|
$destination_settings = drush_sitealias_overlay_options(drush_sitealias_get_record($destination), 'target-');
|
|
$source_db_spec = drush_sitealias_get_db_spec($source_settings, FALSE, 'source-');
|
|
$target_db_spec = drush_sitealias_get_db_spec($destination_settings, FALSE, 'target-');
|
|
$txt_source = (isset($source_db_spec['remote-host']) ? $source_db_spec['remote-host'] . '/' : '') . $source_db_spec['database'];
|
|
$txt_destination = (isset($target_db_spec['remote-host']) ? $target_db_spec['remote-host'] . '/' : '') . $target_db_spec['database'];
|
|
|
|
// Validate.
|
|
if (empty($source_db_spec)) {
|
|
if (empty($source_settings)) {
|
|
return drush_set_error('DRUSH_ALIAS_NOT_FOUND', dt('Error: no alias record could be found for source !source', array('!source' => $source)));
|
|
}
|
|
return drush_set_error('DRUSH_DATABASE_NOT_FOUND', dt('Error: no database record could be found for source !source', array('!source' => $source)));
|
|
}
|
|
if (empty($target_db_spec)) {
|
|
if (empty($destination_settings)) {
|
|
return drush_set_error('DRUSH_ALIAS_NOT_FOUND', dt('Error: no alias record could be found for target !destination', array('!destination' => $destination)));
|
|
}
|
|
return drush_set_error('DRUSH_DATABASE_NOT_FOUND', dt('Error: no database record could be found for target !destination', array('!destination' => $destination)));
|
|
}
|
|
|
|
if (drush_get_option('no-dump') && !drush_get_option('source-dump')) {
|
|
return drush_set_error('DRUSH_SOURCE_DUMP_MISSING', dt('The --source-dump option must be supplied when --no-dump is specified.'));
|
|
}
|
|
|
|
if (drush_get_option('no-sync') && !drush_get_option('target-dump')) {
|
|
return drush_set_error('DRUSH_TARGET_DUMP_MISSING', dt('The --target-dump option must be supplied when --no-sync is specified.'));
|
|
}
|
|
|
|
if (!drush_get_context('DRUSH_SIMULATE')) {
|
|
drush_print(dt("You will destroy data in !target and replace with data from !source.", array('!source' => $txt_source, '!target' => $txt_destination)));
|
|
// @todo Move sanitization prompts to here. They currently show much later.
|
|
if (!drush_confirm(dt('Do you really want to continue?'))) {
|
|
return drush_user_abort();
|
|
}
|
|
}
|
|
}
|
|
|
|
/*
|
|
* A command callback.
|
|
*/
|
|
function drush_sqlsync_sql_sync($source, $destination) {
|
|
$source_settings = drush_sitealias_overlay_options(drush_sitealias_get_record($source), 'source-');
|
|
$destination_settings = drush_sitealias_overlay_options(drush_sitealias_get_record($destination), 'target-');
|
|
$source_is_local = !array_key_exists('remote-host', $source_settings) || drush_is_local_host($source_settings);
|
|
$destination_is_local = !array_key_exists('remote-host', $destination_settings) || drush_is_local_host($destination_settings);
|
|
|
|
// These options are passed along to subcommands like sql-create, sql-dump, sql-query, sql-sanitize, ...
|
|
$source_options = drush_get_merged_prefixed_options('source-');
|
|
$target_options = drush_get_merged_prefixed_options('target-');
|
|
|
|
$backend_options = array();
|
|
// @todo drush_redispatch_get_options() assumes you will execute same command. Not good.
|
|
$global_options = drush_redispatch_get_options() + array(
|
|
'strict' => 0,
|
|
);
|
|
// We do not want to include root or uri here. If the user
|
|
// provided -r or -l, their key has already been remapped to
|
|
// 'root' or 'uri' by the time we get here.
|
|
unset($global_options['root']);
|
|
unset($global_options['uri']);
|
|
|
|
if (drush_get_context('DRUSH_SIMULATE')) {
|
|
$backend_options['backend-simulate'] = TRUE;
|
|
}
|
|
|
|
// Create destination DB if needed.
|
|
if (drush_get_option('create-db')) {
|
|
drush_log(dt('Starting to create database on Destination.'), LogLevel::OK);
|
|
$return = drush_invoke_process($destination, 'sql-create', array(), $global_options + $target_options, $backend_options);
|
|
if ($return['error_status']) {
|
|
return drush_set_error('DRUSH_SQL_CREATE_FAILED', dt('sql-create failed.'));
|
|
}
|
|
}
|
|
|
|
// Perform sql-dump on source unless told otherwise.
|
|
$options = $global_options + $source_options + array(
|
|
'gzip' => TRUE,
|
|
'result-file' => drush_get_option('source-dump', TRUE),
|
|
// 'structure-tables-list' => 'cache*', // Do we want to default to this?
|
|
);
|
|
if (!drush_get_option('no-dump')) {
|
|
drush_log(dt('Starting to dump database on Source.'), LogLevel::OK);
|
|
$return = drush_invoke_process($source, 'sql-dump', array(), $options, $backend_options);
|
|
if ($return['error_status']) {
|
|
return drush_set_error('DRUSH_SQL_DUMP_FAILED', dt('sql-dump failed.'));
|
|
}
|
|
else {
|
|
$source_dump_path = $return['object'];
|
|
if (!is_string($source_dump_path)) {
|
|
return drush_set_error('DRUSH_SQL_DUMP_FILE_NOT_REPORTED', dt('The Drush sql-dump command did not report the path to the dump file produced. Try upgrading the version of Drush you are using on the source machine.'));
|
|
}
|
|
}
|
|
}
|
|
else {
|
|
$source_dump_path = drush_get_option('source-dump');
|
|
}
|
|
|
|
$do_rsync = !drush_get_option('no-sync');
|
|
// Determine path/to/dump on destination.
|
|
if (drush_get_option('target-dump')) {
|
|
$destination_dump_path = drush_get_option('target-dump');
|
|
$rsync_options['yes'] = TRUE; // @temporary: See https://github.com/drush-ops/drush/pull/555
|
|
}
|
|
elseif ($source_is_local && $destination_is_local) {
|
|
$destination_dump_path = $source_dump_path;
|
|
$do_rsync = FALSE;
|
|
}
|
|
else {
|
|
$tmp = '/tmp'; // Our fallback plan.
|
|
drush_log(dt('Starting to discover temporary files directory on Destination.'), LogLevel::OK);
|
|
$return = drush_invoke_process($destination, 'core-status', array(), array(), array('integrate' => FALSE, 'override-simulated' => TRUE));
|
|
if (!$return['error_status'] && isset($return['object']['drush-temp'])) {
|
|
$tmp = $return['object']['drush-temp'];
|
|
}
|
|
$destination_dump_path = Path::join($tmp, basename($source_dump_path));
|
|
$rsync_options['yes'] = TRUE; // No need to prompt as destination is a tmp file.
|
|
}
|
|
|
|
if ($do_rsync) {
|
|
if (!drush_get_option('no-dump')) {
|
|
// Cleanup if this command created the dump file.
|
|
$rsync_options['remove-source-files'] = TRUE;
|
|
}
|
|
$runner = drush_get_runner($source_settings, $destination_settings, drush_get_option('runner', FALSE));
|
|
// Since core-rsync is a strict-handling command and drush_invoke_process() puts options at end, we can't send along cli options to rsync.
|
|
// Alternatively, add options like --ssh-options to a site alias (usually on the machine that initiates the sql-sync).
|
|
$return = drush_invoke_process($runner, 'core-rsync', array("$source:$source_dump_path", "$destination:$destination_dump_path"), $rsync_options);
|
|
drush_log(dt('Copying dump file from Source to Destination.'), LogLevel::OK);
|
|
if ($return['error_status']) {
|
|
return drush_set_error('DRUSH_RSYNC_FAILED', dt('core-rsync failed.'));
|
|
}
|
|
}
|
|
|
|
// Import file into destination.
|
|
drush_log(dt('Starting to import dump file onto Destination database.'), LogLevel::OK);
|
|
$options = $global_options + $target_options + array(
|
|
'file' => $destination_dump_path,
|
|
'file-delete' => TRUE,
|
|
);
|
|
$return = drush_invoke_process($destination, 'sql-query', array(), $options, $backend_options);
|
|
if ($return['error_status']) {
|
|
// An error was already logged.
|
|
return FALSE;
|
|
}
|
|
|
|
// Run Sanitize if needed.
|
|
$options = $global_options + $target_options;
|
|
if (drush_get_option('sanitize')) {
|
|
drush_log(dt('Starting to sanitize target database on Destination.'), LogLevel::OK);
|
|
$return = drush_invoke_process($destination, 'sql-sanitize', array(), $options, $backend_options);
|
|
if ($return['error_status']) {
|
|
return drush_set_error('DRUSH_SQL_SANITIZE_FAILED', dt('sql-sanitize failed.'));
|
|
}
|
|
}
|
|
}
|