全新安装apache2后phpMyAdmin无法正常运行问题求助
Apache2未加载PHP模块,或未配置.php后缀的解析规则,收到phpMyAdmin的页面请求时直接将源码作为静态文件返回。
第一步:检查并安装Apache对应的PHP模块
不同发行版命令不同:
Debian/Ubuntu系列执行:apt install libapache2-mod-php php-mysql
CentOS/RHEL系列执行:yum install php php-mysqlnd mod_ssl
安装完成后确认模块已启用:a2enmod php8.x(把8.x替换成你实际安装的PHP版本号,比如php8.1、php7.4)第二步:验证Apache的PHP解析配置
检查Apache配置文件中是否存在对应解析规则,默认路径:
Debian/Ubuntu在/etc/apache2/mods-enabled/php8.x.conf,CentOS/RHEL在/etc/httpd/conf.d/php.conf
确认包含以下配置段:<FilesMatch \.php$> SetHandler application/x-httpd-php </FilesMatch>如果是PHP-FPM模式部署,确认配置中已正确关联FPM的监听地址(unix socket或TCP端口)。
第三步:重启Apache服务生效配置
Debian/Ubuntu执行:systemctl restart apache2
CentOS/RHEL执行:systemctl restart httpd第四步:验证解析功能
在站点根目录新建info.php文件,写入内容:<?php phpinfo(); ?>,访问该文件确认返回PHP配置页面而非源码,验证正常后再访问phpMyAdmin页面即可。额外排查项:如果上述步骤操作后仍未解决,检查phpMyAdmin所在目录的Apache配置,确认未设置
php_flag engine off强制关闭PHP解析,也没有错误的静态文件规则匹配.php后缀。
内容的提问来源于stack exchange,提问作者Marcelo Menezes

