phpEnv如何迁移MySQL数据到MariaDB phpEnv数据库类型转换-php教程-PHP中文网

phpenv不支持mysql到mariadb的无缝切换，因二者认证插件、字符集、语法及存储引擎参数存在兼容性差异，需手动导出导入并修正sql脚本。

phpenv如何迁移mysql数据到mariadb phpenv数据库类型转换

phpEnv 本身不提供数据库迁移功能，它只是 Windows 下的 PHP + MySQL/MariaDB 集成环境管理工具；迁移必须手动操作，且不能直接“转换类型”，只能导出再导入。

为什么 phpEnv 里改个配置就切不了 MySQL 到 MariaDB

phpEnv 的“切换数据库”功能仅替换服务进程（mysqld.exe → mysqld.exe from MariaDB），但不会处理数据兼容性问题。MySQL 和 MariaDB 虽然协议兼容，但：

MySQL 8.0 的默认认证插件是 caching_sha2_password，MariaDB 不识别，连接会报 Plugin 'caching_sha2_password' is not loaded
MySQL 5.7 的 utf8 默认排序规则是 utf8_general_ci，MariaDB 10.5+ 默认用 utf8mb4_unicode_ci，导入时可能触发警告或字段截断
phpEnv 安装的 MariaDB 版本通常较旧（如 10.1.x），而你的 MySQL 可能是 5.7，CREATE TABLE 语句中带 ALGORITHM=INSTANT 或 JSON 字段定义，在 MariaDB 中会直接报错

用 mysqldump 导出时必须加的关键参数

直接执行 mysqldump -u root -p mydb > dump.sql 很容易在导入 MariaDB 时报错。应使用以下组合：

--compatible=mariadb：让导出语句尽量贴近 MariaDB 语法（例如去掉 MySQL 8.0 特有关键字）
--skip-triggers --skip-routines --skip-events：触发器、存储过程、事件在跨版本迁移中极易不兼容，建议先跳过，后续单独验证补上
--default-character-set=utf8mb4：强制统一字符集，避免 utf8（实际是 utf8mb3）导致 emoji 插入失败
--single-transaction：对 InnoDB 表保证一致性快照，不锁表（前提是源库不是 MyISAM）

完整命令示例：
mysqldump -u root -p --compatible=mariadb --skip-triggers --skip-routines --skip-events --default-character-set=utf8mb4 --single-transaction mydb > mydb_mariadb.sql

导入前必须手动检查的三处 SQL 内容

MariaDB 对某些 MySQL 语法更严格，dump 文件里常见几类需人工清理的地方：

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

删掉所有 /*!50700 PARTITION BY ... */ 注释块——MariaDB 不支持分区语法注释里的 MySQL 版本号
把 datetime NOT NULL DEFAULT '0000-00-00 00:00:00' 改成 datetime NULL 或 datetime NOT NULL DEFAULT CURRENT_TIMESTAMP，否则 MariaDB 10.3+ 会拒绝（strict mode 默认开启）
搜索 ENGINE=InnoDB ROW_FORMAT=DYNAMIC，改为 ENGINE=InnoDB——旧版 MariaDB 不识别 ROW_FORMAT 参数

别依赖“全量替换”，先用文本编辑器打开 dump 文件，用正则 DEFAULT\s+'0000-00-00.*?' 检查 datetime/date 类型的非法默认值。

导入后连不上？重点查 authentication_string 和 plugin 字段

MySQL 5.7+ 用户表里 mysql.user 的 plugin 字段常为 caching_sha2_password，MariaDB 无法解析。导入后必须重置用户密码：

启动 MariaDB 服务后，用 mysql -u root -p 登录
执行：UPDATE mysql.user SET plugin='mysql_native_password', authentication_string=PASSWORD('your_new_pass') WHERE User='root';
再执行：FLUSH PRIVILEGES;

注意：PASSWORD() 函数在 MariaDB 10.2+ 已废弃，若报错，改用：SET PASSWORD FOR 'root'@'localhost' = 'your_new_pass';

真正麻烦的从来不是“怎么导”，而是导完发现 PHP 连不上、时间字段变 NULL、或者某个索引莫名失效——这些细节在 dump 文件里藏得深，又不在 phpEnv 界面里提示，得一行行看错误日志和 SHOW CREATE TABLE 输出比对。