codeigniter自定义配置需严格遵循规范:文件须置于application/config/扁平目录,以$config数组声明并含basepath安全检查;加载时传true启用作用域隔离,取值必带第二参数;环境切换应通过environment常量条件赋值或autoload动态加载;配置文件中禁止使用$this等未初始化对象。

CodeIgniter 的自定义配置文件不是“加个文件就能用”,关键在于加载时机、数组命名规则和作用域隔离——不按规范做,$this->config->item() 会返回 NULL,且错误无提示。
自定义配置文件必须放在 application/config/ 目录下
路径错一个字符都会加载失败。比如你建了 application/config/my/ 子目录再放 db.php,$this->config->load('my/db') 是无效的——CI 不支持子目录嵌套加载。只能是扁平结构:application/config/db.php、application/config/api.php 等。
文件内容必须以 $config 数组形式声明,且开头要加安全检查:
<?php defined('BASEPATH') OR exit('No direct script access allowed');
$config['api_timeout'] = 5000;
$config['cache_enabled'] = TRUE;
漏掉 defined('BASEPATH') 检查,在某些部署环境下可能被直接 HTTP 访问导致敏感配置泄露。
$this->config->load() 的第二个参数决定配置是否被隔离
不传或传 FALSE(默认),所有配置项直接合并进全局 $config 数组;一旦多个文件定义了同名键(比如都写了 $config['debug']),后加载的会覆盖前一个,且毫无警告。
传 TRUE 才能避免冲突:
-
$this->config->load('api', TRUE)→ 配置存入$this->config['api']['api_timeout'] -
$this->config->load('db', TRUE)→ 配置存入$this->config['db']['hostname'] - 取值时必须带第二参数:
$this->config->item('api_timeout', 'api')
这个参数不是“可选优化”,而是多配置文件共存的强制要求。
使用ydata-profiling(前身为pandas-profiling)生成全面的数据质量报告,包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。
开发/生产环境切换不能靠手动改文件
很多人把 database.php 复制两份,上线前手动替换——这在 CI 中极易出错,且无法 Git 版本管理敏感信息。
正确做法是利用 CI 的环境常量(ENVIRONMENT)做条件判断:
<?php defined('BASEPATH') OR exit('No direct script access allowed');
if (ENVIRONMENT === 'production') {
$config['api_url'] = 'https://api.example.com';
} else {
$config['api_url'] = 'http://localhost:8000';
}
或者更彻底:在 application/config/autoload.php 中根据环境动态加载不同文件:
if (ENVIRONMENT === 'development') $autoload['config'] = ['dev_db'];if (ENVIRONMENT === 'production') $autoload['config'] = ['prod_db'];
注意:$autoload['config'] 只接受文件名(不含 .php),且这些文件必须已存在于 application/config/ 下。
别在配置文件里调用 $this 或 CodeIgniter 类实例
像 $config['upload_path'] = $this->config->item('base_path') . '/uploads'; 这种写法会报错——配置文件是在 CI 核心对象(包括 $this)初始化之前就被 require 的,此时 $this 根本不存在。
可行的替代方案只有两个:
- 用已定义的常量,比如
FCPATH、APPPATH、WRITEPATH(CI 4)或BASEPATH(CI 3) - 把这类动态路径逻辑移到控制器或服务类中,而不是塞进配置文件
硬要在配置阶段拼接路径?只能用 PHP 原生函数,例如:$config['log_path'] = FCPATH . 'logs/';










