CodeIgniter需在index.php最开头定义ENVIRONMENT常量,值限'development'、'testing'、'production';配置文件路径为app/Config/{EnvName}/,缺失时单文件回退至app/Config/。

如何让 CodeIgniter 自动加载不同环境的配置文件
CodeIgniter 本身不自动识别 .env 或运行时环境变量来切换配置,必须手动在 index.php 中显式设置 ENVIRONMENT 常量,且这个常量必须在框架加载前定义——晚了就无效。
-
ENVIRONMENT只能是'development'、'testing'或'production'三者之一,其他值(如'staging')会被当作'production'处理 - 配置文件路径固定为
app/Config/{EnvName}/,比如app/Config/production/Database.php,不是app/Config/production/Database.php和app/Config/Database.php同时生效,后者会被完全忽略 - 如果
app/Config/{EnvName}/下某文件缺失(例如app/Config/production/Cache.php),框架会回退到app/Config/Cache.php,但仅限该文件,不是整个目录回退
为什么改了 ENVIRONMENT 却没生效
最常见原因是修改位置错误:很多人把 define('ENVIRONMENT', 'production'); 放在 require FCPATH . 'vendor/autoload.php'; 之后,或者放在 require_once SYSTEMPATH . 'bootstrap.php'; 之后。此时框架已初始化完毕,环境常量已被读取并缓存,再改无意义。
- 必须确保
define('ENVIRONMENT', ...)出现在index.php最开头,紧接在<?php之后,且早于任何require或include - Apache 的
SetEnv或 Nginx 的fastcgi_param不会自动映射到ENVIRONMENT,CodeIgniter 不读取$_SERVER['ENVIRONMENT'],只认常量 - CLI 模式下同样适用,但需确保执行命令时用的是对应环境的
index.php(例如php public/index.php spark),而不是直接调用spark脚本(它有自己的入口逻辑)
app/Config/Boot/ 目录下的文件是否也按环境分离
不分离。所有 app/Config/Boot/*.php 文件都会无条件加载,无论当前 ENVIRONMENT 是什么。它们是“引导级”配置,用于设置基础运行时行为(如时区、错误报告级别),不能按环境覆盖。
- 想控制开发环境开启调试但生产环境关闭?得在
app/Config/Boot/development.php和app/Config/Boot/production.php里分别写ini_set('display_errors', '1');和ini_set('display_errors', '0');—— 但注意:这两个文件本身不会被自动选择,你得手动在index.php里根据ENVIRONMENT来require对应文件 - 更稳妥的做法是:把环境相关 ini 设置统一写进
public/index.php,比如if (defined('ENVIRONMENT') && ENVIRONMENT === 'development') { ini_set('display_errors', '1'); } -
app/Config/Constants.php也是全局加载,不支持环境目录,如有环境差异常量,建议改用getenv()读取系统环境变量(前提是已通过Dotenv加载)
用 Dotenv 替代常量方式是否可行
可以,但属于“额外补充”,不能替代 ENVIRONMENT 常量机制。CodeIgniter 的配置文件环境分离逻辑和 Dotenv 完全无关;Dotenv 只负责注入 $_ENV 和 $_SERVER,不影响 app/Config/{EnvName}/ 的加载路径。
- 如果你希望用
.env控制环境,得自己在index.php开头加逻辑:$env = $_ENV['APP_ENV'] ?? 'production'; define('ENVIRONMENT', $env);,然后确保Dotenv已提前加载 - 别在配置类里用
getenv('DB_HOST')动态覆盖属性——虽然语法合法,但会导致 IDE 无法推导类型、测试难 mock、且每次实例化都调用getenv()(有轻微性能开销) - 真正要动态化的配置项(如 API 密钥),建议统一走
Config\Services::dotenv()封装或自定义配置服务,而不是混入环境目录机制
环境模式切换的关键不在“怎么配”,而在“什么时候定”。只要 ENVIRONMENT 常量在框架启动前落定,后续路径解析、配置合并、错误策略就全跟着走;但一旦错过那个窗口,后面所有补救都是障眼法。










