根本原因是Windows与macOS环境变量加载时机、作用域及大小写处理差异导致CI2在初始化前无法可靠读取——需在index.php或config.php顶层用getenv()结合??/?:安全获取,并通过系统级配置(Apache envvars或Windows服务账户)注入变量。

跨平台环境变量读取失败,根本不是 getenv() 函数本身的问题,而是 Windows 和 macOS 对环境变量的加载时机、作用域和大小写处理存在底层差异——尤其在 CodeIgniter 2 这种早期版本中,$_SERVER 和 getenv() 的行为不一致会直接导致配置错乱或静默 fallback。
为什么 CI2 在 Mac/Windows 上读不到环境变量
CodeIgniter 2 的 config.php 和早期引导逻辑(如 system/core/Loader.php)在框架初始化前就尝试读取环境变量,此时:
- macOS(尤其 zsh/bash)下,通过
export VAR=value设置的变量仅对当前 shell 及其子进程有效,GUI 应用(如 MAMP/XAMPP 启动的 Apache)根本继承不到; - Windows 的 CMD/PowerShell 环境变量需写入注册表(用户级/系统级),但 Apache 服务默认以 LocalSystem 身份运行,不加载用户环境变量;
- CI2 默认用
$_SERVER['VAR']优先于getenv('VAR'),而$_SERVER在 CGI/FastCGI 模式下会被 Web 服务器过滤或重写,大小写也常被强制转为大写(Windows)或保留原样(macOS); -
putenv()在 CI2 中调用太晚(通常在控制器里),但配置文件已加载完毕,补救无效。
Mac 上 Apache 无法读取 shell export 的变量
Mac 下用终端启动 httpd 能读到 export 变量,但 GUI 启动的 MAMP/XAMPP 或系统 Apache 服务不会继承 shell 环境。必须改用服务级注入:
- 对 Apache:编辑
/etc/apache2/envvars(系统 Apache)或 MAMP 的conf/envvars,添加export MY_ENV=prod; - 重启 Apache:
sudo apachectl restart或重启 MAMP; - 验证是否生效:在 CI2 的
index.php顶部加var_dump(getenv('MY_ENV'));,非空即成功; - 避免使用
.bash_profile或.zshrc中的 export —— 它们对 Web 服务进程完全不可见。
Windows Apache 服务忽略用户环境变量
Windows 的 Apache 服务(尤其是通过“服务管理器”启动的)默认以 SYSTEM 账户运行,完全无视你登录用户的环境变量。修复路径唯一且明确:
- 打开“服务”管理器 → 找到
Apache2.4(或类似名称)→ 右键 → “属性” → “登录”选项卡; - 选择“此账户”,输入你当前登录的**纯英文用户名+密码**(中文用户名会导致路径解析失败);
- 点击“应用”后,**必须重启整个服务**(不能只 stop/start,要彻底 kill 进程再启);
- 确认环境变量已写入“系统属性 → 高级 → 环境变量”中的“系统变量”区域(不是用户变量);
- CI2 中统一用
getenv('MY_ENV'),不要依赖$_SERVER['MY_ENV']—— Windows 下$_SERVER常为空或大小写不匹配。
CI2 配置文件里安全读取环境变量的写法
CI2 的 config.php 是 PHP 文件,直接执行,不能用框架方法。必须用最底层、最兼容的方式判断和 fallback:
$env = getenv('CI_ENV') ?: ($_SERVER['CI_ENV'] ?? 'development');
$config['environment'] = strtolower($env);
// 数据库配置按环境切换
if ($config['environment'] === 'production') {
$db['default']['hostname'] = getenv('DB_HOST') ?: 'prod-db.example.com';
$db['default']['username'] = getenv('DB_USER') ?: 'prod_user';
} else {
$db['default']['hostname'] = 'localhost';
$db['default']['username'] = 'root';
}
注意:?: 和 ?? 必须组合使用,因为 getenv() 返回 false(非空字符串)时 ?: 会误判,而 ?? 只判 null;Windows 下 getenv('Db_Host') 可能失败,但 getenv('DB_HOST') 才有效——大小写必须严格匹配。
CI2 没有现代框架的环境加载钩子,所有环境变量必须在 index.php 或 config.php 顶层完成读取和赋值,任何延迟到 autoload 或控制器里的操作都来不及影响数据库连接等核心配置。跨平台部署时,别信“本地跑通就行”,务必在目标服务器环境里用 phpinfo() 或 var_dump($_SERVER) 实际验证变量是否存在、大小写是否正确、是否被 Web 服务器截断。


















