访问localhost/phpMyAdmin显示文件夹列表而非页面如何解决

问题背景 #

运行环境为MacOS Catalina系统，已安装PHP7.4、Apache2、phpMyAdmin5.1，/usr/local/etc/httpd/httpd.conf配置中已设置DirectoryIndex Index.php Index.html参数，访问localhost/phpMyAdmin时仅显示文件夹列表，未加载对应功能页面，现象如下：

排查解决步骤 #

• 第一步：修正DirectoryIndex大小写配置
  你当前配置的DirectoryIndex Index.php Index.html中文件名首字母大写，而phpMyAdmin默认入口文件为小写的index.php，需将配置修改为：
  DirectoryIndex index.php index.html
• 第二步：确认Apache已加载PHP7.4模块
  执行命令检查配置中是否存在PHP模块加载项：
  grep "libphp7_module" /usr/local/etc/httpd/httpd.conf
  若输出为空，需在httpd.conf中添加如下配置：
  LoadModule php7_module /usr/local/opt/php@7.4/lib/httpd/modules/libphp7.so
• 第三步：添加PHP文件解析规则
  需配置Apache将php文件交由PHP模块处理，在httpd.conf中添加如下配置段：

  <FilesMatch \.php$>
      SetHandler application/x-httpd-php
  </FilesMatch>
  

• 第四步：校验phpMyAdmin目录权限
  确保Apache运行用户对phpMyAdmin所在目录有可读可执行权限，执行如下命令调整权限（请替换为你实际的phpMyAdmin存放路径）：
  chmod -R 755 /path/to/phpMyAdmin
chown -R yourUsername:_www /path/to/phpMyAdmin
• 第五步：重启Apache生效配置
  执行命令重启Apache服务：
  sudo apachectl restart
  重启完成后清理浏览器缓存，重新访问localhost/phpMyAdmin即可。

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