Drush提示用户输入的三种方式

Wed, 05 Aug 2015 10:32:19 +0800

Drush是个能让Drupal变简单的好东西。他不仅带有大量的有用工具，同时为用户提供了接口，让用户可以轻松实现自己的命令。如果你需要为你的模块创建Drush命令，只要创建一个包含这些功能命令即可。

在这个教程中，我们会演示如何在这些命令中获取用户反馈。这里我不会提到参数或选项之类的东西。这里主要讲述的是，如何获取一个是或否的确认，或者如何提示用户进行一个选择。另外，我们也会说说如何获取用户输入的文本。

首先让我们看一下*drush_module_name_example_command()*这个回调函数：

  /**
   * Callback function for the example command
   */
  function drush_module_name_example_command() {
    // Command code we will look at
    drush_print('Hello world!');
  }

##确认

首先我们要试验的是如何获取用户的确认。在我们的例子中，我们会请用户确认是否显示内容，可以用Drush API这样实现：

if (drush_confirm('Are you sure you want \'Hello world\' printed to the screen?')) {
  drush_print('Hello world!');
}
else {
  drush_user_abort();
}

这里有两个新函数：*drush_confirm()*这个函数显示一个问题，并尝试从用户合理获取y或者n的反馈。如果回复是y，这个函数会返回true，意味着我们输出的提示获得了确认；如果回应是n，会调用*drush_user_abort()*。这也是推荐的中止Drush命令的方式。

##选项

接下来我们来看看，如何让用户从一系列列表中进行选择。在我们的超级例子Hello World中，我们将给用户提供一系列的选择，让用户决定Drush对谁说Hello。代码实现如下：

$options = array(
 'world' => 'World',
 'univers' => 'Univers',
 'planet' => 'Planet',
);

$choice = drush_choice($options, dt('Who do you want to say hello to?'));

if ($choice) {
  drush_print(dt('Hello @choice!', array('@choice' => $options[$choice])));
}

上面的代码是做什么的呢？首先，我们创建了一个用于保存选项的*$options*数组。这个数组的键和值分别是选项的机器名称和描述。然后我们调用*drush_choice()，两个参数分别是上面的$option*和用于提示用户的问题。

当命令运行时，这个函数会返回用户选择项目的代码。接下来我们判断这个值是否存在，然后输出这个字符串。我们利用$option数组获取到用户选择内容。

##用户输入内容

第三种输入是自由输入的文本。当然这类内容的输入应该进行更加严格的校验，防止恶意输入影响系统。下面我们提示用户来输入他想要问好的目标：

$value = drush_prompt(dt('Who do you want to say hello to?'));

drush_print(dt('Hello @value!', array('@value' =>  $value)));

这个例子非常简单。当命令运行时，*drush_prompt()*函数会在终端显示我们输入的字符串。返回值由用户输入，接下来我们会输出这个返回值。不过请注意这只是示例代码，在真正使用这一功能时，请对用户的输入进行严格的检查。

##结论

这里介绍了三种不同的获取用户输入的Drush。前两种属于最常用的方式，第三种也有他的用武之地。当然——注意安全！

如何用Drush Make完成日常任务

Wed, 05 Aug 2015 10:32:19 +0800

众所周知，Drupal Make在Drupal发行版的创建过程中具有重要作用，不过他对从来没有接触过发行版的人来说同样很有用，一个很好的例子就是《applying patches like a boss》。

本文中我会展示在日常工作中我如何实用Drush Make来达成一些自动化目的，同时帮助我发现一些有趣的Drupal窍门。

##Drush Make命令

Drush Make内置两个命令：

make：把”.makefile“转化为Drupal代码。
make-generate：从当前Drupal站生成”.makefile“。

两个命令都跟”.makefile“有关，它是一种包含Drush Make指令的文本文件。延伸阅读：.makefile语法

现在让我们开始深入一些学习Drush Make。

##重建开发环境

日常工作中，我们经常会因为开发、测试或者演示的需要来安装一个新的干净的Drupal站。除去核心之外，一般还需要安装一些其他的一系列惯用模块，例如Administration Menu, Views或者其他一些什么东西。有了Drush Make，就可以把这个过程自动化，把所有需要的项目都包含到一个文件里面。

