Skip to content

Instantly share code, notes, and snippets.

@sillygwailo
Created February 17, 2012 03:54
Show Gist options
  • Star 0 You must be signed in to star a gist
  • Fork 0 You must be signed in to fork a gist
  • Save sillygwailo/1850462 to your computer and use it in GitHub Desktop.
Save sillygwailo/1850462 to your computer and use it in GitHub Desktop.
drushrc.php
<?php
/**
* Based on the example provided at http://www.drush.org/examples/example.drushrc.php
// Specify a particular multisite.
# $options['l'] = 'http://example.com/subir';
// Specify your Drupal core base directory (useful if you use symlinks).
# $options['r'] = '/home/USER/workspace/drupal-6';
/**
* Useful shell aliases:
*
* Drush shell aliases act similar to git aliases. For best results, define
* aliases in one of the drushrc file locations between #3 through #6 above.
* More information on shell aliases can be found via:
* `drush topic docs-shell-aliases` on the command line.
*
* @see https://git.wiki.kernel.org/articles/a/l/i/Aliases.html#Advanced.
*/
$options['shell-aliases']['pull'] = '!git pull'; // We've all done it.
# $options['shell-aliases']['pulldb'] = '!git pull && drush updatedb';
# $options['shell-aliases']['noncore'] = 'pm-list --no-core';
# $options['shell-aliases']['wipe'] = 'cache-clear all';
# $options['shell-aliases']['unsuck'] = 'pm-disable -y overlay,dashboard';
# $options['shell-aliases']['offline'] = 'variable-set -y --always-set maintenance_mode 1';
# $options['shell-aliases']['online'] = 'variable-delete -y --exact maintenance_mode';
// Add a 'pm-clone' to simplify (cached) git cloning from drupal.org.
# $options['shell-aliases']['pm-clone'] = 'pm-download --gitusername=YOURUSERNAME --package-handler=git_drupalorg --cache';
/**
* Historical (deprecated) aliases:
*
* The following aliases were supported in Drush 4, but removed in Drush 5. To
* keep using them, uncomment the following lines or copy them to your drushrc
* file.
*/
# $options['shell-aliases']['script'] = 'php-script';
# $options['shell-aliases']['sync'] = 'core-rsync';
# $options['shell-aliases']['installsite'] = 'site-install';
# $options['shell-aliases']['is'] = 'site-install';
# $options['shell-aliases']['wd'] = 'watchdog-delete';
# $options['shell-aliases']['enable'] = 'pm-enable';
# $options['shell-aliases']['disable'] = 'pm-disable';
# $options['shell-aliases']['uninstall'] = 'pm-uninstall';
# $options['shell-aliases']['sm'] = 'pm-list';
# $options['shell-aliases']['refresh'] = 'pm-refresh';
# $options['shell-aliases']['updatecode'] = 'pm-updatecode';
# $options['shell-aliases']['update'] = 'pm-update';
# $options['shell-aliases']['download'] = 'pm-download';
// Load a drushrc.php configuration file from the current working directory.
# $options['config'][] = '.';
/**
* Drush knows how to check for and download its own code updates with the
* `drush pm-updatecode` and `drush version` commands. Set this value to TRUE
* (default) allows updates to latest stable release. Set to FALSE to disable
* self update checks completely. Set to 'head' to allow bleeding-edge updates
* from the code repository.
*/
# $options['self-update'] = FALSE;
/**
* Enable logging and periodic upload of anonymized usage statistics. The Drush
* maintainers use this data to learn which commands and options are most
* See the usage-show and usage-send commands.
*/
# $options['drush_usage_log'] = TRUE;
# $options['drush_usage_send'] = TRUE;
/**
* By default, Drush will download projects compatibile with the current
* version of Drupal, or, if no Drupal site is specified, then the Drupal-7
* version of the project is downloaded. Set default-major to select a
* different default version.
*/
# $options['default-major'] = 6;
// Clone extensions (modules, themes, etc.) from drupal.org via 'pm-download'.
$options['package-handler'] = 'git_drupalorg';
/**
* Specify folders to search for Drush command files (*.drush.inc). These
* values are always merged with include paths defined on the command line or
* in other configuration files. On the command line, paths may be separated
* by a colon (:) on Unix-based systems or a semi-colon (;) on Windows.
*/
# $options['include'] = array('/path/to/commands','/path2/to/more/commands');
/**
* Specify the modules to ignore when searching for command files (*.drush.inc)
* inside a Drupal site.
*/
# $options['ignored-modules'] = array('module1', 'module2');
/**
* Specify the folders to search for Drush alias files (*.alias.drushrc.php and
* *.aliases.drushrc.php). These values are always merged with alias paths
* defined on the command line or in other configuration files. On the command
* line, paths may be separated by a colon (:) on Unix-based systems or a
* semi-colon (;) on Windows.
*/
# $options['alias-path'] = array('/path/to/aliases','/path2/to/more/aliases');
/**
* Specify the folder where 'sql-sync' should store persistent dump files.
* Keeping the dump files around improves the performance of rsync when the
* database is rsync'ed to a remote system. If a dump directory is not
* specified, then 'sql-sync' will store dumps in temporary files.
*/
# $options['dump-dir'] = '/path/to/dumpdir';
/**
* Specify the filename and path where 'sql-dump' should store backups of
* database dumps. The default is to dump to STDOUT, however if this option is
* set in a drushrc.php file, the default behaviour can be achieved by
* specifying a value of FALSE ("--result-file=0" on the command line). Two
* substitution tokens are available: @DATABASE is replaced with the name of the
* database being dumped, and @DATE is replaced with the current time and date
* of the dump of the form: YYYYMMDD_HHMMSS. A value of TRUE ("--result-file=1"
* on the command line) will cause 'sql-dump' to use the same temporary backup
* location as 'pm-updatecode'.
*/
# $options['result-file'] = TRUE;
# $options['result-file'] = '/path/to/backup/dir/@DATABASE_@DATE.sql';
// Enable verbose mode.
# $options['v'] = 1;
// Show database passwords in 'status' and 'sql-conf' commands.
# $options['show-passwords'] = 1;
/**
* Specify the logging level for PHP notices. Defaults to "notice". Set to
* "warning" when doing Drush development. Also make sure that error_reporting
* is set to E_ALL in your php configuration file. See `drush status` for the
* path to your php.ini file.
*/
# $options['php-notices'] = 'warning';
/**
* Specify options to pass to ssh in backend invoke. The default is to prohibit
* password authentication, and is included here, so you may add additional
* parameters without losing the default configuration.
*/
# $options['ssh-options'] = '-o PasswordAuthentication=no';
// Set 'remote-os' to 'Windows' to make Drush use Windows shell escape rules
// for remote sites that do not have an 'os' item set.
# $options['remote-os'] = 'Linux';
// By default, unknown options are disallowed and result in an error. Change
// them to issue only a warning and let command proceed.
# $options['strict'] = FALSE;
/**
* Drush requires at least rsync version 2.6.4 for some functions to work
* correctly. rsync version 2.6.8 or earlier may give the following error
* message: "--remove-source-files: unknown option". To fix this, set
* $options['rsync-version'] = '2.6.8'; (replace with the lowest version of
* rsync installed on any system you are using with Drush). Note that this
* option can also be set in a site alias, which is the prefered solution if
* newer versions of rsync are available on some of the systems you use.
* See: http://drupal.org/node/955092
*/
# $options['rsync-version'] = '2.6.9';
/**
* The output charset suitable to pass to the iconv PHP function's out_charset
* parameter.
*
* Drush will convert its output from UTF-8 to the charset specified here. It
* is possible to use //TRANSLIT and //IGNORE charset name suffixes (see iconv
* documentation). If not defined, conversion will not be performed.
*/
# $options['output_charset'] = 'ISO-8859-1';
# $options['output_charset'] = 'KOI8-R//IGNORE';
# $options['output_charset'] = 'ISO-8859-1//TRANSLIT';
/**
* Multiple-site execution options:
*
* Some drush commands such as 'sql-sync' are intended for or capable of being
* executed on multiple sites or server environments and will pass along the
* options specified here to all instances of the command being executed.
*/
/**
* By default, Drush will prepend the name of the site to the output of any
* multiple-site command execution. To disable this behavior, set the
* "--no-label" option.
*/
# $options['no-label'] = TRUE;
/**
* List of tables whose *data* is skipped by the 'sql-dump' and 'sql-sync'
* commands when the "--structure-tables-key=common" option is provided.
* You may add specific tables to the existing array or add a new element.
*/
# $options['structure-tables']['common'] = array('cache', 'cache_filter', 'cache_menu', 'cache_page', 'history', 'sessions', 'watchdog');
/**
* List of tables to be omitted entirely from SQL dumps made by the 'sql-dump'
* and 'sql-sync' commands when the "--skip-tables-key=common" option is
* provided on the command line. This is useful if your database contains
* non-Drupal tables used by some other application or during a migration for
* example. You may add new tables to the existing array or add a new element.
*/
# $options['skip-tables']['common'] = array('migration_data1', 'migration_data2');
/**
* Override specific entries in Drupal's 'variable' table or settings.php
*/
# $options['variables']['site_name'] = 'My Drupal site';
# $options['variables']['theme_default'] = 'minnelli';
# $options['variables']['anonymous'] = 'Visitor';
/**
* Command-specific execution options:
*
* Most execution options can be shared between multiple Drush commands; these
* are specified as top-level elements of the $options array in the prior
* examples above. On the other hand, other options are command-specific, and,
* in some cases, a shared option needs a different configuration depending on
* which command is being executing.
*
* To define options that are only applicable to certain commands, make an entry
* in the $command-specific array as shown below. The name of the command may
* be either the command's full name or any of the command's aliases.
*
* Options defined here will be overridden by options of the same name on the
* command line. Unary flags such as "--verbose" are overridden via special
* "--no-xxx" options (e.g. "--no-verbose").
*
* Limitation: If 'verbose' is set in a command-specific option, it must be
* cleared by '--no-verbose', not '--no-v', and visa-versa.
*/
// Ensure all rsync commands use verbose output.
# $command_specific['rsync'] = array('verbose' => TRUE);
// CVS credentials for module dowlnoads.
# $command_specific['dl'] = array('cvscredentials' => 'user:pass');
// Additional folders to search for scripts.
// Separate by : (Unix-based systems) or ; (Windows).
# $command_specific['script']['script-path'] = 'sites/all/scripts:profiles/myprofile/scripts';
// Always show release notes when running pm-update or pm-updatecode.
# $command_specific['pm-update'] = array('notes' => TRUE);
# $command_specific['pm-updatecode'] = array('notes' => TRUE);
// Set a predetermined username and password when using site-install.
# $command_specific['site-install'] = array('account-name' => 'alice', 'account-pass' => 'secret');
/**
* List of Drush commands or aliases that should override built-in shell
* functions and commands; otherwise, built-ins override Drush commands. Default
* is 'help,dd,sa'. Warning: bad things can happen if you put the wrong thing
* here (e.g. eval, grep), so be cautious. If a Drush command overrides a
* built-in command (e.g. bash help), then you can use the `builtin` operator
* to run the built-in version (e.g. `builtin help` to show bash help instead of
* Drush help.) If a Drush command overrides a shell command (e.g. grep), then
* you can use the regular shell command by typing in the full path to the
* command (e.g. /bin/grep).
*/
# $command_specific['core-cli'] = array('override' => 'help,dd,sa');
/**
* Load a drushrc file from the 'drush' folder at the root of the current
* git repository. Example script below by grayside. Customize as desired.
* @see: http://grayside.org/node/93.
*/
#exec('git rev-parse --git-dir 2> /dev/null', $output);
#if (!empty($output)) {
# $repo = $output[0];
# $options['config'] = $repo . '/../drush/drushrc.php';
# $options['include'] = $repo . '/../drush/commands';
# $options['alias-path'] = $repo . '/../drush/aliases';
#}
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment