如何在自定义Laravel扩展包中按指定优先级覆写spatie/laravel-feed配置

不生效的核心原因 #

1. 配置加载顺序问题：如果你的自定义扩展包的ServiceProvider早于spatie/laravel-feed的ServiceProvider注册，你合并的配置会被后续加载的spatie默认配置覆盖。
2. Laravel自带的mergeConfigFrom方法逻辑是仅写入不存在的配置项，不会覆盖已有的同名配置，所以就算加载顺序正确，你扩展包的配置也无法覆盖spatie的默认配置，不符合你的优先级要求。

实现步骤 #

1. 保证服务提供者加载顺序 #

在你的自定义扩展包的composer.json中添加depends配置，让Laravel优先加载spatie的服务提供者，再加载你的扩展包服务提供者：

{
    "extra": {
        "laravel": {
            "providers": [
                "你的扩展包命名空间\\PackageServiceProvider"
            ],
            "depends": [
                "Spatie\\Feed\\FeedServiceProvider"
            ]
        }
    }
}

2. 自定义配置合并逻辑 #

替换你原来的mergeConfigFrom代码，在你的扩展包ServiceProvider中实现可覆盖的递归合并逻辑，示例代码如下：

<?php

namespace 你的扩展包命名空间;

use Illuminate\Support\ServiceProvider;

class PackageServiceProvider extends ServiceProvider
{
    public function register()
    {
        $spatieConfigPath = $this->app->basePath('vendor/spatie/laravel-feed/config/feed.php');
        $packageConfigPath = __DIR__ . '/../../config/feed.php';

        // 配置文件不存在则跳过
        if (!file_exists($spatieConfigPath) || !file_exists($packageConfigPath)) {
            return;
        }

        $spatieConfig = require $spatieConfigPath;
        $packageConfig = require $packageConfigPath;

        // 合并基础配置：你的扩展包配置优先级高于spatie默认配置
        $mergedBaseConfig = $this->mergeConfig($spatieConfig, $packageConfig);
        
        // 和已有配置合并，避免遗漏其他扩展包的配置
        $finalConfig = $this->mergeConfig(config()->get('feed', []), $mergedBaseConfig);

        // 写入配置容器
        config()->set('feed', $finalConfig);
    }

    public function boot()
    {
        // 可选：允许用户发布你的配置到项目根目录
        $this->publishes([
            $packageConfigPath => config_path('feed.php'),
        ], 'config');
    }

    /**
     * 递归合并配置，后传入的数组值覆盖前一个的同名键
     */
    private function mergeConfig(array $original, array $overrides): array
    {
        foreach ($overrides as $key => $value) {
            if (isset($original[$key]) && is_array($original[$key]) && is_array($value)) {
                // 关联数组递归合并，索引数组直接覆盖
                $original[$key] = $this->isAssocArray($original[$key])
                    ? $this->mergeConfig($original[$key], $value)
                    : $value;
            } else {
                $original[$key] = $value;
            }
        }
        return $original;
    }

    /**
     * 判断是否为关联数组
     */
    private function isAssocArray(array $array): bool
    {
        return array_keys($array) !== range(0, count($array) - 1);
    }
}

3. 优先级验证 #

该实现天然符合你要求的优先级：

• 最低优先级：spatie扩展包的默认配置
• 中间优先级：你的自定义扩展包的配置，会覆盖spatie的同名配置
• 最高优先级：项目根目录config/feed.php的配置，Laravel会在所有服务提供者注册完成后加载该配置，自动覆盖前面所有的同名配置

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