定时任务 Cron

内置 Cron 表达式调度器。

配置

创建 config/cron.php：

return [
    'tasks' => [
        [
            'name'        => 'cleanup',
            'cron'        => '0 0 * * *',
            'command'     => \App\cron\CleanupTask::class,
            'description' => '每日清理临时文件',
        ],
        [
            'name'        => 'backup',
            'cron'        => '0 3 * * *',
            'command'     => \App\cron\BackupTask::class,
            'description' => '每日数据备份',
        ],
    ],
];

每个任务支持以下字段：

字段	类型	必填	说明
name	string	是	任务名称，需唯一
cron	string	是	Cron 表达式
command	string	是	命令类名，需实现 public function handle(): void
description	string	否	任务描述

command 指向的类由容器解析，调用其 handle() 方法执行任务。

运行

cron:schedule 会每分钟启动一个子进程执行 cron:run，无需依赖系统 crontab，建议配合 supervisor / systemd 守护运行：

php lee cron:schedule

启动后输出：

Cron schedule started. Press Ctrl+C to stop.

每次调度通过独立子进程执行，避免内存泄漏与状态污染。cron:run 异常退出时会打印退出码。

调度循环会将休眠对齐到下一分钟边界，确保每轮 cron:run 都在整分钟触发，避免因子进程耗时累积导致触发时刻漂移、漏过整分钟任务。

查看任务列表

php lee cron:list

输出所有已注册的定时任务，包含名称、Cron 表达式和描述：

Scheduled tasks: (2)

  cleanup  0 0 * * *     每日清理临时文件
  backup   0 3 * * *     每日数据备份

Cron 表达式

* * * * *
│ │ │ │ │
│ │ │ │ └── 星期几 (0-7, 0 和 7 都是周日)
│ │ │ └──── 月份 (1-12)
│ │ └────── 日期 (1-31)
│ └──────── 小时 (0-23)
└────────── 分钟 (0-59)

常用示例：

• * * * * * — 每分钟
• 0 * * * * — 每小时
• 0 0 * * * — 每天零点
• 0 9 * * 1 — 每周一 9 点
• */5 * * * * — 每 5 分钟
• 0 0 1,15 * 5 — 每月 1 号、15 号 以及 每周五零点

日期与星期的匹配规则

日期（第 3 段）与星期（第 5 段）遵循标准 cron（Vixie）语义：

• 任一字段为通配（* 或 */n）时，两者按「与」匹配：受限字段必须命中
• 两者都被限制时，按「或」匹配：日期或星期任一命中即触发

例如 0 0 1,15 * 5 表示「每月 1 号、15 号，或每周五」的零点执行，而不是「1 号/15 号恰好是周五」。

注意：0-6 这类显式枚举即使覆盖完整星期范围，也不算通配，仍会与日期形成「或」关系。