ThinkPHP自定义命令类必须继承think\console\Command、类名以Command结尾、置于app/command/目录，且实现configure()和execute()方法；configure()中需调用setName()设小写冒号命名，文件名与类名严格一致，命名空间为app\command；crontab调用时须cd至项目根目录再执行php think命令；execute()开头需调用$this->app->initialize()初始化应用上下文；防重复执行应使用flock或lock文件机制。
ThinkPHP自定义命令类怎么写才被框架识别
必须继承 think\console\Command，且类名需以 Command 结尾（如 SendEmailCommand），同时放在 app/command/ 目录下——框架只扫描这个路径。类里必须实现 configure() 和 execute() 两个方法，缺一不可。
常见错误现象：php think list 不显示你的命令；运行时报错 Class not found 或 Command not defined。
-
configure()里必须调用$this->setName('your:command')，名字不能含空格或大写字母（推荐小写+冒号） - 类文件命名要和类名严格一致（如
SendEmailCommand.php对应class SendEmailCommand） - 如果用了命名空间，必须是
app\command（或你配置的console.command_path对应的命名空间）
crontab 调用 ThinkPHP 命令时路径和环境出问题怎么办
直接写 php /var/www/xxx/think your:command 很容易失败，因为 crontab 默认工作目录不是项目根目录，$_SERVER['DOCUMENT_ROOT'] 为空，think 命令找不到 vendor/autoload.php 或配置文件。
正确做法是显式指定工作目录，并用绝对路径调用 PHP 解释器：
立即学习“PHP免费学习笔记（深入）”；
*/5 * * * * cd /var/www/myapp && /usr/bin/php think your:command > /dev/null 2>&1
- 务必用
cd /path/to/project && php think ...组合，不能只写绝对路径的php - 避免用
~或相对路径，crontab 的$HOME不一定等于你的用户主目录 - 如果命令依赖
.env，确保该文件在项目根目录且权限可读（crontab 运行用户需有读取权限）
命令里调用模型或 Db 类报「No application initialized」
这是因为命令执行时未自动初始化应用上下文，Db::、UserModel:: 等静态访问会因容器未启动而崩溃。
解决方式是在 execute() 开头手动触发初始化：
- 加一行
$this->app->initialize();（适用于 TP6.0+） - 或者用
$this->app->db替代全局Db::，用$this->app->model(UserModel::class)替代 new 实例 - 不建议在命令中直接 new 模型类，会绕过容器注入，导致事件、验证器等失效
典型错误信息：Fatal error: Uncaught RuntimeException: No application initialized
为什么定时任务跑着跑着就卡住或重复执行
ThinkPHP 命令本身不带进程锁，crontab 如果上一次执行没结束（比如网络超时、死循环），下次调度又进来，就会并发跑多个实例。
- 简单方案：用
lock文件，execute()开头检查runtime/command/your-command.lock是否存在并判断是否超时（比如 30 分钟前创建） - 更可靠：改用系统级工具如
flock包裹命令：flock -n /tmp/your-command.lock -c "cd /app && php think your:command" - 别依赖
sleep()或长轮询做“等待”，命令应尽量短平快；耗时操作拆成队列或异步任务
最容易被忽略的是：crontab 时间格式写错（比如把 */5 写成 5 导致每小时第 5 分钟只跑一次），以及服务器时区和 PHP 时区不一致导致调度时间偏差。
