macOS运行PHP项目有四种方式：一、用系统自带Apache+PHP，简单但版本旧；二、用Homebrew装新版PHP+Nginx+PHP-FPM，灵活高效；三、用Docker部署LEMP，环境隔离易复用；四、用MAMP Pro或XAMPP图形化工具，适合新手。
如果您希望在 macOS 系统上运行 PHP 项目，但本地尚未配置可执行的 PHP 环境，则可能是由于系统未预装完整 PHP 运行组件、缺少 Web 服务器支持或扩展未启用。以下是多种可行的部署方式：
一、使用内置 PHP + Apache（系统自带方案）
macOS 自带 PHP 和 Apache 服务，适用于快速启动基础环境，无需额外安装，但版本较旧且扩展管理受限。
1、打开终端，输入 sudo apachectl start 启动系统 Apache 服务。
2、执行 sudo nano /etc/apache2/httpd.conf 编辑 Apache 配置文件。
立即学习“PHP免费学习笔记（深入）”；
3、取消注释以下行（删除行首的 # 号）：LoadModule php_module libexec/apache2/libphp.so。
4、在相同文件中查找 DirectoryIndex 行，在其值末尾添加 index.php，确保 PHP 文件可被默认识别。
5、保存退出后执行 sudo apachectl restart 重启服务。
6、将 PHP 文件放入 /Library/WebServer/Documents/ 目录，通过浏览器访问 http://localhost/yourfile.php 测试。
二、使用 Homebrew 安装最新版 PHP + PHP-FPM + Nginx
该方式可获取当前稳定版 PHP（如 8.2/8.3），配合 Nginx 提供高性能本地服务，并支持按需启用扩展。
1、若未安装 Homebrew，先在终端运行：/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"。
2、执行 brew update 更新包索引。
3、安装 PHP：brew install php，安装完成后会提示配置 PATH，按提示执行对应命令（如 echo 'export PATH="/opt/homebrew/bin:$PATH"' >> ~/.zshrc）。
4、安装 Nginx：brew install nginx。
5、编辑 Nginx 配置：sudo nano /opt/homebrew/etc/nginx/nginx.conf，在 server 块内添加 location ~ \.php$ 区块，指定 fastcgi_pass 127.0.0.1:9000 并设置 fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name。
6、启动 PHP-FPM：brew services start php；启动 Nginx：brew services start nginx。
7、将测试文件（如 info.php）放入 /opt/homebrew/var/www，访问 http://localhost/info.php 验证。
三、使用 Docker 快速部署 LEMP 环境
该方式完全隔离系统环境，避免版本冲突，适合多项目并行开发，且可复用标准镜像配置。
1、安装 Docker Desktop for Mac 并启动应用。
2、创建项目目录，进入后新建 docker-compose.yml 文件，写入 Nginx、PHP-FPM、MySQL 服务定义，其中 PHP 服务基于 php:8.3-fpm 镜像。
3、为 PHP 服务挂载本地代码目录至容器内 /var/www/html，并映射端口如 9000:9000。
4、为 Nginx 服务配置 fastcgi_pass php:9000 指向 PHP 容器服务名。
5、在项目根目录执行 docker-compose up -d 启动全部容器。
6、确认容器运行状态：docker-compose ps，访问 http://localhost 查看 PHP 输出。
四、使用 MAMP Pro 或 XAMPP 图形化工具
面向不熟悉命令行的用户，提供可视化界面管理 PHP 版本、Apache/Nginx 切换、数据库及扩展开关，开箱即用。
1、前往官网下载 MAMP Pro（付费）或 XAMPP（免费）macOS 版安装包。
2、运行安装程序，接受许可协议并选择安装路径（建议默认）。
3、首次启动后，在主界面点击 Preferences → PHP，从下拉菜单中选择所需 PHP 版本（如 8.1、8.2）。
4、切换至 Servers 标签页，勾选 Apache Server 和/或 Nginx Server，点击 Start Servers。
5、点击 Open start page，在浏览器中查看 PHPInfo 页面验证环境。
6、将项目文件复制到 /Applications/MAMP/htdocs/（MAMP）或 /Applications/XAMPP/htdocs/（XAMPP）目录下，通过 http://localhost/yourproject 访问。
