thinkphp定时任务需将业务封装为命令行指令并由linux crontab调用，核心是创建继承think\console\command的命令类（置于app/command/目录、正确命名空间与注册）、在项目根目录测试php think命令可用、crontab中用绝对路径cd项目根目录后执行php think指令并重定向日志。
ThinkPHP部署定时任务不是“开个开关就自动跑”，而是把业务逻辑封装成命令行指令，再由操作系统按时调用。核心就两步：写好命令类 + 配置系统级定时器（通常是Linux crontab）。下面按实际落地顺序讲清楚。
一、创建可执行的命令类
命令类必须放在 app/command/ 目录下，文件名和类名严格匹配命名空间。比如你要做一个清理缓存的任务：
- 新建文件 app/command/CleanCache.php
- 类名写成 CleanCache，命名空间为 app\command
- 继承 think\console\Command
- 在 configure() 方法里设命令名和描述：
$this->setName('cron:clean-cache')->setDescription('清理运行时缓存'); - 在 execute() 方法里写真实逻辑，例如：
\think\Cache::clear(); $output->writeln('缓存已清空');
二、注册命令到框架
ThinkPHP不会自动扫描命令目录，必须显式注册。打开 app/command.php 文件，确保它存在且返回一个数组：
- 如果文件不存在，手动创建，内容为：
<?php return ['app\command\CleanCache']; - 多个命令就写多个完整类名字符串，不能省略命名空间，也不能写别名
- 哪怕只注册一个命令，也必须是数组格式，空数组也得写
return [];
三、测试命令是否可用
别跳过这步，本地验证能避免90%的线上失败：
- 在项目根目录运行：
php think list，看输出里有没有cron:clean-cache - 直接执行：
php think cron:clean-cache，观察是否输出“缓存已清空”且 runtime/cache 目录变空 - 如果报错 Class not found 或 Command not defined，优先检查命名空间、文件路径、注册数组这三项是否完全一致
四、配置Linux crontab触发
这才是真正让任务“定时”的环节。crontab不认你的shell环境，所有路径必须绝对化：
- 用
crontab -e编辑任务列表 - 添加一行（以每5分钟执行为例）：
*/5 * * * * cd /var/www/myproject && /usr/bin/php think cron:clean-cache >> /var/log/clean.log 2>&1 -
cd /var/www/myproject确保工作目录正确，否则自动加载和配置读取会失败 -
/usr/bin/php要用which php确认真实路径，不能写php - 日志重定向
>> /var/log/xxx.log 2>&1很关键，出错时才有迹可循
五、生产环境注意事项
上线前多看一眼这些细节，能避开大部分静默失败：
- 确认 runtime/ 目录对运行 cron 的用户（如 www-data）有读写权限
- 检查 app/config/console.php 中
'scheduling' => true是否开启（TP8要求） - 开发环境默认跳过调度，临时测试加
APP_ENV=production php think cron:clean-cache - 避免在命令构造函数里访问数据库或配置；需要时在
execute()开头手动初始化：app('db')或Db::connect()
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
