未加星标

[ Laravel 5.3 文档 ] Artisan Console ―― 控制台命令

字体大小 | |
[开发(php) 所属分类 开发(php) | 发布者 店小二03 | 时间 2016 | 作者 红领巾 ] 0人收藏点击收藏
1、简介

Artisan是Laravel自带的命令行接口名称,它为我们在开发过程中提供了很多有用的命令。想要查看所有可用的Artisan命令,可使用 list 命令:

php artisan list

每个命令都可以用 help 指令显示命令描述及命令参数和选项。想要查看帮助界面,只需要在命令前加上 help 就可以了:

php artisan help migrate 2、编写命令

除了Artisan提供的系统命令之外,还可以构建自己的命令。你可以将自定义命令存放在 app/Console/Commands 目录;当然,你可以自己选择存放位置,只要该命令可以被Composer自动加载即可。

生成命令

要创建一个新命令,你可以使用Artisan命令 make:console ,该命令会在 app/Console/Commands 目录下创建一个新的命令类。如果该目录不存在,不用担心,因为它将会在你首次运行Artisan命令 make:command 时被创建。生成的命令将会包含默认的属性设置以及所有命令都共有的方法:

php artisan make:command SendEmails 命令结构

命令生成以后,需要填写该类的 signature 和 description 属性,这两个属性在调用 list 显示命令的时候会被用到。

handle 方法在命令执行时被调用,你可以将所有命令逻辑都放在这个方法里面。

注:为了更好地实现代码复用,最佳实践是保持控制台命令的轻量并让它们延迟到应用服务中完成任务。在下面的例子中,注意我们注入了一个服务类来完成发送邮件这样的“繁重”任务。

下面让我们来看一个例子,注意我们可以在命令类的构造函数中注入任何依赖,Laravel服务提供者将会在构造函数中自动注入所有依赖类型提示:

<?php
namespace App\Console\Commands;
use App\User;
use App\DripEmailer;
use Illuminate\Console\Command;
class SendEmails extends Command
{
/**
* The name and signature of the console command.
*
* @var string
*/
protected $signature = 'email:send {user}';
/**
* The console command description.
*
* @var string
*/
protected $description = 'Send drip e-mails to a user';
/**
* The drip e-mail service.
*
* @var DripEmailer
*/
protected $drip;
/**
* Create a new command instance.
*
* @param DripEmailer $drip
* @return void
*/
public function __construct(DripEmailer $drip)
{
parent::__construct();
$this->drip = $drip;
}
/**
* Execute the console command.
*
* @return mixed
*/
public function handle()
{
$this->drip->send(User::find($this->argument('user')));
}
} 闭包命令

基于闭包的命令和闭报路由相对控制器一样,为以类的方式定义控制台命令提供了可选方案,在 app/Console/Kernel.php 文件的 commands 方法中,Laravel加载了 routes/console.php 文件:

/**
* Register the Closure based commands for the application.
*
* @return void
*/
protected function commands()
{
require base_path('routes/console.php');
}

尽管找个文件没有定义HTTP路由,但是它定义了基于控制台的应用入口(和路由作用一样),在这个文件中,你可以使用 Artisan::command 方法定义所有基于闭包的路由。 command 方法接收两个参数 ―― 命令标识和接收命令参数和选项的闭包:

Artisan::command('build {project}', function ($project) {
$this->info("Building {$project}!");
});

该闭包被绑定到底层命令实例,所有你可以像在完整的命令类中一样访问所有辅助函数。

类型提示依赖

除了接收命令参数和选项外,闭包命令还可以类型提示服务容器之外解析的额外依赖:

use App\User;
use App\DripEmailer;
Artisan::command('email:send {user}', function (DripEmailer $drip, $user) {
$drip->send(User::find($user));
});

闭包命令描述

定义基于闭包的命令时,可以使用 describe 方法来添加命令描述,这个描述将会在运行 php artisan list 或 php artisan help 命令时显示:

Artisan::command('build {project}', function ($project) {
$this->info("Building {$project}!");
})->describe('Build the project'); 3、 定义期望输入

编写控制台命令的时候,通常通过参数和选项收集用户输入,Laravel使这项操作变得很方便:在命令中使用 signature 属性来定义我们期望的用户输入。 signature 属性通过一个优雅的、路由风格的语法允许你定义命令的名称、参数以及选项。

参数

所有用户提供的参数和选项都包含在大括号里,下面这个例子定义的命令要求用户输入必选参数user:

/**
* 控制台命令名称
*
* @var string
*/
protected $signature = 'email:send {user}';

你还可以让该参数可选并定义默认的可选参数值:

// 选项参数...
email:send {user?}
// 带默认值的选项参数...
email:send {user=foo} 选项

选项,和参数一样,是用户输入的另一种格式,不同之处在于选项前面有两个短划线( ),有两种类型的选项:接收值和不接收值的。不接收值的选项一般用作布尔开关。我们来看一个这种类型的选项:

