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 安装，但直接 composer create-project laravel/laravel 很可能失败——PHP 版本、扩展、国内源这三关卡住的人最多。
PHP 版本和扩展不满足 Laravel 10 最低要求
Laravel 10 强制要求 PHP >= 8.1，且必须启用 mbstring、openssl、pdo、tokenizer、xml、ctype、json 这些扩展。缺一个，composer create-project 就会报错 Your requirements could not be resolved 或直接中断。
- 先运行
php -v确认版本 ≥ 8.1；低于就换 PHP（比如用brew install php@8.2或 XAMPP/AMPPS 切换） - 运行
php -m | grep -E "(mbstring|openssl|pdo|tokenizer|xml|ctype|json)"检查扩展是否全在；缺的得改php.ini，取消对应extension=xxx行的注释 - Windows 用户特别注意：WAMP/XAMPP 默认 PHP 可能是 8.0 或更低，别只看控制面板显示的“支持 PHP 8.x”，要进命令行实测
Composer 安装 Laravel 10 的正确命令和参数
不用默认命令，加 --prefer-dist 和指定稳定版标签，能避开 dev 分支不稳定、下载慢、解压失败等问题。
- 推荐命令：
composer create-project laravel/laravel:^10.0 myapp --prefer-dist --no-interaction -
^10.0锁定主版本，避免意外拉到 11.x 预发布版 -
--prefer-dist强制走压缩包安装，比 git clone 快且稳定（尤其在国内） -
--no-interaction防止交互式提问卡住（比如问你是否启用 Sanctum、Jetstream） - 如果提示
laravel/installer已全局安装，别用laravel new——它默认拉最新版（可能是 11），且不尊重本地 Composer 配置
国内网络下 Composer 源没切对，90% 的超时和 404 都在这
默认走 packagist.org，国内直连极慢甚至中断，create-project 卡在 “Installing dependencies” 或报 Could not fetch https://packagist.org/packages.json。
- 临时切镜像（单次有效）：
composer create-project -vvv --repository=https://packagist.phpcomposer.com laravel/laravel:^10.0 myapp - 更稳妥：全局换源一次，后续所有项目都生效：
composer config -g repo.packagist composer https://packagist.phpcomposer.com - 阿里云源已停用，别再搜到过期教程里写
https://mirrors.aliyun.com/composer/——现在要用https://packagist.phpcomposer.com或https://packagist.org（配代理） - 换源后务必删掉项目目录下的
vendor和composer.lock，再重跑安装命令，否则旧 lock 文件仍会尝试连原源
真正麻烦的不是命令记不住，而是 PHP 版本和扩展检查常被跳过，结果报错信息全是 Composer 的依赖冲突提示，让人误以为是包问题——其实根源在 php -v 和 php -m 这两行没跑对。
