macOS 开发者在使用 XAMPP 搭建本地开发环境时，经常会遇到令人头疼的“PHP 未找到”错误。即使 XAMPP 自带 PHP，终端仍可能无法识别 php 命令。本文将提供逐步解决方案，确保系统正确识别 PHP。
错误原因解析
执行 php -v 命令时，如果出现 php not found 错误，则表示系统 shell (zsh 或 bash) 无法在其环境变量 $PATH 中找到 PHP 可执行文件。即使 XAMPP 包含 PHP 二进制文件，但其目录未包含在 $PATH 中。
解决方案
立即学习“PHP免费学习笔记（深入）”；
步骤一：定位 XAMPP 中的 PHP
XAMPP 的 PHP 通常位于：/applications/xampp/xamppfiles/bin/php
验证 PHP 可执行文件是否存在：
<code class="bash">ls /applications/xampp/xamppfiles/bin/php</code>
如果命令列出 PHP 文件，则继续下一步。
步骤二：将 XAMPP 的 PHP 添加到 $PATH
为了全局访问 PHP，需要将 XAMPP 的 PHP 目录添加到 $PATH 环境变量。
zsh 用户 (macOS Catalina 默认 shell):
- 打开
.zshrc文件：
<code class="bash">nano ~/.zshrc</code>
- 在文件末尾添加：
<code class="bash">export PATH="/applications/xampp/xamppfiles/bin:$PATH"</code>
-
按
Ctrl + O、Enter、Ctrl + X保存并关闭文件。 -
立即应用更改：
<code class="bash">source ~/.zshrc</code>
bash 用户:
如果使用 bash，编辑 .bash_profile 文件：
<code class="bash">nano ~/.bash_profile</code>
添加相同一行：
<code class="bash">export PATH="/applications/xampp/xamppfiles/bin:$PATH"</code>
保存并应用更改：
<code class="bash">source ~/.bash_profile</code>
步骤三：验证 PHP 安装
更新 $PATH 后，再次测试 php -v 命令：
<code class="bash">php -v</code>
您应该看到 XAMPP 附带的 PHP 版本信息，例如：
<code>PHP 8.2.4 (cli) (built: Apr 6 2023 04:12:41) (nts) Copyright (c) The PHP Group Zend Engine v4.2.4, Copyright (c) Zend Technologies</code>
如果成功，则系统已正确识别 PHP 命令。
步骤四：重启终端 (可选)
如果上述步骤无效，重启终端并再次尝试 php -v 命令。有时，shell 配置文件的更改需要重启终端才能生效。
替代方案：使用 Homebrew 安装 PHP
如果您更倾向于系统级 PHP 安装，而非依赖 XAMPP 的捆绑版本，可以使用 Homebrew：
- 安装 Homebrew (如果未安装):
<code class="bash">/bin/bash -c "$(curl -fssl https://raw.githubusercontent.com/homebrew/install/head/install.sh)"</code>
- 安装 PHP:
<code class="bash">brew install php</code>
- 验证安装:
<code class="bash">php -v</code>
Homebrew 会安装最新版 PHP 并自动配置 $PATH。
总结
理解 shell 的 $PATH 环境变量，可以快速解决“PHP 未找到”错误。无论是将 XAMPP 的 PHP 添加到 $PATH，还是选择 Homebrew 安装，本指南都能帮助您快速上手。现在，您可以专注于应用程序开发了！
欢迎在评论区分享您的经验和技巧！
