Mac系统本身预装了PHP运行环境,同时也可以通过包管理工具安装指定版本的PHP,满足不同项目的运行需求。搭建完成后可以通过本地服务器或者直接运行脚本的方式执行PHP代码。

一、启用Mac系统自带的PHP环境
Mac系统默认已经安装了PHP,我们可以先验证系统自带的PHP版本,然后启用对应的运行服务。
1. 查看系统自带PHP版本
打开Mac的终端,执行以下命令查看当前系统预装的PHP版本:
# 查看PHP版本 php -v
如果终端输出了PHP的版本信息,说明系统已经存在PHP环境,可以直接使用。如果没有输出,可能需要先安装命令行工具,执行xcode-select --install命令安装后再尝试。
2. 使用php-fpm运行PHP
系统自带的PHP包含了php-fpm服务,我们可以通过以下步骤启动服务运行PHP文件:
- 先找到php-fpm的配置文件路径,通常系统自带的php-fpm配置文件在
/etc/php-fpm.conf,如果没有该文件可以复制默认配置:
# 复制默认配置文件 sudo cp /etc/php-fpm.conf.default /etc/php-fpm.conf # 复制进程配置文件 sudo cp /etc/php-fpm.d/www.conf.default /etc/php-fpm.d/www.conf
- 启动php-fpm服务:
# 启动php-fpm sudo php-fpm
启动成功后,我们可以创建一个测试PHP文件验证环境是否可用:
<?php // 测试PHP环境是否正常 echo "Hello PHP on Mac"; phpinfo(); ?>
将上面的代码保存为test.php,然后执行php test.php命令,如果终端输出了Hello PHP on Mac并且打印了PHP的配置信息,说明PHP已经可以正常运行。
二、使用Homebrew安装自定义版本PHP
如果系统自带的PHP版本不符合项目需求,我们可以使用Homebrew包管理工具安装指定版本的PHP,步骤如下:
1. 安装Homebrew
如果还没有安装Homebrew,先在终端执行以下命令安装:
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
2. 安装指定版本PHP
Homebrew的默认源包含多个PHP版本,我们可以根据需要安装对应的版本,比如安装PHP8.2:
# 更新Homebrew源 brew update # 安装PHP8.2 brew install php@8.2 # 将安装的PHP添加到系统环境变量 echo 'export PATH="/opt/homebrew/opt/php@8.2/bin:$PATH"' >> ~/.zshrc echo 'export PATH="/opt/homebrew/opt/php@8.2/sbin:$PATH"' >> ~/.zshrc # 刷新环境变量 source ~/.zshrc
安装完成后再次执行php -v命令,就可以看到当前使用的PHP版本已经切换为刚安装的8.2版本。
3. 配置Apache运行PHP
Mac系统自带了Apache服务器,我们可以配置Apache来支持PHP文件的解析:
- 打开Apache的配置文件
/etc/apache2/httpd.conf,找到以下行并去掉前面的注释符号#:
LoadModule php_module libexec/apache2/libphp.so
- 添加PHP文件的解析配置:
AddType application/x-httpd-php .php
- 启动Apache服务:
# 启动Apache sudo apachectl start # 重启Apache(修改配置后需要执行) sudo apachectl restart
然后将之前创建的test.php文件放到Apache的默认站点目录/Library/WebServer/Documents/下,在浏览器中访问http://localhost/test.php,如果页面正常显示PHP信息,说明Apache+PHP的环境已经搭建完成。
三、常见问题排查
在搭建过程中可能会遇到一些问题,以下是常见的排查方法:
- 如果执行
php -v提示命令不存在,检查环境变量是否配置正确,或者PHP是否安装成功。 - 如果php-fpm启动失败,检查配置文件是否有语法错误,执行
php-fpm -t命令可以检测配置文件的语法。 - 如果Apache访问PHP文件显示源码,说明Apache没有正确加载PHP模块,检查
httpd.conf中的PHP模块配置是否正确。
注意:修改系统配置文件时尽量先备份原文件,避免配置错误导致服务无法启动。如果需要同时运行多个PHP版本,可以通过Homebrew安装多个版本后切换环境变量来实现。
PHPMac_PHP环境搭建php-fpmHomebrewApache修改时间:2026-07-11 18:15:29