Laravel 10 安装需满足PHP≥8.1及mbstring、openssl等7个扩展,使用composer create-project laravel/laravel:^10.0 myapp --prefer-dist --no-interaction,并切换为packagist.phpcomposer.com国内镜像源。
Laravel 10 要用 Composer 安装,但直接很可能失败——PHP 版本、扩展、国内源这三关卡住的人最多。
PHP 版本和扩展不满足 Laravel 10 最低要求
Laravel 10 强制要求 PHP >= 8.1,且必须启用
、
、
、
、
、
、
这些扩展。缺一个,
就会报错
或直接中断。
先运行
确认版本 ≥ 8.1;低于就换 PHP(比如用
或 XAMPP/AMPPS 切换)
运行
检查扩展是否全在;缺的得改
,取消对应
行的注释
Windows 用户特别注意:WAMP/XAMPP 默认 PHP 可能是 8.0 或更低,别只看控制面板显示的“支持 PHP 8.x”,要进命令行实测
Composer 安装 Laravel 10 的正确命令和参数
不用默认命令,加
和指定稳定版标签,能避开 dev 分支不稳定、下载慢、解压失败等问题。
Composer 2.9.6
Composer 2.9.6 是 PHP 生态中高效、稳定的依赖管理工具。此版本在性能与兼容性上进一步优化,改进了依赖解析算法,提升大型项目中的安装与更新速度。它支持并行下载任务,显著减少等待时间,并增强了与私有仓库及镜像源的交互稳定性。同时修复了多项命令行交互与内存使用相关的缺陷,确保在复杂依赖关系下依然可靠运行。无论是新项目初始化还是现有系统维护,Composer 2.9.6 都能为开发者提供流畅、精准的依赖管理体验。
下载
推荐命令:
锁定主版本,避免意外拉到 11.x 预发布版
强制走压缩包安装,比 git clone 快且稳定(尤其在国内)
防止交互式提问卡住(比如问你是否启用 Sanctum、Jetstream)
如果提示
已全局安装,别用
——它默认拉最新版(可能是 11),且不尊重本地 Composer 配置
国内网络下 Composer 源没切对,90% 的超时和 404 都在这
默认走 packagist.org,国内直连极慢甚至中断,
卡在 “Installing dependencies” 或报
。
临时切镜像(单次有效):
更稳妥:全局换源一次,后续所有项目都生效:
阿里云源已停用,别再搜到过期教程里写
——现在要用
或
(配代理)
换源后务必删掉项目目录下的
和
,再重跑安装命令,否则旧 lock 文件仍会尝试连原源
真正麻烦的不是命令记不住,而是 PHP 版本和扩展检查常被跳过,结果报错信息全是 Composer 的依赖冲突提示,让人误以为是包问题——其实根源在
和
这两行没跑对。
composer create-project laravel/laravelmbstringopensslpdotokenizerxmlctypejsoncomposer create-projectYour requirements could not be resolvedphp -vbrew install php@8.2php -m | grep -E "(mbstring|openssl|pdo|tokenizer|xml|ctype|json)"php.iniextension=xxx--prefer-distcomposer create-project laravel/laravel:^10.0 myapp --prefer-dist --no-interaction^10.0--prefer-dist--no-interactionlaravel/installerlaravel newcreate-projectCould not fetch https://packagist.org/packages.jsoncomposer create-project -vvv --repository=https://packagist.phpcomposer.com laravel/laravel:^10.0 myappcomposer config -g repo.packagist composer https://packagist.phpcomposer.comhttps://mirrors.aliyun.com/composer/https://packagist.phpcomposer.comhttps://packagist.orgvendorcomposer.lockphp -vphp -m