phpMyAdmin 不能用 brew install 直接安装，需先用 brew 安装 PHP、MySQL/MariaDB 和 Nginx，再手动部署；必须启用 mysqli、mbstring、openssl 等扩展，正确配置 Nginx 的 alias 与 FastCGI，且 config.inc.php 需设置 blowfish_secret 和 host 并设为 644 权限。
phpMyAdmin 不能直接用 brew install 安装
homebrew 官方仓库里没有 phpmyadmin 这个 formula，它本身是纯 php 的 web 应用，不是可编译安装的命令行工具。你搜到的所谓 “brew install phpmyadmin” 要么是第三方 tap（不稳定），要么是误导信息。
真正该做的是：用 brew 安装它依赖的运行环境（PHP + Web 服务器 + MySQL），再手动部署 phpMyAdmin 文件。
-
brew install php—— 注意默认装的是最新版 PHP（如 8.3），而旧版 phpMyAdmin 可能不兼容 -
brew install mysql或brew install mariadb—— 数据库服务必须先跑起来 - Web 服务选
brew install nginx或让 PHP 自带的内置服务器临时用（仅开发）
PHP 扩展缺一不可，否则白装
phpMyAdmin 启动就报错“Missing extensions”，常见于没启用关键扩展。brew 装的 PHP 默认不自动开启扩展，得手动改 php.ini。
先确认配置文件位置：php --ini，通常在 /opt/homebrew/etc/php/8.3/php.ini（路径随 PHP 版本变）。
- 必须取消注释这三行：
extension=mysqli、extension=mbstring、extension=openssl -
gd和zip建议也开，否则导入导出或图像验证码可能异常 - 改完重启 PHP 服务：
brew services restart php，否则扩展不生效 - 验证是否加载成功：
php -m | grep -E 'mysqli|mbstring'
Web 路径配置最容易卡在权限和别名上
把 phpMyAdmin 放进 Web 根目录（比如 /opt/homebrew/var/www）最省事，但更推荐用 Nginx/Apache 的 alias 指向解压后的目录，避免污染主站结构。
立即学习“PHP免费学习笔记（深入）”；
以 Nginx 为例，常见错误是 location 匹配后没传 PHP 请求给 FastCGI：
- 别只写
alias /path/to/phpmyadmin/;，后面必须加index index.php; - 必须包含 PHP 处理块，例如：
location ~ \.php$ { fastcgi_pass 127.0.0.1:9000; ... } - 确保
fastcgi_param SCRIPT_FILENAME指向真实物理路径，不是 alias 路径（Nginx 的 alias 和 root 在 CGI 场景下行为不同） - Mac 上默认 PHP-FPM socket 路径是
/opt/homebrew/var/run/php-fpm.sock，别硬写 TCP 端口除非你改过配置
config.inc.php 权限和 blowfish_secret 是启动必填项
复制 config.sample.inc.php → config.inc.php 后，两个地方不改就打不开登录页：
-
$cfg['blowfish_secret'] = '随便一串32位字符';—— 不填会提示“未配置加密密钥” -
$cfg['Servers'][$i]['host'] = '127.0.0.1';—— brew 装的 MySQL 默认绑定 localhost，但有些版本只监听 socket，这时要改成'localhost'或显式指定'socket=/opt/homebrew/var/mysql/mysql.sock' -
config.inc.php文件权限不能是 777，Nginx/PHP-FPM 读取时若发现组/其他有写权限会拒绝加载（安全机制）—— 设为644即可
路径、扩展、权限、配置四者只要漏一个，页面就停在白屏或报错提示，没有中间状态。
