ZF2/3的cli.php不工作，因未显式传入ConsoleRequest且路由未配置console类型；正确做法是新建bin/console脚本手动创建ConsoleRequest并调用$application->run()。
Zend Framework 2/3 的 cli.php 入口不工作？先确认是否还在用 ZF2/3
Zend Framework 已于 2019 年停止维护，ZF3 是最后一个版本；2021 年起所有组件迁移至 Laminas Project。如果你的项目里还存在 public/index.php 同级的 cli.php，大概率是 ZF2 遗留结构——它不会被自动识别为 CLI 入口，也不会加载 ConsoleRouter。
实际能跑起来的 CLI 应用，必须满足两个前提：
-
Application实例需显式传入Console请求对象（而非默认的Http） - 路由配置中必须启用
console类型的路由（'type' => 'Console'），且不能和 HTTP 路由混写
ZF3 中如何正确启动 CLI 请求？别直接 require cli.php
ZF3 的 cli.php 示例文件只是个引导模板，不是可执行入口。它缺了关键一步：构造 ConsoleRequest 并注入到 Application。
正确做法是新建一个独立脚本（比如 bin/console），内容类似：
立即学习“PHP免费学习笔记（深入）”；
#!/usr/bin/env php
<?php
chdir(dirname(__DIR__));
require 'vendor/autoload.php';
// 手动创建 ConsoleRequest，否则路由匹配失败
$consoleRequest = new ZendConsoleRequest();
$consoleRequest->setExitStatus(false); // 避免 exit() 中断调用链
$application = new ZendMvcApplication(
require 'config/application.config.php',
new ZendMvcServiceServiceManagerConfig()
);
$application->bootstrap();
$application->run($consoleRequest); // 必须显式传入
常见错误：
- 直接
php cli.php some:command→ 报错Route with name "home" not found，因为没触发 console 路由器 - 忘了
setExitStatus(false)→ 命令执行完直接exit(0)，后续单元测试或集成调用会中断
定义命令时为什么 ConsoleRoute 总是 404？检查路由 key 和参数格式
ZF3 的 console 路由必须放在配置数组的 'console' 键下，且 route 字符串里不能有空格、斜杠需转义。例如：
'routes' => [
'console' => [
'options' => ['route' => 'user:create [:name] [--active]'],
'defaults' => [
'controller' => 'Application\Controller\User',
'action' => 'create',
],
],
],
注意几个硬性规则：
-
route字符串中冒号前后不能有空格：[:name]✅，[: name]❌ - 布尔选项必须用双短横：
--active✅，-active或/active❌ - 控制器类名必须带完整命名空间，且该类需实现
ZendConsoleAdapterAdapterInterface兼容接口 - 如果用了
ZendMvcControllerAbstractConsoleController，记得在 action 里调用$this->console->writeLine()而非echo
Laminas（ZF4+）里 CLI 改用 laminas-cli，旧配置全失效
迁移到 Laminas 后，ZendMvcApplication 不再支持 console 模式，原生路由系统已剥离。必须安装新包：
composer require laminas/laminas-cli
然后在 config/modules.config.php 加上 'LaminasCli'，并把命令定义改写成 Command 类：
namespace AppCommand;
use LaminasCliArgs;
use LaminasCliCommand;
class CreateUserCommand extends Command
{
protected $name = 'user:create';
protected $description = 'Create a new user';
public function execute(Args $args): int
{
$name = $args->get('name');
$active = $args->get('active', false);
// ...
return self::SUCCESS;
}
}
这个改动意味着：
- 所有 ZF3 的
console路由配置彻底无效，不能复用 -
$args->get()返回值类型更严格（null/string/bool），没有隐式类型转换 - 退出码必须显式返回
self::SUCCESS或self::FAILURE，否则 shell 判断失败
最常被忽略的是命名空间路径和模块注册顺序——AppCommand* 类必须被 laminas-cli 的自动发现机制扫到，否则命令列表里根本不会出现。
