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

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

理解錯(cuò)誤

運(yùn)行以下命令：

php -v

如果收到類似這樣的錯(cuò)誤消息：

<code>php not found</code>

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

讓我們來(lái)解決這個(gè)問題！

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

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

/Applications/XAMPP/xamppfiles/bin/php

要驗(yàn)證 PHP 可執(zhí)行文件是否存在于此位置，請(qǐng)運(yùn)行：

ls /Applications/XAMPP/xamppfiles/bin/php

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

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

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

Zsh 用戶（macOS 默認(rèn) shell）

從 macOS Catalina 開始，zsh 是默認(rèn) shell。請(qǐng)按照以下步驟更新您的 $PATH：

1. 打開您的 .zshrc 文件：

nano ~/.zshrc

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

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

3. 按 Ctrl O，然后按 Enter，最后按 Ctrl X 保存并關(guān)閉文件。

4. 通過(guò)運(yùn)行以下命令立即應(yīng)用更改：

source ~/.zshrc

Bash 用戶

如果您仍在使用 bash 作為您的 shell，請(qǐng)編輯 .bash_profile：

nano ~/.bash_profile

添加相同的行：

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

使用以下命令保存并應(yīng)用更改：

source ~/.bash_profile

步驟 3：驗(yàn)證 PHP 安裝

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

php -v

您應(yīng)該會(huì)看到 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)在識(shí)別 php 命令。

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

如果上述步驟沒有立即生效，請(qǐng)重啟終端并再次嘗試運(yùn)行 php -v。有時(shí)，對(duì) shell 配置文件的更改需要重啟終端才能生效。

替代方案：使用 Homebrew 安裝 PHP

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

1. 如果您尚未安裝 Homebrew，請(qǐng)安裝：

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

2. 安裝 PHP：

brew install php

3. 驗(yàn)證安裝：

php -v

這將安裝最新版本的 PHP 并自動(dòng)配置您的 $PATH。

結(jié)論

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

請(qǐng)?jiān)谠u(píng)論中告訴我們本指南是否對(duì)您有所幫助，或分享您在 macOS 上管理 PHP 的技巧！

以上是安裝 XAMPP 后如何修復(fù) macOS 上的'未找到 PHP”錯(cuò)誤的詳細(xì)內(nèi)容。更多信息請(qǐng)關(guān)注PHP中文網(wǎng)其他相關(guān)文章！