application/config/ 是唯一有效的配置文件存放路径,所有配置文件必须置于该目录下且为扁平结构,需声明 $config 数组,加载失败时 item() 默认返回 null;环境配置应通过 environment 常量分支实现,避免多文件 include。

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 不提供开箱即用的「多环境配置文件」机制,得手动控制。
使用ydata-profiling(前身为pandas-profiling)生成全面的数据质量报告,包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。
推荐做法是在单个配置文件中用 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 的配置系统表面简单,实则对规范极其敏感。










