DoctrineBundle多数据库连接配置指南

背景介绍

在Symfony项目中使用DoctrineBundle时，默认情况下会通过DATABASE_URL环境变量配置单一数据库连接。但在实际开发中，我们经常需要配置多个数据库连接，比如主从分离、多租户系统或测试环境专用数据库等场景。

基础配置解析

默认的DoctrineBundle配置位于config/packages/doctrine.yaml文件中，核心配置如下：

doctrine:
    dbal:
        driver: 'pdo_mysql'
        server_version: '8.0.37'
        charset: utf8mb4
        url: '%env(resolve:DATABASE_URL)%'

这个配置使用DATABASE_URL环境变量作为数据源，适用于大多数简单应用场景。

多数据库连接实现方案

方案一：多环境变量配置

可以通过定义新的环境变量来实现多数据库连接：

1. 在.env文件中添加新变量，如SECONDARY_DATABASE_URL
2. 在doctrine.yaml中添加新连接配置：

doctrine:
    dbal:
        connections:
            default:
                url: '%env(resolve:DATABASE_URL)%'
            secondary:
                url: '%env(resolve:SECONDARY_DATABASE_URL)%'

方案二：多实体管理器配置

对于更复杂的场景，可以配置多个实体管理器：

doctrine:
    orm:
        entity_managers:
            default:
                connection: default
                mappings:
                    App:
                        is_bundle: false
                        dir: '%kernel.project_dir%/src/Entity'
                        prefix: 'App\Entity'
            secondary:
                connection: secondary
                mappings:
                    OtherApp:
                        is_bundle: false
                        dir: '%kernel.project_dir%/src/OtherEntity'
                        prefix: 'App\OtherEntity'

环境特定配置

DoctrineBundle支持根据环境配置不同的数据库参数，例如测试环境：

when@test:
    doctrine:
        dbal:
            dbname_suffix: '_test%env(default::TEST_TOKEN)%'

生产环境可以配置缓存优化：

when@prod:
    doctrine:
        orm:
            auto_generate_proxy_classes: false
            proxy_dir: '%kernel.build_dir%/doctrine/orm/Proxies'
            query_cache_driver:
                type: pool
                pool: doctrine.system_cache_pool

最佳实践建议

1. 为不同用途的数据库使用独立的连接配置
2. 生产环境务必关闭自动生成代理类(auto_generate_proxy_classes: false)
3. 测试环境使用独立的数据库实例或添加后缀隔离数据
4. 合理配置缓存策略提升性能

通过以上配置方式，可以灵活地在Symfony项目中管理多个数据库连接，满足各种复杂业务场景的需求。