Drush的官方说明译文

1、Drush的官方说明译文Drush是一款以命令行方式和Unix脚本界面管理Drupal的软件。Drush使有许多非常有用的命令来处理Drupal维护工作，这些命令主要用于与Drupal的交互，例如与模块、主题、资料等方面的交互。类似地，它也可以运行update.php（用于升级或更新Drupal核心的脚本），使用SQL查询或者数据库迁移，还可以运行cron、清除缓存等一些杂项功能等等。如果你对“命令行”不太熟悉，可以尝试看看“命令行”的文档（例如：man bash）或者阅读网上教程（例如搜索“bash 教程”），预先熟悉这些内容将对你学习Drush会有相当大的帮助。Drush版本每一个版本都能

2、兼容一种或两种Drupal版本，现时推荐使用Drush6版。Drush版本分支PHP要求兼容Drupal版本代码状态Drush 7master5.3.3+D6, D7, D8Drush 66.x5.3.3+D6, D7Drush 55.x5.2.0+D6, D7Drush 44.x5.2.0+D5, D6, D7不再支持Drush 33.x5.2.0+D5, D6不再支持Drush基于PHPUnit创建，经过多次测试，每一项功能都能正常运行。使用说明Drush使用相当简单，你只需在Drupal根目录下运行相应的代码则可，例如：（options:选项,command:命令,argument:参数

3、)$ drush options argument1 argument2使用Help命令可以获取一张所有选项和命令的清单：$ drush help如果还想获取更多详细信息，可以键入topic命令：$ drush topic如果想知道如何安装Drush，请继续看下面内容。如果想获取各版本的文档说明，请到Drush官网： 查阅。获取帮助在您通过下面途径获取帮助之前，请把本文阅读完，这有利于您清楚描述问题，快速获得帮助。在drupal问答区drush版块提问。如希望提交BUG或申请新功能，请到github的问题区发表。使用PRs(抽取请求)帮助Drush，详情查

