Mac上通过brew安装php后仍出现PHP警告,如何解决
故障根源
brew安装的新版PHP没有在Shell的可执行文件查找优先级里排到前面,导致执行php命令时,系统仍然优先定位到macOS内置的、已标记废弃的7.3.24版本PHP,而非你新装的版本。
分步排查与修复
- 先确认两个PHP的实际安装位置
执行命令:which -a php
正常会输出两行路径:- 第一行是系统自带的旧PHP:
/usr/bin/php(对应弹出警告的7.3.24版本) - 第二行是brew安装的新PHP:Apple Silicon芯片Mac为
/opt/homebrew/bin/php,Intel芯片Mac为/usr/local/bin/php
可以直接调用新PHP的绝对路径验证安装状态:比如Apple Silicon机型跑/opt/homebrew/bin/php -v,如果能正常输出新版PHP信息、无废弃警告,就说明brew安装的PHP本身完全正常,问题仅为路径优先级错误。
- 第一行是系统自带的旧PHP:
- 调整Shell的PATH顺序
macOS默认使用zsh,部分旧系统默认bash,根据使用的Shell修改对应配置文件,把brew的可执行路径放到系统路径之前:- zsh用户:编辑
~/.zshrc,在文件最顶部追加对应芯片的路径配置:
Apple Silicon机型:export PATH="/opt/homebrew/bin:$PATH"
Intel机型:export PATH="/usr/local/bin:$PATH" - bash用户:编辑
~/.bash_profile,追加和上面一致的路径配置。
配置写完后执行对应命令让配置即时生效:zsh跑source ~/.zshrc,bash跑source ~/.bash_profile。
这时候再执行php -v,就会直接调用brew安装的新版PHP,macOS的废弃警告会直接消失。
注意:brew安装PHP时会自动往Shell配置文件里追加PATH配置,但如果配置文件里有更早写死的系统路径排在前面,就会覆盖brew的配置,手动把brew路径挪到最顶部即可解决。
- zsh用户:编辑
- 安装后续需要的Composer
确认php -v正常输出新版信息、无警告后,直接执行brew install composer即可完成安装,brew会自动关联当前环境的PHP版本,安装完成后跑composer -V就能验证可用性,不需要额外调整路径。
常见踩坑提示:如果调整完PATH仍然有警告,检查配置文件里是否有多段重复的PATH配置,只要保证brew对应的bin路径在所有系统路径之前,就不会优先匹配到内置旧版PHP。
内容的提问来源于stack exchange,提问作者Kristina Bressler
相关产品推荐
相关产品推荐

