PHP轻量级作业调度器 Cron Scheduler
PHP轻量级作业调度器 Cron Scheduler
简介
过去，你可能需要在服务器上为每一个调度任务去创建 Cron 条目。因为这些任务的调度不是通过代码控制的，你要查看或新增任务调度都需要通过 SSH 远程登录到服务器上去操作，所以这种方式很快会让人变得痛苦不堪。
PHP Cron Scheduler 是一个与框架无关的cron作业调度程序，可以轻松地与您的项目集成或作为独立的命令调度程序运行。在使用这个任务调度器时，你只需要在你的服务器上创建单个 scheduler.php 入口。你的任务调度在scheduler.php方法中进行定义。
Github仓库：https://github.com/peppeocchi/php-cron-scheduler
如何工作
在项目根目录下创建一个包含以下内容的 scheduler.php 文件。
<?php
require_once __DIR__.'/vendor/autoload.php';
use GO\Scheduler;
// Create a new scheduler
$scheduler = new Scheduler();
// ... configure the scheduled jobs (see below) ...
// Let the scheduler execute jobs which are due.
$scheduler->run();
然后在crontab中添加一个新条目，以便每分钟运行 scheduler.php 。
* * * * * path/to/phpbin path/to/scheduler.php 1>> /dev/null 2>&1
就是这样！您的调度程序已经启动并运行，现在您可以添加您的作业，而无需再担心crontab。这个Cron每分钟都会调用scheduler.php命令调度器。然后评估你的计划任务并运行到期的任务。
调度作业
默认情况下，您的所有作业将尝试在后台运行。PHP脚本和原始命令默认情况下将在后台运行，而函数将始终在前台运行。您可以通过调用 inForeground() 方法强制命令在前台运行。必须将输出发送到电子邮件的作业将在前台运行。
执行一个PHP脚本
$scheduler->php('path/to/my/script.php');
php()方法接受4个参数：
- PHP脚本的路径.
- 要使用的PHP二进制
- 要传递给脚本的参数（注意：您需要在
php.ini中启用register_argc_argv才能使其工作（ref）。不要担心它是默认启用的，所以除非你故意禁用它，或者你的主机默认禁用它，否则你可以忽略它。 - 标识符
$scheduler->php(
'path/to/my/script.php', // The script to execute
'path/to/my/custom/bin/php', // The PHP bin
[
'-c' => 'ignore',
'--merge' => null,
],
'myCustomIdentifier'
);
调度原始命令
$scheduler->raw('ps aux | grep httpd');
raw()方法接受3个参数：
- 你的命令.
- 要传递给命令的参数
- 标识符
$scheduler->raw(
'mycommand | myOtherCommand',
[
'-v' => '6',
'--silent' => null,
],
'myCustomIdentifier'
);
调度匿名函数
$scheduler->call(function () {
return true;
});
call()方法接受3个参数：
- 匿名函数
- 要传递给函数的参数
- 标识符
$scheduler->call(
function ($args) {
return $args['user'];
},
[
['user' => $user],
],
'myCustomIdentifier'
);
所有传入数组的参数都将被注入到函数中。例如：
$scheduler->call(
function ($firstName, $lastName) {
return implode(' ', [$firstName, $lastName]);
},
[
'John',
'last_name' => 'Doe', // The keys are being ignored
],
'myCustomIdentifier'
);
如果你想传递一个key => value对，请在arguments数组中传递一个数组
$scheduler->call(
function ($user, $role) {
return implode(' ', [$user['first_name'], $user['last_name']]) . " has role: '{$role}'";
},
[
[
'first_name' => 'John',
'last_name' => 'Doe',
],
'Admin'
],
'myCustomIdentifier'
);
计划执行时间
有几种方法可以帮助您设置计划的执行时间。如果您不调用此方法中的任何一个，则作业将每分钟（*）运行一次。
任何表达式
at -此方法接受dragonmantank/cron-expression支持的任何表达式
$scheduler->php('script.php')->at('* * * * *');
每分钟执行
everyMinute 每分钟执行。您可以选择传递 minute 以指定作业每 minute 分钟运行一次。
$scheduler->php('script.php')->everyMinute();
$scheduler->php('script.php')->everyMinute(5);
每小时运行
hourly 每小时运行一次。您可以选择传递您想要运行的 $minute ，默认情况下，它将在每小时的'00'分钟运行。
$scheduler->php('script.php')->hourly();
$scheduler->php('script.php')->hourly(53);
每天运行
daily 每天运行一次。您可以选择传递 hour 和 minute 以获得更细粒度的控制（或字符串 hour:minute ）
$scheduler->php('script.php')->daily();
$scheduler->php('script.php')->daily(22, 03);
$scheduler->php('script.php')->daily('22:03');
项目应用
项目根目录 scheduler.php 文件
<?php
declare(strict_types=1);
namespace think;
date_default_timezone_set('PRC');
require __DIR__ . '/vendor/autoload.php';
# PHP 二进制文件路径
$bin = '/usr/local/php-8.2/bin/php';
$script = __DIR__ . '/think';
$scheduler = new \GO\Scheduler();
# 2024年4月10日 @add Tinywan 订单自动发货 每天一次凌晨12点半执行
$scheduler->php($script . ' order delivery', $bin)->daily(00, 30);
# 2024年4月10日 @add Tinywan 订单自动取消 5分钟执行一次
$scheduler->php($script . ' order cancel', $bin)->everyMinute(5);
$scheduler->run();