4、看：/CONTRIBUTING.md您还可以在(drupal官网）,查找较旧的问题清单：修复错误，未迁移问题，未迁移错误，等等。（Drush项目最初是在Drupal官网上维护，现在迁移至Github）杂项信息官网地址：通过Feed：一份整合了Drush的模块清单。如需获取更多信息，请查看drush官网的资源频道和问答频道，也可以使用drush topic命令获取更多的帮助信息。如果您正在使用Debian或者Ubuntu，推荐使用Debian的安装包，如果您正使用LTS或“稳定版”，并且想获取最新版本的Drush，你可能要在backports中查找。

5、如果您想获取与ISP相关的操作资料，可以在drush官网的“主机操作信息”频道获取。使用要求拥有一个可以运行命令行的PHP，且版本大于5.3.3Drush需要配合Git软件运行，请安装大于1.7版的Git推荐使用Unix类型的运行环境（如Linux,OS X）大多数命令也可以运行于Windows系统，请查看本文“在Widnows下安装Drush”章节通过PEAR安装Drush如果您在使用PEAR安装Drush中遇到困难，您可以考虑查看“手动安装Drush”章节，实际操作起来并不困难。pear channel-discover -bash: pear: command

6、 not foundyum install php-devel php-pear httpd-develpear install drush/drush如果在安装中遇到权限问题，请尝试使用sudo方式运行；如果通过channel-discover方式不能获取Drush，可以尝试使用以下命令：pear upgrade -force Console_Getoptpear upgrade -force pearpear upgrade-allcd /www/web/yalujiang198_cn/public_htmlrootmytestserver public_html# drush upCom

7、mand pm-update needs a higher bootstrap level to run - you will need to invoke drush from a more functional Drupal errorenvironment to run this command.Command pm-update needs the following modules installed/enabled to run: update. errorThe drush command up could not be executed. errorDrush was not

8、able to start (bootstrap) the Drupal database. errorHint: This may occur when Drush is trying to: * bootstrap a site that has not been installed or does not have a configured database. In this case you can selectanother site with a working database setup by specifying the URI to use with the -uri pa

9、rameter on the command line.See drush topic docs-aliases for details. * connect the database through a socket. The socket file may be wrong or the php-cli may have no access to it in ajailed shell. See /node/1428638 for details.Drush was attempting to connect to: Drupal version : 7.2

10、8 Site URI : http:/default Database driver : mysql Database username : yalujiang198 Database name : yalujiang198 Default theme : garland Administration theme : garland PHP executable : /usr/bin/php PHP configuration : /etc/php.ini PHP OS : Linux Drush version : 6.2.0 Drush configuration : Drush alia

11、s files : Drupal root : /www/web/yalujiang198_cn/public_html Site path : sites/default File directory path : sites/default/files cd /etcmkdir drushvi /etc/drush/drush.inierror_reporting = E_ALL | E_NOTICE | E_STRICT如果日后需要升级Drush，使用 pear upgrade drush/drush 命令进行升级即可。想获取指定版本的Drush，可以使用下面代码，并把版本号替找成你需要

12、的版本（发挥想象力）即可。pear install drush/drush-5.0.0pear install drush/drush-6.0.0RC4请往下看“配置Drush”章节获取有关配置Drush的信息。手动安装Drush下载并上传Drush的安装包（drush.tar.gz,drush.zip,或者git下载），放置在网站目录之外。给drush程序添加执行权限$ chmod u+x /path/to/drush/drush告诉系统Drush程序在那里，有三种方法：把drush程序连接到您系统的程序库中，如：$ ln -s /path/to/drush/drush /usr/bin/d

13、rush在命令行配置文件中（.profile, .bash_profile, .bash_aliases, 或.bashrc，一般存在于您的用户文件夹中，如home,root等）添加Drush的文件夹路径：export PATH=$PATH:/path/to/drush:/usr/local/bin系统会从命令的左边第一个路径开始查找，直到找到为止。为Drush指定一个“指令别名”（这种方法特别适合使用两个或以上不同版本的Drush，例如您可能使用Drush6（稳定版）用于管理Drupal6和Drupal7，Drush7（开发版）用于管理Drupal8）。指定一个执行Drush7的“指令别名”

14、的方法很简单，就是在命令行配置文件（请看前面第二条）中添加下面这条代码：$ alias drush-master=/path/to/drush/drush第2和3条中，修改完文件后还需要重新登陆系统或者使用下面命令重新加载bash配置文件，以使修改生效：$ source .bashrc注意：如果您不操作上述上内容，那您以后运行drush必须键入drush的完整路径，例如：/path/to/drush/drush，或者需要进入drush的目录中运行./drush，而且 -r 和 -l 参数必须强制要求输入（查看下面“使用说明”）。使用下面命令确认drush已被系统找到：$ which drush

15、关于如何配置Drush，请看“配置Drush”章节。wdcp面板环境下（php 5.3.27已升级为5.5.9），drush的安装位置为 /usr/share/pear/drush 并通过软连接指向 /usr/bin/drushplete.sh 文件已存在，位于 /usr/share/pear/drush/plete.shvi /root/.bashrc 将内容改用原有内容为# .bashrc# User specific aliases and functionsalias rm=rm -i#alias cp=cp -ialias mv=mv -i# Source global defini

16、tionsif -f /etc/bashrc ; then . /etc/bashrcfi可能需要保留，否则命令行提示符会由 rootmytestserver # 改变为 -bash-4.1#然后打开/usr/local/php/share/pear/drush/（这个文件夹视你的PHP安装地址而定），新建一个aliases.drushrc.php文件，并复制类似下面的内容#lc是在使用use命令时输入，例如：use lc $aliaseslc = array( # 输入你的URL地址 uri = , #输入你网站的绝对路径 root = /www/web/mydrush_com/public

17、_html, #以下注释内容视情况使用，用于远程登陆# db-url = pgsql:/username:password:port/databasename, # remote-host = , # remote-user = root, os = Linux, path-aliases = array( #请认真查找以下地址，不要搞错了哦。 %drush = /usr/share/pear/drush, %drush-script = /usr/share/pear/drush/drush.php, %dump-dir = /usr/share/pear/drush/dumps/, %fi

18、les = /www/web/mydrush_com/public_html/sites/default/files, %custom = /usr/share/pear/drush/custom, ), databases = array ( default = array ( default = array ( driver = mysql, username = mydrush, password = mydrush, port = , host = , database = mydrush, ), ), ), variables = array( #站点名称 site

19、_name = mydrush, ), command-specific = array ( sql-sync = array ( no-cache = TRUE, ), ), # This shell alias will run mycommand when executed via drush stage site-specific-alias # shell-aliases = array ( # site-specific-alias = !mycommand, # ), );-bash-4.1# drush status PHP executable : /usr/bin/php

