Node.js 无法直接连接 PHP，实际是通过子进程调用php命令或HTTP调用PHP服务；Mac上常见问题是PHP未安装或不在PATH中，推荐用Homebrew安装并显式配置路径。
Node.js 本身不能直接“连” PHP，所谓“Node.js 连 PHP”，实际是两种常见场景：一是 Node.js 启动子进程调用 php 命令执行脚本（比如跑一个本地 PHP CLI 工具）；二是前后端分离下，Node.js 服务（如 Express）反向代理或 HTTP 调用本地 PHP-FPM 或内置服务器。在 Mac 上出问题，90% 是因为系统没装 php 命令，或装了但不在 $PATH 里，而 Homebrew 是最可控的补环境方式。
确认 Node.js 是否真在找 php 命令
先别急着装，看错误是不是真来自缺失 PHP。典型表现是 Node.js 报错类似：
spawn php ENOENT
或日志里出现 Command failed: php -v。这说明你的代码用了 child_process.spawn()、exec() 或类似封装（如 php-exec 包），且没做 fallback 或路径硬编码。检查代码中是否写了类似：
exec('php /path/to/script.php', ...)
如果只是想让前端请求 PHP 接口，那 Node.js 根本不需要本地有 php —— 只要 PHP 服务在运行并可被访问即可。
立即学习“PHP免费学习笔记（深入）”；
用 Homebrew 装 PHP 并确保可用
Mac 自带的 PHP 早已废弃（macOS 12+ 已移除），Homebrew 是当前最稳妥的选择：
- 运行
brew install php（默认装最新稳定版，如 PHP 8.3） - 装完后，
php -v应能正常输出版本；若提示 command not found，检查brew --prefix输出路径下的bin/是否在$PATH中（通常~/.homebrew/bin或/opt/homebrew/bin） - 必要时手动加到 shell 配置里：
echo 'export PATH="/opt/homebrew/bin:$PATH"' >> ~/.zshrc && source ~/.zshrc - 注意：不要用
brew install php@8.1这类带版本号的公式再额外装——除非你明确需要多版本共存并用brew link --force php@8.1切换，否则反而容易冲突
Node.js 调用 PHP 时的路径与权限坑
即使 php -v 在终端好使，Node.js 子进程仍可能找不到它，原因通常是：
- Node.js 进程继承的是启动它的 shell 环境变量，如果你用 VS Code 图形界面点开终端，或双击 App 启动 Node 服务，
$PATH可能不含 Homebrew 的bin目录 - 解决办法：启动 Node.js 前显式传入 PATH，例如：
PATH="/opt/homebrew/bin:$PATH" node server.js - PHP 脚本里用了相对路径（如
require '../vendor/autoload.php'），而 Node.js 子进程的工作目录不是你预期的——务必用{ cwd: '/full/path/to/php/dir' }显式指定cwd选项 - Mac 默认启用 SIP，禁止修改
/usr/bin下文件；所以别试图把 brew 装的 php 软链过去，也别用sudo ln -sf硬搞，纯属白费劲
真正麻烦的不是装 PHP，而是 Node.js 进程能不能在所有启动方式下都一致地找到它——图形界面、IDE 内置终端、launchd、pm2，它们的环境变量来源各不相同。最省事的长期方案，是在 Node.js 代码里用 which php 检查，或直接写死 Homebrew 的绝对路径（如 /opt/homebrew/bin/php），而不是依赖 $PATH 查找。
