在 macOS 系统中搭建本地 PHP 服务器，是许多开发者在进行 Web 开发时的基础需求，通过本地服务器，开发者可以在不依赖远程主机的情况下，快速调试 PHP 代码、测试数据库连接以及模拟线上环境，本文将详细介绍在 macOS 上搭建 PHP 本地服务器的完整步骤，包括环境配置、软件选择、常见问题处理等内容,帮助开发者顺利完成搭建工作。
搭建前的准备工作
在开始搭建之前，需要确保 macOS 系统满足基本要求：推荐使用 macOS 10.14 或更高版本，并确保系统已更新至最新状态，开发者需要安装 Xcode 命令行工具，其中包含 GCC 编译器和其他必要的开发组件，打开终端，输入 xcode-select --install 即可安装，如果系统中已安装 Apache 或 PHP，建议先通过终端检查其版本，避免后续配置时出现冲突，输入 httpd -v 可查看 Apache 版本，php -v 可查看 PHP 版本。
选择搭建方式
在 macOS 中搭建 PHP 本地服务器主要有两种方式：一种是使用系统自带的 Apache 和 PHP，另一种是使用第三方集成环境（如 MAMP、XAMPP），对于初学者或需要快速启动的开发者，集成环境更为便捷；而对于希望深度定制或学习底层原理的开发者，手动配置系统自带组件则更有价值，本文将重点介绍手动配置方式,帮助开发者理解服务器搭建的每个环节。
配置 Apache 服务器
macOS 系统默认已安装 Apache，但默认未启用，通过终端启动 Apache 服务：输入 sudo apachectl start，若浏览器访问 http://localhost 显示 “It works!”，则表示 Apache 启动成功，配置 Apache 的虚拟主机，以便支持多项目开发，Apache 的配置文件位于 /etc/apache2/httpd.conf，使用 sudo nano /etc/apache2/httpd.conf 打开文件，找到以下内容并取消注释（删除前面的 ）：
LoadModule rewrite_module libexec/apache2/mod_rewrite.so
Include /etc/apache2/extra/httpd-vhosts.conf然后编辑虚拟主机配置文件 /etc/apache2/extra/httpd-vhosts.conf,添加如下示例配置：
<VirtualHost *:80>
DocumentRoot "/Users/你的用户名/Sites/project1"
ServerName project1.local
<Directory "/Users/你的用户名/Sites/project1">
Options Indexes FollowSymLinks
AllowOverride All
Require all granted
</Directory>
</VirtualHost>保存后，在 /etc/hosts 文件中添加 0.0.1 project1.local，即可通过 http://project1.local 访问项目。
配置 PHP 环境
macOS 默认可能未安装 PHP 或版本较低，可通过 Homebrew 安装所需版本，首先安装 Homebrew：在终端输入 /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"，安装完成后，输入 brew install php 安装最新版 PHP，安装成功后，检查 PHP 版本：php -v，若 Apache 未加载 PHP 模块，需编辑 /etc/apache2/httpd.conf,取消注释以下行：
LoadModule php_module libexec/apache2/libphp.so并在 Apache 配置中添加 PHP 文件解析规则，在 httpd.conf 文件末尾添加：
<FilesMatch \.php$>
SetHandler application/x-httpd-php
</FilesMatch>重启 Apache 服务：sudo apachectl restart，在项目目录下创建 info.php 文件，内容为 <?php phpinfo(); ?>，访问 http://project1.local/info.php 即可查看 PHP 配置信息。
配置数据库支持
PHP 开发通常需要数据库支持，可通过安装 MySQL 或 MariaDB 实现，以 MySQL 为例，使用 Homebrew 安装：brew install mysql，安装完成后，初始化数据库：mysql_secure_installation，根据提示设置 root 密码和其他安全选项，在 PHP 中使用 MySQL，需确保安装了 PHP 的 MySQL 扩展：brew install php-mysql，重启 Apache 后，即可在 PHP 代码中使用 mysqli 或 PDO 连接数据库。
常见问题处理
在搭建过程中，可能会遇到端口冲突、权限不足或模块加载失败等问题，若 Apache 启动失败，可通过 sudo apachectl status 查看错误日志；若虚拟主机无法访问，检查 httpd-vhosts.conf 中的路径是否正确，以及 hosts 文件是否添加了域名映射，确保 PHP 配置文件 php.ini 的路径正确，可通过 php -i | grep "Loaded Configuration File" 查找当前加载的配置文件路径。
开发工具推荐
为提升开发效率，可配合使用代码编辑器（如 VS Code、PhpStorm）和调试工具（Xdebug），安装 Xdebug 的步骤：通过 Homebrew 安装 brew install php-xdebug，然后在 php.ini 中添加配置：
zend_extension=xdebug
xdebug.mode=debug
xdebug.client_port=9003重启 Apache 后,即可在编辑器中配置断点调试。
相关问答 FAQs
问题 1：如何在 macOS 中切换 PHP 版本？
解答：若通过 Homebrew 安装了多个 PHP 版本，可使用 brew list | grep php 查看已安装版本，切换版本时，需先卸载当前版本：brew uninstall php，再安装目标版本：brew install php@8.1，重新配置 Apache 加载新的 PHP 模块，并重启服务，注意：不同版本的 PHP 可能需要单独安装扩展。
问题 2：本地服务器搭建后如何实现 HTTPS 访问？
解答：可通过生成自签名证书实现 HTTPS，使用 OpenSSL 生成证书：openssl req -newkey rsa:2048 -nodes -keyout server.key -x509 -days 365 -out server.crt，将生成的证书文件放在 Apache 配置目录下，然后在 httpd.conf 中添加虚拟主机配置，指定 SSL 证书路径，并将端口改为 443,访问时需在浏览器中信任自签名证书。
