如何通过ACMEBundle在多个Symfony应用间共享Monolog包配置

核心思路 #

可以将Monolog的公共配置封装到ACMEBundle中，让所有依赖该Bundle的Symfony应用自动加载这套配置，无需每个应用单独维护config/packages/monolog.yaml。这完全符合Symfony的Bundle扩展机制，属于配置继承/自动注入方案，无需依赖配置同步工具。

具体实现步骤 #

1. 配置文件存放位置 #

不要将Monolog配置放在Bundle的config/packages/monolog.yaml（该路径为Symfony应用专属目录），需放在Bundle的Resources/config/目录下，例如创建ACMEBundle/Resources/config/monolog.yaml，写入公共日志配置：

# ACMEBundle/Resources/config/monolog.yaml
monolog:
    handlers:
        main:
            type: stream
            path: "%kernel.logs_dir%/%kernel.environment%.log"
            level: debug
            channels: ["!event"]
        # 此处添加公共处理器、Formatter等配置

2. 编写Bundle Extension类 #

必须通过Bundle的Extension类注册并加载配置，让Symfony应用启动时自动读取。创建ACMEBundle/DependencyInjection/ACMEExtension.php：

<?php

namespace ACMEBundle\DependencyInjection;

use Symfony\Component\DependencyInjection\ContainerBuilder;
use Symfony\Component\Config\FileLocator;
use Symfony\Component\HttpKernel\DependencyInjection\Extension;
use Symfony\Component\DependencyInjection\Loader;

class ACMEExtension extends Extension
{
    public function load(array $configs, ContainerBuilder $container)
    {
        // 加载Bundle自身服务配置（如有）
        $loader = new Loader\YamlFileLoader($container, new FileLocator(__DIR__.'/../Resources/config'));
        $loader->load('services.yaml');
        // 加载Monolog公共配置
        $loader->load('monolog.yaml');
    }
}

3. 关联Bundle与Extension类 #

在ACMEBundle/ACMEBundle.php中显式关联Extension（Symfony会自动匹配命名空间，显式声明更稳妥）：

<?php

namespace ACMEBundle;

use ACMEBundle\DependencyInjection\ACMEExtension;
use Symfony\Component\HttpKernel\Bundle\Bundle;

class ACMEBundle extends Bundle
{
    public function getContainerExtension()
    {
        return new ACMEExtension();
    }
}

4. 应用侧集成 #

每个ACMEApplication只需两步操作：

• 通过Composer安装ACMEBundle依赖；
• 在config/bundles.php中注册ACMEBundle：

return [
    // ...其他Bundle
    ACMEBundle\ACMEBundle::class => ['all' => true],
];

应用启动时会自动加载ACMEBundle中的Monolog配置，若应用自身存在monolog.yaml，Symfony会按应用侧配置覆盖Bundle侧的规则合并，方便特殊应用做定制。

关于Symfony Flex的说明 #

Flex的recipes主要用于初始化应用时生成配置，本质是配置同步而非继承。对于已存在的大量应用，Flex无法自动更新所有应用的配置，且需维护recipe仓库，不符合你想要的「配置继承」需求。而上述Bundle扩展方案是动态加载配置，所有应用始终使用ACMEBundle中的最新配置，更适配微服务架构的统一管理。

额外注意点 #

• 配置中的参数（如%kernel.logs_dir%）会自动使用当前应用的容器参数，无需额外处理；
• 若需部分应用覆盖公共配置，只需在该应用的config/packages/monolog.yaml中添加需修改的节点即可；
• 确保ACMEBundle的composer.json声明对monolog-bundle的依赖，避免应用侧缺失依赖：

{
    "require": {
        "symfony/monolog-bundle": "^3.0"
    }
}

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