在macOS上用Homebrew搭建PHP本地开发环境的核心是独立可控、路径清晰、服务解耦；需先安装Homebrew并配置PATH，再安装php@8.3等指定版本，验证pdo_mysql等关键扩展，搭配Nginx与PHP-FPM运行，数据库推荐Docker管理，辅以Composer和Xdebug提升开发效率。
在macOS上用Homebrew搭建PHP本地开发环境，核心是“独立可控”——不依赖系统预装组件，避免版本冲突，便于项目适配与长期维护。关键不在装得多，而在路径清晰、服务解耦、扩展齐备。
安装Homebrew并初始化工具链
Homebrew是整个流程的基石。打开终端执行：
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
安装完成后运行 brew --version 确认输出（如 4.4.2）。若提示 command not found，说明PATH未生效：
立即学习“PHP免费学习笔记（深入）”；
- Apple Silicon Mac：执行 echo 'export PATH="/opt/homebrew/bin:/opt/homebrew/sbin:$PATH"' >> ~/.zshrc
- Intel Mac：执行 echo 'export PATH="/usr/local/bin:/usr/local/sbin:$PATH"' >> ~/.zshrc
再运行 source ~/.zshrc && brew update。这步必须完成，否则后续可能搜不到php@8.x等版本包。
安装指定PHP版本并验证运行时能力
ThinkPHP 8.0、Laravel 10+等主流框架要求PHP ≥ 8.0，建议直接安装 php@8.2 或 php@8.3（稳定且兼容性强）：
brew install php@8.3
安装后检查版本：php -v 应显示 PHP 8.3.x (cli)。若仍为旧版，执行：
brew unlink php && brew link --force php@8.3
接着验证必需扩展是否加载：
php -m | grep -E "(pdo|mysql|mbstring|xml|curl|openssl)"
必须包含 pdo、pdo_mysql、mbstring、xml、curl、openssl。缺任一模块，都可能导致框架启动失败或HTTP请求异常。
配置PHP-FPM与Web服务器解耦
不推荐直接启用macOS自带Apache（版本陈旧、权限混乱），推荐用Homebrew安装Nginx + PHP-FPM组合：
- 安装Nginx：brew install nginx
- 确认PHP-FPM已随php@8.3自动安装（默认监听 127.0.0.1:9000）
- 编辑Nginx配置：sudo nano /opt/homebrew/etc/nginx/nginx.conf
- 在 server 块中添加：
location ~ \.php$ { fastcgi_pass 127.0.0.1:9000; fastcgi_index index.php; fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name; include fastcgi_params; }
启动服务：brew services start nginx && brew services start php@8.3。访问 http://localhost:8080/info.php（文件内容为 <?php phpinfo(); ?>）即可验证整条链路。
按需集成数据库与开发辅助工具
数据库建议统一用Docker管理，避免宿主机污染：
- 安装Docker：brew install --cask docker，启动应用后运行：
docker run -d --name dev-mysql -p 3306:3306 -e MYSQL_ROOT_PASSWORD=dev123 -v $(pwd)/mysql-data:/var/lib/mysql -d mysql:8.0 - 安装Composer：brew install composer，确保能正常执行 composer create-project thinkphp/think tp8
- 调试推荐VS Code + PHP Debug插件，配合php.ini中启用：
xdebug.mode=debug
xdebug.client_host=127.0.0.1
xdebug.start_with_request=yes
所有服务均通过 brew services list 统一查看状态，启停清晰，无后台残留。
