CLI参数按空格切片后依序注入控制器方法形参,支持默认值;含空格值须用英文双引号包裹;所有参数均为字符串,无自动类型转换;$_GET和$this->input->get()在CLI下始终为空,因未设置QUERY_STRING。

CLI 参数必须按位置顺序传,不能用 --key=value 或 -k 这类命名参数;框架原生不解析键值对,只拆分空格后的字符串数组。
CLI 参数怎么被控制器方法接收
CodeIgniter 3 的 CLI 调用本质是把命令行参数按空格切片后,依次注入控制器方法的形参(支持默认值)。例如执行 php index.php tools message "John Smith",会调用 Tools::message($to),其中 $to 就是 "John Smith"。
- 参数个数必须匹配:如果方法定义为
public function backup($date, $force = false),则至少要传一个参数,php index.php tools backup 2026-04-19才合法 - 含空格的值必须用英文双引号包裹,否则会被截断成多个参数
- 没有自动类型转换:所有参数都是字符串,
"123"不会变成整型123,需手动(int)$date - URL 风格的查询参数(如
?a=1&b=2)在 CLI 下完全无效,$_GET始终为空
为什么 $this->input->get() 在 CLI 下拿不到参数
因为 CLI 模式下 PHP_SAPI 是 cli,$this->input 类内部靠 $_SERVER['QUERY_STRING'] 和 $_GET 构建数据,而命令行根本不会设置这些超全局变量。你看到的参数是直接通过 $argv 传进来的,框架只是做了位置映射,没走 HTTP 输入流。
- 别在 CLI 控制器里写
$this->input->get('foo'),它永远返回null - 想兼容 HTTP 和 CLI?得自己从
$argv提取或统一用构造函数/方法参数接收 -
$this->input->is_cli_request()可用于判断当前是否 CLI 环境,但不能帮你取参数
CodeIgniter 4 的 spark 命令参数规则不同
CI4 不走 index.php 入口,而是通过 spark 脚本调用命令类,参数解析由 CodeIgniter\CLI\CLI 类处理,支持命名参数和选项,但前提是命令类显式声明了 $params 和 $options 属性。
- 基础调用仍是位置参数:
php spark db:seed UserSeeder中UserSeeder是第一个位置参数 - 要支持
--force或-f,必须在命令类里定义:protected $options = ['force' => 'Force re-run']; - 未声明的选项会被忽略,不会报错也不会透传到方法里
- 位置参数仍优先于选项参数绑定,比如
php spark migrate:version 20230101 --force,20230101会进$params[0],--force进$options
容易踩的坑:参数空格、引号、类型混淆
最常出问题的是 Windows 用户直接双击运行或在 CMD 里漏掉引号,导致参数被系统提前分割。比如想传 John Doe,写成 php index.php tools message John Doe,实际收到的是两个参数 John 和 Doe,方法只取第一个,输出 Hello John!。
- Windows 下 CMD 对双引号支持较弱,建议改用 PowerShell 或 Git Bash
- CI3 不校验参数个数,少传参数会导致方法内变量为
null,可能引发 Notice 或逻辑错误 - CI4 的
spark命令若缺少必需参数,会交互式提示输入,但脚本化调用时这会卡住进程,务必补全 - 日志中记录 CLI 参数时,别直接拼接
$argv,注意过滤敏感字段(如密码),因为$argv会包含完整命令行字符串










