CodeIgniter 4搭建多站点时如何调用目录外的共享资源

核心实现逻辑 #

所有跨目录资源调用的本质是让CI4的自动加载器能识别共享目录的命名空间映射，依托CI4原生机制即可完成，无需额外第三方扩展。

第一步：梳理实际目录绝对路径 #

先明确部署环境的真实绝对路径示例（Linux环境），避免后续路径配置错误：

/var/www/
├── SYSTEM_CI4/       # 全站点共享的CI4核心系统目录
├── RESOURCES/        # 全站点共享的业务资源目录
│   ├── Models/       # 共享数据模型
│   ├── Libraries/     # 共享业务库
│   ├── Helpers/      # 共享辅助函数库
│   └── ThirdParty/   # 共享第三方依赖
├── WEBSITE_1/        # 独立站点1根目录（含独立的app、writable、public目录）
├── WEBSITE_2/        # 独立站点2根目录
└── ETC/              # 其他站点目录

第二步：修改站点入口指向共享CI4内核 #

默认CI4安装要求每个站点自带独立的system系统目录，要实现内核共享，需要修改每个站点的入口文件public/index.php中的路径常量：

1. 把原默认指向站点内部system目录的常量：

   // 原默认配置（每个站点自带system）
   define('SYSTEMPATH', __DIR__ . '/../system/');
   

   替换为共享SYSTEM_CI4的绝对路径：

   define('SYSTEMPATH', '/var/www/SYSTEM_CI4/');
   

2. 保留站点自身的APPPATH、WRITEPATH、BASEPATH配置不变，保证每个站点的业务代码、缓存、上传文件完全隔离。

第三步：注册共享资源到自动加载规则 #

在每个站点的app/Config/Autoload.php中配置命名空间映射，让CI4可以识别外部共享目录下的类、Helper资源：

1. 配置PSR4命名空间映射，对应共享的Models、Libraries目录

   public $psr4 = [
       APP_NAMESPACE => APPPATH, // 保留站点自身的默认命名空间映射
       'Config'      => APPPATH . 'Config',
       // 新增共享资源的顶层命名空间映射，可自定义命名空间名称
       'Shared'      => '/var/www/RESOURCES/',
   ];
   

   映射规则说明：
   • 共享目录下的类需要匹配对应的命名空间，比如RESOURCES/Models/UserModel.php的类文件开头需要声明namespace Shared\Models;
   • 在站点代码中直接实例化调用即可：new \Shared\Models\UserModel()，无需手动引入文件
   • 如果共享资源存在未遵循PSR4规范的老代码，可以把对应类的绝对路径加到$classmap数组中，实现无命名空间类的自动加载
2. 共享Helper调用
   不需要额外修改Helper搜索路径，只要按照PSR4映射规则，在调用Helper时带上对应命名空间即可，比如加载共享目录下的RESOURCES/Helpers/common_helper.php：

   helper('Shared\common');
   

   CI4会自动按照命名空间映射规则，到对应路径下查找Helper文件加载。
3. 共享第三方资源调用
   对RESOURCES/ThirdParty下的第三方包，只需要在$psr4数组中把对应第三方包的顶层命名空间映射到实际的包路径即可，比如PhpSpreadsheet类库的映射：

   'PhpOffice\PhpSpreadsheet' => '/var/www/RESOURCES/ThirdParty/PhpSpreadsheet/src/'
   

生产环境注意事项 #

• 配置隔离：共享资源的代码中不能硬编码站点独有的配置（比如数据库连接、API密钥），需要通过依赖注入、方法传参的方式接收站点传入的独立配置，避免跨站点配置混淆。
• 批量配置简化：如果站点数量较多，可以把共享的psr4映射配置放到共享RESOURCES目录下的公共配置文件中，在每个站点的入口文件提前加载，修改路径时只需要维护一处，不需要逐站点修改Autoload配置。
• 版本管控：把RESOURCES目录做成独立的git仓库，通过composer的VCS仓库机制给每个站点绑定共享资源的版本号，更新共享代码时先在测试站点验证，再逐站点升级依赖，避免全局同步导致所有站点故障。
• 权限控制：给web服务运行用户（如www-data、nginx）分配SYSTEM_CI4、RESOURCES目录的只读权限，禁止写入，避免共享目录被篡改。
• 缓存清理：修改自动加载规则后，需要删除站点writable/cache下的自动加载缓存文件，避免路径识别失败。

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