CodeIgniterCLI应用开发教程

CodeIgniter 3 默认无法直接通过命令行运行其 index.php 入口文件，因其严重依赖 HTTP 环境变量（如 $_SERVER['REQUEST_METHOD']），而在 CLI 模式下这些变量缺失会导致“Undefined index”错误或白屏；正确做法是复制 index.php 为专用的 cli.php，添加 PHP 脚本头并手动预设必需的 $_SERVER 变量及环境标识，从而安全、稳定地启用 CLI 命令行功能。

CodeIgniter 3 的 index.php 能不能直接在 CLI 下运行？

不能，直接执行会报错 Undefined index: REQUEST_METHOD 或直接白屏。CI 3 默认依赖完整的 HTTP 环境（如 $_SERVER['REQUEST_METHOD']、$_SERVER['PATH_INFO']），而 CLI 模式下这些变量缺失或为空。

必须通过专用入口文件启动，且需显式设置环境为 cli。官方推荐做法是复制一份 index.php 改名为 cli.php，并在开头强制定义关键服务器变量：

#!/usr/bin/env php
<?php define('ENVIRONMENT', 'development');
$_SERVER['argv'][0] = 'cli.php'; // 防止 CI 自动重写 $argv[0]
$_SERVER['argc'] = $_ENV['argc'] ?? $_SERVER['argc'] ?? 0;
$_SERVER['argv'] = $_ENV['argv'] ?? $_SERVER['argv'] ?? [];
$_SERVER['REQUEST_METHOD'] = 'CLI';
$_SERVER['PATH_INFO'] = '';
// 后续照常引入 CI 入口逻辑...
require_once __DIR__ . '/index.php';

php cli.php your_controller your_method 为什么参数不生效？

因为 CodeIgniter 3 的 CLI 模式默认只解析前两个参数（控制器名 + 方法名），其余参数会被丢弃，除非你在控制器方法中手动读取 $this->input->argv() 或原生 $argv。

常见误区是以为 php cli.php tools backup --target=prod 中的 --target=prod 会被自动解析为键值对——CI 3 原生不支持，必须自己处理。

• 推荐方式：在控制器方法里用 array_slice($argv, 2) 获取剩余参数，再用 parse_str(implode('&', $flags), $opts) 手动解析带 = 的选项
• 更稳妥的做法：改用 getopt()（PHP 内置），例如 getopt('t:h', ['target:', 'help'])，但需确保 CLI 入口已正确传递 $argv
• 注意：$this->input->post() 和 $this->input->get() 在 CLI 下始终为空，不要依赖它们

如何让 CLI 命令支持自动补全和帮助信息？

CodeIgniter 3 本身不提供命令行 help 自动生成机制，但你可以用约定方式快速实现基础支持：

• 所有 CLI 控制器方法以 _ 开头（如 _help()）可避免被外部 URL 访问，同时作为内部帮助入口
• 在 your_controller.php 中加入 public function _help()，打印常用用法和参数说明（纯文本）
• 在 cli.php 入口顶部加一行判断：if (in_array('--help', $argv) || in_array('-h', $argv)) { exec("php " . __FILE__ . " " . $argv[1] . " _help"); exit; }
• 若需 tab 补全，需在 shell 层配置（如 Bash 的 complete -F _ci3_complete php），但这属于系统级操作，与 CI 本身无关

别指望 CI 自动识别 --verbose 这类开关；每个开关都得在方法体内显式检查 in_array('--verbose', $argv) 或解析后使用。

数据库连接、Session、日志在 CLI 下有哪些坑？

CLI 模式下数据库能连，但 Session 默认不可用（依赖 Cookie/HTTP 头），日志路径也可能因工作目录不同而写入失败。

• 数据库：只要配置项（如 hostname、username）正确，$this->db 可照常使用；但注意长任务需手动 $this->db->close() 避免连接堆积
• Session：CI 3 的 Session_driver（如 files）在 CLI 下无法初始化，调用 $this->session->set_userdata() 会静默失败；如需状态暂存，改用 file_put_contents(sys_get_temp_dir() . '/cli_state.json', json_encode(...))
• 日志：CI 的 log_message() 默认写入 APPPATH . 'logs/'，但 CLI 运行时的当前工作目录可能不是项目根目录，导致日志写入失败；建议在 cli.php 中提前 chdir(__DIR__)

最易忽略的一点：CLI 进程没有超时限制（不像 Web 请求有 max_execution_time），但数据库连接、cURL、文件锁等仍可能因等待卡死，务必设好 set_time_limit(300) 和超时参数。

今天关于《CodeIgniterCLI应用开发教程》的内容就介绍到这里了，是不是学起来一目了然！想要了解更多关于的内容请关注golang学习网公众号！