使用 composer 创建 laravel 10 项目需先确保 php ≥ 8.1 并启用必要扩展,推荐用 laravel/installer(composer global require laravel/installer)后执行 laravel new my-laravel-app;或直接运行 composer create-project laravel/laravel my-laravel-app "10.*",再 cd my-laravel-app && php artisan serve 验证。

用 Composer 创建 Laravel 10 项目,核心是使用官方推荐的 laravel/installer 工具或直接通过 Composer 的 create-project 命令。Laravel 10 要求 PHP 版本 ≥ 8.1,且需确保 Composer 已正确安装并可用。
确认环境前提
在执行命令前,请检查:
- PHP 版本 ≥ 8.1(运行
php -v查看) - Composer 已全局安装且可执行(运行
composer --version) - 已启用 OpenSSL、PDO、Mbstring、Tokenizer、XML、Ctype、JSON、BCMath、Zip 等必要扩展
方法一:用 laravel/installer(推荐,更简洁)
先全局安装 Laravel 安装器(只需一次):
composer global require laravel/installer
确保 ~/.composer/vendor/bin(Linux/macOS)或 %USERPROFILE%\AppData\Roaming\Composer\vendor\bin(Windows)已加入系统 PATH。
然后创建新项目:
laravel new my-laravel-app
该命令默认拉取最新稳定版 Laravel(当前即 Laravel 10.x),自动安装依赖、生成密钥、配置基础环境。
方法二:用 create-project(无需预装 installer)
直接运行:
composer create-project laravel/laravel my-laravel-app "10.*"
其中 "10.*" 明确限定主版本为 10,避免意外安装 Laravel 11(若已发布)。如省略版本约束,Composer 可能根据本地配置拉取更高主版本。
项目创建完成后,进入目录并启动开发服务器验证:
cd my-laravel-app && php artisan serve
访问 https://www.php.cn/link/f0838b2ebfc6440a474eabdc326bf31a,看到 Laravel 欢迎页即表示成功。
常见注意事项
若遇到权限或缓存问题:
- 执行
composer clear-cache清理 Composer 缓存 - Windows 用户若提示“找不到 php”或“拒绝访问”,请确认 PHP 已加入 PATH,或改用完整路径调用(如
C:\php\php.exe artisan serve) - 国内用户可临时切换镜像加速安装:
composer config -g repo.packagist composer https://packagist.phpcomposer.com(注意该镜像已停用,建议改用https://mirrors.aliyun.com/composer/)











