PDO可直连MariaDB，但需注意认证插件兼容性、DSN显式声明charset=utf8mb4、GTID/binlog格式差异、mysqli::ping()在旧版MariaDB的bug等真实踩坑点。
PHP 连接 MariaDB 和 MySQL 几乎完全一致，PDO 或 mysqli 驱动无需更换、代码不用改——但“几乎”背后藏着几个真实踩坑点，尤其在升级环境或跨版本迁移时。
pdo_mysql 扩展能否直连 MariaDB？
能，且是推荐方式。MariaDB 完全兼容 MySQL 协议，pdo_mysql 扩展底层走的就是这个协议，不区分后端是 MySQL 还是 MariaDB。
但要注意：pdo_mysql 是 PHP 扩展名，不是数据库名；它只负责封装 MySQL 协议通信，不校验服务端版本。只要 MariaDB 启用了标准 MySQL 兼容端口（默认 3306）和认证插件（如 mysql_native_password），连接就成功。
常见错误现象：
立即学习“PHP免费学习笔记（深入）”；
- 连接报错
SQLSTATE[HY000] [2054] The server requested authentication method unknown to the client：MariaDB 10.4+ 默认启用unix_socket或ed25519插件，而旧版 PHP 的pdo_mysql不支持；需在 MariaDB 中为用户显式切回mysql_native_password -
Connection refused：确认 MariaDB 是否监听127.0.0.1（而非仅localhost），因为localhost在 Unix 系统下会触发 socket 连接，路径不对就失败
charset=utf8mb4 为什么必须显式声明？
MySQL 5.5.3+ 和 MariaDB 5.5.3+ 都支持 utf8mb4，但驱动不会自动推导。如果 DSN 中漏掉 charset=utf8mb4，PDO 会默认用 latin1 建立连接，导致中文存入乱码、emoji 插入失败，且错误不报在连接阶段，而是在 INSERT 时静默截断或报错 Incorrect string value。
实操建议：
- DSN 中强制写死：
"mysql:host=$host;port=$port;dbname=$dbname;charset=utf8mb4" - 不要依赖
SET NAMES utf8mb4替代——它只影响当前会话，且在预处理语句中可能被忽略 - MariaDB 10.2.7+ 支持
collation_server配置项，但 PHP 驱动不读取该值，仍需 DSN 显式指定
GTID 和 Binlog 格式差异会影响 PHP 应用吗？
绝大多数 PHP 应用不直触 GTID 或 Binlog，所以不影响连接和查询。但如果你在用基于复制的高可用架构（例如 Orchestrator、MHA），或自己实现读写分离/故障转移逻辑，就会暴露问题：
- MariaDB 的 GTID（
gtid_domain_id+gtid_seq_no）和 MySQL 5.6+ 的 GTID（server_uuid:transaction_id）格式不互通；不能混搭主从 - MariaDB 默认
binlog_format=ROW，MySQL 5.6 默认STATEMENT；若应用依赖SELECT ... FOR UPDATE+STATEMENT复制做一致性校验，切换到 MariaDB 后可能行为偏移 -
CREATE TABLE ... SELECT在 MariaDB 中会被重写为CREATE OR REPLACE，而 MySQL 不会；若你的迁移脚本依赖建表原子性，需测试该语句是否仍符合预期
为什么 mysqli::ping() 在 MariaDB 上有时返回 false？
mysqli::ping() 底层发的是 COM_PING 包，理论上所有兼容 MySQL 协议的服务都应响应。但在 MariaDB 10.3~10.5 某些小版本中，存在一个已知 bug：当连接空闲超时（wait_timeout 触发）后，ping() 可能返回 false 而不重连，导致后续查询直接抛 MySQL server has gone away。
这不是协议不兼容，而是 MariaDB 实现细节缺陷。解决方法：
- 升级 MariaDB 到 10.5.13+ 或 10.6.4+（该问题已在补丁中修复）
- 改用
PDO::getAttribute(PDO::ATTR_CONNECTION_STATUS)辅助判断，或直接捕获异常后重连 - 避免依赖
ping()做连接保活，改用更轻量的SELECT 1
真正容易被忽略的，是那些“没报错却悄悄变了”的地方：比如 DECIMAL 字段在 CREATE TABLE SELECT 中的默认值推导、JSON 列在 MariaDB 里实际是 LONGTEXT 别名、validate_password 插件缺失导致密码策略失效——它们不拦连接，但会在数据写入、权限控制或运维操作时突然冒头。
