简单介绍

horizon为您的laravel驱动的redis队列提供了漂亮的仪表板和代码驱动配置。Horizon允许您轻松监视队列系统的关键度量，如作业吞吐量、运行时和作业失败。

 

您的所有工作机配置都存储在一个简单的配置文件中，允许您的配置保留在源代码管理中，以便整个团队可以进行协作。

注意：由于它使用异步进程信号，horizon需要php 7.1+

您可以使用composer将horizon安装到您的laravel项目中：

composer require laravel/horizon

安装Horizon后，使用“供应商：发布Artisan”命令发布其资源：

php artisan vendor:publish --provider="Laravel\Horizon\HorizonServiceProvider"

配置

发布horizon的资产后，它的主配置文件将位于config/horizon.php。此配置文件允许您配置工作机选项，并且每个配置选项都包含其用途的描述，因此请确保彻底浏览此文件。

平衡期权

Horizon允许您从三种平衡策略中进行选择：简单（simple）、自动（auto）和错误（false）。默认情况下，简单策略在进程之间均匀地分割传入的作业：

'balance' => 'simple',
自动策略根据队列的当前工作负载调整每个队列的工作进程数。例如，当呈现队列为空时，如果通知队列有1000个等待作业，Horizon将向通知队列分配更多的作业，直到它为空。当balance选项设置为false时，将使用默认的laravel行为，该行为按照队列在配置中列出的顺序处理队列。
horizon在/horizon处显示仪表板。默认情况下，您只能在本地环境中访问此仪表板。要为仪表板定义更具体的访问策略，应该使用horizon：：auth方法接受应返回true或false的回调，指示用户是否应访问Horizon仪表板：

Horizon::auth(function ($request) {
    // return true / false;
});

运行范围

一旦您在config/horizon.php配置文件中配置了您的工作人员，就可以使用horizon artisan命令启动horizon。这个命令将启动所有配置的工作线程：

php artisan horizon
可以暂停地平线进程，并指示它使用地平线：暂停和地平线：继续Artisan命令继续处理作业：

php artisan horizon:pause php artisan horizon:continue

您可以使用horizon:terminate artisan命令优雅地终止计算机上的主地平线进程。地平线当前正在处理的任何作业都将完成，然后地平线将退出：

php artisan horizon:terminate

部署地平线

如果要将horizon部署到活动服务器，则应配置一个进程监视器来监视php artisan horizon命令，并在该命令意外退出时重新启动它。将新代码部署到服务器时，需要指示主地平线进程终止，以便进程监视器可以重新启动它并接收代码更改。

 

您可以使用horizon:terminate artisan命令优雅地终止计算机上的主地平线进程。地平线当前正在处理的任何作业都将完成，然后地平线将退出：

php artisan horizon:terminate

PHP Artisan Horizon:终止

管理器配置

如果使用主管流程监视器管理地平线流程，则以下配置文件应足够：

[program:horizon]
process_name=%(program_name)s
command=php /home/forge/app.com/artisan horizon
autostart=true
autorestart=true
user=forge
redirect_stderr=true
stdout_logfile=/home/forge/app.com/horizon.log