首先安装PHP并配置解释器路径,再在PhpStorm中设置对应PHP可执行文件;通过Homebrew安装PHP后,将路径添加到.zshrc,并在PhpStorm的Preferences→PHP中指定本地解释器(M1/M2为/opt/homebrew/bin/php,Intel为/usr/local/bin/php),最后验证运行test.php输出版本信息即可完成配置。

在Mac系统上配置PHP环境并让PhpStorm正常工作,关键在于正确安装PHP、配置解释器路径,并确保终端与IDE能协同运行。以下是专为macOS用户整理的实用步骤。
安装PHP(通过Homebrew)
macOS默认不带最新版PHP,推荐使用Homebrew管理安装。
步骤:- 打开终端,安装Homebrew(如未安装):
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" - 使用Homebrew安装PHP(以PHP 8.1为例):
brew install php@8.1 - 若需其他版本,替换版本号即可,如php@8.2
- 安装完成后,让系统识别PHP命令:
echo 'export PATH="/opt/homebrew/opt/php@8.1/bin:$PATH"' >> ~/.zshrc
(Apple Silicon芯片M1/M2使用/opt/homebrew;Intel Mac使用/usr/local) - 刷新配置:
source ~/.zshrc - 验证安装:
php -v应显示PHP版本信息
在PhpStorm中配置PHP解释器
PhpStorm需要知道PHP可执行文件的位置才能运行和调试代码。
操作步骤:- 打开PhpStorm,进入 Preferences(快捷键 ⌘ + ,)
- 导航至 PHP 标签页
- 点击右侧“...”按钮添加解释器
- 选择 “From Docker, Vagrant, VM, Remote…” 下的 Local
- 在路径框中填入PHP可执行文件路径:
M1/M2 Mac:/opt/homebrew/bin/php
Intel Mac:/usr/local/bin/php - 确认后PhpStorm会解析版本并启用相关功能(语法检查、智能提示等)
配置CLI工具与调试支持(可选但推荐)
提升开发效率,建议启用命令行工具和Xdebug。
立即学习“PHP免费学习笔记(深入)”;
建议操作:- 确保php.ini已加载Xdebug扩展
查看位置:php --ini
编辑对应的php.ini文件,加入(Homebrew安装通常自动配置):zend_extension=xdebug.so - 在PhpStorm中设置Xdebug端口(默认9003):
Preferences → PHP → Debug → Xdebug → Port: 9003 - 开启监听:点击PhpStorm顶部工具栏电话图标(Start Listening),准备接收调试请求
测试配置是否成功
创建一个简单脚本验证整个流程。
方法:- 在项目中新建 test.php,内容:
- 右键文件,选择 “Run ‘test.php’”
- 若控制台输出PHP版本信息,说明配置成功
基本上就这些。只要Homebrew安装顺利,PhpStorm路径指向正确,Mac上的PHP开发环境就能快速跑起来。遇到路径问题时,多用which php和php -v排查,基本都能解决。











