example.drushrc.php 9.8 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230
  1. <?php
  2. /*
  3. * Examples of valid statements for a drushrc.php file. Use this file to cut down on
  4. * typing of options and avoid mistakes.
  5. *
  6. * Rename this file to drushrc.php and optionally copy it to one of
  7. * five convenient places, listed below in order of precedence:
  8. *
  9. * 1. Drupal site folder (e.g sites/{default|example.com}/drushrc.php).
  10. * 2. Drupal installation root.
  11. * 3. In any location, as specified by the --config (-c) option.
  12. * 4. User's .drush folder (i.e. ~/.drush/drushrc.php).
  13. * 5. System wide configuration folder (e.g. /etc/drush/drushrc.php).
  14. * 6. Drush installation folder.
  15. *
  16. * If a configuration file is found in any of the above locations, it
  17. * will be loaded and merged with other configuration files in the
  18. * search list.
  19. *
  20. * IMPORTANT NOTE on configuration file loading:
  21. *
  22. * At its core, drush works by "bootstrapping" the Drupal environment
  23. * in very much the same way that is done during a normal page request
  24. * from the web server, so most drush commands run in the context
  25. * of a fully-initialized website.
  26. *
  27. * Configuration files are loaded in the reverse order they are
  28. * shown above. Configuration files #6 through #3 are loaded immediately;
  29. * the configuration file stored in the Drupal root is loaded
  30. * when Drupal is initialized, and the configuration file stored
  31. * in the site folder is loaded when the site is initialized.
  32. *
  33. * This load order means that in a multi-site environment, the
  34. * configuration file stored in the site folder will only be
  35. * available for commands that operate on that one particular
  36. * site. Additionally, there are some drush commands such as
  37. * pm-download do not bootstrap a drupal environment at all,
  38. * and therefore only have access to configuration files #6 - #3.
  39. * The drush commands 'rsync' and 'sql-sync' are special cases.
  40. * These commands will load the configuration file for the site
  41. * specified by the source parameter; however, they do not
  42. * load the configuration file for the site specified by the
  43. * destination parameter, nor do they load configuration files
  44. * for remote sites.
  45. *
  46. * See `drush topic docs-bootstrap` for more information on how
  47. * bootstrapping affects the loading of drush configuration files.
  48. */
  49. // Specify a particular multisite.
  50. # $options['l'] = 'http://example.com/subir';
  51. // Specify your Drupal core base directory (useful if you use symlinks).
  52. # $options['r'] = '/home/USER/workspace/drupal-6';
  53. // Load a drushrc.php configuration file from the current working directory.
  54. # $options['c'] = '.';
  55. // You should not use drush-4.x on Windows; upgrade to the 5.x branch.
  56. // If you are really sure that you want to ignore this advice, you may
  57. // still disable the warning by setting the 'check_os' setting to the
  58. // special value shown below.
  59. # $options['check_os'] = 'i-want-4.x';
  60. // Control automatically check for updates in pm-updatecode and drush version.
  61. // FALSE = never check for updates. 'head' = allow updates to drush-HEAD.
  62. // TRUE (default) = allow updates to latest stable release.
  63. # $options['self-update'] = FALSE;
  64. // By default, drush will download projects compatibile with the
  65. // current version of Drupal, or, if no Drupal site is specified,
  66. // then the Drupal-7 version of the project is downloaded. Set
  67. // default-major to select a different default version.
  68. # $options['default-major'] = 6;
  69. // Specify CVS for checkouts
  70. # $options['package-handler'] = 'cvs';
  71. // Specify CVS credentials for checkouts (requires --package-handler=cvs)
  72. # $options['cvscredentials'] = 'name:password';
  73. // Specify additional directories to search for *.drush.inc files
  74. // Separate by : (Unix-based systems) or ; (Windows).
  75. # $options['i'] = 'sites/default:profiles/myprofile';
  76. // Specify additional directories to search for *.alias.drushrc.php
  77. // and *.aliases.drushrc.php files
  78. # $options['alias-path'] = '/path/to/aliases:/path2/to/more/aliases';
  79. // Specify directory where sql-sync will store persistent dump files.
  80. // Keeping the dump files around will improve the performance of rsync
  81. // when the database is rsync'ed to a remote system. If a dump directory
  82. // is not specified, then sql-sync will store dumps in temporary files.
  83. # $options['dump-dir'] = '/path/to/dumpdir';
  84. // Specify directory where sql-dump should store backups of database
  85. // dumps. @DATABASE is replaced with the name of the database being
  86. // dumped, and @DATE is replaced with the current time and date of the
  87. // dump. TRUE will cause sql-dump to use the same backup directory that
  88. // pm-updatecode does.
  89. //
  90. // If set, this can be explicitly overridden by specifying --result-file
  91. // on the commandline. The default behavior of dumping to
  92. // STDOUT can be achieved via --result-file=0
  93. # $options['result-file'] = '/path/to/backup/dir/@DATABASE_@DATE.sql';
  94. # $options['result-file'] = TRUE;
  95. // Enable verbose mode.
  96. # $options['v'] = 1;
  97. // Show database passwords in 'status' and 'sql-conf' commands
  98. # $options['show-passwords'] = 1;
  99. // Default logging level for php notices. Defaults to "notice"; set to "warning"
  100. // if doing drush development. Also make sure that error_reporting is set to E_ALL
  101. // in your php configuration file. See 'drush status' for the path to your php.ini file.
  102. # $options['php-notices'] = 'warning';
  103. // Specify options to pass to ssh in backend invoke. (Default is to prohibit password authentication; uncomment to change)
  104. # $options['ssh-options'] = '-o PasswordAuthentication=no';
  105. // rsync version 2.6.8 or earlier will give an error message:
  106. // "--remove-source-files: unknown option". To fix this, set
  107. // $options['rsync-version'] = '2.6.8'; (replace with the lowest
  108. // version of rsync installed on any system you are using with
  109. // drush). Note that drush requires at least rsync version 2.6.4
  110. // for some functions to work correctly.
  111. //
  112. // Note that this option can also be set in a site alias. This
  113. // is preferable if newer versions of rsync are available on some
  114. // of the systems you use.
  115. // See: http://drupal.org/node/955092
  116. # $options['rsync-version'] = '2.6.9';
  117. /*
  118. * The output charset suitable to pass to iconv PHP function as out_charset
  119. * parameter. Drush will convert its output from UTF-8 to the charset specified
  120. * here. It is possible to use //TRANSLIT and //IGNORE charset name suffixes
  121. * (see iconv documentation). If not defined conversion will not be performed.
  122. */
  123. # $options['output_charset'] = 'ISO-8859-1';
  124. # $options['output_charset'] = 'KOI8-R//IGNORE';
  125. # $options['output_charset'] = 'ISO-8859-1//TRANSLIT';
  126. /*
  127. * Multiple command execution options
  128. */
  129. // By default, drush will prepend the name of the
  130. // site to the output of any multiple-site command
  131. // execution. To disable this behavior, set the
  132. // --no-label option
  133. # $options['no-label'] = TRUE;
  134. /*
  135. * Customize this associative array with your own tables. This is the list of
  136. * tables whose *data* is skipped by the 'sql-dump' and 'sql-sync' commands when
  137. * a structure-tables-key is provided. You may add new tables to the existing
  138. * array or add a new element.
  139. */
  140. $options['structure-tables'] = array(
  141. 'common' => array('cache', 'cache_filter', 'cache_menu', 'cache_page', 'history', 'sessions', 'watchdog'),
  142. );
  143. /*
  144. * Customize this associative array with your own tables. This is the list of
  145. * tables that are entirely omitted by the 'sql-dump' and 'sql-sync' commands
  146. * when a skip-tables-key is provided. This is useful if your database contains
  147. * non Drupal tables used by some other application or during a migration for
  148. * example. You may add new tables to the existing array or add a new element.
  149. */
  150. $options['skip-tables'] = array(
  151. 'common' => array('migration_data1', 'migration_data2'),
  152. );
  153. /*
  154. * Command-specific options
  155. *
  156. * To define options that are only applicable to certain commands,
  157. * make an entry in the 'command-specific' structures as shown below.
  158. * The name of the command may be either the command's full name
  159. * or any of the command's aliases.
  160. *
  161. * Options defined here will be overridden by options of the same
  162. * name on the command line. Unary flags such as "--verbose" are overridden
  163. * via special "--no-xxx" options (e.g. "--no-verbose").
  164. *
  165. * Limitation: If 'verbose' is set in a command-specific option,
  166. * it must be cleared by '--no-verbose', not '--no-v', and visa-versa.
  167. */
  168. # $command_specific['rsync'] = array('verbose' => TRUE);
  169. # $command_specific['dl'] = array('cvscredentials' => 'user:pass');
  170. // Specify additional directories to search for scripts
  171. // Separate by : (Unix-based systems) or ; (Windows).
  172. # $command_specific['script']['script-path'] = 'sites/all/scripts:profiles/myprofile/scripts';
  173. // Always show release notes when running pm-update or pm-updatecode
  174. # $command_specific['pm-update'] = array('notes' => TRUE);
  175. # $command_specific['pm-updatecode'] = array('notes' => TRUE);
  176. // List of drush commands or aliases that should override built-in
  177. // shell functions and commands; otherwise, built-ins override drush
  178. // commands. Default is help,dd,sa.
  179. // Warning: bad things can happen if you put the wrong thing here
  180. // (e.g. eval, grep), so be cautious.
  181. // If a drush command overrides a built-in command (e.g. bash help),
  182. // then you can use the `builtin` operator to run the built-in version
  183. // (e.g. `builtin help` to show bash help instead of drush help.)
  184. // If a drush command overrides a shell command (e.g. grep), then
  185. // you can use the regular shell command by typing in the full path
  186. // to the command (e.g. /bin/grep).
  187. # $command_specific['core-cli'] = array('override' => 'help,dd,sa');
  188. /**
  189. * Variable overrides:
  190. *
  191. * To override specific entries in the 'variable' table for this site,
  192. * set them here. Any configuration setting from the 'variable'
  193. * table can be given a new value. We use the $override global here
  194. * to make sure that changes from settings.php can not wipe out these
  195. * settings.
  196. *
  197. * Remove the leading hash signs to enable.
  198. */
  199. # $override = array(
  200. # 'site_name' => 'My Drupal site',
  201. # 'theme_default' => 'minnelli',
  202. # 'anonymous' => 'Visitor',
  203. # );