安装 XAMPP 后如何修复 macOS 上的'未找到 PHP”错误

macOS 开发者使用 XAMPP 搭建本地开发环境时，常常会遇到令人沮丧的“PHP not found”错误。尽管 XAMPP 自带 PHP，但终端可能仍然无法识别 php 命令。

本文将逐步指导您解决此问题，确保系统能够找到 PHP。

理解错误

运行以下命令：

<code class="language-bash">php -v</code>

如果收到类似这样的错误消息：

<code>php not found</code>

这意味着您的系统 shell（如 zsh 或 bash）无法在其环境中找到 PHP 可执行文件。即使 XAMPP 包含其自身的 PHP 二进制文件，也会发生这种情况，因为包含 PHP 的目录未包含在 shell 的 $PATH 中。

让我们来解决这个问题！

步骤 1：找到 XAMPP 安装中的 PHP

XAMPP 包含其自身的 PHP 安装，通常位于以下目录：

<code class="language-bash">/Applications/XAMPP/xamppfiles/bin/php</code>

要验证 PHP 可执行文件是否存在于此位置，请运行：

<code class="language-bash">ls /Applications/XAMPP/xamppfiles/bin/php</code>

如果此命令列出了 PHP 文件，则您走在正确的轨道上。

步骤 2：将 XAMPP 的 PHP 添加到 shell 的 PATH

要使 PHP 可执行文件全局可用，您需要将 XAMPP PHP 目录添加到 shell 的 $PATH。

Zsh 用户（macOS 默认 shell）

从 macOS Catalina 开始，zsh 是默认 shell。请按照以下步骤更新您的 $PATH：

1. 打开您的 .zshrc 文件：

<code class="language-bash">nano ~/.zshrc</code>

2. 在文件的末尾添加以下行：

<code class="language-bash">export PATH="/Applications/XAMPP/xamppfiles/bin:$PATH"</code>

3. 按 Ctrl O，然后按 Enter，最后按 Ctrl X 保存并关闭文件。

4. 通过运行以下命令立即应用更改：

<code class="language-bash">source ~/.zshrc</code>

Bash 用户

如果您仍在使用 bash 作为您的 shell，请编辑 .bash_profile：

<code class="language-bash">nano ~/.bash_profile</code>

添加相同的行：

<code class="language-bash">export PATH="/Applications/XAMPP/xamppfiles/bin:$PATH"</code>

使用以下命令保存并应用更改：

<code class="language-bash">source ~/.bash_profile</code>

步骤 3：验证 PHP 安装

更新 $PATH 后，测试 php 命令是否有效：

<code class="language-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 命令。

步骤 4：重启终端（可选）

如果上述步骤没有立即生效，请重启终端并再次尝试运行 php -v。有时，对 shell 配置文件的更改需要重启终端才能生效。

替代方案：使用 Homebrew 安装 PHP

如果您更倾向于系统范围的 PHP 安装，而不是依赖 XAMPP 的捆绑版本，您可以使用 Homebrew 安装 PHP：

1. 如果您尚未安装 Homebrew，请安装：

<code class="language-bash">/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"</code>

2. 安装 PHP：

<code class="language-bash">brew install php</code>

3. 验证安装：

<code class="language-bash">php -v</code>

这将安装最新版本的 PHP 并自动配置您的 $PATH。

结论

一旦您理解了 shell 的 $PATH 如何工作，“PHP not found”错误就可以快速修复。无论您是将 XAMPP 的 PHP 添加到您的 PATH，还是选择 Homebrew，本指南都能确保您能够立即运行。现在，您可以专注于最重要的事情——开发出色的应用程序！

请在评论中告诉我们本指南是否对您有所帮助，或分享您在 macOS 上管理 PHP 的技巧！

以上是安装 XAMPP 后如何修复 macOS 上的'未找到 PHP”错误的详细内容。更多信息请关注PHP中文网其他相关文章！