如何在CodeIgniter 4中扩展核心类并新增自定义函数？

CI4 没有沿用 CI3 中 MY_ 前缀自动识别扩展核心类的机制，需要通过类继承+服务重绑定或者基础父类复用的方式实现核心类扩展，正确操作步骤如下：

场景1：扩展系统核心服务类（如Request、Response、Router等） #

• 第一步：在 app/Libraries 目录（目录不存在可手动新建）下创建自定义扩展类，必须继承对应官方核心类，注意补全正确的命名空间：

<?php
namespace App\Libraries;

// 引入对应核心类的官方命名空间
use CodeIgniter\HTTP\Request as CoreRequest;

class MyRequest extends CoreRequest
{
    // 新增自定义函数
    public function getClientRealIp()
    {
        // 自定义逻辑示例
        return $this->getServer('HTTP_X_FORWARDED_FOR') ?? $this->getIPAddress();
    }
}
?>

• 第二步：修改 app/Config/Services.php，重写对应核心类的服务绑定，让框架优先加载你自定义的扩展类：

// 重写request服务绑定
public static function request(bool $getShared = true)
{
    if ($getShared) {
        return static::getSharedInstance('request');
    }

    return new \App\Libraries\MyRequest(
        new \CodeIgniter\HTTP\URI(),
        'php://input',
        new \CodeIgniter\HTTP\Headers(),
        config('App')
    );
}

配置完成后框架全局调用的Request类就会替换成你自定义的扩展类，直接调用新增方法即可。

场景2：扩展控制器公共方法（最常用场景） #

CI4 默认已提供 BaseController 作为所有业务控制器的公共父类，你不需要额外修改核心配置，直接在该类中新增自定义方法即可：

• 编辑 app/Controllers/BaseController.php，新增你需要的公共函数：

// 自定义公共返回方法示例
public function successJson(array $data = [], string $msg = '操作成功')
{
    return $this->response->setJSON([
        'code' => 0,
        'msg' => $msg,
        'data' => $data
    ]);
}

• 所有业务控制器继承 BaseController 后即可直接调用新增方法：

class User extends BaseController
{
    public function info()
    {
        return $this->successJson(['id' => 1, 'name' => 'test']);
    }
}

• 自定义扩展类的命名空间填写错误，未正确引入官方核心类的命名空间
• 未重写Services配置，直接修改了system目录下的官方核心类文件
• 扩展类未正确继承对应官方核心类，导致核心方法缺失

内容的提问来源于stack exchange，提问作者Code Metal