Skip to content

Commit

Permalink
finish review commands.md
Browse files Browse the repository at this point in the history
  • Loading branch information
summerblue committed Feb 13, 2015
1 parent 7ffc7f2 commit 382670b
Show file tree
Hide file tree
Showing 18 changed files with 76 additions and 76 deletions.
4 changes: 2 additions & 2 deletions artisan.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@
<a name="introduction"></a>
## 介绍

Artisan 是 Laravel 内置的命令行接口。它提供了一些有用的指令协助您开发,它是由强大的 Symfony Console 组件所驱动。
Artisan 是 Laravel 内置的命令行接口。它提供了一些有用的命令协助您开发,它是由强大的 Symfony Console 组件所驱动。

<a name="usage"></a>
## 用法
Expand All @@ -27,7 +27,7 @@ Artisan 是 Laravel 内置的命令行接口。它提供了一些有用的指令

#### 指定环境配置

您可以指定要使用的环境配置,只要在执行指令时加上 `--env` 即可切换:
您可以指定要使用的环境配置,只要在执行命令时加上 `--env` 即可切换:

php artisan migrate --env=local

Expand Down
2 changes: 1 addition & 1 deletion bus.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,7 @@ Command bus 提供一个简便的方法来封装任务,使你的程序更加
<a name="creating-commands"></a>
## 建立命令

使用 `make:command` 这个 Artisan 指令可以产生一个新的命令类
使用 `make:command` 这个 Artisan 命令可以产生一个新的命令类

php artisan make:command PurchasePodcast

Expand Down
2 changes: 1 addition & 1 deletion collections.md
Original file line number Diff line number Diff line change
Expand Up @@ -25,7 +25,7 @@

#### 建立集合

如上述,`collect` 辅助方法将会用给定的数组返回一个新的 `Illuminate\Support\Collection` 实例。你也可以在 `Collection` 类上使用 `make` 指令
如上述,`collect` 辅助方法将会用给定的数组返回一个新的 `Illuminate\Support\Collection` 实例。你也可以在 `Collection` 类上使用 `make` 命令

$collection = collect([1, 2, 3]);

Expand Down
46 changes: 23 additions & 23 deletions commands.md
Original file line number Diff line number Diff line change
@@ -1,40 +1,40 @@
# Artisan 开发

