PHP 怎么PHP 动态配置

wen PHP项目 2026-07-27 98

本文目录导读：

PHP 怎么PHP 动态配置

数据库存储配置（最推荐）
配置文件 + 缓存（适合性能敏感场景）
环境变量 + .env 文件
Redis/Memcached 内存缓存
管理后台配置界面（综合方案）
选择建议

在 PHP 中实现动态配置（即在不修改代码文件的情况下修改配置，并实时或按需生效）有几种常见方式，以下是主流方案：

数据库存储配置（最推荐）

适用场景：需要频繁修改、支持多用户/多环境的配置。

// config.php - 配置读取类
class Config
{
    private static $cache = [];
    public static function get($key, $default = null)
    {
        // 先从缓存读取
        if (isset(self::$cache[$key])) {
            return self::$cache[$key];
        }
        // 从数据库读取（示例使用PDO）
        $db = new PDO('mysql:host=localhost;dbname=test', 'user', 'pass');
        $stmt = $db->prepare("SELECT `value` FROM `config` WHERE `key` = ?");
        $stmt->execute([$key]);
        $row = $stmt->fetch(PDO::FETCH_ASSOC);
        if ($row) {
            // 支持JSON格式存储复杂配置
            $value = json_decode($row['value'], true) ?? $row['value'];
            self::$cache[$key] = $value;
            return $value;
        }
        return $default;
    }
    public static function set($key, $value)
    {
        $db = new PDO('mysql:host=localhost;dbname=test', 'user', 'pass');
        $value = is_array($value) ? json_encode($value) : $value;
        $stmt = $db->prepare("REPLACE INTO `config` (`key`, `value`) VALUES (?, ?)");
        $stmt->execute([$key, $value]);
        // 清除缓存
        unset(self::$cache[$key]);
    }
}
// 使用示例
$siteName = Config::get('site_name', '默认站点名');
echo $siteName;

数据库表结构：

CREATE TABLE `config` (
    `key` VARCHAR(100) PRIMARY KEY,
    `value` TEXT,
    `updated_at` TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP
);

配置文件 + 缓存（适合性能敏感场景）

适用场景：配置变化不频繁，但需要即时生效。

// config.php - 动态配置加载器
class DynamicConfig
{
    private static $config = null;
    private static $configFile = __DIR__ . '/config.php';
    public static function load()
    {
        // 每次调用时重新读取文件（生产环境建议用APC/Redis缓存）
        if (file_exists(self::$configFile)) {
            self::$config = include self::$configFile;
        } else {
            self::$config = [];
        }
    }
    public static function get($key, $default = null)
    {
        if (self::$config === null) {
            self::load();
        }
        return self::$config[$key] ?? $default;
    }
    public static function set($key, $value)
    {
        self::load(); // 先加载现有配置
        self::$config[$key] = $value;
        self::save();
    }
    private static function save()
    {
        $content = '<?php return ' . var_export(self::$config, true) . ';';
        file_put_contents(self::$configFile, $content, LOCK_EX);
    }
}
// 使用
DynamicConfig::set('site_name', '新站点名称');
echo DynamicConfig::get('site_name');

config.php 文件内容示例：

<?php return array (
  'site_name' => '我的网站',
  'debug' => true,
  'db_host' => 'localhost',
);

环境变量 + .env 文件

适用场景：不同环境（开发/测试/生产）配置分离。

// 使用 phpdotenv 库 (composer require vlucas/phpdotenv)
require 'vendor/autoload.php';
use Dotenv\Dotenv;
$dotenv = Dotenv::createImmutable(__DIR__);
$dotenv->load();
// 允许动态修改（但实际修改的是内存中的环境变量）
$_ENV['APP_DEBUG'] = 'false';
// 读取
echo $_ENV['APP_NAME'] ?? '默认应用名';

.env 文件内容：

APP_NAME=MyApp
APP_DEBUG=true
DB_HOST=localhost

Redis/Memcached 内存缓存

适用场景：高并发、实时性要求高的配置。

class RedisConfig
{
    private static $redis = null;
    private static function connect()
    {
        if (self::$redis === null) {
            self::$redis = new Redis();
            self::$redis->connect('127.0.0.1', 6379);
        }
    }
    public static function get($key, $default = null)
    {
        self::connect();
        $value = self::$redis->get('config:' . $key);
        return $value !== false ? unserialize($value) : $default;
    }
    public static function set($key, $value, $ttl = 3600)
    {
        self::connect();
        return self::$redis->setex('config:' . $key, $ttl, serialize($value));
    }
}
// 使用
RedisConfig::set('max_upload_size', '50M');
echo RedisConfig::get('max_upload_size', '2M');

管理后台配置界面（综合方案）

生产环境通常需要管理后台：

// admin/config.php - 管理后台控制器
if ($_POST['action'] == 'save_config') {
    $allowedKeys = ['site_name', 'site_desc', 'max_upload', 'email_from'];
    foreach ($_POST['config'] as $key => $value) {
        if (in_array($key, $allowedKeys)) {
            // 更新到数据库或配置文件
            Config::set($key, $value);
        }
    }
    // 清除OPcache（如果有）
    if (function_exists('opcache_reset')) {
        opcache_reset();
    }
}
// 前端配置显示
$configs = [
    'site_name' => Config::get('site_name'),
    'site_desc' => Config::get('site_desc'),
];