<p>ThinkPHP 8 不解析 Cron 表达式，真正解析执行的是操作系统 crontab；其定时机制为“命令+外部 Cron”协作模式：在命令类中用链式方法（如->dailyAt()）定义业务节奏，在服务器 crontab 中配置表达式（如0 2 *）决定调用频率。</p>
ThinkPHP 8 本身不解析 Cron 表达式，它不直接调度任务；真正的 Cron 表达式由操作系统（如 Linux 的 crontab）负责解析和触发。ThinkPHP 8 的定时任务机制是「命令 + 外部 Cron」协作模式：你写好 PHP 命令类，再用系统级 Cron 按表达式周期调用 php think schedule:run 或直接调用你的自定义命令。
Cron 表达式在哪写？
不在 ThinkPHP 代码里写，而是在服务器的 crontab 中配置。例如：
-
*/5 * * * * cd /var/www/myapp && /usr/bin/php think schedule:run >> /dev/null 2>&1→ 每 5 分钟执行一次调度扫描 -
0 2 * * * cd /var/www/myapp && /usr/bin/php think report:daily >> /var/log/daily-report.log 2>&1→ 每天凌晨 2 点执行日报命令 -
0 9,14 * * 1-5 cd /var/www/myapp && /usr/bin/php think notify:workday >> /dev/null→ 工作日早 9 点、下午 2 点各执行一次
为什么不能在 PHP 里写 * * * * *？
因为 ThinkPHP 8 的 schedule:run 是一次性扫描器，不是守护进程。它只检查「此刻是否该执行某个任务」，而判断依据来自你在命令类中写的调度逻辑（比如 ->dailyAt('03:00')），不是靠解析字符串形式的 Cron 表达式。这些 PHP 链式方法最终会被转换为时间戳比对，而非交给 cron daemon。
换句话说：
✅ 你在 app/command/ 命令类中用 $schedule->command('sync:user')->hourly() 这类方法定义业务节奏；
✅ 你在服务器上用 crontab 写 * * * * * 等表达式决定「多久调用一次 ThinkPHP 的调度入口」。
常用 Cron 表达式对照与避坑点
-
* * * * *：每分钟执行（开发调试可用，生产慎用，避免高频扫描） -
*/10 * * * *：每 10 分钟一次（推荐用于常规任务扫描） -
0 0 * * *：每天 0 点整（注意服务器时区，建议统一设为 UTC 或项目所在时区） -
0 6 * * 1：每周一早上 6 点（1=周一，部分系统用0=周日，用crontab -e时可加注释说明） -
0 12 1 * *：每月 1 日中午 12 点
⚠️ 注意：
– 所有路径必须绝对（/usr/bin/php、/var/www/myapp）；
– 必须 cd 到项目根目录，否则框架无法加载配置和自动加载类；
– 不要用 ~ 或相对路径，crontab 默认工作目录是 /root。
如何验证 Cron 是否生效？
别只看 crontab -l 显示存在——要验证实际执行：
立即学习“PHP免费学习笔记（深入）”；
- 写一个最简测试命令：
echo "$(date): hello" >> /tmp/cron-test.log - 配到 crontab：
* * * * * echo "$(date): hello" >> /tmp/cron-test.log 2>&1 - 等 1 分钟，运行
tail -f /tmp/cron-test.log看是否有输出 - 成功后再替换为
php think ...，避免把问题归因错位
