写给愿意动手的 PHP 开发者
PHP学习网 PHP学习网
公告PHP学习网为公益性网站,致力于为广大PHP爱好者服务
首页/ PHP 源码/ 配置加载:环境分离与默认值
系统与运维 通用 PHP 7.4+

配置加载:环境分离与默认值

config 目录按环境分文件,支持点号取值、默认值、环境变量覆盖,避免把密码写进代码。

完整代码

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')

怎么用

  1. config/app.php 放公共配置,config/production.php 放线上差异(覆盖同名键)。
  2. 入口设置环境:putenv('APP_ENV=production') 或用 Nginx fastcgi_param。
  3. 密码不要写在配置文件里,用 getenv 读取环境变量。

注意

  • array_replace_recursive 是深合并,适合嵌套的配置数组。
  • 静态变量缓存只在一个请求内有效,FPM 下每个请求都会重新读,开销很小。
  • 配置文件不要放在 Web 根目录,.php 后缀也会被下载源码(如果 PHP 挂了)。

相关源码