如何配置Cron定时任务在Linux快速运行Hyperf-php教程-PHP中文网

hyperf定时任务通过hyperf/crontab组件纯php协程实现，无需系统crond；需安装组件、启用配置、注册crontabdispatcherprocess进程、定义继承abstractcrontab的注解任务类，启动后自动秒级调度。

如何配置cron定时任务在linux快速运行hyperf

Hyperf 本身不依赖 Linux 系统 crond，它的 hyperf/crontab 是纯 PHP 实现的协程定时调度器，无需、也不建议用系统 crontab 去调用 php bin/hyperf.php start 或执行脚本——那样既低效又破坏进程模型，还无法支持秒级、单例、分布式锁等核心能力。

如果你的目标是“让 Hyperf 的定时任务快速、可靠、按预期运行”，正确做法是直接启用 Hyperf 自带的 Crontab 调度器，而不是绕路走系统 cron。以下是关键配置步骤：

1. 安装并启用 hyperf/crontab 组件

执行安装命令：

composer require hyperf/crontab

组件会自动注册，无需额外启用。确保 config/autoload/crontab.php 中 enable 设为 true：

return [
    'enable' => true,
    'scan' => [
        'paths' => ['app/Crontab'],
    ],
    'timezone' => 'Asia/Shanghai',
];

2. 注册 Crontab 调度进程

在 config/autoload/processes.php 中添加调度器进程（Hyperf 3.0+ 必须）：

Linux Journey

当用户想学习Linux基础、命令行、文件系统等时，在LabEx查找并推荐免费的Linux Journey课程。

下载

return [
    \Hyperf\Crontab\Process\CrontabDispatcherProcess::class,
];

这个进程负责解析规则、触发任务，是整个定时能力的“大脑”。没有它，注解或配置的任务都不会执行。

3. 定义任务（推荐注解方式）

在 app/Crontab/ 下新建类，继承 AbstractCrontab 并标注 @Crontab：

namespace App\Crontab;
<p>use Hyperf\Crontab\AbstractCrontab;
use Hyperf\Crontab\Annotation\Crontab;</p><h1>[Crontab(name: 'Heartbeat', rule: '<em>/10 </em> <em> </em> <em> </em>')]</h1><p>class HeartbeatCrontab extends AbstractCrontab
{
public function execute(): void
{
echo "[HEARTBEAT] " . date('H:i:s') . PHP_EOL;
}
}</p>