composer create-project 可快速搭建 PHP 项目,语法为 composer create-project [选项] [目录名] [版本],支持指定目录、版本及安装方式;常用选项包括 --prefer-dist、--prefer-source、--keep-vcs 等,适用于 Laravel 等框架的初始化,建议配置镜像源加速下载。

当你需要快速搭建一个基于 PHP 的项目结构时,composer create-project 是一个非常实用的命令。它能从指定的包创建一个全新的项目,自动安装依赖并生成基础文件,特别适合使用框架(如 Laravel、Symfony)或 CMS 系统的场景。
基本语法与参数说明
命令的基本格式如下:
composer create-project [选项] [目录名] [版本]-
包名:你要基于哪个 Composer 包创建项目,比如
laravel/laravel - 目录名(可选):新项目的目录名称。如果不填,默认使用包名的最后一部分
-
版本(可选):指定要安装的版本,例如
^8.0或dev-main
示例:
composer create-project laravel/laravel my-blog这会创建一个名为 my-blog 的目录,并在里面安装最新稳定版的 Laravel 框架。
常用选项详解
这个命令支持多个选项来控制行为:
- --prefer-dist:优先从压缩包(dist)安装,速度快,适合生产环境
- --prefer-source:从源码安装,适用于开发调试,便于查看和修改代码
-
--stability (-s):设置最低稳定性,如
dev、alpha、beta等 -
--no-install:只克隆项目结构,不运行
composer install - --keep-vcs:保留版本控制信息(如 .git 目录),方便后续贡献代码
- --no-scripts:不执行 composer.json 中定义的脚本
例如,你想用开发分支并保留 Git 记录:
composer create-project laravel/laravel my-app dev-develop --keep-vcs适用场景与使用建议
这个命令最适合以下几种情况:
- 启动一个新项目,尤其是使用主流框架时
- 想快速体验某个 PHP 包的功能而不想手动配置
- 需要基于某个开源项目做二次开发
建议在运行前确认全局 Composer 配置是否合理,比如镜像源设置。国内用户可使用阿里云或 Laravel China 的镜像加速下载。
常见问题处理
如果遇到权限错误,检查目标目录是否已存在且不可写。Composer 不会覆盖已有文件夹。
若提示“Could not find package”,请确认包名拼写正确,或尝试加引号防止 shell 解析特殊字符。
版本约束写错也可能导致失败,建议查阅 Packagist 上的具体版本标签。
基本上就这些。掌握好这个命令,能让你更高效地初始化 PHP 项目。