- [简介](#introduction)
- [建立自订指令](#building-a-command)
- [注册自订指令](#registering-commands)
- [建立自定义命令](#building-a-command)
- [注册自定义命令](#registering-commands)

<a name="introduction"></a>
## 简介

除了 Artisan 本身提供的指令之外,您也可以为您的应用程序建立属于你自己的指令。你可以将自订指令存放在 `app/Console/commands` 目录底下;然而,您也可以任意选择存放位置,只要您的指令能够被 `composer.json` 自动加载。
除了 Artisan 本身提供的命令之外,您也可以为您的应用程序建立属于你自己的命令。你可以将自定义命令存放在 `app/Console/commands` 目录底下;然而,您也可以任意选择存放位置,只要您的命令能够被 `composer.json` 自动加载。

<a name="building-a-command"></a>
## 建立自订指令
## 建立自定义命令

### 自动创建类(Class)

要创建一个新的自订指令,您可以使用 `make:console` 这个 Artisan 指令,这将会自动产生一个 Command stub 协助您开始创建您的自订指令
要创建一个新的自定义命令,您可以使用 `make:console` 这个 Artisan 命令,这将会自动产生一个 Command stub 协助您开始创建您的自定义命令

#### 自动创建一个新的指令类
#### 自动创建一个新的命令类

php artisan make:console FooCommand

上面的指令将会协助你自动创建一个类,并保存为文件 `app/Console/FooCommand.php`
上面的命令将会协助你自动创建一个类,并保存为文件 `app/Console/FooCommand.php`

在创建自订指令时,加上 `--command` 这个选项,将可以指定之后在终端机使用此自订指令时,所要输入的自订指令名称
在创建自定义命令时,加上 `--command` 这个选项,将可以指定之后在终端机使用此自定义命令时,所要输入的自定义命令名称

php artisan make:console AssignUsers --command=users:assign

### 撰写自订指令
### 撰写自定义命令

一旦你的自订指令被创建后,你需要填写自订指令的 `名称(name)``描述(description)`,您所填写的内容将会被显示在 Artisan 的 `list` 画面中。
一旦你的自定义命令被创建后,你需要填写自定义命令的 `名称(name)``描述(description)`,您所填写的内容将会被显示在 Artisan 的 `list` 画面中。

当您的自订指令被执行时,将会调用 `fire` 方法,您可以在此为自订指令加入任何的逻辑判断
当您的自定义命令被执行时,将会调用 `fire` 方法,您可以在此为自定义命令加入任何的逻辑判断

### 参数与选项

你可以透过 `getArguments``getOptions` 为自订指令自行定义任何需要的参数与选项。这两个方法都会返回一组指令数组,并由选项数组的清单所组成。
你可以透过 `getArguments``getOptions` 为自定义命令自行定义任何需要的参数与选项。这两个方法都会返回一组命令数组,并由选项数组的清单所组成。

当定义 `arguments` 时,该数组值的定义分别如下:

Expand All @@ -48,7 +48,7 @@

对选项而言,参数 `mode` 可以是下列其中一项:`InputOption::VALUE_REQUIRED`, `InputOption::VALUE_OPTIONAL`, `InputOption::VALUE_IS_ARRAY`, `InputOption::VALUE_NONE`

模式为 `VALUE_IS_ARRAY` 表示调用指令时可以多次使用此选项来传入多个值
模式为 `VALUE_IS_ARRAY` 表示调用命令时可以多次使用此选项来传入多个值

php artisan foo --option=bar --option=baz

Expand All @@ -58,21 +58,21 @@

### 取得输入值(参数与选项)

当您的自订指令执行时,您需要让您的应用程序可以访问到这些参数和选项的值,要做到这一点,您可以使用 `argument``option` 方法:
当您的自定义命令执行时,您需要让您的应用程序可以访问到这些参数和选项的值,要做到这一点,您可以使用 `argument``option` 方法:

#### 取得自订指令被输入的参数
#### 取得自定义命令被输入的参数

$value = $this->argument('name');

#### 取得自订指令被输入的所有参数
#### 取得自定义命令被输入的所有参数

$arguments = $this->argument();

#### 取得自订指令被输入的选项
#### 取得自定义命令被输入的选项

$value = $this->option('name');

#### 取得自订指令被输入的所有选项
#### 取得自定义命令被输入的所有选项

$options = $this->option();

Expand Down Expand Up @@ -111,15 +111,15 @@

$this->confirm($question, true);

### 调用其它指令
### 调用其它命令

有时候您可能希望在您的指令内部调用其它指令,此时您可以使用 `call` 方法:
有时候您可能希望在您的命令内部调用其它命令,此时您可以使用 `call` 方法:

$this->call('command:name', ['argument' => 'foo', '--option' => 'bar']);

<a name="registering-commands"></a>
## 注册自订指令
## 注册自定义命令

#### 注册一个 Artisan 指令
#### 注册一个 Artisan 命令

一旦你的自订指令撰写完成后,你需要将它注册于 Artisan 它才能被使用。这通常位于 `app/Console/Kernel.php` 这个文件中。在此文件的 `commands` 属性,你会找到一份指令的清单。若要注册你的自订指令,很简单的你只要将它加入清单中。当 Artisan 启动时,被列于此属性中的所有指令都将被 [IoC container](/docs/5.0/container) 解析,并且被注册于 Artisan 。
一旦你的自定义命令撰写完成后,你需要将它注册于 Artisan 它才能被使用。这通常位于 `app/Console/Kernel.php` 这个文件中。在此文件的 `commands` 属性,你会找到一份命令的清单。若要注册你的自定义命令,很简单的你只要将它加入清单中。当 Artisan 启动时,被列于此属性中的所有命令都将被 [IoC container](/docs/5.0/container) 解析,并且被注册于 Artisan 。
12 changes: 6 additions & 6 deletions configuration.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,9 +18,9 @@

### 命名你的应用程序

在安装完成 Laravel 后,你可以「命名」你的应用程序。默认情况下,`app` 的目录是命名在 `App` 下,通过 Composer 使用 [PSR-4 autoloading standard](http://www.php-f通过ig.org/psr/psr-4/) 自动加载。不过,你可以轻松地通过 Artisan 指令 `app:name` 来修改命名空间,以配合你的应用程序名称。
在安装完成 Laravel 后,你可以「命名」你的应用程序。默认情况下,`app` 的目录是命名在 `App` 下,通过 Composer 使用 [PSR-4 autoloading standard](http://www.php-f通过ig.org/psr/psr-4/) 自动加载。不过,你可以轻松地通过 Artisan 命令 `app:name` 来修改命名空间,以配合你的应用程序名称。

举例来说,假设你的应用程序叫做「 Horsefly 」,你可以从安装的根目录执行下面的指令
举例来说,假设你的应用程序叫做「 Horsefly 」,你可以从安装的根目录执行下面的命令

php artisan app:name Horsefly

Expand Down Expand Up @@ -94,20 +94,20 @@ Laravel 通过 [DotEnv](https://github.com/vlucas/phpdotenv) PHP library by Vanc
<a name="configuration-caching"></a>
## 设置缓存

为了让你的的应用程序提升一些速度,你可以使用 Artisan 指令 `config:cache` 将所有的配置文件暂存到单一文件。通过指令会将所有的设置选项合并成一个文件,让框架能够快速加载。
为了让你的的应用程序提升一些速度,你可以使用 Artisan 命令 `config:cache` 将所有的配置文件暂存到单一文件。通过命令会将所有的设置选项合并成一个文件,让框架能够快速加载。

通常来说,你应该将执行 `config:cache` 指令作为部署工作的一部分
通常来说,你应该将执行 `config:cache` 命令作为部署工作的一部分

<a name="maintenance-mode"></a>
## 维护模式

当你的应用程序处于维护模式时,所有的路由都会指向一个自定的视图。当你要更新或进行维护作业时,「关闭」整个网站是很简单的。维护模式会检查包含在应用程序的默认中间层堆叠。如果应用程序处于维护模式,`HttpException` 会抛出 503 的状态码。

启用维护模式,只需要执行 Artisan 指令 `down`
启用维护模式,只需要执行 Artisan 命令 `down`

php artisan down

关闭维护模式,请使用 Artisan 指令 `up`
关闭维护模式,请使用 Artisan 命令 `up`

php artisan up

Expand Down
8 changes: 4 additions & 4 deletions controllers.md
Original file line number Diff line number Diff line change
Expand Up @@ -138,7 +138,7 @@ Laravel 让你能轻易地定义单一路由来处理控制器中的每一项行
<a name="restful-resource-controllers"></a>
## RESTful 资源控制器

资源控制器可让你无痛建立和资源相关的 RESTful 控制器。例如,你可能希望创建一个控制器,它可用来处理针对你的应用程序所保存相片的 HTTP 请求。我们可以使用 `make:controller` Artisan 指令,快速创建这样的控制器:
资源控制器可让你无痛建立和资源相关的 RESTful 控制器。例如,你可能希望创建一个控制器,它可用来处理针对你的应用程序所保存相片的 HTTP 请求。我们可以使用 `make:controller` Artisan 命令,快速创建这样的控制器:

php artisan make:controller PhotoController

Expand Down Expand Up @@ -295,12 +295,12 @@ Laravel [服务容器](/docs/5.0/container) 用于解析所有的 Laravel 控制
<a name="route-caching"></a>
## 路由缓存

若控制器路由只由你的应用程序专用,你可利用 Laravel 的路由缓存。使用路由缓存,将大幅降低注册应用程序所有路由所需要的时间。某些情况下,路由注册甚至可以快上 100 倍。要产生路由缓存,只要执行 `route:cache` Artisan 指令
若控制器路由只由你的应用程序专用,你可利用 Laravel 的路由缓存。使用路由缓存,将大幅降低注册应用程序所有路由所需要的时间。某些情况下,路由注册甚至可以快上 100 倍。要产生路由缓存,只要执行 `route:cache` Artisan 命令

php artisan route:cache

就是这样!你的缓存路由文件将会被用来代替 `app/Http/routes.php` 此一文件。记住,若你增加了任何新的路由,你就 必须产生一个新的路由缓存。因此在专案部署时,你可能会希望只要执行 `route:cache` 指令
就是这样!你的缓存路由文件将会被用来代替 `app/Http/routes.php` 此一文件。记住,若你增加了任何新的路由,你就 必须产生一个新的路由缓存。因此在专案部署时,你可能会希望只要执行 `route:cache` 命令

要移除路由缓存文件,但不希望产生新的缓存,可使用 `route:clear` 指令
要移除路由缓存文件,但不希望产生新的缓存,可使用 `route:clear` 命令

php artisan route:clear
8 changes: 4 additions & 4 deletions elixir.md
Original file line number Diff line number Diff line change
Expand Up @@ -33,7 +33,7 @@ Laravel Elixir 提供了简洁流畅的 API,让你能够为你的 Laravel 应

### Laravel Elixir

最后的步骤就是安装 Elixir!伴随着新安装的 Laravel,你会发现根目录有个名为 `package.json` 的文件。想像它就如同你的 `composer.json` 文件,只是它定义的是 Node 的依赖,而不是 PHP。你可以使用以下的指令进行安装依赖的动作
最后的步骤就是安装 Elixir!伴随着新安装的 Laravel,你会发现根目录有个名为 `package.json` 的文件。想像它就如同你的 `composer.json` 文件,只是它定义的是 Node 的依赖,而不是 PHP。你可以使用以下的命令进行安装依赖的动作

npm install

Expand Down Expand Up @@ -110,7 +110,7 @@ elixir(function(mix) {

传递给此方法的文件路径均相对于 `resources/css` 目录。

#### 合并样式文件且保存在自订的路径
#### 合并样式文件且保存在自定义的路径

```javascript
elixir(function(mix) {
Expand Down Expand Up @@ -261,15 +261,15 @@ elixir(function(mix) {

请注意我们 `扩增( extend )` Elixir 的 API 时所使用的第一个参数,稍后我们需要在 Gulpfile 中使用它,以及建立 Gulp 任务所使用的回呼函式。

如果你想要让你的自订任务能被监控,只要在监控器注册就行了。
如果你想要让你的自定义任务能被监控,只要在监控器注册就行了。

```javascript
this.registerWatcher("message", "**/*.php");
```

这行程序的意思是指,当符合正则表达式的文件一经修改,就会触发 `message` 任务。

很好!接着你可以将这行程序写在 Gulpfile 的顶端,或者将它放到自订任务的文件里。如果你选择后者,那么你必须将它加载至你的 Gulpfile,例如:
很好!接着你可以将这行程序写在 Gulpfile 的顶端,或者将它放到自定义任务的文件里。如果你选择后者,那么你必须将它加载至你的 Gulpfile,例如:

```javascript
require("./custom-tasks")
Expand Down
4 changes: 2 additions & 2 deletions events.md
Original file line number Diff line number Diff line change
Expand Up @@ -28,11 +28,11 @@ Laravel 里的 `EventServiceProvider` 提供了一个方便的地方注册所有
],
];

使用 Artisan 命令行指令 `handler:event`,来产生一个事件的处理程序:
使用 Artisan 命令行命令 `handler:event`,来产生一个事件的处理程序:

php artisan handler:event EmailPurchaseConfirmation --event=PodcastWasPurchased

当然,在每次你需要一个处理程序或是事件时,手动地执行 `make:event``handler:event` 指令很麻烦。作为替代,简单地添加处理程序跟事件到你的 `EventServiceProvider` 并使用 `event:generate` 指令。这个指令将会产生任何在你的 `EventServiceProvider` 列出的事件跟处理程序:
当然,在每次你需要一个处理程序或是事件时,手动地执行 `make:event``handler:event` 命令很麻烦。作为替代,简单地添加处理程序跟事件到你的 `EventServiceProvider` 并使用 `event:generate` 命令。这个命令将会产生任何在你的 `EventServiceProvider` 列出的事件跟处理程序:

php artisan event:generate

Expand Down
Loading

0 comments on commit 382670b

Please sign in to comment.