Yii2.0 在 PHP 命令行中运行脚本的方法与步骤

拾光

发布时间：2026-10-14 | 1人浏览过

原创

当需要在计划任务或后台环境中调用 Yii2.0 应用时，必须使用其支持的 PHP 命令行接口（CLI）。本文将介绍如何基于控制台控制器（Controller）构建命令脚本，并演示正确的命令行执行语法。

结果或目标

成功创建一个可被 php yii 命令调用的后台脚本，用于替代 Web 请求中的常规控制器逻辑。

准备条件

已安装并配置好的 Yii2.0 项目环境。
php 命令已正确添加至系统环境变量中。
具备项目根目录的操作权限。

第1步：验证 PHP 环境变量

目的：确保命令行能直接识别 php 指令，避免路径错误导致脚本无法执行。

动作：在终端输入以下命令进行检查：

php -v

完成状态：若返回 PHP 版本信息，则环境配置无误；若无反应或报错，需先将 PHP 可执行文件路径加入系统的 PATH 环境变量中。

第2步：理解控制器继承结构

Yii2.0 中 Web 与 CLI 环境的控制器类存在明显区分，这是编写命令行脚本的基础：

yii\console\Controller：专门用于命令行（CLI）环境的基类。
yii\web\Controller：用于处理 HTTP Web 请求的基类。
yii\base\Controller：两者的公共基础父类。

关键点：命令行下的自定义脚本必须继承自 yii\console\Controller。

第3步：新建命令控制器文件

入口位置：项目根目录下的 commands/ 文件夹。

操作：参照默认的 HelloController.php 示例文件，创建新的控制器。例如新建 YourController.php，基本结构如下：

<?php
namespace app\commands;

use yii\console\Controller;

class YourController extends Controller
{
    /**
     * 定义一个名为 index 的动作，默认输出 'hello world'
     */
    public function actionIndex($message = 'hello world')
    {
        echo $message . "\n";
    }
}

参数说明： - actionIndex 是默认执行的方法，对应命令行的子命令。 - 方法参数（如 $message）会自动映射为命令行输入的参数。

第4步：执行命令行脚本

入口：终端（Terminal/CMD）。

动作：切换到项目根目录，使用标准语法执行：
php yii <ControllerID>/<ActionID>

示例：
假设要执行上述 YourController 的 actionIndex 方法：

php yii your/index

若需要传入自定义参数，可直接追加在命令后：

php yii your/index "custom message"

执行成功后，终端应打印出对应的输出内容。

简要总结

Yii2.0 的命令行运行依赖于 commands 目录下的 console\Controller 派生类。只要确保 PHP 环境变量配置正确，并通过 php yii controller/action 格式调用，即可在服务器后台高效执行任务。以上就是Yii2.0在PHP命令行中运行的详细内容，更多关于Yii2命令行开发技巧的资料请关注本站其它相关文章！