如何修复Homebrew的「No available formula」警告及php56相关报错

开发者阿泽

2026-5-22

解决Homebrew启动终端报错的方案

这问题我之前帮朋友处理过，本质是Homebrew的homebrew/php tap早就被官方废弃清理了，而你的终端启动流程里还在试图调用这个不存在的php56 formula。咱们一步步来解决：

第一步：检查终端启动配置文件
每次终端启动就触发报错，大概率是你的shell配置文件里有自动执行的相关命令。打开这些文件逐一排查：
- Bash用户：~/.bash_profile、~/.bashrc、~/.profile
- Zsh用户：~/.zshrc、~/.zprofile
  看看有没有类似brew install homebrew/php/php56、引用php56路径的代码，或者依赖php56的自动执行脚本，找到后删除或注释掉这些内容。
第二步：彻底清理废弃的Homebrew Tap
虽然你已经试过brew tap homebrew/php但提示为空，咱们直接把这个废弃的tap彻底移除：
```
brew untap homebrew/php
```
第三步：清理Homebrew残留缓存与旧公式
执行以下命令清理所有过期缓存、残留的旧公式文件：
```
brew cleanup --prune=all
brew doctor
```
运行brew doctor后如果还有提示，按照提示修复剩余的小问题就行。
第四步：如果确实需要PHP 5.6（可选）
如果你还需要PHP 5.6版本，官方tap已经不维护了，可以用第三方维护的tap：
```
brew tap shivammathur/php
brew install shivammathur/php/php@5.6
```
安装完成后记得更新你的shell配置，把新的php路径加入环境变量，避免再触发旧的报错。