phpMyAdmin 版本必须与 MAMP Pro 的 PHP 版本严格匹配，如 PHP 7.4 对应 phpMyAdmin 5.1.5；需禁用自动同步、修改 Apache 配置指向自定义路径，并正确设置 host、port 和 blowfish_secret 才能正常登录。
phpMyAdmin 版本不匹配 PHP 时直接报错
新版 phpmyadmin（如 5.2+）默认要求 php >= 8.1，而 mamp pro 自带的旧版 php（比如 7.4）一启动就抛出 fatal error: uncaught typeerror。这不是配置问题，是硬性版本墙——强行替换文件只会卡在登录页或白屏。
- 先查清当前 MAMP Pro 激活的
PHP版本：http://localhost:8888/MAMP/→ “PHP Info” - 再去官网找对应
phpMyAdmin版本的Requirements表，重点看 “PHP version” 一行 - 推荐组合：
PHP 7.4→ 用phpMyAdmin 5.1.5；PHP 8.2→ 可上phpMyAdmin 5.2.2
替换前必须停用 MAMP Pro 的自动 phpMyAdmin 同步
MAMP Pro 默认会把 /Applications/MAMP/bin/phpMyAdmin/ 下的内容和内置版本强绑定，每次启动都可能覆盖你手动放进去的文件。不关掉这个机制，换十次也白搭。
- 打开 MAMP Pro → 菜单栏
File→Edit Template→PHP - 找到并注释掉类似
Alias /phpMyAdmin "/Applications/MAMP/bin/phpMyAdmin"的行（加#） - 再新增一行：
Alias /phpMyAdmin "/Users/yourname/custom-phpmyadmin"（路径必须绝对、可读） - 重启 MAMP Pro 才生效
config.inc.php 里最关键的三处改写
直接复制官方包里的 config.sample.inc.php 改名后，以下三项不调，进不了登录页或连不上 MySQL：
-
$cfg['Servers'][$i]['host'] = '127.0.0.1';（不能写localhost，MAMP Pro 的 socket 绑定认 IP） -
$cfg['Servers'][$i]['port'] = '8889';（MAMP Pro MySQL 默认端口不是 3306） -
$cfg['blowfish_secret'] = 'a8b3c7d9e1f2...';（必须填满至少 32 位随机字符，否则提示Missing parameter: blowfish_secret）
其他如 $cfg['Servers'][$i]['auth_type'] = 'cookie'; 可保留，默认就行。
权限与符号链接导致 403 Forbidden
即使路径写对、配置无误，浏览器仍报 403 Forbidden，八成是 Apache 拒绝了你自定义目录的访问权限。
立即学习“PHP免费学习笔记（深入）”；
- 确保目标目录（如
/Users/yourname/custom-phpmyadmin）对_www用户可读：sudo chown -R _www:_www /Users/yourname/custom-phpmyadmin - 禁用系统 SIP 后仍可能被 macOS Gatekeeper 拦截 —— 右键该文件夹 → “显示简介” → 底部点“全部允许”
- 别用符号链接（
ln -s）指向 Dropbox 或 iCloud 目录，Apache 默认禁止跨挂载点访问
路径里有空格或中文？立刻改掉。Apache 对这类路径解析极不稳定。
