核心是用Homebrew统一管理PHP、Web服务器和扩展:先安装Homebrew并更新,再brew install php@8.3并配置PATH与php.ini,接着按需选用PHP内置服务器、Apache或Nginx+PHP-FPM,最后通过brew安装redis等扩展并验证加载。

在 macOS 上搭本地 PHP 开发环境,核心是用 Homebrew 统一管理 PHP、Web 服务器和扩展,而不是依赖系统自带的老旧版本。整个过程分四步:装好包管理器、装并配置 PHP、选一个 Web 服务跑起来、按需加扩展。不复杂,但路径和配置细节容易出错。
安装 Homebrew 并确认环境
Homebrew 是 macOS 开发环境的基石,所有后续操作都基于它:
- 打开终端,运行安装命令:
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" - 安装完成后执行
brew --version,看到版本号即成功 - 运行
brew update确保软件源最新 - 检查当前 shell 类型:
echo $SHELL;Apple Silicon Mac 通常为/bin/zsh,配置文件是~/.zshrc
安装 PHP 并配置 CLI
推荐安装 PHP 8.3(当前稳定版),避免兼容性问题:
- 执行
brew install php@8.3,Homebrew 会自动处理依赖和基础配置 - 安装完后,按提示将路径加入
~/.zshrc(Apple Silicon):echo 'export PATH="/opt/homebrew/bin:/opt/homebrew/sbin:$PATH"' >> ~/.zshrc - 执行
source ~/.zshrc生效,再运行php -v应显示PHP 8.3.x - 查看配置文件位置:
php --ini,通常为/opt/homebrew/etc/php/8.3/php.ini
选择并配置 Web 服务
三种主流方式,按需求选一种即可:
立即学习“PHP免费学习笔记(深入)”;
-
轻量测试用 PHP 内置服务器:无需额外安装,适合单文件快速验证
进入项目目录,运行php -S localhost:8000,浏览器访问http://localhost:8000 -
Apache(系统自带或 Homebrew 版):适合熟悉传统 LAMP 的用户
编辑/etc/apache2/httpd.conf,取消注释LoadModule php_module libexec/apache2/libphp.so,并在DirectoryIndex行末尾加index.php;重启服务:sudo apachectl restart;把info.php放到/Library/WebServer/Documents/ -
Nginx + PHP-FPM(推荐):性能好、配置灵活
执行brew install nginx php@8.3;Nginx 配置中添加location ~ \.php$块,指向fastcgi_pass 127.0.0.1:9000;启动服务:brew services start php和brew services start nginx;测试文件放/opt/homebrew/var/www
安装常用扩展(如 Redis、PDO_SQLite、cURL)
多数扩展可通过 Homebrew 直接安装,省去手动编译:
- Redis 扩展:
brew install php@8.3-redis,安装后自动写入php.ini的extension=redis.so - PDO_SQLite、cURL、mbstring、openssl、gd 等基础扩展,Homebrew 安装 PHP 时已默认启用,只需检查
php.ini中对应行是否未被注释(如extension=pdo_sqlite) - 若需手动开启某扩展,用
nano /opt/homebrew/etc/php/8.3/php.ini编辑,去掉行首分号;改完重启 Web 服务或 PHP-FPM - 验证扩展是否加载:
php -m | grep redis或访问info.php(内容为<?php phpinfo(); ?>)网页查看



















