直接用Homebrew安装配置PHP是macOS最稳妥主流方式,先执行命令安装Homebrew并验证版本,再brew install php@8.3,配置PATH使which php指向正确路径,复制并编辑php.ini启用pdo_sqlite、mbstring等扩展及时区,最后可通过php -S、Apache或Nginx+PHP-FPM运行。
直接用 homebrew 安装配置 php 是 macos 上最稳妥、最主流的方式。它能避开系统自带的老旧或已移除 php,统一管理版本、扩展和路径,整个过程清晰可控。
安装 Homebrew(如果还没装)
它是后续所有操作的基础:
- 打开终端,粘贴并执行:
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" - 按提示输入管理员密码,等待完成
- 执行 brew --version,看到版本号即成功
- 再运行 brew update 确保软件源最新
安装 PHP 并设为默认 CLI 版本
推荐安装当前稳定版(如 PHP 8.3),Homebrew 会自动处理依赖:
- 执行 brew install php@8.3
- 安装完成后运行 php -v,确认显示的是 8.3.x 版本
- 若仍显示旧版或报 command not found,需补全 PATH:
Apple Silicon Mac:运行 echo 'export PATH="/opt/homebrew/bin:/opt/homebrew/sbin:$PATH"' >> ~/.zshrc
Intel Mac:运行 echo 'export PATH="/usr/local/bin:/usr/local/sbin:$PATH"' >> ~/.zshrc - 执行 source ~/.zshrc 生效,再验证 which php 输出是否含 /opt/homebrew/bin/php(Apple Silicon)或 /usr/local/bin/php(Intel)
配置 php.ini 启用常用功能
关键配置文件默认在 Homebrew 路径下,修改后立即影响 CLI 和 Web 服务:
- 查看位置:php --ini → 记下 “Loaded Configuration File” 路径(通常是 /opt/homebrew/etc/php/8.3/php.ini)
- 复制模板: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
- 取消注释并确认启用:
extension=pdo_sqlite
extension=mbstring
extension=curl
extension=openssl - 设置时区(搜索 date.timezone):
date.timezone = Asia/Shanghai
选一种方式让 PHP 跑起来
根据开发阶段选择轻量或生产级方案:
立即学习“PHP免费学习笔记(深入)”;
- 快速测试(推荐新手):进项目目录,运行 php -S localhost:8000,浏览器打开 http://localhost:8000 即可
-
搭配 Apache(适合传统 LAMP 习惯):
安装:brew install httpd
启用 PHP 模块:编辑 /opt/homebrew/etc/httpd/httpd.conf,取消注释 LoadModule php_module 行,并添加 AddHandler php-script .php 和 DirectoryIndex index.php
重启:brew services restart httpd -
搭配 Nginx + PHP-FPM(适合 ThinkPHP/Laravel 等现代框架):
安装:brew install nginx php@8.3
启动 FPM:brew services start php@8.3
配置 Nginx 的 location ~ \.php$ 块,指向 127.0.0.1:9000(PHP-FPM 默认监听端口)



















