ThinkPHP定时任务有五种方案:一、Linux Crontab直接调用PHP脚本;二、自定义命令行指令配合Crontab;三、内置行为扩展模拟Cron;四、Worker常驻进程实现毫秒级调度;五、Shell脚本封装多条件判断逻辑。

如果您希望在ThinkPHP项目中实现定时执行特定逻辑(如清理缓存、发送通知或同步数据),但又不依赖外部系统主动触发,则需配置定时任务计划。以下是多种可落地的自动化配置方案:
一、使用Linux Crontab直接调用PHP脚本
该方法由操作系统内核级调度,完全独立于Web请求,稳定性最高,适用于拥有服务器SSH权限的场景。
1、通过SSH登录服务器,执行crontab -e进入编辑模式。
2、添加一行标准Cron表达式,例如每5分钟执行一次指定脚本:
*/5 * * * * /usr/bin/php /var/www/myproject/think cron:run >> /var/log/think-cron.log 2>&1
立即学习“PHP免费学习笔记(深入)”;
3、确保/usr/bin/php为实际PHP解释器路径,可通过which php确认。
4、确认/var/www/myproject/think为项目根目录下的可执行入口文件,且具有可执行权限。
5、保存退出后,系统自动加载新规则,无需重启服务。
二、通过ThinkPHP自定义命令行指令配合Crontab
此方式将业务逻辑封装为命令行指令,再由Crontab按周期调用,兼顾框架规范性与系统级可靠性。
1、在app/command/目录下新建指令类文件,例如CleanCache.php,命名空间为app\command。
2、在configure()方法中设定指令名称与描述:$this->setName('cron:clean-cache')->setDescription('清理运行时缓存');
3、在execute()方法中编写具体逻辑,例如:\think\Cache::clear(); $output->writeln('缓存已清除');
4、在服务器端Crontab中调用该指令:
0 */2 * * * /usr/bin/php /var/www/myproject/think cron:clean-cache >> /var/log/clean-cache.log 2>&1
5、确保runtime目录具有写入权限,避免因权限问题导致指令静默失败。
三、启用ThinkPHP内置行为扩展模拟Cron
该机制通过HTTP请求触发检查逻辑,适合无服务器权限或共享主机环境,但要求站点有稳定访问流量。
1、在app/config/tags.php中注册行为钩子:'app_end' => ['\behavior\CronRun']。
2、在app/config/crons.php中定义任务数组:return ['cache_clean' => ['app\common\job\CacheClean', 3600]];,其中3600表示间隔秒数。
3、创建任务类app\common\job\CacheClean.php,必须实现run()方法,内部执行具体操作。
4、确保app/common/job/目录存在且可被自动加载,类名与命名空间严格匹配。
5、每次用户访问任意页面时,框架将在app_end阶段检查各任务是否到达执行时间点,并触发对应run()方法。
四、基于Worker常驻进程实现毫秒级精度调度
适用于需要高频率响应(如每秒轮询)、低延迟执行或长连接维持的场景,需额外安装扩展并以守护进程运行。
1、执行composer require topthink/think-worker安装Worker支持包。
2、在config/console.php中注册指令:'timer' => \app\command\Timer::class。
3、创建app/command/Timer.php,在execute()中启动循环:while(true) { $this->doTask(); sleep($this->interval); }。
4、在doTask()中调用实际业务方法,例如数据库状态检测或消息队列推送。
5、通过php think timer start --d启动为后台守护进程,进程PID将被记录,异常退出后需手动重启。
五、使用Shell脚本封装多条件判断调度逻辑
当任务触发需满足复合时间条件(如每月10日+凌晨3点)或需进程防重时,Shell脚本能提供更灵活的控制能力。
1、新建shell/cron-runner.sh脚本,首行声明解释器:#!/bin/bash。
2、定义项目路径与PHP路径变量:appPath=$(cd "$(dirname "$0")/.."; pwd),phpPath=$(which php)。
3、使用date命令提取当前日期组件,构造条件判断:if [[ "$day" -eq "10" && "$hour" -eq "3" ]]; then。
4、在条件块内检查进程是否存在:pid=$(ps -ef | grep "think task_monthly" | grep -v grep | awk '{print $2}')。
5、仅当进程未运行时才启动新实例:if [[ ! -n "$pid" ]]; then $phpPath $appPath/think task_monthly >> $appPath/runtime/log/monthly.log 2>&1 & fi。



















