直接安装php@8.1即可,但必须确保使用apple silicon原生homebrew(路径为/opt/homebrew/bin/brew)、正确设置path优先包含/opt/homebrew/opt/php@8.1/bin、手动复制php.ini.default并启用关键扩展,否则php -v会报错或加载错误版本。

直接装 php@8.1 就行,但必须注意路径、架构和链接顺序——跳过任一环,php -v 都会显示错版本或报 command not found。
确认 Homebrew 是 Apple Silicon 原生安装
Mac M 系列芯片必须用 ARM 版 Homebrew,否则 php@8.1 二进制可能无法运行或路径错乱:
- 运行
which brew,正确输出应为/opt/homebrew/bin/brew - 若看到
/usr/local/bin/brew,说明是 Intel 版残留,需先清理:sudo rm -rf /usr/local/Homebrew,再重装 - 确保终端未启用 Rosetta(右键 Terminal → “显示简介” → 取消勾选“使用 Rosetta”)
安装 php@8.1 而不是 php 或 shivammathur/php/php@8.1
Homebrew 官方仓库已原生支持 php@8.1(截至 2026 年),无需第三方 tap:
- 执行
brew install php@8.1即可,brew tap shivammathur/php已过时且可能引入冲突公式 - 安装后二进制路径固定为
/opt/homebrew/opt/php@8.1/bin/php(Apple Silicon) - 不要运行
brew link php@8.1—— 默认不 link,避免覆盖其他版本;切换时用brew link --force php@8.1显式控制
PATH 必须优先包含 /opt/homebrew/opt/php@8.1/bin
仅加 /opt/homebrew/bin 不够,因为该目录下只有软链,真正可执行文件在 opt/php@8.1/bin/ 下:
- 编辑
~/.zshrc,在最开头插入:export PATH="/opt/homebrew/opt/php@8.1/bin:/opt/homebrew/opt/php@8.1/sbin:$PATH" - 运行
source ~/.zshrc,再检查:which php应输出/opt/homebrew/opt/php@8.1/bin/php - 若仍指向
/usr/bin/php,说明系统 PATH 优先级更高,需确认没在其他配置文件(如/etc/zshrc)里硬编码了旧路径
php.ini 不会自动生成,改完要重启 CLI 进程
php --ini 显示 “Loaded Configuration File: (none)” 是常态,Homebrew 不会主动复制模板:
- 先确认模板存在:
ls /opt/homebrew/etc/php/8.1/php.ini*,通常有php.ini.default - 手动复制:
cp /opt/homebrew/etc/php/8.1/php.ini.default /opt/homebrew/etc/php/8.1/php.ini - 修改后无需重启服务,但已打开的终端进程不会自动重载配置;新开终端或重新运行
php -i | grep "Loaded Configuration File"验证 - 常见要开的项:取消
;extension=opcache和;extension=pdo_mysql前的分号
最容易被忽略的是:每次新开终端,PATH 是否真生效;以及 php --ini 输出的配置路径是否和你编辑的 php.ini 文件完全一致——少一个数字(比如写成 8.11 而非 8.1)都会导致配置静默失效。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











