CodeIgniter配置文件位置详解

CodeIgniter 的配置系统严格限定配置文件必须位于 `application/config/` 目录下且为扁平结构，任何子目录、错误路径或缺失 `$config` 数组都会导致静默加载失败——进而使 `item()` 返回令人困惑的 `NULL`；本文深入剖析了配置加载机制、常见陷阱（如漏写加载名、环境变量误用）、自动加载配置的正确姿势，以及如何通过 `ENVIRONMENT` 常量优雅实现开发/生产环境切换，帮你避开官方文档未明说却高频踩坑的配置雷区。

application/config/ 是唯一有效的配置文件存放路径，其他位置一律不被识别。

CodeIgniter 配置文件的默认位置和命名规则

所有配置文件必须放在 application/config/ 目录下，且是扁平结构——不支持子目录。比如 application/config/payment.php 合法，但 application/config/my/payment.php 会加载失败，$this->config->load('my/payment') 直接报错或静默忽略。

文件内必须声明 $config 数组，不能用 $this、self:: 或任何未初始化对象；也不能直接 echo / exit；返回值只能是数组赋值语句。

• config.php 是主配置文件，CI 启动时自动加载
• database.php、routes.php 等系统配置同理，命名无特殊限制，但不要覆盖内置名（如别叫 config.php 以外的文件叫 database.php）
• 自定义文件如 payment.php、wechat.php，只要不重名，就能被 load() 正常识别

为什么 $this->config->item() 返回 NULL

常见原因不是代码写错，而是配置没加载成功，且 CI 不报错——它只会默默返回 NULL。

检查这几点：

• 文件是否真在 application/config/ 下（注意大小写、.php 后缀、BOM 头）
• 是否调用了 $this->config->load('payment') —— 没 load 就直接 item('key') 必然 NULL
• 是否传了第二参数：正确写法是 $this->config->item('api_key', 'payment')，漏掉 'payment' 就去 config.php 里找，当然找不到
• 是否在 autoload.php 中声明了自动加载：$autoload['config'] = array('payment');

环境配置怎么切：development / production

CI 不提供开箱即用的「多环境配置文件」机制，得手动控制。

推荐做法是在单个配置文件中用 ENVIRONMENT 常量分支赋值，例如：

<?php
if (defined('ENVIRONMENT') && ENVIRONMENT === 'production') {
    $config['cache_enabled'] = TRUE;
    $config['debug_mode'] = FALSE;
} else {
    $config['cache_enabled'] = FALSE;
    $config['debug_mode'] = TRUE;
}

不建议建 config.production.php 这类文件再 include —— 容易漏加载、难维护，也破坏 CI 的配置管理逻辑。

autoload 加载顺序和覆盖问题

多个配置文件里如果定义了同名 key，后加载的会覆盖先加载的。

比如 config.php 里有 $config['base_url'] = ''，而 custom.php 里也有 $config['base_url'] = 'https://example.com'，且 custom 在 autoload 数组里排在 config 后面，那最终生效的就是后者。

所以要注意：

• 业务配置尽量拆到独立文件，避免污染 config.php
• autoload 列表顺序影响最终值，调试时可 dump $this->config->config 查看合并结果
• 不要在不同配置文件中重复定义同一 key，除非你明确需要覆盖行为

路径错一个字符、少传一个参数、漏写 ENVIRONMENT 判断，都会让配置“看起来写了，实际没生效”。CI 的配置系统表面简单，实则对规范极其敏感。

到这里，我们也就讲完了《CodeIgniter配置文件位置详解》的内容了。个人认为，基础知识的学习和巩固，是为了更好的将其运用到项目中，欢迎关注golang学习网公众号，带你了解更多关于CodeIgniter的知识点！