20、PHP configuration : /etc/php.ini PHP OS : Linux Drush version : 6.2.0 Drush configuration : Drush alias files : /usr/share/pear/drush/includes/./aliases.drushrc.php -bash-4.1#配置Drush查看“examle.bashrc”样板，了解如何添加“指令别名”，使得Drush与bash更亲密地结合在一起。您可以从Drush源代码中/你/的/drush/路径/example/example.bashrc找到这文件，把它复制到系统命

21、令行.bashrc文件中（或者相似文件）。如果您在上述步骤找不到配置文件，您可以查看plete.sh顶部有关如何添加drush进系统bash中的说明。一旦您完成了这些配置，那么网站的指令别名、命令名、命令行指令别名、全局参数和命令指定参数都全部配置完成！（可选操作）如果plete.sh已经导入系统（理想情况下，它会出现在bash_completetion.d），您可以使用_drush_ps1() 命令函数来添加您要管理的drush网站（使用drush use 网站名 命令切换应用的网站）在您的PS1函数中，如：if $(type -t _git_ps1) & $(type -t _drush_

22、ps1) ; then PS1=uh w$(_git_ps1 (%s)$(_drush_ps1 %s)$ fi把下面这行放进.bashrc .bash_profile .profile任意一个文件中：msonnabaumhostname /repos/drush (master)sitename$为了帮助Drush日后的发展，请提交使用的统计数据，您只需把下面这两行代码放进.drushrc.php文件中，Drush就会自动上传使用统计数据：$optionsdrush_usage_log = TRUE;$optionsdrush_usage_send = TRUE;运行记录会保存在本地文件中并随

23、时反馈给Drush，即使这些日志记录超过50kb。您可以选择关闭这项自动上传功能，使用手动的usage-show和usage-send命令代替自动上传，这可以更小心地发送不敏感的数据。MAMP的附加设置用户如果使用MAMP（mac apache mysql php)作为运行Drupal的环境，那么需要在命令行环境中指定PHP和Mysql的PATH，依据不同的MAMP程序的PHP版本进行设置。在OS X系统下，用户文件夹中（home）编辑（或者创建）一个叫.bash_profile的文件，依PHP版本添加下面内容。使用PHP5.3则添加下面这行：export PATH=/Applications

24、/MAMP/Library/bin:/Applications/MAMP/bin/php5.3/bin:$PATH使用PHP5.4则添加下面这行：export PATH=/Applications/MAMP/Library/bin:/Applications/MAMP/bin/php5.4/bin:$PATH如果您使用低于1.84版本的MAMP，则添加下面这行：export PATH=/Applications/MAMP/Library/bin:/Applications/MAMP/bin/php5/bin:$PATH如果您按上面提示添加了相应的代码，PDO:_construct仍然提示您“找

25、不到文件或文件夹”，尝试使用下面这两行命令：sudo mkdir /var/mysqlsudo ln -s /Applications/MAMP/tmp/mysql/mysql.sock /var/mysql/mysql.sock一般来说，在您设置以上内容之前还需要对php.ini文件进行配置，否则可能会运行失败，请继续查看下面“php.ini配置”章节其它AMP的附加设置如果您正使用如XAMPP类似的安装包或者Acquias Dev Desktop安装包，那么您就必要让系统找到您的PHP运行程序，方法就是向系统提交一个PHP路径的变量（看前面的“手动安装”3.2章），AMP的版本不同，PHP

