如何解决macOS PHP CLI命令不可用的解决办法？

首先确认PHP是否安装，若未安装或路径未配置，可通过Homebrew安装php@8.3并将其bin目录添加至PATH，随后创建符号链接并验证版本，确保终端可识别php命令。

如果您在终端中输入 php 命令时提示“command not found”或无法执行 PHP 脚本，可能是由于 PHP 未正确安装或系统路径未配置。以下是解决此问题的步骤：

一、确认PHP是否已安装

该步骤用于检查当前系统中是否存在 PHP 可执行文件，避免重复安装或误操作。

1、打开终端，输入以下命令并回车：
php -v

2、如果显示 PHP 版本信息，则说明 PHP 已安装但可能未加入环境变量；
若提示“command not found”，则需进行后续安装或路径配置。

二、通过Homebrew安装或重装PHP

Homebrew 是 macOS 上常用的包管理工具，可通过它安装最新版本的 PHP。

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

1、确保已安装 Homebrew，若未安装，请在终端运行以下命令：
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

2、使用 Homebrew 安装 PHP（以 PHP 8.3 为例）：
brew install php@8.3

3、安装完成后，再次运行 php -v 验证是否可用。

三、将PHP可执行路径添加到环境变量

即使已安装 PHP，若其路径未加入 shell 环境变量 PATH，则 CLI 仍无法识别 php 命令。

1、查找 PHP 实际安装路径，运行：
brew --prefix php@8.3

可赞AI

文字一秒可视化，免费AI办公神器

56

查看详情

2、获取输出结果后，将其 bin 目录添加至 PATH。编辑 shell 配置文件：
- 若使用 zsh（默认），运行：
nano ~/.zshrc

3、在文件末尾添加如下行（假设 PHP 安装路径为 /opt/homebrew/opt/php@8.3）：
export PATH="/opt/homebrew/opt/php@8.3/bin:$PATH"

4、保存并退出编辑器（Ctrl+O 回车，Ctrl+X），然后重新加载配置：
source ~/.zshrc

四、创建符号链接使PHP全局可用

Homebrew 安装的某些 PHP 版本不会自动创建全局 php 命令，需手动建立符号链接。

1、运行以下命令创建软链接：
brew link php@8.3

2、若提示“Could not symlink”权限错误，请根据提示修复目录权限或使用 sudo（谨慎操作）。

3、完成链接后，再次执行 php -v 检查命令是否生效。

五、检查并切换默认PHP版本

当系统中存在多个 PHP 版本时，需确保默认调用的是期望版本。

1、列出所有已安装的 PHP 版本路径：
ls /opt/homebrew/bin/php*

2、查看当前使用的 PHP 来源：
which php

3、如需切换，默认可通过修改 ~/.zshrc 中的 PATH 顺序，或将目标版本路径前置。
例如优先使用 PHP 8.3：
export PATH="/opt/homebrew/opt/php@8.3/bin:$PATH"

以上就是如何解决macOS PHP CLI命令不可用的解决办法？的详细内容，更多请关注php中文网其它相关文章！