composer执行create-project时,先解析包名和版本,从Packagist获取元信息,下载主包及依赖,安装至新目录并初始化项目结构。
composer create-project 时,Composer 实际上是在执行一个自动化流程,用来从指定的包创建一个全新的项目。这个命令常用于基于框架或应用模板快速搭建项目,比如 laravel、symfony 或自定义的项目脚手架。它不只是简单地克隆代码,背后涉及多个步骤和逻辑处理。
1. 解析目标包并下载依赖
Composer 首先会解析你提供的包名(例如 laravel/laravel),查找其在 Packagist 上的元信息。然后根据你指定的版本(如 、 等)确定要安装的具体版本。
接着,Composer 下载该包的源码或压缩包,并将其内容解压到你指定的目标目录中。如果未指定目录,则使用包名作为文件夹名称。
- 若包是公开的,Composer 通常从 dist(压缩包)安装以提升速度
- 若使用
--prefer-source,则会通过 Git 克隆源码,便于后续开发贡献
2. 安装项目的依赖项
项目模板本身往往有 require 和 require-dev 列表。Composer 在将模板代码写入目录后,会立即读取其中的 composer.json 文件,并开始安装这些依赖。
这一步和其他 composer install 操作一致:解析依赖树、下载对应版本、生成 vendor/ 目录和自动加载文件(autoload.php)。
- 依赖安装遵循你当前环境的平台条件(PHP 版本、扩展等)
- 可使用
--no-deps跳过依赖安装(不推荐用于实际项目)
3. 执行项目级别的初始化脚本
许多项目模板会在 composer.json 中定义 scripts,特别是 post-create-project-cmd。这个脚本钩子会在项目创建完成后自动触发。
典型用途包括:
- 生成应用密钥(如 Laravel 的
php artisan key:generate) - 创建 .env 文件(复制 .env.example)
- 提示用户进行下一步操作(如运行迁移或启动开发服务器)
这些脚本由模板作者定义,是“开箱即用”体验的关键部分。
4. 清理版本控制信息(可选)
如果你使用了 --remove-vcs 参数,Composer 会在项目创建后删除模板中原有的版本控制信息,比如 .git 目录或 .svn 文件夹。
这样新项目就不会继承模板的提交历史,方便你从零开始建立自己的仓库。
基本上就这些。Composer 的 create-project 是一个封装良好的工具,把“获取模板 + 安装依赖 + 初始化配置”整合成一条命令,极大简化了项目启动流程。理解其内部机制有助于你更好地使用或创建自己的项目模板。