26、的路径可能也会不同，但下面路径一般是正确的：PathApplicationApplications/acquia-drupal/php/bin AcquiaDev Desktop (Mac)/Applications/xampp/xamppfiles/binXAMP (Mac)/opt/lampp/binXAMPP (Windows)一般来说，在做这张些之前您还需要对php.ini进行配置，请查看“php.ini配置”章节。使用指定的PHP版本运行drush如果您想使用网站运行的PHP之外的版本，您可以向系统添加一个环境变量，系统的环境变量配置文件一般会称为：.profile, .bash_p

27、rofile, .bash_aliases, 或者 .bashrc，这些文件一般能在用户文件夹中找到，并添加下面这行代码：export DRUSH_PHP=/path/to/phpwdcp:vi /root/.profile export DRUSH_PHP= /www/wdlinux/php/binphp.ini配置一般来说，PHP的网站运行和命令行运行是使用不同的php.ini配置文件，请保证PHP命令行运行环境拥有跟网站运行环境一样的内存容量，否则Drupal可能会在运行Drush时候崩溃。想查看Drush正在使用何种版本PHP，请使用下面代码：$ drush status想查看网站运行

28、环境使用何种版本PHP,请在php文件中使用phpinfo()函数进行输出。您可以查看官网的教程：/node/207036如果Drush正使用与网站运行环境一样的php.ini文件，那么您可以为Drush创建一个专用的php.ini文件，您只需把网站运行使用的php.ini文件复制一份，并放到$HOME/.dursh或者/etc/drush文件夹中，然后对此php.ini进行一些修改就可以了。这种“分开使用php.ini”的方法有利于运行Drush时保证网站运行稳定。如果您只想覆写一些变量，您可以在/example文件夹中复制一份example.drush.in

29、i，然后放到$HOME/.drush或者/etc/drush文件夹中，并修改以适应您的Drush，这文件头部的注释部份有更多相关配置的说明。为了更好地运行Drush，您还需要向系统提交以下几个环境变量：export PHP_INI=/path/to/php.iniexport DRUSH_INI=/path/to/drush.iniexport PHP_OPTIONS=-d memory_limit=128Mcentos wdcp环境下：vi /etc/profile 。 export PHP_INI=/www/wdlinux/etc/php.iniexport DRUSH_INI= /etc

30、/drush/drush.iniexport DRUSH_PHP= /www/wdlinux/php/bin/phpexport PHP_OPTIONS=-d memory_limit=128Mexport PATH 要使修改的环境变量马上生效，需要执行以下代码rootCentOS # source /etc/profile drush status PHP executable : /www/wdlinux/php/bin/php PHP configuration : /www/wdlinux/apache_php-5.5.9/etc/php.ini /etc/drush/drush.in

31、i /etc/drush/drush.ini PHP OS : Linux Drush version : 6.2.0 Drush configuration : Drush alias files : /usr/share/pear/drush/includes/./aliases.drushrc.php 设置这三个环境变量后（使用完整路径的php.ini或drush.ini），Drush和网站就使用了不同的php.ini文件，如果某天您想使用不同的php.ini文件，您只需像这样另外指定一个路径就可以了。Drush需要一个相对自由的运行环境，特别地，您应该保证safe_mode, open

32、_basedir, disable_function和diable_classes被清除，而且如果您正使用PHP5.3.x，您还需要在php.ini文件中添加下面代码：magic_quotes_gpc = Offmagic_quotes_runtime = Offmagic_quotes_sybase = Off在Windows下安装DrushDrush在Windows环境下得到了许多改进，但依然落后于其它环境。如果您想使用功能完整的Drush，建议在Linux/Unix/OSX环境（您可以在Windows上运行个虚拟机安装）。这里有一个Drush的MSI安装包：http:/www.drush

33、.org/drush_windows_installer请认真查看该页以获取更多有关Windows下运行Drush的信息。在Windows环境下，无论帮助文档还是使用文档，只要涉及到“drush option”命令，你都要把drush换成drush.batDrush的Windows安装文档可以在这里找到：/node/594744大多数Drush命令都可以运行于Widnows CMD或者PowerShell。但是我们推荐使用Git Bash命令行环境，使用“Git Windows安装包”即可以安装。想了解更多“Git For Windows”，可以Click入这里

