本篇文章聚焦在 Mac 下搭建和配置 PHP 与 MySQL 的开发环境，覆盖从系统准备、工具链安装、数据库配置到常见问题的排查等全流程内容。通过详细步骤与示例代码，帮助开发者快速建立可用的本地环境。
1、Mac 环境准备与版本选择
1.1 硬件与系统版本
在进行开发前，需要确认 Mac 硬件配置与 macOS 版本支持最新的 PHP 版本和 MySQL 版本。若计划使用容器化工具，确保磁盘空间充足。系统环境的稳定性将直接影响后续安装和调试效率，优先选择官方支持的版本进行开发。
除了系统版本，命令行工具与开发工具链的可用性也很关键。请确保你具有完整的 Xcode 命令行工具，避免在安装依赖时遇到缺失的编译器或头文件问题。
1.2 版本选择与工具链
核心工具包括 Homebrew、PHP、MySQL、以及可选的 Composer、PhpMyAdmin 等。确保在系统中具备网络访问能力以获取安装包，并根据项目需求选择合适的 PHP 主版本（如 PHP 8.2 或 PHP 8.3）。
为提升开发效率，建议同时安装版本控制工具 Git，以及代码编辑器（如 VS Code）以便快速创建、运行与调试数据库驱动的应用。
2、在 Mac 上安装 PHP
2.1 安装 Homebrew 与环境配置
通过 Homebrew 安装 PHP 时，优先确保 Homebrew 已安装最新版本，并执行 brew update && brew upgrade。这样可以保证 依赖库与扩展的兼容性，减少版本冲突。
安装完成后，确认 PHP 的 路径与版本信息，并确保全局命令可用，避免在后续配置中出现找不到 php 的情况。
# 安装 Homebrew（若未安装）
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"# 更新并升级
brew update
brew upgrade# 验证 Homebrew 状态
brew doctor
2.2 安装 PHP 及常见扩展
选择合适的 PHP 主版本如 PHP 8.2，并安装常用扩展，如 pdo_mysql、mbstring、curl、openssl 等，以保障数据库交互与安全性。安装完成后，确保 php-fpm 与 Web 服务器的集成准备就绪。
为避免系统自带的冲突，建议使用 单独的 PHP 运行时，并通过 brew services 来管理服务状态。
# 安装所选 PHP 版本（示例为 8.2）
brew install php@8.2# 将 php-fpm 服务加入开机启动并启动
brew services start php@8.2# 确认 PHP 版本
php -v
3、在 Mac 上安装 MySQL
3.1 安装 MySQL
使用 Homebrew 安装 MySQL 的步骤通常包括 安装包、初始化数据库、启动服务。确保选择稳定版本并修改默认端口以避免与系统服务冲突，若需要在不同项目间切换端口，也可配置不同的实例。
在安装过程中，可以启用 mysql_secure_installation 来设置 root 密码、禁用匿名用户、删除测试数据库等安全措施，以保障本地开发环境的基本安全。
# 安装 MySQL
brew install mysql# 启动 MySQL 服务
brew services start mysql# 初始安全设置
mysql_secure_installation
3.2 配置初始账户与权限
为本地开发创建一个数据库用户并赋予合适权限，避免直接使用 root。使用以下命令创建用户并授权，确保日后连接只使用该用户即可：
CREATE USER 'devuser'@'localhost' IDENTIFIED BY 'password';
GRANT ALL PRIVILEGES ON *.* TO 'devuser'@'localhost' WITH GRANT OPTION;
FLUSH PRIVILEGES;
4、PHP 与 MySQL 的连接与环境配置
4.1 PHP-FPM 与 Web 服务器的集成
在 macOS 上，最常见的做法是让 PHP-FPM 与 Nginx 或 Apache 协同工作。配置要点包括 监听端口/套接字、用户权限、以及将 .php 文件转发给 FPM 处理，以实现高效的动态页面渲染能力。
若选择 Apache，需确保通过 mod_proxy_fcgi 或其他方式转发到 PHP-FPM，若选择 Nginx，则需要在站点配置中正确设置 fastcgi_pass、fastcgi_index 等参数。
# 示例：使用 nginx 加载 php-fpm（简化示例，实际需要 nginx 配置文件）
# 安装 nginx
brew install nginx# 启动 nginx 和 php-fpm
brew services start nginx
brew services start php@8.2# Nginx 站点配置片段（示意）
server {listen 8080;server_name localhost;root /Users/youruser/Sites;index index.php index.html;location ~ \\.php$ {fastcgi_pass 127.0.0.1:9000;include fastcgi_params;fastcgi_index index.php;}
}
4.2 测试数据库连接与排错要点
编写一个简单的 PHP 测试脚本来验证 PDO 或 mysqli 连接是否正常。若连接失败，优先检查 主机、端口、用户名、密码 与 数据库名称，以及 php.ini 中的扩展加载，并确保数据库用户具备访问权限。
PDO::ERRMODE_EXCEPTION,PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC,PDO::ATTR_EMULATE_PREPARES => false,
];try {$pdo = new PDO($dsn, $user, $pass, $options);echo "连接成功";
} catch (PDOException $e) {echo "连接失败: " . $e->getMessage();
}
?>5、运行与排查常见问题
5.1 常见问题及排错路径
在本地开发中，常见问题包括 PHP 未加载扩展、数据库连接被拒绝、端口冲突、以及 权限不足导致脚本无法写入日志等。系统化的排错流程有助于快速定位问题。
一个可靠的排错顺序是：先确认 命令行工具版本、PHP 版本、以及 MySQL 服务状态，再检查 日志文件，最后尽量在最小化复现场景中验证问题。
5.2 常用诊断命令与日志
记录下关键日志路径和诊断命令，以便快速回溯问题，例如 PHP-FPM 的错误日志、Nginx/Apache 的访问日志，以及 MySQL 的错误日志。
# 查看 MySQL 服务状态
brew services list# 查看 PHP 版本与可用扩展
php -v
php -m# 查看服务器日志位置（示例）
tail -n 100 /usr/local/var/log/nginx/error.log
tail -n 100 /usr/local/var/log/php-fpm.log
tail -n 100 /usr/local/var/mysql/*.err
