当前位置：首页 > 文章列表 > 文章 > php教程 > MacPHP安装教程：Homebrew快速安装PHP工具链

MacPHP安装教程：Homebrew快速安装PHP工具链

2026-01-21 17:24:44 0浏览收藏

最近发现不少小伙伴都对文章很感兴趣，所以今天继续给大家介绍文章相关的知识，本文《Mac系统PHP安装教程：Homebrew一键安装PHP工具链》主要内容涉及到等等知识点，希望能帮到你！当然如果阅读本文时存在不同想法，可以在评论中表达，但是请勿使用过激的措辞~

Homebrew安装PHP后php -v无响应是因PATH未包含/opt/homebrew/bin（M1/M2）或/usr/local/bin（Intel），需运行eval "$(/opt/homebrew/bin/brew shellenv)" >> ~/.zshrc并source ~/.zshrc；指定版本需用shivammathur/php/php@8.2等公式；扩展需手动编辑对应php.ini启用；Web服务须配置php-fpm，注意权限匹配。

mac系统php怎么下载安装_homebrew一键安装PHP工具链【操作】

mac 系统上用 Homebrew 安装 PHP 不是“一键”完事，brew install php 看似简单，但默认安装的是最新稳定版（比如 PHP 8.3），不自动配置环境变量、不启用扩展、不生成 php.ini，直接运行 php -v 可能仍指向系统自带的旧版（PHP 8.1 或更早），甚至报错“command not found”。

为什么 `brew install php` 后 `php -v` 没反应？

Homebrew 安装的 PHP 二进制文件默认放在 /opt/homebrew/bin/php（Apple Silicon）或 /usr/local/bin/php（Intel），但 macOS 的 $PATH 默认不包含这些路径，shell 找不到它。

检查是否已加入 PATH：
```
echo $PATH | grep homebrew
```
（M1/M2）或
```
echo $PATH | grep local
```
（Intel）
没输出？说明 shell 没加载 Homebrew 的初始化脚本 —— brew doctor 会提示你运行 echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zshrc（M1/M2）或 echo 'eval "$(/usr/local/bin/brew shellenv)"' >> ~/.zshrc（Intel）
改完记得重载：source ~/.zshrc，再试 php -v

如何指定安装某个 PHP 版本（如 8.1 或 8.2）？

Homebrew 官方仓库只保留一个 php 公式（latest），老版本需通过 homebrew-php 社区仓库或使用 shivammathur/php tap —— 但后者已归档。目前最稳妥的方式是：

先卸载现有 PHP：brew uninstall php
安装特定版本（以 8.2 为例）：
```
brew install shivammathur/php/php@8.2
```
链接该版本：brew link --force php@8.2
验证：php -v 应显示 PHP 8.2.x
注意：php@8.2 安装后配置文件在 /opt/homebrew/etc/php/8.2/php.ini，不是系统级路径

PHP 扩展（如 `pdo_mysql`、`redis`）怎么启用？

Homebrew 安装的 PHP 默认禁用所有扩展，需手动编辑 php.ini 并重启 CLI 或 Web 服务。

找到当前生效的配置文件：php --ini → 输出类似 Loaded Configuration File: /opt/homebrew/etc/php/8.2/php.ini
用编辑器打开它，取消注释对应行：
```
;extension=pdo_mysql
```
→ 改成
```
extension=pdo_mysql
```
Redis 扩展需先装：brew install php@8.2-redis（注意版本对齐），再在 php.ini 中加
```
extension=redis
```
改完保存，执行 php -m | grep mysql 验证是否加载成功

Apache/Nginx + PHP 要额外配什么？

Homebrew 的 php 公式不自动集成到 Web 服务器 —— 它只提供 CLI 和 FPM 模式。

若用 Apache：brew install httpd 后，需手动在 /opt/homebrew/etc/httpd/httpd.conf 中加载 libphp.so（PHP 8.2 已移除此模块），推荐改用 php-fpm 方式
启用 FPM：brew services start php@8.2，然后在 Nginx 配置里指向 127.0.0.1:9000（或 Unix socket：unix:/opt/homebrew/var/run/php-fpm.sock）
关键点：FPM 配置文件是 /opt/homebrew/etc/php/8.2/php-fpm.d/www.conf，其中 listen.owner 和 listen.group 必须匹配你的 Web 服务器用户（如 _www），否则 502 错误