如何在Laravel 11中实现环境感知的配置加载？

针对你的需求，Laravel本身没有直接提供按环境目录自动合并配置的功能，但可以通过服务提供者轻松实现，具体步骤如下：

一、确认目录结构 #

你已搭建的目录结构完全符合需求，再明确下：

config/
    constant.php       // 通用基础配置
config/production/
    constant.php       // 生产环境专属配置（用于覆盖通用配置的重叠项）

二、在服务提供者中实现配置合并逻辑 #

Laravel的服务提供者是扩展配置加载逻辑的最佳入口，我们可以在App\Providers\AppServiceProvider的boot方法中添加以下代码：

<?php

namespace App\Providers;

use Illuminate\Support\Facades\Config;
use Illuminate\Support\ServiceProvider;

class AppServiceProvider extends ServiceProvider
{
    /**
     * 启动应用服务
     */
    public function boot(): void
    {
        // 仅在production环境下加载并合并专属配置
        if ($this->app->environment('production')) {
            // 读取生产环境专属配置文件
            $productionConfig = require config_path('production/constant.php');
            // 合并配置：生产环境配置会覆盖通用配置中的相同键
            Config::set('constant', array_merge(Config::get('constant'), $productionConfig));
        }
    }

    /**
     * 注册应用服务
     */
    public function register(): void
    {
        // 留空即可，无需额外操作
    }
}

代码逻辑说明： #

• $this->app->environment('production')：精准判断当前应用是否处于生产环境
• config_path('production/constant.php')：获取生产环境配置文件的绝对路径，避免路径错误
• array_merge(...)：将通用配置与生产配置合并，后传入的生产配置会覆盖通用配置中的相同键值
• Config::set('constant', ...)：将合并后的最终配置重新注入Laravel的配置系统，确保config('constant')能获取到正确结果

三、配置缓存注意事项 #

如果你使用php artisan config:cache生成配置缓存，需要注意：

• 配置缓存会固化当前环境的配置状态，也就是说，若在local环境执行缓存命令，生产环境的专属配置不会被加载到缓存文件中
• 正确操作：在对应环境下执行缓存命令，比如生产环境部署时执行php artisan config:cache，这样缓存文件会包含合并后的生产配置

四、验证效果 #

1. local/staging环境：调用config('constant')，返回的是config/constant.php的原始内容
2. production环境：调用config('constant')，返回的是通用配置与生产配置合并后的结果（重叠项已被生产配置覆盖）

可以通过dd(config('constant'))快速打印配置内容，验证合并效果是否符合预期。

内容的提问来源于stack exchange，提问作者Anu Tig3r