ThinkPHP定时任务必须通过Linux crontab调用php think命令实现，核心是编写继承think\console\Command的命令类，置于app/command目录、命名空间为app\command，并在configure()中用setName()定义命令名；execute()中禁用Web上下文，直接调用Db、Cache等组件，返回0表示成功；crontab条目须显式cd项目根目录、用PHP绝对路径执行并重定向日志。
ThinkPHP 本身不提供常驻进程式定时调度器，所有可靠、可运维的定时任务都必须走 Linux crontab 调用 php think 命令——这是唯一被生产环境验证过的方式，其他方案要么依赖访问流量（如行为钩子），要么容易失控（如 sleep 循环）。
怎么写一个能被 crontab 正确调用的 ThinkPHP 命令
命令类必须满足三个硬性条件，缺一不可：
- 放在
app/command/目录下，命名空间为app\command - 继承
think\console\Command，并在configure()中用$this->setName('cron:clear-cache')显式定义命令名 -
execute()方法里不要用$_SERVER、Request::instance()或任何 Web 上下文相关逻辑；数据库、配置、缓存均可直接调用
示例片段：
protected function execute(Input $input, Output $output)
{
\think\Cache::clear();
trace('cache cleared', 'cron');
$output->writeln('✅ 缓存已清空');
return 0;
}注意：返回 0 表示成功，非零值会被 crontab 记为失败；别用 exit() 或 die()。
立即学习“PHP免费学习笔记（深入）”；
crontab 条目为什么总不执行
90% 的失败不是代码问题，而是环境没对齐。常见表现和对应解法：
- 日志为空或报
Class not found：说明工作目录错了，crontab默认在/root下运行，必须显式cd /var/www/myproject && - 报
Command "cron:clear-cache" is not defined：命令没注册或命名空间写错，确认config/console.php中'commands'数组已包含该类映射 - 报
PHP Fatal error: Uncaught PDOException：CLI 环境下localhost可能解析失败，把config/database.php中的hostname改成127.0.0.1 - 日志写不进
runtime/log/：检查目录权限，确保crontab执行用户（通常是root）和 Web 用户（如www-data）都能写，建议chown -R www-data:www-data runtime/并chmod -R 775 runtime/
crontab 表达式与日志重定向怎么写才靠谱
别信“先跑起来再说”，每条规则必须带路径、绝对 PHP 路径、日志重定向：
- 用
which php查真实路径，比如/usr/bin/php或/opt/homebrew/bin/php（macOS M1/M2） - 表达式末尾必须接完整命令链：
0 */2 * * * cd /var/www/myproject && /usr/bin/php think cron:clear-cache >> runtime/log/cron/clear.log 2>&1 -
>> runtime/log/cron/clear.log 2>&1是关键：把标准输出和错误都追加到日志，否则失败无声无息 - 测试时先用
* * * * * ...（每分钟一次），等看到日志再调回真实周期
别省 cd 和 >>，crontab 没有“默认上下文”，每一步都得写死。
为什么不能用 ThinkPHP 内置的 Cron 行为扩展
它靠 app_end 钩子在每次 HTTP 请求结束时检查时间戳，本质是“被动触发”：
- 站点没访问，任务就永远不执行；流量低峰期可能积压数小时
- 多个请求并发进来，可能重复触发同一任务，除非你自己加 Redis 锁
- 无法监控执行状态、失败重试、超时控制——这些都得额外补
- 只适合开发调试或低频轻量任务（如每小时检查一次配置变更），不适合清理缓存、同步订单这类强时效性任务
真正要上线的任务，crontab + php think 是唯一可控、可审计、可定位的路径。
