抛出问题
我们发布新版本代码时,如果优雅的终止运行中的异步任务,规避异步任务运行到一半被kill掉的情况。
解决办法
通过调研之后发现,laravel 的 horizon 扩展可以解决这个问题,使用下面的命令可以优雅的结束进程:
- 确保进行中进程不会被kill掉,执行结束后才允许被kill;
 - 非进行的任务等候,不会加入到队列中;
 
优雅的解决了这个问题,思路就是这么的朴实无华。
php artisan horizon:terminate
下面开始隆重介绍 Horizon
简介
Horizon 提供了一个漂亮的仪表盘,可以通过代码配置 Laravel Redis 队列,同时它允许你轻易的监控你的队列系统中诸如任务吞吐量,运行时间和失败任务等关键指标。

 
安装
注意:确保 queue 配置文件中设置了 redis 队列驱动。
使用 Composer 为 Laravel 项目安装 Horizon:
composer require laravel/horizon
安装完成后,使用 horizon:install 发布 Artisan 命令:
php artisan horizon:install
需要创建 failed_jobs 表,Laravel 将使用该表来存储任何 failed queue jobs:
php artisan queue:failed-table
php artisan migrate
- 2
 - 3
 
升级 Horizon
当准备升级到 Horizon 的一个新的主要版本之前,一定好好看看更新声明,熟悉新特性,结合业务场景思考有没有坑。
注意,升级之后记得要重新发布 Horizon 的资源文件:
php artisan horizon:assets
配置
发布 Horizon 相关文件后,他的主要配置文件会放在 config/horizon.php。
可以在这个文件中配置队列相关选项,并且每个配置项都有详细的使用说明。
注意:确保 horizon 配置文件的 environments 部分包含你计划在其上运行 Horizon 的每个环境的条目。
'environments' => [
    'production' => [
        'supervisor-1' => [
            'connection' => 'redis',
            'queue' => [
                'high_{0}',
            ],
            'balance' => 'auto',
            'minProcesses' => 1,
            'maxProcesses' => 2,
            'tries' => 1
        ],
    ],
    'test' => [
        'supervisor-1' => [
            'connection' => 'redis',
            'queue' => [
                'high_{0}',
            ],
            'balance' => 'auto',
            'minProcesses' => 1,
            'maxProcesses' => 2,
            'tries' => 1
        ],
    ],
    'local' => [
        'supervisor-1' => [
            'connection' => 'redis',
            'queue' => [
                'high_{0}',
            ],
            'balance' => 'auto',
            'minProcesses' => 3,
            'maxProcesses' => 11,
            'tries' => 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
 - 37
 - 38
 - 39
 - 40
 
均衡配置
Horizon 提供了三种均衡策略: simple , auto ,和 false 。
- 默认的是 simple , 会将收到的任务均分给队列进程:
 
'balance' => 'simple',
- auto 策略会根据当前的工作量调整每个队列的工作进程任务数量。
 - 当配置项 balance 配置为 false ,Horizon 会使用 Laravel 默认执行行为,它将按照配置中列出的顺序处理队列任务。
 
例如:如果 A 队列有 1000 个待执行任务,但是你的 B 队列是空的,
 Horizon 会分配更多的工作进程给 B 队列,直到 A 队列中所有任务执行完成。
当使用 auto 策略时,您可以定义 minProcesses 和 maxProcesses 配置选项,以控制最小和最大进程数范围应向上和向下扩展到:
'environments' => [
    'production' => [
        'supervisor-1' => [
            'connection' => 'redis',
            'queue' => ['default'],
            'balance' => 'auto',
            'minProcesses' => 1,
            'maxProcesses' => 10,
            'tries' => 3,
        ],
    ],
],
- 2
 - 3
 - 4
 - 5
 - 6
 - 7
 - 8
 - 9
 - 10
 - 11
 - 12
 
失败任务记录
horizon 配置文件允许你配置应保留最近和失败任务的时间(以分钟为单位)。 默认情况下,最近的任务保留一小时,而失败的任务保留一周:
'trim' => [
    'recent' => 60,
    'failed' => 10080,
],
- 2
 - 3
 - 4
 

仪表盘权限验证
Horizon 仪表盘路由是 /horizon 。
默认情况下,你只能在 local 环境下访问仪表盘。
在你的 app/Providers/HorizonServiceProvider.php 文件中,有一个 gate 方法。
这里授权控制 非本地 环境中对 Horizon 的访问。
可以根据需要随意修改此门面,以限制对 Horizon 安装的访问:
/**
 * Register the Horizon gate.
 *
 * This gate determines who can access Horizon in non-local environments.
 *
 * @return void
 */
protected function gate()
{
    Gate::define('viewHorizon', function ($user) {
        return in_array($user->email, [
            'xxxx@xxx.com',
        ]);
    });
}
- 2
 - 3
 - 4
 - 5
 - 6
 - 7
 - 8
 - 9
 - 10
 - 11
 - 12
 - 13
 - 14
 - 15
 
注意:记住,Laravel 会自动将 authenticated 用户注入到 gate 方法。
如果应用程序通过其他方法(如 IP 限制)提供 Horizon 安全,那么 Horizon 用户可能不需要 “登录”。
总结
文章开头抛出的问题是我开发过程中没考虑到的,
初识文档也没体会到 php artisan horizon:terminate 的妙处。
随着项目的不断成长,自己的技术水平和编程思想也在随之成长。
下期再见
下一篇文章会总结 Horizon 进阶知识点,包括:安装、部署、标签、通知、Metrics等。

                

















