PHPCLI报错Commandnotfound解决方法

当在命令行中运行PHP脚本却遭遇“Command not found”错误时，问题通常源于PHP CLI未安装或其可执行路径未正确添加到系统环境变量中；本文手把手教你快速诊断并解决这一常见难题——从验证PHP是否已安装、按系统选择合适方式安装CLI版本，到精准配置PATH环境变量、验证功能可用性，再到Windows下可选的文件关联修复，覆盖全平台实操要点，助你5分钟内打通PHP命令行开发环境。

如果您尝试在命令行中运行 PHP 脚本，但系统提示“Command not found”，则可能是由于 PHP CLI 环境未正确配置或未将 PHP 可执行文件路径添加到系统环境变量中。以下是解决此问题的步骤：

一、确认 PHP CLI 是否已安装

在终端中输入以下命令，用于检测系统是否已安装 PHP 命令行解释器：

1、打开终端（Linux/macOS）或命令提示符/PowerShell（Windows）。

2、输入 php -v 并回车。

3、如果返回 PHP 版本信息，则说明已安装；若提示“command not found”或“不是内部或外部命令”，则需进行安装或路径配置。

二、安装 PHP CLI（适用于未安装情况）

若系统未安装 PHP CLI，需根据操作系统选择对应方式完成安装：

1、在 Ubuntu/Debian 系统中，运行 sudo apt update && sudo apt install php-cli php。

2、在 CentOS/RHEL 系统中，运行 sudo yum install php 或 sudo dnf install php（视版本而定）。

3、在 Windows 系统中，需手动下载 PHP 发行包并解压至指定目录，例如 C:\php，确保其中包含 php.exe 文件。

三、将 PHP 添加至系统环境变量

若 PHP 已安装但无法全局调用，通常是因为其路径未加入环境变量 PATH 中：

1、查找 php.exe 所在路径（Windows）或 php 二进制文件位置（Linux/macOS），可通过 where php（Windows）或 which php（Linux/macOS）定位。

2、在 Windows 上，右键“此电脑” → 属性 → 高级系统设置 → 环境变量 → 编辑“Path” → 新增 PHP 安装目录路径（如 C:\php）。

3、在 Linux/macOS 上，编辑 shell 配置文件（如 ~/.bashrc 或 ~/.zshrc），添加 export PATH="$PATH:/your/php/path"，然后执行 source ~/.bashrc 使其生效。

四、验证 PHP CLI 功能

完成配置后，应重新启动终端并测试 PHP 是否可正常调用：

1、输入 php -m 查看已加载的扩展模块列表。

2、创建一个测试脚本 test.php，内容为 。

3、运行 php test.php，若输出 Hello CLI，则表示配置成功。

五、检查默认解释器关联（Windows 特有）

某些 Windows 系统可能未将 .php 文件与 php.exe 关联，导致双击运行失败，但不影响 CLI 使用。如需修复文件关联：

1、以管理员身份打开命令提示符。

2、执行 assoc .php=PhpScript。

3、执行 ftype PhpScript="C:\php\php.exe" "%1" %*（请根据实际路径修改）。

今天关于《PHPCLI报错Commandnotfound解决方法》的内容介绍就到此结束，如果有什么疑问或者建议，可以在golang学习网公众号下多多回复交流；文中若有不正之处，也希望回复留言以告知！