Mac快速切换PHP版本方法详解

本文详解了在 macOS 上通过 Homebrew 实现轻量、精准、无污染的 PHP 多版本切换方法：核心是 `brew unlink` 清理旧链接 + `brew link --force php@X.Y` 强制激活目标版本，并强调必须同步重启对应版本的 PHP-FPM 服务，才能确保 CLI 与 Web 环境（如 Nginx+PHP-FPM）完全一致；同时提醒读者注意各版本独立的扩展路径、配置文件和编译兼容性，避免因复用 php.ini 或混装扩展导致启动失败——这是一套不依赖额外工具、不修改 shell 配置、真正可控且贴近生产实践的高效切换方案。

直接用 brew link --force 切换是最轻量、最可控的方式，不需要额外工具或全局 alias，也不会污染 shell 配置——但必须配合 brew unlink 清理旧链接，否则会出错。

确认已安装的 PHP 版本有哪些

Homebrew 不会自动列出带 @ 符号的版本，得手动筛：

• brew list | grep php@ —— 输出类似 php@8.1、php@8.2、php@8.3
• 如果没看到想用的版本（比如缺 php@8.0），先运行 brew install php@8.0；注意：5.6 及更老版本 Homebrew 已彻底移除，无法安装
• 每个版本实际装在独立路径，如 Apple Silicon 上是 /opt/homebrew/opt/php@8.2/bin/php，Intel 是 /usr/local/opt/php@8.2/bin/php

用 brew unlink + brew link --force 切换 CLI 版本

这是最干净的切换方式，只影响当前终端 session 的 php 命令，不改 PATH、不写配置文件：

• 先断开所有已链接的 PHP：brew unlink php（注意不是 php@8.x）
• 再强制链接目标版本：brew link --force php@8.2（--force 必须加，否则报 “Linking is not permitted”）
• 验证：which php 应返回 /opt/homebrew/bin/php，php -v 显示对应版本
• ⚠️ 常见错误：bash: /usr/local/bin/php: No such file or directory —— 说明 unlink 后没 link 新版本，或 link 失败但没报错

切换后 CLI 和 Web 服务（PHP-FPM/Apache）不是一回事

你改了 php -v 的输出，并不代表网页里 phpinfo() 也跟着变：

• CLI 模式走的是 brew link 设置的 php 命令
• PHP-FPM 是独立服务，需单独重启：brew services restart php@8.2（不能用 php@8.1 的服务去跑 php@8.2 的代码）
• Apache 如果用的是系统自带模块（libphp.so），它根本不认 Homebrew 的 PHP —— 这种组合基本不可靠，建议统一用 Nginx + PHP-FPM
• 查当前生效的配置：php --ini 看 Loaded Configuration File 路径，确保你在改的是这个 php.ini

别让扩展和配置跨版本复用

PHP 扩展（如 pdo_mysql、xdebug）是编译绑定到具体 PHP 版本的，混用必报错：

• PHP Warning: PHP Startup: Unable to load dynamic library 'pdo_mysql' —— 典型就是用了 php@8.1 的 php.ini，却加载了 php@8.2 编译的 so 文件
• 每个版本的扩展路径不同：/opt/homebrew/lib/php/pecl/20220829/（8.2） vs /opt/homebrew/lib/php/pecl/20210902/（8.1）
• 切版本后必须重装扩展：pecl install xdebug（它会自动匹配当前 php 版本）
• 别图省事复制整个 ext 目录或共用一个 php.ini —— 路径、INI 指令支持度、默认值都可能不同

真正容易被忽略的点是：PHP-FPM 配置里的 php_admin_value[extension] 或 php_ini 路径，一旦写死就绕过 brew link 的切换逻辑。每次切版本，最好顺手检查 php-fpm.d/www.conf 和 php --ini 是否一致。

本篇关于《Mac快速切换PHP版本方法详解》的介绍就到此结束啦，但是学无止境，想要了解学习更多关于文章的相关知识，请关注golang学习网公众号！