phpEnv 不支持 MariaDB，因其硬编码适配 MySQL 服务名、配置路径及检测方式；强行替换会导致启动失败、状态识别异常；唯一稳妥方案是将 MariaDB 作为独立服务（如 MSI 安装并改用 3307 端口）或通过 Docker 运行，彻底剥离 phpEnv 的数据库管理。
phpEnv 本身不支持 MariaDB，强行替换会破坏服务管理逻辑，导致启动失败、版本切换失灵或 phpEnv 控制面板无法识别数据库状态。 它的“软件管理”模块硬编码适配 MySQL 二进制结构（如 mysqld 服务名、my.ini 路径约定、mysqladmin ping 检测方式），MariaDB 的 mysqld.exe 行为虽相似，但服务注册名、默认配置项、密码认证插件默认值均有差异——这不是改个文件夹名就能绕过的。
为什么不能直接把 MariaDB 解压进 phpEnv\server\mysql\ 下？
phpEnv 启动 MySQL 时依赖固定路径和命名规则：phpEnv\server\mysql\mysql-5.7\bin\mysqld.exe、phpEnv\server\mysql\mysql-5.7\data\、phpEnv\server\mysql\mysql-5.7\my.ini。即使你把 MariaDB 10.6 解压成 mysql-10.6，它仍会：
- 在 Windows 服务注册时尝试用
mysql作为服务名（而 MariaDB 默认注册为MariaDB或自定义名），phpEnv 停止服务时执行net stop mysql会失败 - 读取
my.ini时忽略 MariaDB 特有参数（如aria_pagecache_buffer_size），但若配置了 MySQL 不识别的选项（如innodb_strict_mode=OFF在旧版 MariaDB 中合法），启动直接报错退出 - phpEnv 的“数据库状态检测”脚本调用
mysqladmin -u root -p password ping，而 MariaDB 8.0+ 默认启用unix_socket插件，root 用户可能无法用密码登录，导致面板显示“未运行”
想用 MariaDB，唯一可行路径是绕过 phpEnv 的数据库管理
保留 phpEnv 管理 PHP/Apache/Nginx，但把 MariaDB 当作独立服务运行：
- 从 MariaDB 官网下载 Windows MSI 安装包（如
mariadb-10.11.8-winx64.msi），**不要解压 zip 包**——MSI 会正确注册服务、初始化 data 目录、写入注册表 - 安装时自定义服务名为
MariaDB（不要改成mysql），端口设为3307（避开 phpEnv 默认的 3306，避免冲突） - 安装完成后，在系统环境变量
Path中添加D:\Program Files\MariaDB 10.11\bin\（路径以你实际安装位置为准） - 在你的 PHP 项目里，连接 DSN 改为
mysql:host=127.0.0.1;port=3307;dbname=test，而不是依赖 phpEnv 自动注入的localhost:3306 - phpEnv 面板里的“MySQL 状态”将始终显示离线，这正常——你已主动剥离它的数据库控制权
如果坚持要让 phpEnv “认出” MariaDB，必须修改其核心脚本
这属于高风险操作，仅限调试用途，且每次 phpEnv 升级都会被覆盖：
立即学习“PHP免费学习笔记（深入）”；
- 找到
phpEnv\phpenv\phpenv.exe同级目录下的config\mysql.json（或类似命名的 JSON 配置文件），手动添加一个 MariaDB 版本条目，指定"service_name": "MariaDB"和"port": 3307 - 修改
phpEnv\phpenv\lib\mysql.ps1（PowerShell 启动脚本），把所有net start mysql替换为net start MariaDB，把mysqladmin ping改为mysqladmin -h127.0.0.1 -P3307 ping - 在
phpEnv\server\mysql\下新建mysql-10.11文件夹，把 MariaDB 的bin和data复制进去，再手写一个精简版my.ini，只保留[mysqld]段和port、datadir、basedir三项，**删掉所有 MariaDB 专属参数** - 重启 phpEnv，它可能显示“MariaDB 已启动”，但一旦你通过面板切换回 MySQL 5.7，旧版脚本大概率因找不到
mysql服务而卡死
真正省事的做法是：用 phpEnv 跑 PHP + Web 服务器，用 Docker 跑 MariaDB（docker run -d -p 3307:3306 --name mariadb -e MARIADB_ROOT_PASSWORD=123 -v ./mariadb-data:/var/lib/mysql mariadb:10.11），或者直接换用支持多引擎的环境工具（如 Laragon、XAMPP）。phpEnv 的设计初衷就是 MySQL 快速部署，不是数据库抽象层。
