在macOS上用MAMP搭建ThinkPHP环境需三点：配置Apache重写规则使URL路由生效、通过虚拟主机为各项目分配独立域名（如tp5shop.local）、按版本正确配置数据库连接（TP3.x用config.php，TP5.x用database.php），并统一使用127.0.0.1而非localhost避免MySQL socket连接失败。
在 macOS 上用 MAMP 搭建 ThinkPHP 环境，核心在于三点：让 Apache 正确识别 ThinkPHP 的入口和重写规则、为不同项目分配独立域名（多站点）、以及稳定连接并操作 MySQL 数据库。MAMP 提供图形化管理，但默认配置并不直接适配 ThinkPHP 的 URL 路由和 public 入口结构，需手动调整。
多站点配置：用虚拟主机隔离 ThinkPHP 项目
MAMP 免费版不支持图形化虚拟主机管理，需手动编辑 Apache 配置文件实现多站点。关键不是改 htdocs 目录，而是为每个 ThinkPHP 项目指定独立的 DocumentRoot 并启用重写。
- 打开 /Applications/MAMP/conf/apache/httpd.conf，确认以下两行已取消注释：
LoadModule rewrite_module modules/mod_rewrite.soInclude /Applications/MAMP/conf/apache/extra/httpd-vhosts.conf - 编辑 /Applications/MAMP/conf/apache/extra/httpd-vhosts.conf，添加一个 VirtualHost 块（以项目
tp5shop为例）：<VirtualHost *:8888><br> ServerName tp5shop.local<br> DocumentRoot "/Applications/MAMP/htdocs/tp5shop/public"<br> <Directory "/Applications/MAMP/htdocs/tp5shop/public"><br> AllowOverride All<br> Require all granted<br> </Directory><br></VirtualHost>
- 修改系统 hosts 文件：
sudo nano /etc/hosts，追加一行：127.0.0.1 tp5shop.local - 重启 MAMP 中的 Apache 服务，浏览器访问 http://tp5shop.local 即可加载 ThinkPHP 5 的 public 入口，URL 重写（如
/index/user/login）才能正常工作。
ThinkPHP 数据库连接配置要点
ThinkPHP 不直接读取 phpMyAdmin 的登录凭据，需在项目配置中显式声明 MySQL 连接参数。MAMP 默认的 MySQL 凭据是 root / root，端口 3306，但 ThinkPHP 3.x 与 5.x 的配置方式不同。
- ThinkPHP 3.2：在
Application/Common/Conf/config.php中设置：'DB_TYPE' => 'mysql',<br>'DB_HOST' => '127.0.0.1', // 不建议用 localhost（可能走 socket）<br>'DB_NAME' => 'shop_db',<br>'DB_USER' => 'root',<br>'DB_PWD' => 'root',<br>'DB_PORT' => 3306,<br>'DB_PREFIX' => 'tp_'
- ThinkPHP 5.x：在
application/database.php中配置：'hostname' => '127.0.0.1',<br>'database' => 'shop_db',<br>'username' => 'root',<br>'password' => 'root',<br>'hostport' => 3306
- 务必使用
127.0.0.1而非localhost，避免因 MySQL socket 连接失败导致报错“SQLSTATE[HY000] [2002] No such file or directory”。
phpMyAdmin 管理数据库的实用技巧
phpMyAdmin 是 MAMP 自带的数据库管理界面，地址为 http://localhost:8888/phpMyAdmin。它不只是用来建表，更是调试 ThinkPHP 数据操作的关键工具。
立即学习“PHP免费学习笔记（深入）”；
- 创建数据库时，**字符集选 utf8mb4，排序规则选 utf8mb4_unicode_ci** —— 这是 ThinkPHP 5+ 推荐配置，兼容 emoji 和多语言。
- 导入 SQL 文件前，先在 phpMyAdmin 中选中目标数据库，再点击“导入”标签页，上传 .sql 文件即可。适用于快速初始化测试数据。
- 执行 SQL 语句调试时，可在“SQL”标签页直接运行：
SELECT * FROM tp_user WHERE status = 1;
结果实时显示，比在代码里 var_dump 更直观。 - 权限不足报错（如 “#1044 - Access denied for user 'root'@'localhost'”）？在 phpMyAdmin 左侧选中数据库 → “权限” → 编辑 root 用户，勾选所有全局权限并刷新。
常见问题速查与绕过方案
环境跑起来后，90% 的问题集中在路径、重写和权限上，不必重装 MAMP。
-
页面 404 或跳转到 MAMP 首页：检查 VirtualHost 的 DocumentRoot 是否指向 ThinkPHP 的
public目录（TP5）或webroot（TP6），不是项目根目录。 -
URL 重写失效（如 /index/index 显示为 /index.php/index/index）：确认 Apache 的
AllowOverride All已在 VirtualHost 内启用，且项目 public 目录下存在有效的.htaccess文件。 -
MySQL 连接超时或拒绝访问：在终端执行
/Applications/MAMP/Library/bin/mysql -u root -p -h 127.0.0.1测试连通性；若失败，打开 MAMP → Preferences → MySQL → 勾选 “Allow network access to MySQL”。 - 修改 PHP 版本后 ThinkPHP 报错：TP5.1+ 要求 PHP ≥ 7.1，TP6 要求 ≥ 7.3。MAMP 右上角菜单可切换 PHP 版本，切换后必须重启 Apache。
