安裝 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中文網其他相關文章！