thinkphp5 无内置定时任务调度器，必须依赖系统 cron 调用命令行入口 think 执行；php 本身无进程管理能力，http 钩子式触发不可靠；推荐 linux 下用 crontab 调用 think 命令并重定向日志，配合队列与锁机制防重复。
直接结论：ThinkPHP5 本身不提供内置的计划任务调度器，所有“定时执行”都依赖外部系统级 Cron 驱动；所谓“TP 的定时任务”，本质是用 Cron 调用 TP 的命令行入口（think）或自定义指令，而非框架自己轮询或常驻。
为什么不能只写 PHP 代码就自动定时？
PHP 是请求响应式语言，没有原生进程管理能力。即使你在 app/config/crons.php 里配了数组、在 tags.php 里挂了 CronRun 行为，它也只会在每次 HTTP 请求结束时检查一次时间戳——没访问，就不触发；高并发时可能重复执行；无法精确到分钟级；日志和错误难追踪。这不是“计划任务”，只是“碰巧触发的钩子”。
真正可靠的定时，必须由操作系统级 Cron 控制启动时机，再交由 PHP 执行逻辑。
Linux 下用 Crontab 调用 think 命令（推荐）
这是最主流、最可控的方式，适用于有服务器 SSH 权限的生产环境。
- 先确保你的自定义命令已注册：在
application/command.php中添加类路径，例如'app\command\CleanCache' - 该命令类必须继承
think\console\Command，并在configure()中设好setName('cron:clean-cache') - 在服务器执行
crontab -e，添加一行（注意路径和解释器）：0 */2 * * * /usr/bin/php /var/www/myproject/think cron:clean-cache >> /var/log/clean-cache.log 2>&1
- 关键点：
-
/usr/bin/php必须是绝对路径，用which php确认 -
/var/www/myproject/think必须可执行（chmod +x），且位于项目根目录 - 建议显式切换目录：
cd /var/www/myproject && /usr/bin/php think cron:clean-cache - 务必重定向输出，否则失败无声；
2>&1把错误也写进日志
-
如何避免任务重复执行或卡死？
这是上线后最容易出问题的地方，不是加个 Cron 就万事大吉。
- 耗时操作（如导出、同步）不要直接在 Cron 指令里跑完，应推入队列：
Queue::push(new ExportJob($params))，再用php think queue:listen单独消费 - 加运行锁：在指令开头读写缓存或数据库标记，例如
Cache::has('export_lock_'.date('YmdHi'))，带 2 分钟过期 - 检查
runtime/目录权限，Cron 运行用户（通常是www-data或apache）必须有写入权，否则日志、缓存、锁全失效 - 不要用
sleep()或长循环模拟定时——PHP 脚本超时会被 kill，且阻塞整个 Cron 进程
没有服务器权限时的替代方案（慎用）
仅适用于共享主机、测试环境或临时需求，不可用于生产。
启用 CronRun 行为扩展后，它靠 app_end 钩子在每次请求末尾检查是否该执行。这意味着：
- 网站每天至少得有几次真实访问，否则任务永远不会跑
- 如果多个请求同时到达，可能并发执行同一任务（需自行加锁）
- 无法控制执行时刻，只能“大概每隔 N 秒检查一次”，精度差
-
F('CRON_CONFIG')存的是文件缓存，若 runtime 不可写，整个机制静默失效
真要用，至少把间隔设大些（比如 3600 秒），并确保 CRON_CONFIG_ON 开启、crons.php 返回格式正确（数组键为任务名，值为 [类名, 秒数]）。
复杂点在于：Cron 规则本身不感知 PHP 环境，而 ThinkPHP 命令又高度依赖 APP_PATH、RUNTIME_PATH 和配置加载顺序。一个看似简单的 */5 * * * * php think task:run，实际可能因路径错、环境变量缺、权限不足、输出未捕获，变成“写了却从不执行”的幽灵任务。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
