composer create-project 命令用于基于现有模板创建新项目,如 laravel/laravel,并自动安装依赖;它会下载指定包的完整代码、复制到目标目录、执行 composer install 并触发初始化脚本,适合快速搭建框架应用。

当你运行 composer create-project 命令时,Composer 会从一个已有的项目模板(通常是框架或应用骨架)创建一个新的本地项目。它不是安装依赖,而是直接复制整个项目的结构,包括其 composer.json 配置,并自动安装所需的依赖包。
命令的基本语法
执行该命令的格式如下:composer create-project vendor/package-name [target-directory] [version]
-
vendor/package-name:你要创建项目的包名,比如
laravel/laravel - target-directory(可选):指定新项目存放的目录名,如果不填,默认使用包名
-
version(可选):指定要使用的版本,如
dev-main、1.0.0等
内部工作流程
这个命令实际做了几件事:
- 从 Packagist 中查找指定的包
- 下载该包的完整代码(相当于克隆整个仓库)
- 将项目文件复制到你指定的目标目录
- 读取该项目自带的
composer.json文件 - 自动执行 composer install 安装所有依赖项
- 如果项目定义了脚本(scripts),还可能触发一些初始化操作,比如生成密钥、清理.git信息等
常见使用场景
这个命令特别适合用来快速搭建基于框架的新应用:
- 创建 Laravel 应用:
composer create-project laravel/laravel my-site - 使用特定 PHP 版本分支:
composer create-project symfony/skeleton my-app "6.4.*" - 基于开发分支测试:
composer create-project yiisoft/yii2-app-basic my-yii-app dev-master
基本上就这些。它本质上是一个“项目生成器”,比单纯 require 包更完整,适合从零开始搭建应用。










