macOS 開發(fā)者使用 XAMPP 搭建本地開發(fā)環(huán)境時，常常會遇到令人沮喪的“PHP not found”錯誤。盡管 XAMPP 自帶 PHP，但終端可能仍然無法識別 php 命令。

本文將逐步指導您解決此問題，確保系統(tǒng)能夠找到 PHP。

理解錯誤

運行以下命令：

php -v

如果收到類似這樣的錯誤消息：

<code>php not found</code>

這意味著您的系統(tǒng) shell（如 zsh 或 bash）無法在其環(huán)境中找到 PHP 可執(zhí)行文件。即使 XAMPP 包含其自身的 PHP 二進制文件，也會發(fā)生這種情況，因為包含 PHP 的目錄未包含在 shell 的 $PATH 中。

讓我們來解決這個問題！

步驟 1：找到 XAMPP 安裝中的 PHP

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

/Applications/XAMPP/xamppfiles/bin/php

要驗證 PHP 可執(zhí)行文件是否存在于此位置，請運行：

ls /Applications/XAMPP/xamppfiles/bin/php

如果此命令列出了 PHP 文件，則您走在正確的軌道上。

步驟 2：將 XAMPP 的 PHP 添加到 shell 的 PATH

要使 PHP 可執(zhí)行文件全局可用，您需要將 XAMPP PHP 目錄添加到 shell 的 $PATH。

Zsh 用戶（macOS 默認 shell）

從 macOS Catalina 開始，zsh 是默認 shell。請按照以下步驟更新您的 $PATH：

1. 打開您的 .zshrc 文件：

nano ~/.zshrc

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

export PATH="/Applications/XAMPP/xamppfiles/bin:$PATH"

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

4. 通過運行以下命令立即應用更改：

source ~/.zshrc

Bash 用戶

如果您仍在使用 bash 作為您的 shell，請編輯 .bash_profile：

nano ~/.bash_profile

添加相同的行：

export PATH="/Applications/XAMPP/xamppfiles/bin:$PATH"

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

source ~/.bash_profile

步驟 3：驗證 PHP 安裝

更新 $PATH 后，測試 php 命令是否有效：

php -v

您應該會看到 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>

如果有效，恭喜！您的系統(tǒng)現(xiàn)在識別 php 命令。

步驟 4：重啟終端（可選）

如果上述步驟沒有立即生效，請重啟終端并再次嘗試運行 php -v。有時，對 shell 配置文件的更改需要重啟終端才能生效。

替代方案：使用 Homebrew 安裝 PHP

如果您更傾向于系統(tǒng)范圍的 PHP 安裝，而不是依賴 XAMPP 的捆綁版本，您可以使用 Homebrew 安裝 PHP：

1. 如果您尚未安裝 Homebrew，請安裝：

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

2. 安裝 PHP：

brew install php

3. 驗證安裝：

php -v

這將安裝最新版本的 PHP 并自動配置您的 $PATH。

結論

一旦您理解了 shell 的 $PATH 如何工作，“PHP not found”錯誤就可以快速修復。無論您是將 XAMPP 的 PHP 添加到您的 PATH，還是選擇 Homebrew，本指南都能確保您能夠立即運行?，F(xiàn)在，您可以專注于最重要的事情——開發(fā)出色的應用程序！

請在評論中告訴我們本指南是否對您有所幫助，或分享您在 macOS 上管理 PHP 的技巧！

以上是安裝 XAMPP 后如何修復 macOS 上的'未找到 PHP”錯誤的詳細內容。更多信息請關注PHP中文網(wǎng)其他相關文章！