CodeIgniter 4 的配置不支持热加载,因配置在启动时一次性读取并静态缓存,不监听文件变更;动态字典应存于缓存、数据库或 JSON 文件,而非 Config 类中。

CodeIgniter 4 不支持配置项“热加载”——改了 app/Config/ 下的文件,不重启服务、不清缓存,新值不会生效。所谓“自动更新”只存在于 ASP.NET Core 或 Laravel 这类设计上就支持 IOptionsMonitor 或 cache:clear + 重实例化的框架里;CI4 的配置是启动时一次性读取、静态缓存的。
为什么 Config 类不响应文件修改
CI4 的 Config 类(如 App\Config\Database)在首次访问时通过反射读取 PHP 文件并缓存结果,后续调用直接返回内存中已解析的数组。它不监听文件系统事件,也不检查 filemtime(),更不会重新 require 配置文件。即使你手动调用 $config = config('Database'),拿到的仍是初始加载的副本。
- 配置类实例化发生在
Services::autoloader()和Services::configure()阶段,仅在应用启动时执行一次 -
writable/cache/config/下的缓存文件(如database.php.cache)是序列化后的配置数组,不是实时映射 - 没有内置机制 hook 到
file_put_contents('app/Config/Database.php', ...)后触发 reload
想让数据字典类“动态更新”,得绕开 Config 类
如果你的“数据字典”是一组运行时可能变更的键值对(比如状态码映射、多语言标签),别塞进 app/Config/Labels.php 这类静态配置类里。这类内容本质是业务数据,不是框架配置。
- 把字典存在数据库或 JSON 文件中,用
Cache服务封装读写:cache()->get('status_map')/cache()->save('status_map', $data, 3600) - 自定义一个
Dictionary服务,在app/Config/Services.php中注册为shared,并在构造时检查缓存时效或文件 mtime - 避免在控制器里直接
include APPPATH.'Config/Labels.php'—— 这会绕过 autoloader,且无法被 cache 管理
强制刷新配置的唯一可靠方式
开发阶段真要验证配置变更效果,只有两个动作是确定生效的:
- 执行
php spark cache:clear清掉writable/cache/config/下所有缓存文件 - 重启开发服务器:
php spark serve必须手动 Ctrl+C 再重起,它不会监听app/Config/目录变化
生产环境切记:不要靠“改完立刻生效”做运维决策。CI4 的 spark optimize 会预编译全部配置到 writable/cache/,上线前必须走这一步,否则改了文件也白改。
容易被忽略的关键点
很多人卡在“改了 app/Config/MyDict.php 却拿不到新值”,其实问题不在加载逻辑,而在误用了配置类的定位。CI4 的 config('MyDict') 只负责提供**启动快照**,不是数据代理层。真正需要动态性的字典,得自己建一层抽象,用 Cache、File 或 Database 驱动,而不是指望 Config 类突然变活。











