Mac环境下Yii2、XAMPP与phpMyAdmin配置故障求助

1. 配置Yii2应用UQST通过http://localhost/UQST/访问 #

你遇到的Forbidden错误，核心是Apache没有权限访问用户目录下的Yii2文件，同时可能未开启符号链接支持。按以下步骤操作：

步骤1：修改Apache目录权限配置 #

编辑Apache主配置文件/private/etc/apache2/httpd.conf，找到<Directory "/Library/WebServer/Documents">配置块，替换为以下内容：

<Directory "/Library/WebServer/Documents">
    Options Indexes FollowSymLinks Multiviews
    AllowOverride All
    Require all granted
</Directory>

• FollowSymLinks允许Apache解析符号链接；
• AllowOverride All让Yii2的.htaccess规则生效；
• Require all granted开放该目录的全局访问权限。

步骤2：调整用户目录与Yii2文件权限 #

Apache运行用户为_www，需确保它能读取你的用户目录和Yii2文件：

# 开放用户目录的读取权限
chmod 755 /Users/my_username/
# 递归设置Yii2应用目录的权限
chmod -R 755 /Users/my_username/UQST/

步骤3：重启Apache生效 #

sudo apachectl restart

如果想直接通过http://localhost/UQST/访问Yii2首页，建议把符号链接指向/Users/my_username/UQST/web/（Yii2的入口目录），而不是整个UQST目录。

2. 配置phpMyAdmin通过http://localhost/UQST/phpMyAdmin/访问 #

Not Found错误通常和目录路径、权限或PHP模块未开启有关，按以下步骤排查：

步骤1：确认目录与权限 #

先检查phpMyAdmin目录是否确实在/Users/my_username/UQST/web/phpMyAdmin/（Mac系统区分大小写，注意目录名拼写），然后设置权限：

chmod -R 755 /Users/my_username/UQST/web/phpMyAdmin/

步骤2：开启Apache的PHP模块 #

编辑/private/etc/apache2/httpd.conf，找到并取消以下两行的注释（去掉前面的#）：

LoadModule php7_module libexec/apache2/libphp7.so
AddType application/x-httpd-php .php

这一步确保Apache能解析PHP文件，否则phpMyAdmin页面会直接下载或显示源码。

步骤3：重启Apache测试 #

sudo apachectl restart

如果仍有问题，可查看Apache错误日志/private/var/log/apache2/error_log，里面会有具体的错误提示（比如缺少PHP扩展、权限细节等）。

额外提示 #

• 切换到Apache后，检查Yii2的config/web.php中request配置，确保baseUrl设置正确：

  'request' => [
      'baseUrl' => '/UQST/web',
  ],
  

• 若想简化访问路径，可配置Apache虚拟主机，直接将域名指向Yii2的web目录，访问体验会更顺畅。

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