phpMyAdmin 5.0.4在IIS+PHP8环境下无法加载setup配置GUI页报错

核心报错原因 #

• 版本兼容性不匹配是触发问题的本质：phpMyAdmin 5.0.4 版本正式适配的PHP运行环境最高为PHP 7.4，不支持PHP 8.0的强类型参数校验规则
• PHP 8.0 对所有内置函数的入参类型做了严格校验：像preg_replace()这类函数的第三个入参$subject，要求必须是字符串或数组类型，如果传入null值会直接抛出致命TypeError，中断程序运行；而PHP 7.x 同场景下仅触发兼容警告，不会中断页面流程
• 你碰到的setup/index.php:32行的报错，就是代码读取IIS环境变量得到了null值，直接传入preg_replace函数，在PHP8环境下触发了强制校验。

可选解决方法 #

方案1：版本对齐（最稳妥，零代码改动） #

• 将IIS站点绑定的PHP运行版本从8.0切换为7.4.x稳定版（这是phpMyAdmin 5.0.4官方明确兼容的PHP版本范围）
• 操作路径：打开IIS管理器，进入站点的「处理程序映射」配置页，把原来指向PHP 8.0版本php-cgi.exe的映射规则，替换为PHP 7.4对应路径的php-cgi.exe，完成后重启站点即可恢复正常访问

方案2：代码补丁兼容（受环境限制不能换PHP版本时使用） #

如果业务环境强制要求使用PHP8.0，可通过给代码加空值兜底的方式解决强类型报错：

1. 打开报错文件 C:\inetpub\wwwroot\phpmyadmin\setup\index.php，定位到第32行的preg_replace()调用逻辑
2. 给传入函数的第三个参数加空值兜底规则：

   原代码中直接传递的环境变量/配置值如果为null，替换为带空字符串兜底的写法，比如给对应变量后追加 ?? ''，确保传入preg_replace的参数为有效字符串类型，满足PHP8的入参要求

3. 后续还要排查setup目录、主程序目录下其他同类内置函数（如preg_match、str_replace）的空值传参问题，避免其他位置触发同类类型报错

方案3：升级phpMyAdmin版本适配PHP8 #

• 替换当前的phpMyAdmin 5.0.4版本为官方正式支持PHP 8.0的5.1.0及以上版本
• 升级时记得保留旧版本目录下已有的config.inc.php配置文件，避免重复初始化数据库连接参数

注意事项 #

• 当前报错和你已经配置的IIS_IUSRS组目录权限无关，不需要额外调整目录的访问权限
• 不要随意修改PHP的错误屏蔽级别，当前的报错栈可以直接定位问题代码行，屏蔽错误只会导致纯白页面，增加排查成本

内容的提问来源于stack exchange，提问作者xtg