本文详细讲解在 Arch Linux 中解决 phpMyAdmin 页面显示 PHP 版本检查错误或空白页的常见问题，核心在于启用必需的 PHP 扩展（如 mysqli 和 bz2）并确保 Web 服务器（如 Apache 或 Nginx）正确解析 PHP 文件。
本文详细讲解在 arch linux 中解决 phpmyadmin 页面显示 php 版本检查错误或空白页的常见问题，核心在于启用必需的 php 扩展（如 `mysqli` 和 `bz2`）并确保 web 服务器（如 apache 或 nginx）正确解析 php 文件。
在 Arch Linux 上部署 phpMyAdmin 时，即使已安装较新版本的 PHP（如 PHP 8.1+），仍可能遇到两类典型问题：
- 访问
http://localhost/phpmyadmin时显示类似PHP 7.2.5+ is required. Currently installed version is: 8.1.8的原始 PHP 代码（而非报错页面），说明 PHP 未被 Web 服务器执行，而是作为纯文本返回； - 或出现完全空白页，通常意味着 PHP 解析失败、关键扩展缺失，或自动加载器（Composer）未就绪。
✅ 正确安装与配置步骤（Arch Linux）
1. 安装必要软件包
sudo pacman -S php php-apache mariadb phpmyadmin
⚠️ 注意：若使用 Nginx，请安装
php-fpm并跳过php-apache；本教程以 Apache 为例。
2. 启用关键 PHP 扩展
编辑 /etc/php/php.ini，取消以下两行的注释（删除分号 ;）：
extension=mysqli extension=bz2
此外，建议一并启用（尤其用于导入导出功能）：
立即学习“PHP免费学习笔记（深入）”；
Linux 安全审计工具，检查 SSH 配置、开放/监听端口、防火墙规则（ufw/iptables/nftables）、失败登录尝试、sudoers 权限...
extension=mbstring extension=gd extension=zip extension=xml
3. 配置 Apache 支持 PHP
确保 /etc/httpd/conf/httpd.conf 中已启用：
LoadModule mpm_prefork_module modules/mod_mpm_prefork.so LoadModule php_module modules/libphp.so AddHandler php-script .php Include conf/extra/phpmyadmin.conf
? 提示：Arch 官方 phpMyAdmin 包已自带
/etc/httpd/conf/extra/phpmyadmin.conf，它将/usr/share/webapps/phpMyAdmin映射为/phpmyadmin路径。
4. 重启服务并验证
sudo systemctl restart httpd sudo systemctl restart mysqld # 或 mariadb
访问 http://localhost/phpmyadmin —— 此时应正常加载登录界面。
? 常见故障排查要点
-
PHP 未执行（显示原始代码） → 检查
mod_php是否加载、.php是否绑定php-script处理器、httpd配置语法是否正确（sudo httpd -t）。 -
空白页 + 无错误日志 → 查看
/var/log/httpd/error_log，确认是否因AUTOLOAD_FILE缺失导致致命错误；此时需进入/usr/share/webapps/phpMyAdmin/运行：sudo -u http composer install --no-dev --optimize-autoloader
-
登录失败 / mysqli 连接拒绝 → 确保 MariaDB 已启动，且
config.inc.php中$cfg['Servers'][$i]['host'] = 'localhost';与实际服务一致（推荐改用'127.0.0.1'避免 socket 解析问题）。
✅ 总结
Arch Linux 的 phpMyAdmin 不是“装完即用”，其强依赖 PHP 扩展完整性与 Web 服务器深度集成。最关键的一步永远是：解注 mysqli 和 bz2 扩展，并确保 httpd 正确调用 PHP 解析器。 忽略任一环节都可能导致看似矛盾的报错（如显示 PHP_VERSION 字符串），实则是底层解析链断裂所致。遵循 Arch Wiki 文档并严格校验每项扩展状态，即可稳定运行。
