国内安装 laravel 需完成四步闭环：配置 composer 国内镜像源、验证 php ≥8.1/8.2 并启用必要扩展、显式指定版本创建项目、生成密钥并清空配置与通用缓存。
国内安装 Laravel，核心不是只换镜像，而是四步闭环：配好 Composer 国内源、验证 PHP 环境达标、显式指定版本创建项目、生成密钥并清缓存。缺一不可，否则容易卡在下载慢、扩展报错或版本冲突上。
第一步：设好 Composer 全局镜像源
官方 Packagist 在国内访问不稳定，必须切到国内镜像。推荐优先用腾讯云或阿里云，华为云和 Laravel China 作备用：
- 腾讯云（当前最稳）：composer config -g repo.packagist composer https://mirrors.cloud.tencent.com/composer/
- 阿里云（常用稳定）：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
- Laravel China（Laravel 专项优化）：composer config -g repo.packagist composer https://packagist.laravel-china.org
执行后运行 composer config -l | grep repo.packagist，确认输出是你刚设置的 URL；再顺手执行 composer clear-cache 清掉旧缓存。
第二步：检查 PHP 环境是否达标
Laravel 10 要求 PHP ≥ 8.1，Laravel 11 要求 PHP ≥ 8.2，且以下扩展必须真实启用（不只是装了，还要在 php.ini 中开启）：
- mbstring、openssl、pdo、intl、json、xml、ctype、curl
- Windows 用户检查 php.ini 是否去掉了对应 extension= 行前的分号
- Linux/macOS 用户可用 php -m | grep -E 'mbstring|openssl|pdo' 快速核对
第三步：用命令显式创建指定版本项目
别直接跑 composer create-project laravel/laravel，容易拉到不兼容的预发布版。按需锁定：
- 装 Laravel 10：composer create-project laravel/laravel:^10.0 myapp
- 装 Laravel 11：composer create-project laravel/laravel:^11.0 myapp
项目建好后，进目录：cd myapp
第四步：初始化配置并清理缓存
新项目不能直接跑，必须完成基础初始化：
- 生成应用密钥：php artisan key:generate
- 清空配置缓存：php artisan config:clear
- 清空通用缓存：php artisan cache:clear
做完这三步，再用 php artisan serve 启动，访问 http://localhost:8000 就能看见 Laravel 欢迎页。
