composer缺失时无法执行create-project命令,laravel项目骨架(artisan、routes/、app/等)根本不会生成;需先运行composer --version验证,若提示command not found则需按系统类型安装并配置path。

Composer缺失时无法执行composer create-project命令,Laravel项目骨架根本不会生成,artisan、routes/、app/等关键目录全部缺失,后续所有操作都失去前提。
先确认Composer是否真的缺失
打开终端,运行composer --version。如果提示command not found或bash: composer: command not found,说明Composer未安装或未加入系统PATH;如果输出版本号(如Composer version 2.7.7),则问题不在缺失,需排查其他环节。
注意:Windows用户若装过XAMPP/MAMP但没勾选“Add to PATH”,即使安装了Composer也可能报此错误——此时不是缺失,而是路径未生效。
Windows系统快速安装Composer
方法一:图形化安装器(推荐新手)
① 访问 https://www.php.cn/link/594ca739e3609243a6b6a3dd8d871114 下载 Composer-Setup.exe
② 双击运行,全程点“Next”,关键一步:勾选 【Add Composer to the system PATH】(否则安装完仍不可用)
③ 到PHP安装目录确认php.exe存在(如C:\xampp\php\php.exe),安装器会自动探测;若探测失败,手动输入该路径
④ 完成后重启终端,再运行composer --version验证
方法二:命令行一键安装(适合已有PHP CLI环境)
在终端中依次执行:
php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"<br>php -r "if (hash_file('sha384', 'composer-setup.php') === 'e0012edf3e80b6978849f5eff0d4b4e4c79ff1609dd1e613307e16318854d24ae64f26d17af3ef0bf7cfb710ca74755a' ) { echo 'Installer verified'; } else { echo 'Installer corrupt'; unlink('composer-setup.php'); } echo PHP_EOL;"<br>php composer-setup.php --install-dir=C:\bin --filename=composer.bat<br>php -r "unlink('composer-setup.php');"
最后把
C:\bin加进系统环境变量PATH
macOS系统安装Composer
如果你已用Homebrew管理PHP(推荐方式):
先确保Homebrew最新:brew update
然后执行:brew install composer
安装完成后运行which composer,输出应为/opt/homebrew/bin/composer(Apple Silicon)或/usr/local/bin/composer(Intel)。【若输出为空,说明brew安装未成功或shell未重载PATH】
如果未装Homebrew,或想跳过它:
下载安装脚本:curl -sS https://getcomposer.org/installer | php
移动到全局可执行位置:sudo mv php /usr/local/bin/composer
设置可执行权限:sudo chmod +x /usr/local/bin/composer
Linux(Ubuntu/Debian)安装Composer
方法一:APT源安装(最稳)
执行:sudo apt update && sudo apt install composer
验证:composer --version —— 此方式安装的版本可能略旧(如2.2.x),但兼容性极佳,适合生产环境。
方法二:手工安装(获取最新版)
运行:
php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"<br>php -r "if (hash_file('sha384', 'composer-setup.php') === 'e0012edf3e80b6978849f5eff0d4b4e4c79ff1609dd1e613307e16318854d24ae64f26d17af3ef0bf7cfb710ca74755a' ) { echo 'Installer verified'; } else { echo 'Installer corrupt'; unlink('composer-setup.php'); } echo PHP_EOL;"<br>sudo php composer-setup.php --install-dir=/usr/local/bin --filename=composer
这一步必须用
sudo,否则无法写入系统bin目录。
安装完Composer立刻验证Laravel环境
第一步:检查PHP版本与扩展
运行php -v,确认输出≥PHP 8.2;再运行php -m | grep -E 'mbstring|openssl|xml|ctype|json|curl|pdo|tokenizer',确保所有关键词均出现在结果中——【缺任一扩展,create-project必失败】
第二步:切国内镜像源(国内用户强制动作)
执行:composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
验证是否生效:composer config -g repo.packagist 应输出该阿里云地址
第三步:创建Laravel项目
执行:composer create-project laravel/laravel myapp "11.*" --prefer-dist
项目名myapp不能含空格、中文或特殊符号;"11.*"的引号不可省,否则shell会解析*导致报错











