CodeIgniter 4中如何正确使用CLI命令执行控制器方法

问题根因 #

你遇到404错误是两个常见配置问题导致的：

• 方法名与类名重名：虽然PHP 7+已经不再将类同名方法识别为构造函数，但CodeIgniter 4的自动路由逻辑会过滤这类和类名重名的方法，不会将其作为可访问的控制器路由入口
• 默认路由大小写转换规则：CodeIgniter 4自动路由默认会将URI段的驼峰格式转换为小写+下划线格式，直接传递驼峰方法名会匹配失败

修复步骤 #

1. 调整控制器方法名 #

避免方法名和类名重名，修改app/Controllers/ExportAlert.php的代码：

<?php
namespace App\Controllers;
use CodeIgniter\Controller;

class ExportAlert extends Controller
{   
    public function index()
    {   
                
    }

    // 将原和类名重名的ExportAlert方法改名，例如改为exportData
    public function exportData() { 
        if ($this->request->isCLI()) { 
            echo "Ok"; 
        } else { 
            echo "Not allowed"; 
        }                          
    }
}

2. 确认自动路由配置 #

打开app/Config/Routes.php，确保自动路由配置开启（默认状态为开启，若你之前手动关闭过需要改回）：

// 普通自动路由
$routes->setAutoRoute(true);
// CI 4.2及以上版本可以额外开启改进版自动路由
$routes->setAutoRouteImproved(true);

正确CLI调用控制器格式 #

CodeIgniter 4 CLI调用控制器的通用语法为：
php 项目根目录/public/index.php 控制器名 方法名 [可选参数1 可选参数2...]
注意：控制器名首字母需要大写，方法名如果是驼峰格式，调用时可以写全小写，或者用下划线分隔的格式。

你修复后对应的执行命令为：

E:\Codeigniter4\mywebapp>php public/index.php ExportAlert exportData

优化建议 #

如果是固定的CLI功能，更推荐使用CodeIgniter 4的自定义命令实现，不需要走路由匹配逻辑，稳定性和性能都更好。

内容的提问来源于stack exchange，提问作者Dennis Liu