phpEnv支持将默认MySQL安全替换为完全兼容的MariaDB，需手动部署、调整服务指向并配置my.ini及字符集，替换后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）。
立即学习“PHP免费学习笔记（深入）”；
- 安装时取消勾选 “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... —— 后者说明脚本还没真正切过去。
