phpEnv安装MariaDB替代MySQL配置指南

本文详细介绍了如何在 Windows 下的 phpEnv 轻量级 PHP 开发环境中，安全、可靠地用完全兼容 MySQL 的 MariaDB 替代默认数据库，涵盖从识别当前数据库进程、下载安装官方 MariaDB MSI 包、创建符号链接、重配 my.ini 与字符集（特别是 utf8mb4）、修复认证插件兼容性问题，到启用远程访问及防火墙放行的完整实操流程——整个替换过程对现有 PHP 代码几乎零侵入，但需谨慎处理服务脚本、路径引用和配置细节，避免因残留 MySQL 指向导致启动失败或连接异常，是 PHP 开发者优化本地环境、拥抱更活跃开源生态的实用指南。

phpEnv 是 Windows 下轻量级 PHP 开发环境套件，它默认捆绑的是 MySQL，但你可以安全替换成 MariaDB —— 因为 MariaDB 完全兼容 MySQL 的协议、客户端命令（mysql、mysqldump）、连接方式和 PDO DSN 格式，替换后 PHP 代码几乎无需修改。

确认 phpEnv 当前数据库进程与端口

phpEnv 启动后，默认使用 mysqld.exe 进程监听 3306 端口。但这个“mysqld.exe”实际可能是 MySQL 或 MariaDB 的二进制文件 —— 关键看它属于哪个发行版。

打开任务管理器 → 查看“详细信息”页 → 找到 mysqld.exe 进程 → 右键“打开文件所在位置”。如果路径里含 mariadb 字样（如 phpEnv\mariadb\bin\mysqld.exe），说明已内置；如果是 mysql 目录，则需手动替换。

• 不要直接覆盖 mysqld.exe 文件：Windows 下服务注册名、配置路径、数据目录结构都可能不一致
• phpEnv 的服务控制脚本（如 start_mysql.bat）通常硬编码了可执行路径，替换前先查清它调用的是哪个 mysqld
• 用 netstat -ano | findstr :3306 确认端口占用进程 PID，再比对任务管理器中的 PID，避免误杀其他服务

下载并部署 MariaDB 替换包（Windows）

phpEnv 不提供一键切换数据库的 UI，必须手动部署 MariaDB 并调整服务指向。推荐使用官方 MSI 安装包（如 mariadb-10.11.8-winx64.msi），而非 ZIP 解压版 —— MSI 会自动注册 Windows 服务、写入注册表、配置 PATH，并且安装路径干净（默认 C:\Program Files\MariaDB 10.11）。

• 安装时取消勾选 “Install as Windows Service”，避免与 phpEnv 自带的服务冲突
• 安装完成后，把 C:\Program Files\MariaDB 10.11\bin\ 加入系统 PATH（或仅临时加到 phpEnv 的启动脚本中）
• 将 phpEnv 原 mysql 目录重命名为 mysql.bak，再在原位置新建空 mysql 文件夹，用 mklink 创建符号链接：mklink /D mysql "C:\Program Files\MariaDB 10.11"
• 检查 phpEnv\mysql\my.ini 是否存在；若不存在，从 MariaDB 安装目录复制一份，并确保 datadir 指向 phpEnv 原数据目录（如 phpEnv\mysql\data），否则会初始化全新库

验证 PDO 连接与字符集兼容性

PHP 用 PDO 连 MariaDB 和连 MySQL 几乎一样，但两个细节容易出错：

• charset=utf8mb4 必须显式声明在 DSN 中，例如："mysql:host=localhost;port=3306;dbname=test;charset=utf8mb4"；MariaDB 10.2+ 默认 utf8mb4，但旧版 phpEnv 的 MySQL 配置可能仍设 default-character-set=utf8，导致中文乱码
• 若遇到 SQLSTATE[HY000] [1045] Access denied for user 'root'@'localhost'，不是密码错，而是 MariaDB 的 auth_plugin 默认为 mysql_native_password，而某些老版本 phpEnv 的 mysql 客户端只支持 mysql_old_password —— 此时需登录 MariaDB 执行：ALTER USER 'root'@'localhost' IDENTIFIED VIA mysql_native_password USING PASSWORD('your-pass');
• 用 php -r "print_r(PDO::getAvailableDrivers());" 确认 mysql 驱动已启用；若无输出，检查 php.ini 中是否启用了 extension=php_pdo_mysql.dll

远程访问与防火墙放行

phpEnv 默认只允许本地连接（bind-address = 127.0.0.1）。要让 Navicat 或其他机器访问，需两步操作：

• 编辑 phpEnv\mysql\my.ini，找到 bind-address 行，改为 bind-address = 0.0.0.0（或注释掉该行）
• 在 MariaDB 中创建远程用户：CREATE USER 'dev'@'%' IDENTIFIED BY 'pass123'; GRANT ALL ON *.* TO 'dev'@'%'; FLUSH PRIVILEGES;
• Windows 防火墙必须放行 TCP 3306 端口：用管理员权限运行 netsh advfirewall firewall add rule name="MariaDB" dir=in action=allow protocol=TCP localport=3306
• 注意：phpEnv 的托盘图标右键菜单中“MySQL 设置”可能仍显示 MySQL 名称，这是界面文字残留，不影响底层 MariaDB 运行

真正麻烦的不是替换本身，而是 phpEnv 启动脚本里隐式依赖 MySQL 的服务名、日志路径、甚至错误提示字符串。一旦你改了 bin 路径或 my.ini，务必用 phpEnv\start_mysql.bat 手动执行一次，观察控制台输出是否有 Starting MariaDB... 或残留的 Starting MySQL... —— 后者说明脚本还没真正切过去。

今天关于《phpEnv安装MariaDB替代MySQL配置指南》的内容介绍就到此结束，如果有什么疑问或者建议，可以在golang学习网公众号下多多回复交流；文中若有不正之处，也希望回复留言以告知！