Laravel配置怎么动态刷新

wen PHP项目 2026-07-11 233

本文目录导读：

Laravel配置怎么动态刷新

清除配置缓存
运行时动态修改配置
数据库驱动的动态配置
使用环境变量动态刷新
配置文件的动态包含
最佳实践建议
注意事项

在 Laravel 中，配置动态刷新主要涉及缓存配置的清除和重新加载，以下是几种常见的方法：

清除配置缓存

Artisan 命令方式

# 清除配置缓存
php artisan config:clear
# 重新生成配置缓存
php artisan config:cache

在代码中执行

use Illuminate\Support\Facades\Artisan;
// 清除配置缓存
Artisan::call('config:clear');
// 重新缓存配置
Artisan::call('config:cache');

运行时动态修改配置

使用 Config Facade

use Illuminate\Support\Facades\Config;
// 读取配置
$value = Config::get('app.name');
// 动态设置配置（仅当前请求有效）
Config::set('app.timezone', 'Asia/Shanghai');
// 批量设置
Config::set([
    'app.timezone' => 'Asia/Shanghai',
    'app.locale' => 'zh-CN'
]);

使用全局 helper 函数

// 读取配置
$value = config('app.name');
// 设置配置（仅当前请求有效）
config(['app.timezone' => 'Asia/Shanghai']);

数据库驱动的动态配置

创建动态配置系统：

创建配置表 Migration

// database/migrations/create_dynamic_configs_table.php
Schema::create('dynamic_configs', function ($table) {
    $table->id();
    $table->string('key')->unique();
    $table->text('value')->nullable();
    $table->string('type')->default('string');
    $table->timestamps();
});

创建 Service Provider

// app/Providers/DynamicConfigServiceProvider.php
namespace App\Providers;
use Illuminate\Support\ServiceProvider;
use Illuminate\Support\Facades\Config;
class DynamicConfigServiceProvider extends ServiceProvider
{
    public function boot()
    {
        if (app()->runningInConsole()) {
            return;
        }
        // 加载动态配置
        $this->loadDynamicConfigs();
    }
    protected function loadDynamicConfigs()
    {
        try {
            $configs = \App\Models\DynamicConfig::all();
            foreach ($configs as $config) {
                // 将点号转换为数组访问
                Config::set($config->key, $this->parseValue($config));
            }
        } catch (\Exception $e) {
            // 数据库不存在时的处理
        }
    }
    protected function parseValue($config)
    {
        switch ($config->type) {
            case 'boolean':
                return filter_var($config->value, FILTER_VALIDATE_BOOLEAN);
            case 'integer':
                return (int) $config->value;
            case 'json':
                return json_decode($config->value, true);
            default:
                return $config->value;
        }
    }
}

创建配置 Model

// app/Models/DynamicConfig.php
namespace App\Models;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Support\Facades\Cache;
class DynamicConfig extends Model
{
    protected $fillable = ['key', 'value', 'type'];
    // 更新配置时清除缓存
    protected static function booted()
    {
        static::saved(function () {
            Cache::forget('dynamic_configs');
        });
        static::deleted(function () {
            Cache::forget('dynamic_configs');
        });
    }
    // 获取所有配置（带缓存）
    public static function getAllCached()
    {
        return Cache::remember('dynamic_configs', 3600, function () {
            return self::all();
        });
    }
}

辅助类

// app/Helpers/DynamicConfig.php
namespace App\Helpers;
use App\Models\DynamicConfig as ConfigModel;
use Illuminate\Support\Facades\Cache;
use Illuminate\Support\Facades\Config;
class DynamicConfigHelper
{
    public static function get($key, $default = null)
    {
        $config = ConfigModel::where('key', $key)->first();
        if (!$config) {
            return $default;
        }
        return self::parseValue($config);
    }
    public static function set($key, $value, $type = 'string')
    {
        // 如果是数组或对象，转换为 JSON
        if (is_array($value) || is_object($value)) {
            $type = 'json';
            $value = json_encode($value);
        }
        // 更新或创建配置
        ConfigModel::updateOrCreate(
            ['key' => $key],
            ['value' => $value, 'type' => $type]
        );
        // 刷新运行时配置
        Config::set($key, self::parseValue((object)['value' => $value, 'type' => $type]));
        // 清除缓存
        Cache::forget('dynamic_configs');
    }
    protected static function parseValue($config)
    {
        switch ($config->type ?? 'string') {
            case 'boolean':
                return filter_var($config->value, FILTER_VALIDATE_BOOLEAN);
            case 'integer':
                return (int) $config->value;
            case 'json':
                return json_decode($config->value, true);
            default:
                return $config->value;
        }
    }
}

使用环境变量动态刷新

use Dotenv\Dotenv;
class EnvConfigRefresh
{
    public function refresh()
    {
        // 重新加载 .env 文件
        $dotenv = Dotenv::createImmutable(base_path());
        $dotenv->load();
        // 强制重新加载环境变量
        foreach ($_ENV as $key => $value) {
            putenv("$key=$value");
        }
    }
}

配置文件的动态包含

// config/dynamic.php
return [
    'settings' => function() {
        // 动态生成配置
        return [
            'maintenance_mode' => cache('maintenance_mode', false),
            'api_rate_limit' => app('App\Services\ConfigService')->getApiRateLimit(),
        ];
    }
];
// 使用方式
$settings = config('dynamic.settings')();

最佳实践建议

缓存策略

// 使用缓存装饰器
class CachedDynamicConfig
{
    protected $cacheTTL = 3600; // 1小时
    public function get($key, $default = null)
    {
        return Cache::remember("config:{$key}", $this->cacheTTL, function () use ($key, $default) {
            return Config::get($key, $default);
        });
    }
    public function refresh($key = null)
    {
        if ($key) {
            Cache::forget("config:{$key}");
        } else {
            // 清除所有配置缓存
            // 需要根据实际缓存键模式处理
        }
    }
}

事件驱动刷新

// app/Events/ConfigUpdated.php
class ConfigUpdated
{
    public $key;
    public $value;
}
// 监听器
class RefreshConfigCache
{
    public function handle(ConfigUpdated $event)
    {
        Cache::forget("config:{$event->key}");
        Config::set($event->key, $event->value);
    }
}