下面是一个用于多语言测试的站点的.makefile

; Drush Make API version.
api = 2
; Drupal core.
core = 7.x

;Common modules.
projects[admin_menu][subdir] = "contrib"
projects[ctools][subdir] = "contrib"
projects[token][subdir] = "contrib"
projects[views][subdir] = "contrib"

; Development modules.
projects[devel][subdir] = "development"

; Multilingual modules.
projects[fallback_language_negotation][subdir] = "contrib"
projects[variable][subdir] = "contrib"
projects[i18n][subdir] = "contrib"
projects[i18nviews][subdir] = "contrib"

; Load some translations.
translations[] = de
translations[] = ru

这个文件可以在本地进行保存（例如在~/.drush/make-files/d7_i18n.make），也可以保存在远程服务器例如github。

可以执行make命令，通过这个文件在服务器上来创建我们的自定义环境（例如~/.drush/make-files/d7_i18n.make）

  $ drush make d7_i18n.make /var/www/drupal_test.local

第一次执行可能会比较耗时，不过以后Drush会利用缓存节省很多时间。

最后.makefile中指定的最新版本的Drupal core, 第三方模块以及翻译文件都会被下载，并放置到指定位置。接下来，可以进入该站点的网址来运行install.php，或者使用Drush进行安装：

  $ drush si --db-url="mysql://user:password@localhost/databasename" --site-name="Drupal Multilingual"

另外，还可以通过–tar选项，为.makefile生成tar包。

  $ drush make d7_i18n.make drupal_multilingual --tar

在其中加入一系列的Features(基于Features模块)，就建立了你自己的发行版。

##下载依赖关系

你有没有发现有些第三方模块提供了.make或者.make.example文件？这些通常包含了外部库的列表（例如Colorbox module中的jQuery Colorbox插件）。这些文件可以使用–no-core标志，在drupal站内部运行。例如我们要下载Chosen模块：

$ drush dl chosen Project chosen (7.x-2.0-beta4) downloaded to sites/all/modules/contrib/chosen. 
$ drush make sites/all/modules/contrib/chosen/chosen.make.example --no-core 
chosen downloaded from https://github.com/harvesthq/chosen/releases/download/v1.1.0/chosen_v1.1.0.zip

在上个例子中，会下载和解压jQuery插件到libraries文件夹中，这对使用者来说会非常方便。

所以这里建议模块开发者，如果你试用了外部库，请在你的Drupal.org项目中添加一个.make.example文件。还有其他办法也能达到这个目的，例如创建一个Drush命令chosen-plugin，这需要117行代码，而make的方式只需要7行代码。

##为现存网站生成makefile

利用Drush Make可以轻易的共享自定义的Drupal。首先在Drupal根目录运行generate-makefile命令：

$ drush generate-makefile drupal_custom_build.make

生成的drupal_custom_build.make文件中包含所有启用的项目版本的指令。如果一个项目中包含.git目录，Drush Make会自动设置相应的属性：

projects[redirect][type] = "module"
projects[redirect][download][type] = "git"
projects[redirect][download][url] = "http://git.drupal.org/project/redirect.git"
projects[redirect][download][branch] = "7.x-1.x"
projects[redirect][download][revision] = "0b7b8dc2d58cb277874d87c91c45f0a361e148f7"

生成的文件需要一些人工的审查工作。例如可以添加patch引用，在我的项目中为Redirect模块添加了两个补丁：

projects[redirect][patch][] = "https://drupal.org/files/issues/redirect-global-905914-145.patch" 
projects[redirect][patch][] = "https://drupal.org/files/issues/redirect.circular-loops.1796596-146.patch"

在你需要向其他同事共享你的工作环境，或为排错提供故障现场时，上面生成的.makefile会非常有用。

##帮助你探索Drupal世界

最后，Drush Make文件也是一个帮助用户了解发行版的工具。例如Commerce Kickstart或者OpenScholar中包含的众多有趣的项目。

最后，希望本文能够帮助读者更好的使用Drush，来完成日常任务，甚至建立自己的发行版。

drush | 伪架构师

Drush提示用户输入的三种方式

如何用Drush Make完成日常任务