Mac下使用默认PHP服务器无法正常访问Magento2的问题求助

问题梳理 #

• 执行php -S 127.0.0.1:80后访问127.0.0.1提示连接被拒绝
• 访问127.0.0.1/pub可显示主页但无样式
• Ubuntu环境无需添加/pub即可正常访问

核心配置遗漏点及修复方案 #

1. Apache虚拟主机配置（替代PHP内置服务器） #

你当前用的是PHP内置服务器php -S，但Magento2官方推荐搭配Apache/Nginx运行，且需要配置虚拟主机指向pub目录——这也是Ubuntu能直接访问的核心原因。

操作步骤：

• 打开Apache主配置文件（Mac默认路径：/etc/apache2/httpd.conf），确保以下模块已启用（删除行首的#）：

  LoadModule rewrite_module libexec/apache2/mod_rewrite.so
  LoadModule php_module libexec/apache2/libphp.so
  

• 打开虚拟主机配置文件/etc/apache2/extra/httpd-vhosts.conf，添加以下配置：

  <VirtualHost *:80>
      ServerName magento.local
      DocumentRoot "/usr/local/opt/magento/pub"
      <Directory "/usr/local/opt/magento/pub">
          AllowOverride All
          Require all granted
          Options Indexes FollowSymLinks
      </Directory>
      ErrorLog "/private/var/log/apache2/magento.local-error_log"
      CustomLog "/private/var/log/apache2/magento.local-access_log" common
  </VirtualHost>
  

• 编辑本地hosts文件/etc/hosts，添加一行映射：

  127.0.0.1 magento.local
  

• 重启Apache服务：sudo apachectl restart
• 访问http://magento.local即可正常打开站点

2. 静态资源路径修复（解决无样式问题） #

如果暂时不想配置虚拟主机，可通过Magento命令修复静态资源：

• 进入项目目录：cd /usr/local/opt/magento
• 部署静态资源：

  php bin/magento setup:static-content:deploy -f
  

• 清理缓存：

  php bin/magento cache:clean
  php bin/magento cache:flush
  

3. PHP内置服务器连接被拒绝的原因 #

php -S 127.0.0.1:80失败的核心原因是80端口已被Apache占用（你提到使用了Mac默认Apache，它默认监听80端口），PHP内置服务器无法重复绑定该端口。

临时解决：换用未被占用的端口，比如：

php -S 127.0.0.1:8080

之后访问127.0.0.1:8080/pub即可。

4. Magento基础URL配置检查 #

确保数据库中基础URL配置正确：

• 登录MySQL，执行SQL查询：

  SELECT * FROM core_config_data WHERE path LIKE '%base_url%';
  

• 确认web/unsecure/base_url和web/secure/base_url的值为你设置的域名（比如http://magento.local/），若不正确，执行更新：

  UPDATE core_config_data SET value = 'http://magento.local/' WHERE path = 'web/unsecure/base_url';
  UPDATE core_config_data SET value = 'http://magento.local/' WHERE path = 'web/secure/base_url';
  

• 再次执行缓存清理命令生效。

总结 #

最根本的问题是未配置Apache虚拟主机指向Magento的pub目录，Ubuntu环境下应该已经完成了这步配置，所以无需手动添加/pub路径。优先配置虚拟主机，这是Magento2开发/生产环境的标准部署方式。

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