Mac系统跑PHP框架要装啥_跨平台环境配置简单方法【指南】

推荐用 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 运行时。