Hyperf新建多进程定时任务命令行写法-php教程-PHP中文网

Hyperf定时任务通过CrontabDispatcherProcess进程统一调度，配合$singleton=true和$mutex=['type'=>'redis']实现多进程安全执行；需安装hyperf/crontab、定义继承AbstractCrontab的任务类、在processes.php中注册调度器进程。

hyperf新建多进程定时任务命令行写法

Hyperf 新建多进程定时任务，本身不靠“命令行创建”来实现多进程——定时任务默认由 CrontabDispatcherProcess 进程统一调度，它本身就是个常驻的独立进程；而“多进程”指的是整个 Hyperf 应用启动时启用多个 Worker 进程（如通过 Swoole 配置 worker_num），或你主动注册额外的自定义进程（如 @Process）。所谓“新建多进程定时任务”，实际是两件事的组合：1）定义定时任务；2）确保它在多进程环境下安全、不重复执行。下面直接说清楚怎么写、怎么配：

一、先装好定时任务组件

确保已安装：
composer require hyperf/crontab
组件会自动注册，无需手动启用。

二、定义定时任务类（支持多进程安全）

在 app/Crontab/ 下新建类，继承 AbstractCrontab，关键点是开启单例 + 分布式锁：

必须设置 $singleton = true：防止多个 Worker 同时触发同一任务
推荐加 Redis 锁：$mutex = ['type' => 'redis']：跨进程防重，需已配置 Redis
$rule 支持标准 cron（如 "0 * * * *" 每小时）或秒级（如 "*/5 * * * * *" 每5秒）

示例：

namespace App\Crontab;
<p>use Hyperf\Crontab\AbstractCrontab;
use Hyperf\Crontab\Annotation\Crontab;</p><h1>[Crontab]</h1><p>class DailyCleanupTask extends AbstractCrontab
{
public string $name = 'daily_cleanup';
public string $rule = '0 2 <em> </em> *'; // 每天凌晨2点
public array $singleton = true;
public array $mutex = ['type' => 'redis'];</p><pre class="brush:php;toolbar:false;">public function execute(): void
{
    // 清理过期日志、缓存等业务逻辑
    \Hyperf\Utils\Coroutine::sleep(0.1);
    echo "[DailyCleanup] executed at " . date('Y-m-d H:i:s') . "\n";
}

}

三、注册调度器进程（让定时任务真正多进程运行）

定时任务不是靠命令行启动的，而是随服务一起跑。你需要在 config/autoload/processes.php 中显式注册调度进程：

return [
    // 必须加上这一行，否则定时任务不会运行
    \Hyperf\Crontab\Process\CrontabDispatcherProcess::class,
];

这个 CrontabDispatcherProcess 是一个独立协程进程，负责解析规则、触发任务，它本身不占用 Worker 进程，但能协调所有 Worker 共同参与执行（配合 $singleton 和 $mutex 保证只执行一次）。

hyperframes-超帧视频

HTML 驱动的视频合成——GSAP 动画、TTS 字幕、音频响应、着色器转场

下载

四、命令行相关操作（仅用于调试或手动触发）

Hyperf 不提供“新建多进程定时任务”的命令行指令，但你可以：

用命令生成普通命令类（非定时任务）：php bin/hyperf.php gen:command Task\ManualSync
手动触发该命令：php bin/hyperf.php task:manual-sync
若想用系统 crontab 触发（绕过 Hyperf 调度）：
0 3 * * * cd /path/to/project && php bin/hyperf.php task:manual-sync >> /dev/null 2>&1

注意：这种方式脱离了 Hyperf 的协程调度和锁机制，需自行处理并发安全。