Mac安装PHP完整教程详解

本文详细介绍了在现代 macOS 系统（尤其是 Monterey 及更新版本）上正确安装和配置 PHP 的唯一推荐方案——使用 Homebrew，彻底摒弃已移除的系统自带 PHP；涵盖从 Homebrew 安装与升级、PATH 环境变量精准配置、PHP 8.3 命令行生效验证，到 php.ini 模板复制、关键参数修改及即时生效技巧，并明确指出绝大多数开发场景（如 Laravel 开发、Composer 使用、API 测试）完全无需 Apache 或 Nginx，仅靠 PHP 内置服务器即可高效启动项目，帮助开发者避开常见陷阱，一步到位建立稳定、可控、现代化的本地 PHP 环境。

Homebrew 是当前 macOS 上安装 PHP 最可靠、最可控的方式，系统自带的 PHP 已在 macOS Monterey（12.0）起彻底移除，直接运行 php -v 会报 command not found —— 别折腾旧方法，用 Homebrew 装最新稳定版（如 PHP 8.3）是唯一推荐路径。

怎么确认 Homebrew 没装或需要更新

终端里执行 brew --version。如果提示 command not found，说明没装；如果输出版本号但低于 4.0，建议先更新——因为老版本 brew 对 Apple Silicon 的路径处理不一致，容易导致后续 php 命令找不到。

没装就跑这行：

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

已装但版本旧，执行：

• brew update（同步远程公式库）
• brew upgrade（升级已安装工具，含 brew 自身）

完成后再次 brew --version，确保 ≥ 4.0。

brew install php 后为什么 php -v 还是旧版本或报错

根本原因：Homebrew 安装的 PHP 二进制文件默认放在 /opt/homebrew/bin/php（Apple Silicon）或 /usr/local/bin/php（Intel），但 shell 并不知道该优先用它——PATH 顺序错了。

执行 which php 看输出。如果是 /usr/bin/php，那就是系统残留 alias 或旧 PATH 生效了；如果是空，说明 PATH 根本没包含 Homebrew 路径。

解决办法（以 Apple Silicon 为例）：

• 确认 shell 类型：echo $SHELL，大概率是 /bin/zsh
• 把 Homebrew bin 路径加到 ~/.zshrc 开头（必须靠前，否则被系统路径覆盖）：echo 'export PATH="/opt/homebrew/bin:/opt/homebrew/sbin:$PATH"' >> ~/.zshrc
• 重载配置：source ~/.zshrc
• 再跑 which php，应输出 /opt/homebrew/bin/php；php -v 显示 8.3.x 才算真正生效

php.ini 在哪？改完怎么让配置生效

Homebrew 不会自动创建或覆盖 php.ini，它只提供一个默认模板。运行 php --ini，看 “Loaded Configuration File” 行——路径类似 /opt/homebrew/etc/php/8.3/php.ini。如果这行显示 “(none)”，说明你还没复制模板。

操作步骤：

• 检查模板是否存在：ls /opt/homebrew/etc/php/8.3/php.ini*，通常有 php.ini.default
• 复制为正式配置：cp /opt/homebrew/etc/php/8.3/php.ini.default /opt/homebrew/etc/php/8.3/php.ini
• 编辑它：nano /opt/homebrew/etc/php/8.3/php.ini
• 改关键项，比如：date.timezone = "Asia/Shanghai"、memory_limit = 512M、upload_max_filesize = 64M
• 改完保存，**不需要重启任何服务**——CLI 模式下每次运行 php 都会重新读取该文件

验证是否生效：php -r "echo ini_get('date.timezone');" 输出应为你设的时区。

要不要装 Apache/Nginx？其实多数情况不用

如果你只是写命令行脚本、跑 Laravel/Symfony 命令、用 Composer、或者本地测试 API 接口，**完全不需要 Web 服务器**。PHP 内置服务器够用：php -S localhost:8000，配合路由文件就能跑简单页面。

只有当你明确需要：

• 跑 WordPress / Drupal 这类依赖 .htaccess 或复杂 rewrite 规则的 CMS
• 调试多域名、HTTPS、反向代理等真实部署场景
• 压测或长期驻留服务

才值得配 Nginx + PHP-FPM。否则，php -S 是最快启动、零配置、无端口冲突的方案——尤其适合日常开发和 CI 流水线中的 PHP 单元测试环境。

最后提醒一句：别手动改系统级 /etc/php.ini 或试图 symlink 到 Homebrew 的配置，那条路只会让你在不同 PHP 版本间反复迷失。每个 php@8.3 公式都自带独立配置目录，认准 php --ini 输出的路径，其他全是干扰项。

今天关于《Mac安装PHP完整教程详解》的内容介绍就到此结束，如果有什么疑问或者建议，可以在golang学习网公众号下多多回复交流；文中若有不正之处，也希望回复留言以告知！