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