本教程旨在解决homebrew安装特定php版本（如php@7.3）时遇到的“disabled because it is a versioned formula”错误。通过引入`shivammathur/php`第三方tap，用户可以轻松安装并管理homebrew官方不再支持的php版本（范围涵盖5.6至8.2），从而绕过默认的版本限制，确保开发环境的灵活性和兼容性。
理解Homebrew的PHP版本管理策略
Homebrew作为macOS和Linux上流行的包管理器，通常致力于提供最新且受官方支持的软件版本。对于PHP这类频繁更新且存在多个活跃分支的语言，Homebrew的官方核心Tap（homebrew/core）通常只维护少数最新或广泛使用的版本。当用户尝试安装一个Homebrew核心Tap中已被标记为“版本化公式（versioned formula）”或已禁用的旧版PHP时，例如php@7.3，就会遇到以下错误提示：
Error: php@7.3 has been disabled because it is a versioned formula!
这表明Homebrew官方不再直接支持或推荐通过其核心Tap安装该特定版本。虽然这有助于保持系统的整洁和安全性，但对于需要维护旧项目或特定开发环境的用户来说，却带来了不便。
解决方案：利用shivammathur/php Tap
为了解决这一问题，我们可以借助社区维护的第三方Homebrew Tap——shivammathur/php。这个Tap专门为Homebrew用户提供了安装和管理多个PHP版本的便利，包括那些Homebrew官方核心Tap不再支持的版本。它支持从PHP 5.6到8.2的广泛版本范围，极大地增强了开发环境的灵活性。
以下是安装特定PHP版本（以php@7.3为例）的详细步骤：
立即学习“PHP免费学习笔记（深入）”；
步骤一：添加shivammathur/php Tap
首先，你需要将shivammathur/php这个第三方Tap添加到你的Homebrew环境中。这个操作只需执行一次。
brew tap shivammathur/php
执行此命令后，Homebrew会从GitHub下载并配置该Tap的公式，使其可用于后续的包安装。
步骤二：安装目标PHP版本
添加Tap之后，你就可以使用完整的Tap路径来安装你需要的特定PHP版本了。以安装php@7.3为例：
brew install shivammathur/php/php@7.3
Homebrew会开始下载并编译（如果需要）php@7.3。这个过程可能需要一些时间，具体取决于你的网络速度和系统性能。
步骤三：链接PHP版本
安装完成后，你需要将新安装的PHP版本链接到你的系统路径中，使其成为当前活跃的PHP版本。
brew link php@7.3
如果你的系统上已经链接了其他PHP版本，Homebrew可能会提示你先解除旧版本的链接。在这种情况下，你可以使用--force选项来强制链接，但这需要谨慎操作，以避免冲突：
brew link php@7.3 --force
重要提示： 强制链接会覆盖当前已链接的PHP版本。在进行此操作前，请确保你了解其影响，并知道如何切换回之前的版本。
验证安装
安装并链接完成后，你可以通过以下命令验证PHP版本是否正确：
php -v
如果一切顺利，你应该能看到类似PHP 7.3.x (cli) ...的输出。
注意事项与最佳实践
- 版本兼容性: shivammathur/php Tap支持的PHP版本范围广泛（5.6 - 8.2），但请始终查阅其GitHub仓库以获取最新的支持列表。
-
多版本共存与切换: 如果你需要同时管理多个PHP版本并在它们之间切换，可以使用brew unlink <旧版本>和brew link <新版本>命令。例如，从php@7.3切换到php@8.0：
brew unlink php@7.3 brew install shivammathur/php/php@8.0 # 如果尚未安装 brew link shivammathur/php/php@8.0
或者直接使用shivammathur/php提供的切换工具（如php-version，可能需要额外安装或配置）。
- PATH环境变量: 确保你的shell配置文件（如.bash_profile, .zshrc）中Homebrew的路径配置正确，通常Homebrew会自动处理。
-
更新与维护: 定期更新Homebrew和shivammathur/php Tap，以获取最新的修复和功能：
brew update brew upgrade shivammathur/php/php@7.3 # 升级特定版本
- 安全风险: 使用官方已停止维护的旧版PHP（如PHP 7.3已EOL）可能存在安全漏洞，不再接收安全更新。在生产环境中使用时，请务必评估潜在风险并采取适当的缓解措施。仅在有明确需求（如维护遗留系统）的情况下使用旧版本。
- 卸载: 如果不再需要某个PHP版本，可以使用brew uninstall shivammathur/php/php@7.3来卸载它。
总结
通过引入shivammathur/php这个强大的第三方Homebrew Tap，我们成功解决了Homebrew在安装旧版或特定PHP版本时遇到的“versioned formula”错误。这不仅提供了安装PHP 5.6到8.2等广泛版本的灵活性，也确保了开发者能够根据项目需求轻松配置和管理其开发环境。然而，在使用旧版本PHP时，务必注意其潜在的安全风险，并仅在必要时使用。掌握这些技巧，将使你在Homebrew的PHP版本管理上更加游刃有余。