34、查看：当为远程Windows环境配置“指令别名”时，请特别阅读example.aliases.drushrc.php文件中的信息，特别是当设置变量给远程主机或者系统时，这些设置对运行drush rsync 和 drush sql-sync命令非常重要。其它如果您正使用多个站点，那么在您使用Drush命令的时候必须附上 -l 选项，这个选项用于指定您命令作用于那个网站。如果您命令行当前并不在网站的根目录下，您还需要使用-r选面指定网站根目录。如果您不使用-l（后跟一个URL）选项，那么Drush就会自动使用默认设置的网站，Drupal的全局变量$GLOBALbse_url将设置成http:/de

35、fault，这将会引起一些功能失效。$ drush -l pm-update关联选项-r , -root=Drupal root directory to use (defaults to current directory or anywhere in a Drupal directory tree)-l , -uri=URI of the Drupal site to use-v, -verboseDisplay verbose output.一些强劲的脚本会消耗掉您所有的PHP缓存，解决办法就是使用Bash自动重启，例如：while true; do drush search-index

36、; sleep 5; doneDrush配置文件在example文件夹中你会找到一些配置文件的样板（example.drushrc.php），您可以尝试修改这些样板匹配您的使用环境，这会省心不少，网站别名定义（example.aliases.drushrc.php）和Drush命令（sandwich.drush.inc）。你也可以查看policy样板文件，这个文件可以用于自定义命令或者参数，以适应您或您单位的需要。DRUSHRC.PHP如果您对输入参数感到十分厌倦，您可以使用一个drushrc.php文件去定义默认参数，多个Drush的配置文件都能提供十分灵活的参数配置以适应不同的网站或者单源

37、多站。查看example.drushrc.php样板和里面的安装详解。网站别名Drush可以在一个远程服务器上运行命令，也可以在一列远程服务器运行命令。定义方法就是一个符号加一个术语，如：# Synchronize staging files to production$ drush rsync staging:%files/ live:%files# Syncronize database from production to dev, excluding the cache table$ drush sql-sync -structure-tables-key=custom -no-cac

38、he live dev查看：/node/670460和example.aliases.drushrc.php获取更多的信息。自定义命令Drush可以扩展您的名令，书写一个自定义的命令并不比写一个Drupal复杂，它们都遵从一样的结构。Drush里有一个sandwich.drush.inc的文件，它可以帮助您了解一个命令是如何构建的。当然，Drush的核心命令也是一个非常好的学习样板。您可以把您的Drush自定义命令放到下面任意一个地方：随便放一个地方，然后在输入命令时使用 -include 参数指定命令文件（使用命令查看 drush topic docs-con

39、figuration）把它与模块放到一起与之关联，这是推荐使用的方法。放到用户文件夹的.drush文件夹里，一般没有这文件夹，需要自己创建。放到Drush全局命令环境中，如：/usr/share/drush/commands放到Drupal/drush或者sites/all/drush文件夹中，这个drush一般需要自己创建。请注意，文件名一定要使用.drush.inc名称结尾，这样才能让Drush找到这个文件。问答问：Drush 是什么意思？答：Drupal Shell，Drupal命令行问：Drush怎么读？答：Drush的读法依据个人喜好而不同，有的人喜欢像“Drupal”的读法一样，读

40、“猪斯”，也有的人读“抓斯”，我个人偏爱后者（译者：我也偏爱后者）。问：Drush有单元调试工具吗？答：Drush有一套十分正点的单元调试工具，在/tests文件夹里查看README.me文件，里有详细说明。Drush 常用命令网站上线：drush vset site_offline 0网站离线：drush vset site_offline 1更新所有模块，并执行数据库更新：drush up更新模块，不更新数据库：drushupc清空缓存：drush ccdrush up和drush upc同时升级core和第三方模块。drupal中使用drush命令，快速批量的开启和关闭模块 方法一：dr

