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

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

理解錯(cuò)誤

執(zhí)行以下指令：

php -v

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

<code>php not found</code>

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

讓我們來解決這個(gè)問題吧！

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

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

/Applications/XAMPP/xamppfiles/bin/php

要驗(yàn)證 PHP 執(zhí)行檔是否存在於此位置，請(qǐng)執(zhí)行：

ls /Applications/XAMPP/xamppfiles/bin/php

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

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

要讓 PHP 執(zhí)行檔全域可用，您需要將 XAMPP PHP 目錄新增至 shell 的 $PATH。

Zsh 使用者（macOS 預(yù)設(shè) shell）

從 macOS Catalina 開始，zsh 是預(yù)設(shè) shell。請(qǐng)依照以下步驟更新您的 $PATH：

1. 開啟您的 .zshrc 檔案：

nano ~/.zshrc

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

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

3. 按 Ctrl O，然後按 Enter，最後按 Ctrl X 儲(chǔ)存並關(guān)閉檔案。

4. 透過執(zhí)行以下命令立即套用變更：

source ~/.zshrc

Bash 用戶

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

nano ~/.bash_profile

新增相同的行：

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

使用以下指令儲(chǔ)存並套用變更：

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：重啟終端（選購(gòu)）

如果上述步驟沒有立即生效，請(qǐng)重新啟動(dòng)終端並再次嘗試執(zhí)行 php -v。有時(shí)，對(duì) shell 設(shè)定檔的變更需要重新啟動(dòng)終端才能生效。

替代方案：使用 Homebrew 安裝 PHP

如果您更傾向於系統(tǒng)範(fàn)圍的 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)設(shè)定您的 $PATH。

結(jié)論

一旦您了解 shell 的 $PATH 如何運(yùn)作，「PHP not found」錯(cuò)誤就可以快速修復(fù)。無論您是將 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)文章！