Laravel 5.1框架中如何创建自定义Artisan控制台命令

2024-08-25 11:38
文章标签 自定义 命令 创建 框架 控制台 artisan 5.1 laravel

本文主要是介绍Laravel 5.1框架中如何创建自定义Artisan控制台命令，希望对大家解决编程问题提供一定的参考价值，需要的开发者们随着小编来一起学习吧！

对于laravel初学者来说，对laravel创建自定义Artisan控制台命令可能是不太了解，接下来的这篇文章给大家分享一下laravel框架中创建自定义Artisan控制台命令的实例。

 

1、入门

Laravel通过Artisan提供了强大的控制台命令来处理非浏览器业务逻辑。要查看Laravel中所有的Artisan命令，可以通过在项目根目录运行：

1

php artisan list

对应输出如下（部分截图）：

2015-10-19_211849.jpg

其中一些命名我们已经比较熟悉了，比如创建迁移make:migration以及执行迁移migrate，又比如创建模型make:model，创建控制器make:controller等。

如果要查看具体某个命令的使用方法，比如我们要查看创建Artisan命令make:console的具体用法，可以使用如下命令：

1

php artisan help make:console

对应输出如下：

2015-10-19_212233.jpg

2、创建命令

Artisan除了提供丰富的控制台命令之外，还允许我们通过make:console命令创建自己的控制台命令。上面我们已经使用help指令查看了make:console的用法，下面我们就沿着这条路走下去，一探究竟：创建命令并运行起来得到我们想要的各种结果。

首先我们创建一个最简单的命令，打印Hello LaravelAcademy，使用Artisan命令如下：

1

php artisan make:console HelloLaravelAcademy --command=laravel:academy

其中HelloLaravelAcademy是命令名，laravel:academy是控制台执行的命令，类似make:console。

执行完成后，会在app/Console/Commands目录下生成一个HelloLaravelAcademy.php文件：

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

22

23

24

25

26

27

28

29

30

31

32

33

34

35

36

<?php

namespace App\Console\Commands;

use Illuminate\Console\Command;

class HelloLaravelAcademy extends Command

{

    /**

     * The name and signature of the console command.

     *

     * @var string

     */

    protected $signature = 'laravel:academy';

    /**

     * The console command description.

     *

     * @var string

     */

    protected $description = 'Command description.';

    /**

     * Create a new command instance.

     *

     * @return void

     */

    public function __construct()

    {

        parent::__construct();

    }

    /**

     * Execute the console command.

     *

     * @return mixed

     */

    public function handle()

    {

        //

    }

}

其中$signature即为在控制台执行的命令名，$description为命令描述，handle方法为执行命令时调用的方法。

接下来我们简单编写handle方法如下：

1

2

3

4

public function handle()

{

    echo "Hello LaravelAcademy\n";

}

好了，一个最简单的命令已经编写好了，接下来要怎么执行并在控制台打印出“Hello LaravelAcademy”呢？

3、运行命令

在运行命令前需要将其注册到App\Console\Kernel的$commands属性中：

1

2

3

4

protected $commands = [

     ...  //其他命令类

     \App\Console\Commands\HelloLaravelAcademy::class

];

接下来我们就可以在控制台运行如下Artisan命令：

1

php artisan laravel:academy

终端就会打印出：

1

Hello LaravelAcademy

是不是很简单？

4、更多样的输入输出

当然，上面是最简单的情形，没有输入，写死的输出。实际环境中有更复杂的需求，有更多样的输入输出，下面我们来一一讨论。

定义输入

上面已经提到，我们可以通过修改$signature属性定义输入参数及选项，比如这里我们将上述Hello后面的字符串调整为通过输入参数来控制，可修改$signature如下：

1

protected $signature = 'laravel:academy {name}';

这样定义意味着name是必选参数，当然还支持更多自定义参数输入：

1

2

{name?} //可选参数

{name=LaravelAcademy} //默认name值为LaravelAcademy

为增强程序健壮性，我们将name修改为有默认值：

1

protected $signature = 'laravel:academy {name=LaravelAcademy}';

有时候我们还会在执行命令时传入一些选项，比如是否显示标点符号（虽然听上去很鸡肋，这里权当测试之用）， 那么我们可以修改$signature属性如下：

1

protected $signature = 'laravel:academy {name=LaravelAcademy} {--mark}';

如果调用命令时传递--mark则代表其值为true，否则为false，如果选项值在输入时通过用户设置，可定义$signature如下：

1

protected $signature = 'laravel:academy {name=LaravelAcademy} {--mark=}';

这样用户就可以在传入选项时通过=来为选项赋值，当然和参数一样，我们也可以为选项指定默认值：

1

protected $signature = 'laravel:academy {name=LaravelAcademy} {--mark=!}';

获取输入

定义好输入参数和选项后，又该如何获取其对应值呢？Laravel为我们提供了相应的方法。

