“composer不是内部命令”说明composer未被系统识别,需先配置php环境(php -v验证并添加php.exe路径到path),再用composer-setup.exe安装并确保c:\programdata\composersetup\bin加入系统path,最后重启终端运行composer --version验证。

“composer不是内部命令”说明系统根本没识别到 Composer,得先让 Windows 认出它,再装 Laravel。这不是 Laravel 的问题,而是环境没搭好。
第一步:确认 PHP 已装好且能运行
Composer 是 PHP 工具,没 PHP 就完全动不了。打开 CMD 或 PowerShell,执行:
php -v
如果报错“不是内部或外部命令”,说明 PHP 没加进系统 PATH。你需要:
- 找到 php.exe 所在目录(例如 C:\php、D:\xampp\php 或 D:\phpstudy_pro\Extensions\php\php8.2.12nts)
- 右键“此电脑”→“属性”→“高级系统设置”→“环境变量”→在“系统变量”的 Path 中新建一行,粘贴该路径
- 保存后,**必须关闭所有已打开的终端,重新打开一个 CMD 再试 php -v**
第二步:安装 Composer 并确保 PATH 生效
用官网 Composer-Setup.exe 安装最稳妥,但注意两个关键点:
- 安装时手动点击“Browse”重新指定 php.exe 路径(哪怕它自动填了,也再选一次,避开空格/中文路径)
- 勾选 “Add to PATH”,安装完立刻去环境变量里确认:
在“系统变量”的 Path 中搜索 ComposerSetup,应看到 C:\ProgramData\ComposerSetup\bin
若没有,手动添加这一项(C:\ProgramData是隐藏文件夹,地址栏直接粘贴路径可进入)
改完 PATH 后,同样要关掉所有终端,新开一个,再运行 composer --version 验证。
第三步:装 Laravel 的两种方式(选一种就行)
✅ 推荐方式:全局安装 laravel/installer
运行:
composer global require laravel/installer
成功后,laravel 命令仍可能报错——因为它的实际位置在:
%APPDATA%\Composer\vendor\bin(例如 C:\Users\Alice\AppData\Roaming\Composer\vendor\bin)
这个路径默认不在 PATH 里,需手动加到用户变量的 Path 中(不是系统变量),加完重启终端。
然后就能直接用:
laravel new myapp
⚠️ 替代方式:不装 installer,直接 create-project
运行(加国内镜像防卡死):
composer create-project --prefer-dist --repository=https://mirrors.cloud.tencent.com/composer/ laravel/laravel myapp
顺手检查几处高频雷区
如果装完还是失败,别急着重装,快速过一遍:
-
PHP 版本:Laravel 11 要求 PHP ≥ 8.2,运行
php -v确认 -
必需扩展:运行
php -m | findstr /i "mbstring openssl xml curl",缺哪个就去 php.ini 里取消对应extension=行的注释 -
镜像源:国内建议统一设为腾讯云源:
composer config -g repo.packagist composer https://mirrors.cloud.tencent.com/composer/











