Symfony如何连接MariaDB数据库-php教程-PHP中文网

数据库连接配置写在 .env，不是 doctrine.yaml；symfony 的 mariadb 连接参数必须通过 database_url 设置，doctrine.yaml 仅启用组件和定义映射，serverversion 必须含 -mariadb 后缀，协议头用 mysql://，本地开发用 127.0.0.1 并注意 url 编码与权限配置。

symfony如何连接mariadb数据库

数据库连接配置写在 .env，不是 doctrine.yaml

Symfony 的 MariaDB 连接参数必须写在 .env 文件的 DATABASE_URL 中，config/packages/doctrine.yaml 只负责启用 Doctrine 组件和定义实体映射规则，它不参与实际连接。配错位置是连不上最常见原因。

正确写法示例（MariaDB 10.1）：
DATABASE_URL="mysql://root:123456@127.0.0.1:3306/symfony_webapp?serverVersion=10.1.34-MariaDB&charset=utf8mb4"

mysql:// 协议头不能省，即使连的是 MariaDB；Doctrine 统一用 mysql 驱动
本地开发务必用 127.0.0.1，别写 localhost——否则 MySQL/MariaDB 会尝试走 Unix socket，容易报 SQLSTATE[HY000] [2002] No such file or directory
serverVersion 必须显式指定，格式要带 -MariaDB 后缀（如 10.1.34-MariaDB），否则 Doctrine 无法匹配语法特性
密码含 @、/、: 等字符时，必须 URL 编码，例如 pass@word → pass%40word

确认 PHP 扩展和用户权限是否就绪

连不上不一定是 URL 写错了，先排除底层依赖和权限问题。

运行 php -m | grep pdo_mysql，确保 pdo_mysql 扩展已启用（MariaDB 兼容该驱动，无需额外装 mariadb 扩展）
doctrine:database:create 报 Access denied，说明 DATABASE_URL 里的用户没有 CREATE 权限，不是配置问题。需执行：
GRANT CREATE ON *.* TO 'your_user'@'%'; FLUSH PRIVILEGES;
若只希望建库不授权全局 CREATE，可改用原生命令：
mysql -u root -p -e "CREATE DATABASE IF NOT EXISTS symfony_webapp CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;"

多数据库场景下如何区分 MariaDB 实例

一个 Symfony 项目连多个 MariaDB 实例时，不能靠修改 .env 切换，得靠 Doctrine 的多连接配置。

Symfony Windows版

Symfony Windows版用于下载 Symfony CLI 5.17.1 官方安装包，辅助开发者创建 Symfony 项目并进入框架学习与配置流程。

下载

在 config/packages/doctrine.yaml 中定义第二个连接：

doctrine:
    dbal:
        connections:
            default:
                # ... 正常配置
            mariadb_secondary:
                driver: 'pdo_mysql'
                host: '%env(MARIADB_SECONDARY_HOST)%'
                port: '%env(int:MARIADB_SECONDARY_PORT)%'
                dbname: '%env(MARIADB_SECONDARY_NAME)%'
                user: '%env(MARIADB_SECONDARY_USER)%'
                password: '%env(MARIADB_SECONDARY_PASSWORD)%'
                server_version: '10.11.2-MariaDB'
                charset: utf8mb4

对应环境变量加到 .env，如 MARIADB_SECONDARY_HOST=192.168.1.100
使用时指定连接名：$this->getDoctrine()->getConnection('mariadb_secondary')
实体默认仍走 default 连接；如需绑定某实体到特定库，需在 Entity 类上加 @ORM\Entity(repositoryClass="App\Repository\StudentRepository", connection="mariadb_secondary")

迁移命令别乱用 `doctrine:schema:update --force`

这个命令在 MariaDB 上尤其危险：它绕过迁移历史，直接比对实体类和当前表结构生成 ALTER 语句，容易漏掉中间字段变更、破坏数据一致性，且 MariaDB 对 ALGORITHM=INPLACE 更严格，某些修改会被拒绝。

正确流程是：php bin/console make:migration → 检查生成的 src/Migrations/ 文件 → php bin/console doctrine:migrations:migrate
仅当确定无数据风险（比如刚初始化空库）且只是加字段时，才考虑 doctrine:schema:update --force
生产环境绝对禁用 --force，CI 流水线里也建议用 doctrine:migrations:status --show-versions 做校验

真正容易被忽略的是 serverVersion 的完整格式 —— 少写 -MariaDB 后缀，Doctrine 就按 MySQL 语法解析，建索引或用窗口函数时可能静默失败或报错不明确。