获取参数值可以通过Illuminate\Console\Command的argument方法：

1

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

如果无参调用argument方法，则返回的是所有参数值数组。

获取选项值可以通过Illuminate\Console\Command的option方法：

1

$mark = $this->option('mark');

同理，无参调用option方法会返回所有选项值数组。

这样我们可以修改HelloLaravelAcademy的handle方法如下：

1

2

3

4

5

6

7

8

9

public function handle()

{

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

    $mark = $this->option('mark');

    $string = 'Hello '.$name;

    if($mark)

        $string .= $mark;

    echo $string."\n";

}

这样我们在控制台输入如下Artisan命令：

1

php artisan laravel:academy

对应输出为：

1

Hello LaravelAcademy!

再运行如下Artisan命令：

1

php artisan laravel:academy Laravel --mark=?

对应输出为：

1

Hello Laravel?

输入提示

我们甚至还可以完全让用户通过在控制台输入name来获取输入参数，首先修改handle方法如下：

1

2

3

4

5

public function handle()

{

    $name = $this->ask('What do you want to say Hello?');

    echo "Hello ".$name."\n";

}

然后在终端输入php artisan laravel:academy，交互页面如下：
2015-10-19_224643.jpg

如果是输入密码一类的敏感信息可以用secret替代ask方法。
有时候我们会根据用户的意愿选择继续还是中止：

1

2

3

4

5

6

7

8

public function handle()

{

    if($this->confirm('Do you want to continue?[y|n]')){

        $this->info("Continue");

    }else{

        $this->error("Interrupt");

    }

}

对应输出为：

2015-10-19_232437.jpg

除了让用户手动输入外，还可以使用anticipate方法实现自动完成功能：

1

2

3

4

5

public function handle()

{

    $name = $this->anticipate('What is your name?', ['Laravel', 'Academy']);

    $this->info($name);

}

当然还可以使用choice方法为用户提供选择避免手动输入，用户只需选择对应索引即可：

1

2

3

4

5

public function handle()

{

    $name = $this->choice('What is your name?', ['Laravel', 'Academy']);

    $this->info($name);

}

对应交互页面如下：

2015-10-19_233106.jpg

编写输出

关于输出字符串，上面我们简单使用了echo语句，其实Laravel提供了更为强大和多样化的方法：

1

2

3

4

5

6

7

public function handle()

{

    $this->info("Successful!");

    $this->error("Something Error!");

    $this->question("What do you want to do?");

    $this->comment("Just Comment it!");

}

执行php artisan laravel:academy对应输出如下：

2015-10-19_225422.jpg

表格

Artisan甚至可以输出表格：

1

2

3

4

5

6

public function handle()

{

    $headers = ['Name', 'Email'];

    $users = \App\User::all(['name', 'email'])->toArray();

    $this->table($headers, $users);

}

执行php artisan laravel:academy对应输出为：

2015-10-19_225643.jpg

进度条

当然对于复杂耗时的命令，进度条是必不可少的，

1

2

3

4

5

6

7

8

9

public function handle()

{

    $this->output->progressStart(10);

    for ($i = 0; $i < 10; $i++) {

        sleep(1);

        $this->output->progressAdvance();

    }

    $this->output->progressFinish();

}

执行php artisan laravel:academy对应输出为：

2015-10-19_230505.jpg

5、从CLI之外调用Artisan

除了在控制台执行Artisan命令之外，还可以通过代码在别处调用Artisan命令，比如其它Artisan命令、控制器、路由或其他。

路由

在路由闭包中我们可以通过Artisan门面的call方法来调用本节创建的命令：

1

2

3

4

5

6

//在路由中调用Artisan命令

Route::get('testArtisan',function(){

    $exitCode = Artisan::call('laravel:academy', [

        'name' => 'Laravel学院', '--mark' => '！'

    ]);

});

其它Artisan命令

在一个Artisan命令中也可以调用另一个Artisan命令，还是通过call方法：

1

2

3

4

public function handle()

{

    $this->call('inspire');

}

如果想要调用一个Artisan命令并阻止其所有输出，可以使用callSilent方法：

1

2

3

4

public function handle()

{

    $this->callSilent('inspire');

}

除此之外，关于Artisan命令你还应该知道的是我们可以在创建的命令类的控制器或方法中注入任何依赖。这就意味着我们可以在命令类中使用注册到服务容器的所有类。

相关推荐：

laravel框架的启动过程分析

Laravel框架内置的Broadcast功能如何实现与客户端实时通信

以上就是Laravel 5.1框架中如何创建自定义Artisan控制台命令的详细内容，更多请关注php中文网其它相关文章！

这篇关于Laravel 5.1框架中如何创建自定义Artisan控制台命令的文章就介绍到这儿，希望我们推荐的文章对编程师们有所帮助！

