ThinkPHP跨平台部署：macOS下使用MAMP Pro配置虚拟主机【说明】

在 macOS 上折腾 ThinkPHP 部署，最烦人的莫过于每次都要敲 localhost:8888/tp5/public 这种又臭又长的路径。想要用 tp5.local 这样的自定义域名一步到位？MAMP Pro 是唯一正确的选择——它的独立虚拟主机能绕过 public 子目录限制、搞定 URL 重写，并且把 PATH_INFO 规规矩矩地传过去。免费版 MAMP 在这些关键点上统统翻车，别指望了。

好，下面直接拆解操作步骤，每个环节都有容易掉坑的地方，咱们一个个说清楚。

创建 ThinkPHP 专用虚拟主机

打开 MAMP Pro，点击左下角的 【+】 按钮，选择 “New Host”，然后点 “Continue”。弹出来的窗口里，“Host Name” 一栏填你想用的本地域名，比如 【tp5.local】。注意：不能有下划线、空格或中文，而且必须以字母开头。“Document Root” 点击右侧文件夹图标，导航到你的 ThinkPHP 项目的 public 目录，比如 /Applications/MAMP/htdocs/tp5/public。

这一步不少人栽跟头——选的是整个项目的根目录而非 public，结果路由全是 404，静态资源也访问不了。记住，ThinkPHP 6+ 的入口已经强制收敛到 public，选错目录后面一切免谈。

（这里顺便提醒一句，上面的推广内容已删除，咱们继续。）

启用 Apache 重写与 PHP 版本绑定

切到 “Apache” 选项卡，勾选 “Activate URL rewriting”，这是开启伪静态的关键开关。下方 “PHP Version” 下拉菜单别忘了选对版本：ThinkPHP 6.x 用 PHP 7.4 或 8.0+ 都行；如果是 5.0/5.1 的老项目，那就选 PHP 7.2+。要是你的项目用了 ThinkPHP 6.3+ 并且启用了 Swoole 或协程特性，PHP 版本必须与之匹配，否则启动时会报 Class 'SwooleCoroutine' not found 这种让人抓狂的错误。

配置好之后点击右上角 “Sa ve” 保存，MAMP Pro 会自动验证路径是否有效，然后提示你重启服务。

修改系统 hosts 文件绑定域名

打开终端，输入 sudo nano /etc/hosts，输入管理员密码，在文件末尾新加一行：127.0.0.1 tp5.local。然后 Control+O 回车保存，Control+X 退出。

这一行千万别写成 127.0.1.1 或 ::1，否则浏览器因为 IPv6 优先策略，死活解析不到你的本地服务器，一直给你弹“找不到服务器”。修改完后关掉终端重新打开，执行 ping tp5.local，看到返回 127.0.0.1 就说明绑定成功了。

验证 Rewrite 与 PATH_INFO 传递

在 ThinkPHP 项目的 public 目录下新建一个临时测试文件 test.php，内容如下：

启动 MAMP Pro 的 Apache 服务，在浏览器访问 http://tp5.local/test.php/hello/world。如果页面输出 string(11) "/hello/world"，说明 PATH_INFO 传递正常。如果显示 "not set"，那就要去检查 Apache 配置里 AcceptPathInfo On 是否生效——MAMP Pro 默认是开启的，但如果你以前手动改过 httpd.conf 可能会被覆盖。确认没问题后，记得删掉 test.php。

启动服务并访问首页

回到 MAMP Pro 主界面，点击左上角 “Start Servers”，等 Apache 和 MySQL 的状态变成绿色运行中。然后在浏览器地址栏输入 http://tp5.local/，正常的话就能看到 ThinkPHP 的欢迎页或者你自己的路由首页了。从此以后，http://tp5.local/index.php/admin、http://tp5.local/static/css/app.css 这样的地址直接就能访问，public 路径彻底藏起来了。