刚安装完 PHPStudy 和 Composer,兴冲冲地在 CMD 中输入php -v或composer -v,结果却收到一盆冷水——“不是内部或外部命令”。别担心,这通常不是你的操作失误,而是系统环境变量中没有包含这些程序的关键路径。手动将所需目录添加到系统环境变量中,命令行才能正确识别它们。
确认 PHP 是否已安装并正确配置 Path
打开 CMD 直接输入php -v。如果提示“不是内部或外部命令”,说明 PHP 的路径尚未写入系统环境变量。请先定位 PHPStudy 中当前启用的 PHP 版本所在目录,例如 D:\phpstudy_pro\Extensions\php\php8.0.2nts(具体路径以你的实际安装位置为准)。
右键点击“此电脑”→属性→高级系统设置→环境变量→在“系统变量”中找到并双击Path→点击“新建”→粘贴刚才复制的 PHP 完整路径→点击确定保存所有更改。
务必重启 CMD 窗口:旧终端会缓存启动时的 PATH 变量,不关闭重开,新路径无法生效。重新打开 CMD,再执行php -v,若显示 PHP 版本号即表示配置成功。
验证并解决 Composer 命令不可用的问题
方法一:检查 Composer 是否被系统正确识别
在 CMD 中运行composer -V(注意是大写 V)。如果报错,先别急着重装——90% 的情况是由于 PATH 中遗漏了 Composer 的 bin 目录。
方法二:手动添加 Composer 全局 bin 路径
Composer 安装完成后,其可执行文件实际存储在%APPDATA%\Composer\vendor\bin目录下。这个路径必须显式添加到系统 PATH 中。进入环境变量设置→在“用户变量”的Path中新增一行:%APPDATA%\Composer\vendor\bin→保存并退出。
方法三:解决 Composer-Setup.exe 未自动写入 PATH 的典型失败场景
运行echo %PATH%,搜索ComposerSetup\bin。如果未找到,说明官方安装器在 UAC 受限或 PowerShell 策略严格的环境中跳过了 PATH 写入。此时需要手动添加系统级 PATH:C:\ProgramData\ComposerSetup\bin。这是 Composer 主程序composer.bat的实际存放位置,缺少该路径会导致任何全局命令都无法调用。
强制刷新并交叉验证两个核心命令
第一步:关闭所有已打开的 CMD、PowerShell、IDE 终端窗口。
第二步:全新启动 CMD,依次执行以下三行命令:
php -vcomposer -Vcomposer config --list --global
第三步:观察输出。前三行都应该正常返回版本信息或配置列表;如果其中任何一个命令仍然报错,说明对应的路径未生效或存在拼写错误,需仔细检查路径中的盘符、斜杠方向、空格及中文字符。
第四步:执行composer global require topthink/think-cli,完成后直接输入think -V。如果能输出 ThinkPHP CLI 版本,恭喜——整个链路(PHP→Composer→ThinkCLI)已全部打通。

