thinkphp使用之定时任务与Crontab【自动化】-ThinkPHP-PHP中文网

thinkphp定时任务必须通过linux crontab调用php think命令实现，核心是编写继承think\console\command的命令类，置于app/command目录、命名空间为app\command，并在configure()中用setname()定义命令名；execute()中禁用web上下文，直接调用db、cache等组件，返回0表示成功；crontab条目须显式cd项目根目录、用php绝对路径执行并重定向日志。

thinkphp使用之定时任务与crontab【自动化】

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()。

`crontab` 条目为什么总不执行

90% 的失败不是代码问题，而是环境没对齐。常见表现和对应解法：

Obsidian (Linux)

操作 Obsidian 库（纯 Markdown 笔记），并通过 notesmd-cli 实现自动化。

下载

日志为空或报 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 没有“默认上下文”，每一步都得写死。