composer create-project 用于基于模板创建新项目,如 Laravel 或 Symfony。语法为 composer create-project [选项] [目录名] [],常用选项包括 --prefer-dist、--no-dev、--stability 等,可组合使用以定制安装方式,典型用法如创建 Laravel 项目或从主分支安装开发版,命令会自动创建目录、下载依赖并执行脚本,需确保 Composer 可用且注意网络与权限问题。

composer create-project 命令用于基于某个已存在的项目模板创建一个新的项目目录。它通常用来快速搭建框架或应用的初始结构,比如 Laravel、Symfony 等。
基本语法
composer create-project [选项] [目录名] []
说明:
- 包名:要安装的 Composer 包,如 laravel/laravel
- 目录名(可选):指定新项目存放的目录名称,如果不填,默认使用包名的最后一部分
- 版本(可选):指定要安装的版本,如 v9.0.0 或 dev-main
常用选项
这些选项可以组合使用:
- --prefer-dist:优先从 dist(压缩包)安装,速度更快
- --prefer-source:优先从源码安装,适合开发调试
- --stability (-s):指定最低稳定版本,如 dev、alpha、beta、rc、stable
- --no-dev:不安装 require-dev 中的依赖,适合生产环境
- --keep-vcs:保留版本控制信息(如 .git 目录),即使项目不是通过 VCS 克隆的
- --no-install:只下载项目,不执行 composer install
- --no-scripts:不执行 composer.json 中定义的脚本
- --ignore-platform-reqs:忽略当前环境对 PHP 版本、扩展等的要求
常见用法示例
以下是一些典型场景:
- 创建最新版 Laravel 项目:
composer create-project laravel/laravel myproject - 指定版本安装:
composer create-project laravel/laravel myproject 9.x - 从主分支安装(开发版):
composer create-project laravel/laravel myproject dev-main - 不安装开发依赖:
composer create-project laravel/laravel myproject --no-dev - 优先使用源码方式安装,便于调试:
composer create-project symfony/skeleton myapp --prefer-source - 安装一个不稳定版本:
composer create-project package/name myapp -s dev
注意事项
该命令会:
- 创建目标目录(如果不存在)
- 下载指定包及其依赖
- 自动执行 composer install 来安装依赖(除非加了 --no-install)
- 执行 composer.json 中定义的 scripts(除非用了 --no-scripts)
确保系统已安装 Composer 并能全局运行。如果遇到权限或网络问题,可尝试加上 -vvv 参数查看详细日志。
基本上就这些,灵活组合选项就能满足大多数初始化项目的需求。