原文地址:
本文来自互联网用户投稿，该文观点仅代表作者本人，不代表本站立场。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如若转载，请注明出处：http://www.chinasem.cn/article/1105452。

相关文章

Vite 打包目录结构自定义配置小结

Vite 打包目录结构自定义配置小结

《Vite打包目录结构自定义配置小结》在Vite工程开发中,默认打包后的dist目录资源常集中在asset目录下,不利于资源管理,本文基于Rollup配置原理,本文就来介绍一下通过Vite配置自定义... 目录一、实现原理二、具体配置步骤1. 基础配置文件2. 配置说明（1）js 资源分离（2）非 JS 资
阅读更多...
GSON框架下将百度天气JSON数据转JavaBean

GSON框架下将百度天气JSON数据转JavaBean

《GSON框架下将百度天气JSON数据转JavaBean》这篇文章主要为大家详细介绍了如何在GSON框架下实现将百度天气JSON数据转JavaBean,文中的示例代码讲解详细,感兴趣的小伙伴可以了解下... 目录前言一、百度天气jsON1、请求参数2、返回参数3、属性映射二、GSON属性映射实战1、类对象映
阅读更多...
Spring创建Bean的八种主要方式详解

Spring创建Bean的八种主要方式详解

《Spring创建Bean的八种主要方式详解》Spring（尤其是SpringBoot）提供了多种方式来让容器创建和管理Bean,@Component、@Configuration+@Bean、@En... 目录引言一、Spring 创建 Bean 的 8 种主要方式1. @Component 及其衍生注解
阅读更多...
聊聊springboot中如何自定义消息转换器

聊聊springboot中如何自定义消息转换器

《聊聊springboot中如何自定义消息转换器》SpringBoot通过HttpMessageConverter处理HTTP数据转换,支持多种媒体类型,接下来通过本文给大家介绍springboot中... 目录核心接口springboot默认提供的转换器如何自定义消息转换器Spring Boot 中的消息
阅读更多...
MySQL 数据库表操作完全指南:创建、读取、更新与删除实战

MySQL 数据库表操作完全指南:创建、读取、更新与删除实战

《MySQL数据库表操作完全指南:创建、读取、更新与删除实战》本文系统讲解MySQL表的增删查改（CURD）操作,涵盖创建、更新、查询、删除及插入查询结果,也是贯穿各类项目开发全流程的基础数据交互原... 目录mysql系列前言一、Create(创建)并插入数据1.1 单行数据 + 全列插入1.2 多行数据
阅读更多...
Linux查询服务器 IP 地址的命令详解

Linux查询服务器 IP 地址的命令详解

《Linux查询服务器IP地址的命令详解》在服务器管理和网络运维中,快速准确地获取服务器的IP地址是一项基本但至关重要的技能,下面我们来看看Linux中查询服务器IP的相关命令使用吧... 目录一、hostname 命令：简单高效的 IP 查询工具命令详解实际应用技巧注意事项二、ip 命令：新一代网络配置全
阅读更多...
C#控制台程序同步调用WebApi实现方式

C#控制台程序同步调用WebApi实现方式

《C#控制台程序同步调用WebApi实现方式》控制台程序作为Job时,需同步调用WebApi以确保获取返回结果后执行后续操作,否则会引发TaskCanceledException异常,同步处理可避免异... 目录同步调用WebApi方法Cls001类里面的写法总结控制台程序一般当作Job使用，有时候需要控制
阅读更多...
Linux grep 命令的使用指南

Linux grep 命令的使用指南

《Linuxgrep命令的使用指南》本文给大家介绍Linuxgrep命令的使用指南,包括基础搜索语法、实践指南,感兴趣的朋友跟随小编一起看看吧... 目录linux grep 命令全面使用指南一、基础搜索语法1. 基本文本搜索2. 多文件搜索二、常用选项详解1. 输出控制选项2. 上下文控制选项三、正则表达
阅读更多...
MySQL 临时表创建与使用详细说明

MySQL 临时表创建与使用详细说明

《MySQL临时表创建与使用详细说明》MySQL临时表是存储在内存或磁盘的临时数据表,会话结束时自动销毁,适合存储中间计算结果或临时数据集,其名称以#开头（如#TempTable）,本文给大家介绍M... 目录mysql 临时表详细说明1.定义2.核心特性3.创建与使用4.典型应用场景5.生命周期管理6.注
阅读更多...
MySQL的触发器全解析(创建、查看触发器)

MySQL的触发器全解析(创建、查看触发器)

《MySQL的触发器全解析(创建、查看触发器)》MySQL触发器是与表关联的存储程序,当INSERT/UPDATE/DELETE事件发生时自动执行,用于维护数据一致性、日志记录和校验,优点包括自动执行... 目录触发器的概念：创建触www.chinasem.cn发器：查看触发器：查看当前数据库的所有触发器的定
阅读更多...

Copyright China编程 23002807@qq.com

沪ICP备2023033072号-2