Mac用brew安装PHP环境步骤详解

本文详细介绍了在 macOS 上使用 Homebrew 快速、干净地搭建 PHP 开发环境的完整流程——从安装和更新 Homebrew，到通过官方维护的 shivammathur/php 仓库精准安装最新版 PHP（如 8.3 或 8.4），再到正确配置 PATH 避免与系统弃用版本冲突，并提供版本切换与扩展管理的实用技巧；整个过程无需编译、不污染系统、支持多版本共存，是 Mac 用户高效入门或升级 PHP 环境的首选方案。

直接用 Homebrew 安装 PHP 是 macOS 上最简洁高效的方式，不用手动编译、不污染系统路径，还能轻松切换版本。关键一步是先装好 Homebrew（如果还没装），再通过官方 tap 添加最新 PHP 支持。

确认 Homebrew 已安装并更新

打开终端，运行：

• 检查是否已装：brew --version，有输出说明已就绪；没有就先去 brew.sh 复制安装命令执行
• 更新 brew 和仓库：brew update（这步很重要，确保能拉到最新 PHP 版本）

添加 PHP 官方仓库（php tap）

Homebrew 核心仓库只保留少量旧版 PHP，新版（如 8.2、8.3、8.4）由 PHP 团队自己维护在 shivammathur/php 这个 tap 里：

• 运行：brew tap shivammathur/php
• 之后就能用 brew search php 看到带版本号的选项，比如 php@8.3、php@8.4

安装指定 PHP 版本（推荐带版本号的 formula）

不要直接 brew install php——它可能装的是过时的 8.1 或链接混乱的“latest”。明确指定更稳：

• 装最新稳定版（如 PHP 8.4）：brew install shivammathur/php/php@8.4
• 装 PHP 8.3：brew install shivammathur/php/php@8.3
• 安装后会自动软链到 /opt/homebrew/bin/php（Apple Silicon）或 /usr/local/bin/php（Intel），且附带 pecl、phpize、php-fpm

配置 PATH 并验证

确保终端优先调用 brew 安装的 PHP，而不是系统自带的（macOS 自带 PHP 已弃用，版本极老）：

• 编辑 shell 配置文件：nano ~/.zshrc（M1/M2 默认用 zsh）
• 在末尾加一行：export PATH="/opt/homebrew/bin:$PATH"（Apple Silicon）或 export PATH="/usr/local/bin:$PATH"（Intel）
• 保存后执行：source ~/.zshrc
• 验证：which php 应返回 /opt/homebrew/bin/php；php -v 显示你刚装的版本

不复杂但容易忽略：每次换 PHP 版本，记得 brew unlink php@旧版 && brew link php@新版，或者用 brew switch（需先装 brew install brew-switch）。扩展如 opcache、pdo_mysql 默认已启用，需要额外扩展可 pecl install 或通过 brew install php@8.4-opcache 类似方式补充。

到这里，我们也就讲完了《Mac用brew安装PHP环境步骤详解》的内容了。个人认为，基础知识的学习和巩固，是为了更好的将其运用到项目中，欢迎关注golang学习网公众号，带你了解更多关于的知识点！