/**
* 控制台命令名称
*
* @var string
*/
protected $signature = 'email:send {user} {--queue}';

在本例中, --queue 开关在调用Artisan命令的时候被指定。如果 --queue 开关被传递,其值是 true ,否则其值是 false :

php artisan email:send 1 --queue

带值的选项

接下来,我们来看一个带值的选项,如果用户必须为选项指定值,需要通过 = 进行分配:

/**
* 控制台命令名称
*
* @var string
*/
protected $signature = 'email:send {user} {--queue=}';

在这个例子中,用户可以通过这样的方式传值:

php artisan email:send 1 --queue=default

还可以给选项分配默认值,如果用户没有传递值给选项,将会使用默认值:

email:send {user} {--queue=default}

选项简写

如果想要为命令选项分配一个简写,可以在选项前指定并使用分隔符|将简写和完整选项名分开:

email:send {user} {--Q|queue} 输入数组

如果你想要定义参数和选项以便指定输入数组,可以使用字符 * ,首先,让我们看一个指定数组参数的例子:

email:send {user*} 调用这个方法时, user 参数会顺序传递到命令行,例如,下面的命令会设置 user 的值为 ['foo', 'bar'] : php artisan email:send foo bar

定义一个期望输入数组的选项时,每个传递给命令的选项值都应该加上选项名前缀:

email:send {user} {--id=*}
php artisan email:send --id=1 --id=2 输入描述

你可以通过冒号将参数和描述进行分隔的方式分配描述到输入参数和选项,如果你需要一些空间来定义命令,可以通过换行来定义命令:

/**
* 控制台命令名称
*
* @var string
*/
protected $signature = 'email:send {user : The ID of the user} {--queue= : Whether the job should be queued}'; 4、命令I/O 获取输入

在命令被执行的时候,很明显,你需要访问命令获取的参数和选项的值。使用 argument 和 option 方法即可实现:

/**
* Execute the console command.
*
* @return mixed
*/
public function handle()
{
$userId = $this->argument('user');
//
}

如果需要以数组方式返回所有参数的值,调用 arguments 方法:

$arguments = $this->arguments();

选项值和参数值的获取一样简单,使用 option 方法,要以数组方式返回所有选项值,可以调用 options 方法:

// Retrieve a specific option...
$queueName = $this->option('queue');
// Retrieve all options...
$options = $this->options();

如果参数或选项不存在,返回null。

输入提示

除了显示输出之外,你可能还要在命令执行期间要用户提供输入。 ask 方法将会使用给定问题提示用户,接收输入,然后返回用户输入到命令:

/**
* 执行控制台命令
*
* @return mixed
*/
public function handle(){
$name = $this->ask('What is your name?');
}

secret 方法和 ask 方法类似,但用户输入在终端对他们而言是不可见的,这个方法在问用户一些敏感信息如密码时很有用:

$password = $this->secret('What is the password?'); 让用户确认

如果你需要让用户确认信息,可以使用 confirm 方法,默认情况下,该方法返回 false ,如果用户输入 y ,则该方法返回 true :

if ($this->confirm('Do you wish to continue? [y|N]')) {
//
}

自动完成

anticipate 方法可用于为可能的选项提供自动完成功能,用户仍然可以选择答案,而不管这些选择:

$name = $this->anticipate('What is your name?', ['Taylor', 'Dayle']); 给用户提供选择

如果你需要给用户预定义的选择,可以使用 choice 方法。用户选择答案的索引,但是返回给你的是答案的值。如果用户什么都没选的话你可以设置默认返回的值:

$name = $this->choice('What is your name?', ['Taylor', 'Dayle'], false); 编写输出 要将输出发送到控制台,使用line, info , comment , question 和 error 方法,每个方法都会使用相应的ANSI颜色以作标识。例如,要显示一条信息消息给用户, 使用 info

本文开发(php)相关术语:php代码审计工具 php开发工程师 移动开发者大会 移动互联网开发 web开发工程师 软件开发流程 软件开发工程师

分页:12
转载请注明
本文标题:[ Laravel 5.3 文档 ] Artisan Console ―― 控制台命令
本站链接:http://www.codesec.net/view/481246.html
分享请点击:


1.凡CodeSecTeam转载的文章,均出自其它媒体或其他官网介绍,目的在于传递更多的信息,并不代表本站赞同其观点和其真实性负责;
2.转载的文章仅代表原创作者观点,与本站无关。其原创性以及文中陈述文字和内容未经本站证实,本站对该文以及其中全部或者部分内容、文字的真实性、完整性、及时性,不作出任何保证或承若;
3.如本站转载稿涉及版权等问题,请作者及时联系本站,我们会及时处理。
登录后可拥有收藏文章、关注作者等权限...
技术大类 技术大类 | 开发(php) | 评论(0) | 阅读(190)