41、ush pml -no-core -type=module -status=enabled -pipe modules.txt xargs -a modules.txt drush -y dis xargs -a modules.txt drush -y en这种方法执行disable和enable不会进行询问直接自动执行方法二：将所有启用模块保存下来：drush pm-list -no-core -type=module -status=enabled | awk /(/ & /)/ & ! /Ccore.*-.*Rrequired/ | sed s/.*(.*).*/1/ ModulesW

42、outCore禁用模块：drush pm-disable cat ModulesWoutCore启用模块：drush pm-enable cat ModulesWoutCore注意事项：1.为了使用Drush，必须先告诉Drush要操作哪个站点，一个最直接的方法是将当前目录转到要想操作的站点目录下，Drush就自动将操作应用于当前目录下的站点。2.升级会直接覆盖文件，改动过的文件，一定要做好备份。例如 robots.txt .htaccess ，模板，css 等3.升级后，文件被覆盖，文件权限被修改。要修改回正确的权限：chown -R ctohome:ctohome /your_docume

43、nt_rootDrush 升级drupal 范例：先给mysql数据库添加一个用户 updrupalrootwww # mysql -u root -pEnter password:输入root密码mysqlmysql第一种：增加一个用户test1密码为abc，让他可以在任何主机上登录，并对所有数据库有查询、插入、修改、删除的权限。首先用以root用户连入MYSQL，然后键入以下命令：grant select,insert,update,delete on *.* to test1“%” Identified by “abc”;但增加的用户是十分危险的，你想如某个人知道test1的密码，那么他

44、就可以在internet上的任何一台电脑上登录你的mysql数据库并对你的数据可以为所欲为了，解决办法见例第二种：第二种：增加一个用户test2密码为abc,让他只可以在localhost上登录，并可以对数据库mydb进行查询、插入、修改、删除的操作（localhost指本地主机，即MYSQL数据库所在的那台主机），这样用户即使用知道test2的密码，他也无法从internet上直接访问数mysql grant select,insert,update,delete on book.* to test2localhost Identified by abc;如果你不想test2有密码，可以再打

45、一个命令将密码消掉。mysql grant select,insert,update,delete on book.* to test2localhost Identified by ;更新Drupal 时 我们需要一个用户对wdcpdb数据库的wd_site表有select权限以便遍历网站，所以mysqlgrant select on wdcpdb.wd_site to updrupallocalhost Identified by updrupalmima;Query OK, 0 rows affected (0.00 sec)为确保生效，刷新一下权限mysql FLUSH PRIVILE

46、GES; Query OK, 0 rows affected (0.01 sec) 然后就可以使用新用户了rootwww # mysql -uupdrupal -pupdrupalmimaWelcome to the MySQL monitor. Commands end with ; or g.Your MySQL connection id is 2086Server version: 5.1.69 Source distributionCopyright (c) 2000, 2013, Oracle and/or its affiliates. All rights reserved.O

47、racle is a registered trademark of Oracle Corporation and/or itsaffiliates. Other names may be trademarks of their respectiveowners.Type help; or h for help. Type c to clear the current input statement.mysql重建你的开发环境1. make 把.makefile应用到Drupal系统。2. make-generate 从当前的Drupal系统创建.makefile。例子：从当前的目录创建 大连

48、外经协会和鸭绿江文化网的 make 文件rootyanhuang#cd /www/web/dlwjxh_com/public_htmlrootyanhuang public_html#drush generate-makefile /www/web/dlwjxh_com/drupal_dlwjxh_com_build.makerootyanhuang#cd /www/web/yljnet_com/public_htmlrootyanhuang public_html#drush generate-makefile www/web/yljnet_com/drupal_yljnet_com_bui

49、ld.make再添加一些Features(link is external)，你就能得到你自己的发行版。drupal中使用drush命令，快速批量的开启和关闭模块方法一：plain view plaincopyprint?1. drushpml-no-core-type=module-status=enabled-pipemodules.txt2. xargs-amodules.txtdrush-ydis3. xargs-amodules.txtdrush-yendrush pml -no-core -type=module -status=enabled -pipe modules.txtxargs -a modules.txt drush -y disxargs -a