php -v 报错说明php未进path,需先将php.exe所在目录(如c:\xampp\php)加入系统path并重启终端;再手动添加c:\programdata\composersetup\bin到系统path,并将%appdata%\composer\vendor\bin加入用户path,最后配置阿里云镜像源。

php -v 都报错,别急着装 Composer
Composer 不是独立程序,它必须调用 php.exe 才能运行。如果命令行里输 php -v 报“不是内部或外部命令”,说明 PHP 根本没进系统 PATH —— 此时装 Composer 一定失败,且错误提示会误导你去查 Composer 本身。
常见路径有:C:\php、C:\xampp\php、C:\wamp64\bin\php\php8.2.12。找到你的 php.exe 所在目录(不含文件名),加到「系统变量 → Path」里。
- 加完必须关掉所有已打开的 CMD/PowerShell/VS Code 终端,再新开一个窗口验证
- 运行
php --ini看Loaded Configuration File路径,确认你改的是这个php.ini - 确保这三行已取消注释:
extension=openssl、extension=curl、extension=mbstring - 用
php -m | findstr openssl检查扩展是否真加载成功
composer 命令不识别?PATH 没写对或没生效
官方 Composer-Setup.exe 勾选了 “Add to PATH” 并不等于真的写进去了。UAC 权限受限、杀毒软件拦截、用户账户控制跳过确认,都可能导致静默失败。
最可靠的做法是手动加:
- Composer 默认安装路径是:
C:\ProgramData\ComposerSetup\bin(注意C:\ProgramData是隐藏文件夹) - 右键“此电脑”→“属性”→“高级系统设置”→“环境变量”,在「系统变量」的
Path里新增这一行 - 别加错成
php.exe目录——那是 PHP 的路径,不是 Composer 的 - 验证前务必新开终端,旧进程不会读新 PATH
laravel、phpunit 这些命令还是找不到?global bin 路径没加
composer global require laravel/installer 安装的可执行文件(如 laravel.bat)默认放在:%APPDATA%\Composer\vendor\bin。这个路径和 Composer 自身的 composer.bat 路径是两回事,系统默认不认。
- 运行
composer global config bin-dir --absolute查出真实路径(比如C:\Users\Alice\AppData\Roaming\Composer\vendor\bin) - 把这个路径加到「用户变量 → Path」里(别加到系统变量,避免权限冲突)
- 加完同样要新开终端,再运行
echo %PATH%确认该路径已出现在输出中 - 如果
laravel.bat文件不存在,说明global require没真正成功,或包没声明"bin"字段
composer create-project 卡在 Loading composer repositories…?镜像没切对
这不是网络断了,是默认源 https://packagist.org 在 Windows 下 DNS 解析 + TLS 握手慢,尤其遇上企业防火墙或本地 DNS 污染。卡住时看到的进度条根本不是下载,而是元数据索引拉取。
- 推荐用阿里云镜像:
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 腾讯云镜像也稳定:
composer config -g repo.packagist composer https://mirrors.cloud.tencent.com/composer/ - 注意:项目级
composer.json里的repositories字段优先级高于全局配置,得手动删或改 - 换源后首次运行仍可能慢(要建本地缓存),但后续操作就快了
最容易被忽略的点:PATH 加了两次却只加对了一半 —— PHP 路径、Composer 主路径、global vendor bin 路径,这三个是独立的,缺一不可;镜像设了但项目里又硬编码了私有源,全局配置就失效了。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











