推荐用 Homebrew 统一管理 PHP（如 8.3）、官方脚本安装 Composer、手动启用 php.ini 中的必要扩展（如 pdo_mysql、opcache），并优先使用框架内置服务器开发。
Mac 系统跑 PHP 框架，不需要重装系统、不用折腾虚拟机，用 Homebrew + php + composer 就能直接开干。但很多人卡在「PHP 版本混乱」「扩展没加载」「Apache/Nginx 冲突」这三步上。
Homebrew 是唯一推荐的包管理入口
Mac 自带的 PHP 已废弃（macOS 12+ 彻底移除），系统级 php 命令不可靠。必须用 Homebrew 统一管理：
- 先装
Homebrew：/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" - 再装 PHP（推荐 8.2 或 8.3）：
brew install php@8.3 - 立刻执行
echo 'export PATH="/opt/homebrew/bin:$PATH"' >> ~/.zshrc && source ~/.zshrc，否则终端找不到新php - 验证：
php -v应输出PHP 8.3.x，且which php返回/opt/homebrew/bin/php
别用 macports 或手动编译——维护成本高，和 Composer 生态兼容性差。
Composer 必须用官方安装脚本，不能 brew install composer
brew install composer 装的是旧版或阉割版，常导致 laravel new 失败、symfony new 报 invalid signature。正确做法：
立即学习“PHP免费学习笔记（深入）”；
- 运行：
php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');" - 校验哈希：
php -r "if (hash_file('sha384', 'composer-setup.php') === 'e0012edf3e80b6978849f5eff0d4b4e4c79ff1609dd1f6133267f71df8ae4f85de586033151e5a16c7247988c51021449a80d698') { echo 'Installer verified'; } else { echo 'Installer corrupt'; unlink('composer-setup.php'); } echo PHP_EOL;" - 安装到全局：
sudo php composer-setup.php --install-dir=/usr/local/bin --filename=composer
完成后 composer --version 应显示 2.7.x 或更高，且 composer diagnose 不报 openssl 或 zip 扩展缺失。
PHP 扩展不是装了就生效，得手动改 php.ini
Homebrew 安装的 PHP 默认不启用常用扩展（如 pdo_mysql、opcache、mbstring），框架启动会报 Class 'PDO' not found 或响应极慢。
- 找到配置文件：
php --ini输出的Loaded Configuration File路径（通常是/opt/homebrew/etc/php/8.3/php.ini） - 取消注释这些行：
extension=mbstring、extension=pdo_sqlite、extension=opcache；MySQL 项目加extension=pdo_mysql - 重启终端后运行
php -m | grep -E 'mbstring|pdo|opcache'，确保全在列表里 - 注意：
opcache.enable=1和opcache.revalidate_freq=0在开发环境建议开启，避免改代码不生效
别依赖 brew services start php ——它只管 PHP-FPM 启动，不管 php.ini 加载逻辑。
Laravel/Symfony 本地运行用内置服务器最省事
别急着配 Apache 或 Nginx。Mac 上跑框架开发，php artisan serve 或 symfony server:start 足够快、无端口冲突、支持热重载。
- Laravel：
laravel new myapp && cd myapp && php artisan serve→ 访问http://127.0.0.1:8000 - Symfony：
symfony new myapp --webapp && cd myapp && symfony server:start - 如果提示
Address already in use，说明端口被占，加--port=8001换一个 - 数据库用
mysql@8.0（brew install mysql@8.0）或更轻量的sqlite，避免 Docker 启动 MySQL 的资源开销
真正要上线时再配 Nginx，开发阶段硬套生产环境配置，纯属给自己加锁。
最容易被忽略的是：每次升级 Homebrew 的 PHP（比如从 8.2 升到 8.3），php.ini 不会自动迁移，所有 extension 配置得重加一遍；还有 ~/.zshrc 里的 PATH 必须指向新版 bin 目录，否则 php 和 composer 用的可能是两个不同版本的 PHP 运行时。
