配置加载:环境分离与默认值
config 目录按环境分文件,支持点号取值、默认值、环境变量覆盖,避免把密码写进代码。
更新于 2026-10-3125 行代码
完整代码
PHP
<?php
function config(string $key = null, $default = null)
{
static $conf = null;
if ($conf === null) {
$env = getenv('APP_ENV') ?: 'local';
$base = require __DIR__ . '/config/app.php';
$file = __DIR__ . '/config/' . $env . '.php';
$conf = is_file($file) ? array_replace_recursive($base, require $file) : $base;
}
if ($key === null) {
return $conf;
}
$cur = $conf;
foreach (explode('.', $key) as $seg) {
if (!is_array($cur) || !array_key_exists($seg, $cur)) {
return $default;
}
$cur = $cur[$seg];
}
return $cur;
}
// 用法:config('db.host', '127.0.0.1')
怎么用
- config/app.php 放公共配置,config/production.php 放线上差异(覆盖同名键)。
- 入口设置环境:putenv('APP_ENV=production') 或用 Nginx fastcgi_param。
- 密码不要写在配置文件里,用 getenv 读取环境变量。
注意
- array_replace_recursive 是深合并,适合嵌套的配置数组。
- 静态变量缓存只在一个请求内有效,FPM 下每个请求都会重新读,开销很小。
- 配置文件不要放在 Web 根目录,.php 后缀也会被下载源码(如果 PHP 挂了)。