macOS下MAMP配置ThinkPHP二级域名：本地调试环境搭建指南【说明】-ThinkPHP-PHP中文网

在 macOS 上用 MAMP 搭建 ThinkPHP 二级域名本地调试环境，必须严格对齐 hosts 解析、MAMP 虚拟主机和 ThinkPHP 路由三者：①在 /etc/hosts 中添加 127.0.0.1 admin.tp6.test 等映射并执行 sudo dscacheutil -flushcache；②在 httpd-vhosts.conf 中配置 ServerName 与 hosts 一致、DocumentRoot 指向 public/、启用 AllowOverride All；③在 config/app.php 开启 'url_domain_deploy' => true，并在路由文件中用 Route::domain() 绑定子域名与应用目录。

macos下mamp配置thinkphp二级域名：本地调试环境搭建指南【说明】

在 macOS 上用 MAMP 搭建 ThinkPHP 二级域名本地调试环境，关键不是堆砌工具，而是让 hosts 解析、MAMP 虚拟主机、ThinkPHP 路由三者严格对齐。缺一不可，错一个就 404 或跳转失败。

hosts 文件必须精准映射

这是整个流程的起点，写错就全盘失效。用管理员权限打开 /etc/hosts（终端执行 sudo nano /etc/hosts），在末尾添加：

127.0.0.1 admin.tp6.test
127.0.0.1 api.tp6.test
127.0.0.1 tp6.test

注意：IP 和域名之间只用空格或 Tab；域名不能带端口、不能含下划线；每行一个；保存为 UTF-8 无 BOM；改完立即执行 sudo dscacheutil -flushcache 刷新 DNS 缓存。

MAMP 中配置虚拟主机（非默认 htdocs）

MAMP 免费版不直接支持图形化虚拟主机管理，需手动修改 Apache 配置：

打开 /Applications/MAMP/conf/apache/extra/httpd-vhosts.conf，追加如下块（以 admin.tp6.test 为例）：

<virtualhost>
    ServerName admin.tp6.test
    DocumentRoot "/Users/你的用户名/Sites/myapp/public"
    <directory>
        Options Indexes FollowSymLinks
        AllowOverride All
        Require all granted
    </directory></virtualhost>

确保：DocumentRoot 指向项目 public 目录（不是根目录）；ServerName 必须和 hosts 里完全一致；AllowOverride All 启用 .htaccess（ThinkPHP 伪静态依赖它）。

再确认 /Applications/MAMP/conf/apache/httpd.conf 中已取消注释这两行：

macOS UI 自动化技能包 —— 用 Python 控制你的 Mac

让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启：辅助功能 + 屏幕录制权限

下载

Include conf/extra/httpd-vhosts.conf
LoadModule rewrite_module modules/mod_rewrite.so

重启 MAMP 的 Apache 服务生效。

ThinkPHP 框架侧启用并绑定子域名

仅配好 Web 服务器还不够，框架必须主动识别并分发请求：

在 config/app.php 中开启域名部署：'url_domain_deploy' => true（TP6 唯一有效开关，APP_SUB_DOMAIN_DEPLOY 已废弃）；
在 app/common/route.php 或 route/app.php 中注册路由规则：

Route::domain('admin', 'admin'); // 访问 admin.tp6.test → 加载 app/admin/ 应用
Route::domain('api', 'api');     // 访问 api.tp6.test → 加载 app/api/ 应用

注意：域名前缀（如 admin）必须与 ServerName 中的子域名部分完全一致；应用目录名（如 admin）需真实存在且结构合规。

验证与常见卡点

全部配置完成后，在浏览器访问 http://admin.tp6.test：

如果显示 “无法连接”：检查 hosts 是否生效（ping admin.tp6.test 应返回 127.0.0.1）、MAMP Apache 是否监听 80 端口；
如果显示 404 或白屏：确认 DocumentRoot 是 public/，不是项目根目录；检查 .htaccess 是否被 Apache 正确读取（可临时放一个 phpinfo() 测试）；
如果路由不生效：确认 url_domain_deploy 开关已开启，且 Route::domain() 在正确位置注册（通常在 route/app.php 中）。

php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！