phpMyAdmin被下载或显示源码，说明Apache未将请求交由PHP处理；常见原因包括Alias路径缺少PHP配置、Directory块缺权限与处理器指令、或缺失AddType/AddHandler。
phpMyAdmin目录被当成静态文件下载
浏览器直接下载 index.php 或显示源码，说明 apache 根本没把请求交给 php 处理——不是 phpmyadmin 本身坏了，而是它所在目录没被纳入 php 解析范围。
常见原因有三个：
• Alias 指向的路径下缺少 PHP 处理器配置（仅定义别名不等于启用 PHP）
• 对应的 <directory></directory> 块里没加 Require all granted 和 PHP 处理指令
• Apache 配置中漏了 AddType application/x-httpd-php .php 或 AddHandler
检查点：
• 运行 httpd -M | grep php 确认 php_module 已加载
• 在 phpMyAdmin 的 Apache 配置段（如 /etc/apache2/conf-available/phpmyadmin.conf）里，确保包含：
<Directory /usr/share/phpmyadmin>
Options FollowSymLinks
AllowOverride All
Require all granted
<FilesMatch \.php$>
SetHandler application/x-httpd-php
</FilesMatch>
</Directory>
访问返回403 Forbidden
页面打不开且报 403，大概率是 Apache 的目录权限控制拦住了请求，尤其在 Debian/Ubuntu 新版本中默认禁止外部访问系统级安装路径（如 /usr/share/phpmyadmin）。
关键动作：
• 不要只改 Allow from all（Apache 2.2）或 Require all granted（2.4），必须确认该指令写在正确的 <directory></directory> 块内，且路径与 Alias 实际指向一致
• 若用 a2enconf phpmyadmin 启用了配置，再执行 sudo systemctl reload apache2，不是 restart
• 检查 SELinux 是否启用（getenforce 返回 Enforcing 就得临时关掉：setenforce 0）
立即学习“PHP免费学习笔记（深入）”；
空白页或500错误但无日志输出
页面完全空白，或出现 500 错误但 error.log 里没明显线索，往往是因为 PHP 扩展缺失或配置错位。
重点排查：
• php -m | grep -E 'mysqli|mbstring|json' —— phpMyAdmin 强依赖这三个扩展
• 查看 phpMyAdmin 根目录下的 config.inc.php，确认 $cfg['Servers'][$i]['host'] 指向的是本地 MySQL 实例（如 'localhost' 或 '127.0.0.1'），而非空值或错误域名
• 如果用的是 socket 连接（如 /var/run/mysqld/mysqld.sock），确保 PHP 的 mysqli.default_socket 或配置文件里已显式指定
DocumentRoot 权限或符号链接问题
即使所有配置都对，仍可能因文件系统权限或路径解析失败导致失败。Apache 进程用户（通常是 www-data 或 daemon）必须对整个路径链有可执行（x）权限。
验证方式：
• 找到 DocumentRoot 或 Alias 目标路径（比如 /usr/share/phpmyadmin）
• 逐级运行 ls -ld / /usr /usr/share /usr/share/phpmyadmin，确认每层都有 x 权限给对应用户
• 若 phpMyAdmin 是通过符号链接挂载（例如从 /opt/lampp/phpmyadmin 链到 /usr/share/phpmyadmin），需在对应 <directory></directory> 块中添加 Options +FollowSymLinks
最常被忽略的是：Apache 2.4 默认禁用符号链接跟随，而很多一键包（如 XAMPP、LAMPP）靠软链组织目录结构，不加这个选项就会静默失败。
