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

macOS 开发者在使用 XAMPP 搭建本地开发环境时，经常会遇到令人头疼的“PHP 未找到”错误。即使 XAMPP 自带 PHP，终端仍可能无法识别 php 命令。本文将提供逐步解决方案，确保系统正确识别 PHP。

错误原因解析

执行 php -v 命令时，如果出现 php not found 错误，则表示系统 shell (zsh 或 bash) 无法在其环境变量 $PATH 中找到 PHP 可执行文件。即使 XAMPP 包含 PHP 二进制文件，但其目录未包含在 $PATH 中。

解决方案

立即学习“PHP免费学习笔记（深入）”；

步骤一：定位 XAMPP 中的 PHP

XAMPP 的 PHP 通常位于：/applications/xampp/xamppfiles/bin/php

验证 PHP 可执行文件是否存在：

ls /applications/xampp/xamppfiles/bin/php

如果命令列出 PHP 文件，则继续下一步。

步骤二：将 XAMPP 的 PHP 添加到 $PATH

为了全局访问 PHP，需要将 XAMPP 的 PHP 目录添加到 $PATH 环境变量。

zsh 用户 (macOS Catalina 默认 shell):

1. 打开 .zshrc 文件：

nano ~/.zshrc

2. 在文件末尾添加：

export PATH="/applications/xampp/xamppfiles/bin:$PATH"

3. 按 Ctrl + O、Enter、Ctrl + X 保存并关闭文件。

4. 立即应用更改：

source ~/.zshrc

bash 用户:

如果使用 bash，编辑 .bash_profile 文件：

nano ~/.bash_profile

添加相同一行：

export PATH="/applications/xampp/xamppfiles/bin:$PATH"

保存并应用更改：

source ~/.bash_profile

步骤三：验证 PHP 安装

更新 $PATH 后，再次测试 php -v 命令：

php -v

您应该看到 XAMPP 附带的 PHP 版本信息，例如：

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

如果成功，则系统已正确识别 PHP 命令。

步骤四：重启终端 (可选)

如果上述步骤无效，重启终端并再次尝试 php -v 命令。有时，shell 配置文件的更改需要重启终端才能生效。

替代方案：使用 Homebrew 安装 PHP

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

1. 安装 Homebrew (如果未安装):

/bin/bash -c "$(curl -fssl https://raw.githubusercontent.com/homebrew/install/head/install.sh)"

2. 安装 PHP:

brew install php

3. 验证安装:

php -v

Homebrew 会安装最新版 PHP 并自动配置 $PATH。

总结

理解 shell 的 $PATH 环境变量，可以快速解决“PHP 未找到”错误。无论是将 XAMPP 的 PHP 添加到 $PATH，还是选择 Homebrew 安装，本指南都能帮助您快速上手。现在，您可以专注于应用程序开发了！

欢迎在评论区分享您的经验和技巧！

以上就是安装 XAMPP 后如何修复 macOS 上的“未找到 PHP”错误的详细内容，更多请关注php中文网其它相关文章！