必须用绝对路径调用php解释器、cd到项目根目录、显式设置app_env环境变量，三者缺一不可；否则因cron环境缺失path、autoload.php路径错误或配置加载异常导致失败。

Linux cron 调用 php think 命令总失败？先锁死三要素

直接写 * * * * * php think task:send 几乎必翻车。根本原因不是命令写错，而是 cron 运行时缺失关键上下文。

• 必须用绝对路径调用 PHP：/usr/bin/php，不能只写 php（cron 不读你的 $PATH）
• 必须 cd 到项目根目录再执行：否则 think 找不到 vendor/autoload.php，报 Class not found
• 必须显式指定环境变量：APP_ENV=production，否则配置加载错乱，数据库连接、缓存驱动都可能出问题

正确写法示例：
0 2 * * * cd /var/www/myapp && APP_ENV=production /usr/bin/php think cleanup:logs >> /var/log/cleanup.log 2>&1

cron 配置里 think:timer 或 think:run 是什么？别用

ThinkPHP 官方没有 think:timer 这个内置命令，也不存在能长期驻留的 think:run。你看到的这类写法，要么是第三方扩展伪造的，要么是误传。

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

• think:timer 在 TP6/TP8 中并不存在，运行会直接报 Command "timer" is not defined
• 所谓“框架内置定时器”本质是行为（Behavior）+ 请求触发，依赖用户访问，app_end 钩子每来一次请求才检查一遍时间戳，漏跑率极高
• 真要秒级精度或高可靠性，必须走系统 cron + CLI 命令，或者上 Workerman/Swoole 常驻进程

自定义命令类写完，为什么 php think 列表里看不到？

常见原因是命令类没被自动发现，或命名空间/路径不匹配。TP6/TP8 默认只扫描 app/command 下的类，且要求命名空间与目录结构严格一致。

• 类文件必须放在 app/command/（TP8）或 application/command/（TP6），不能放错层级
• 命名空间必须是 app\command（TP8）或 app\command（TP6），不是 app\admin\command 或 app\common\command
• 类名需遵循 PascalCase，且 configure() 中 setName('xxx:yyy') 的值必须唯一，不能和其他命令重复
• 首次添加命令后，建议清空 runtime/cache/ 目录，避免命令注册缓存未更新

日志空白、任务静默失败？检查这三处输出重定向

很多任务看似没执行，其实是执行了但错误被吞掉，或者日志路径不可写。

• >> /path/to/log 只追加标准输出（stdout），PHP error_log()、异常堆栈、trigger_error() 默认走 stderr，必须加 2>&1 合并重定向
• 确保日志目录存在且 web 用户（如 www-data）或 cron 所属用户有写权限，runtime/log 不是安全选择——cron 通常以 root 或普通用户运行，和 Web 进程用户不同
• 在命令 execute() 开头加 error_reporting(E_ALL); ini_set('display_errors', '1');，再配合 2>&1，才能捕获致命错误

真正难排查的问题，往往卡在环境变量缺失、工作路径错误、日志权限不足这三点上，而不是业务逻辑本身。

php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！