ThinkPHP 8定时任务需创建继承think\console\Command的命令类并配置crontab调用：一、命令类置于app/command/目录，用php think make:command生成，configure()设命令名，execute()写业务逻辑；二、本地执行php think 命令测试；三、crontab中用绝对路径cd项目根目录后执行php think指令并重定向日志。
ThinkPHP 8 的定时任务不是靠框架自己“守着钟表”跑，而是用 PHP 命令行脚本 + 操作系统级调度（如 Linux 的 crontab）配合完成的。核心就两点：写一个可执行的命令类，再让系统定期调用它。不复杂，但容易忽略环境、路径和权限细节。
一、创建命令类：业务逻辑的载体
所有自定义定时任务都封装在一个继承 think\console\Command 的 PHP 类里，必须放在 app/command/ 目录下（注意是小写 command，不是 Command）。
- 推荐用命令行生成骨架：
php think make:command DailyReport，会自动创建app/command/DailyReport.php - 关键方法有两个：
configure()里设命令名（如report:daily）和描述；execute(Input $input, Output $output)里写真实业务，比如查数据库、发邮件、清理缓存 - 命名建议用“分组:动作”格式，如
stat:user-active或cache:refresh，方便后续管理 - 可以在
execute中使用 ThinkPHP 的各种门面（如Log::info()、Db::table()），和控制器里写法一致
二、本地测试：确认命令能独立运行
别跳过这步——很多线上失败的问题，其实在本地就能暴露。
- 在项目根目录执行：
php think report:daily（换成你自己的命令名） - 观察是否正常输出、是否有报错、数据库或日志是否按预期更新
- 如果报错，重点检查：PHP CLI 版本是否与 Web 一致（
php -vvsphpinfo()）、.env 环境变量是否加载（CLI 默认不读 .env，需确保配置已生效）、数据库连接是否通 - 加一句
$output->writeln('Task completed at ' . date('Y-m-d H:i:s'));是最简单的验证手段
三、配置系统级定时器（以 Linux crontab 为例）
这才是真正“定时”的地方。Cron 不认识你的 PHP 代码，只认一条完整的 shell 命令。
立即学习“PHP免费学习笔记（深入）”；
- 编辑当前用户的计划任务：
crontab -e - 添加一行，例如每天凌晨2点执行：
0 2 * * * cd /var/www/myproject && /usr/bin/php think report:daily >> /var/www/myproject/runtime/log/cron.log 2>&1 - 注意三个关键点：
–cd切到项目根目录（否则 think 命令找不到配置）
– 用绝对路径调用php（which php查看，避免 Cron 使用默认系统 php）
– 重定向日志（>>和2>&1）便于排查失败原因 - 保存后，可用
crontab -l查看是否生效，systemctl status cron确保服务在运行
四、生产环境避坑要点
上线后最常见的问题，往往和开发时的“理所当然”有关。
-
权限问题：Cron 默认可能以
root或www-data身份运行，检查runtime/目录、日志文件、缓存目录是否对该用户可读写（chown -R www-data:www-data runtime/） -
环境隔离：CLI 模式不自动加载
.env，确保数据库、Redis 等配置已在config/database.php等文件中硬编码或通过其他方式注入 -
超时与内存：长时间任务记得在
execute开头加set_time_limit(0);和ini_set('memory_limit', '512M'); - 并发控制：避免同一任务被多次触发（比如网络延迟导致上一次没结束，下一次又启动），可在任务开头加文件锁或数据库标记
