yii框架定时任务需通过console控制器（继承yii\console\controller，actionxxx方法）配合系统crontab实现，禁用config/console.php中非官方的task配置；crontab须用绝对路径、显式cd切换目录、完整重定向输出，并注意php cli环境一致性。
Yii框架本身不内置 Cron 调度器，所有定时任务必须靠「控制台命令 + 系统 crontab」组合实现。别试图在 config/console.php 里配 pattern 或 task 组件——那些是第三方扩展或过时写法，官方 Yii2/3 均不支持。
怎么写一个可被 crontab 调用的 Console 控制器
核心是继承 yii\console\Controller，方法名必须是 actionXXX 形式，且类名以 Controller 结尾：
- 路径必须在
commands/目录下（如app\commands\CleanLogController），命名空间要匹配目录结构 - 方法内避免依赖
$_GET、$_SERVER['HTTP_HOST']等 Web 环境变量；改用Yii::$app->params或传参 - 若需数据库操作，确认
console.php中已正确配置db组件，且连接未被 Web 配置覆盖 - 加日志比 echo 更可靠：
Yii::info('Start cleaning logs', 'cron')，日志通道建议单独配croncategory
示例：
namespace app\commands;
<p>use yii\console\Controller;</p><p>class CleanLogController extends Controller
{
public function actionRun($days = 30)
{
$cutoff = strtotime("-{$days} days");
$affected = \app\models\Log::deleteAll(['</p><h3>crontab 表达式怎么填才不踩坑</h3><p>Linux 的 <code>crontab -e</code> 不认 Yii 的「每 5 分钟」语义，只认标准五段式。常见错误包括：</p><div class="aritcle_card flexRow artxards">
<div class="artcardd flexRow">
<a class="aritcle_card_img" rel="nofollow" href="/xiazai/gongju/2519" title="Yii Framework 2.0.51"><img
src="https://img.php.cn/upload/manual/001/503/042/6a6b069743ad2879.png" alt="Yii Framework 2.0.51" onerror="this.onerror='';this.src='/static/lhimages/moren/morentu.png'" ></a>
<div class="aritcle_card_info flexColumn">
<a rel="nofollow" href="/xiazai/gongju/2519" title="Yii Framework 2.0.51" class="overflowclass">Yii Framework 2.0.51</a>
<p class="overflowclass">下载 Yii Framework 2.0.51 官方 Basic 应用模板，查看 Composer 安装方式、版本信息与开发文档。</p>
</div>
<a rel="nofollow" href="/xiazai/gongju/2519" title="Yii Framework 2.0.51" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span>
</a>
</div>
</div>
- 误把
*/5 * * * *写成5 * * * *（后者是「每小时第 5 分钟」，不是「每 5 分钟一次」） - 忽略 PHP 解释器路径：用
which php确认真实路径，比如/usr/bin/php或/opt/homebrew/bin/php，别直接写php - 没设工作目录，导致相对路径（如
./runtime）失效 —— 必须用cd /path/to/app &&显式切换 - 输出重定向不完整：
> /dev/null 2>&1缺一不可，否则失败时 cron 会发邮件报警（很多服务器默认开启）
正确写法（每天凌晨 2:15 执行）：
15 2 * * * cd /var/www/myapp && /usr/bin/php yii clean-log/run --days=90 > /dev/null 2>&1
参数和选项怎么传给 action 方法
Yii 控制台自动解析位置参数和命名选项，但规则很具体：
- 位置参数按顺序绑定到
actionXxx($a, $b, $c)的形参，不能跳过中间参数 - 命名选项必须带
--前缀，如--force=1或--dry-run；布尔选项值可省略（--force即 true） - 在 action 内用
$this->isColor() ? 'ansi' : 'plain'判断是否交互模式，避免日志里混入 ANSI 字符 - 不要在 action 中调用
exit()；应返回整数退出码：return ExitCode::OK（0）或ExitCode::UNSPECIFIED_ERROR（1）
对应命令行调用：
php yii clean-log/run 60 --force --verbose
为什么任务没执行？优先查这三处
90% 的失败不是代码问题，而是环境链断裂：
-
crontab -l看到的配置，是否属于运行 web 服务的同一用户？sudo -u www-data crontab -e和crontab -e是不同用户的 crontab - PHP CLI 版本是否和 Web 版本一致？
php -v和php -i | grep 'Loaded Configuration File'查 CLI 配置路径 - Yii 应用是否启用了调试模式？
YII_DEBUG在 console 环境中也需明确定义，否则某些组件（如日志路由）可能不加载
复杂点在于：crontab 的 PATH 环境变量极简，which php 结果可能不在其 PATH 里；最稳妥的做法永远是写绝对路径，而不是赌环境变量。
