Composer如何创建新项目_从零开始初始化PHP工程

使用composer create-project可快速创建PHP项目，它会下载项目骨架并自动安装依赖，适合启动框架类项目；而composer init适用于从空目录逐步构建项目，通过交互式提问生成composer.json文件，适合自定义或库开发。前者用于快速搭建如Laravel等框架应用，后者用于轻量级或独立工具开发。最佳实践中建议指定版本约束、了解骨架结构、优先使用--prefer-dist、确保来源可信，并在项目初期完成定制。对于依赖管理，composer.json定义依赖范围和项目元数据，是项目的“蓝图”；composer.lock记录依赖精确版本，保证环境一致性。应用项目应提交composer.lock以确保各环境一致，库项目则不应提交。两者协同工作，确保依赖可复现与稳定。

从零开始初始化PHP工程，Composer提供了两种主要途径：一种是利用

create-project

composer init

composer.json

解决方案

要使用Composer创建新项目，最常见且高效的方式是利用

composer create-project

composer install

例如，如果你想创建一个新的Laravel项目，命令会是这样：

composer create-project laravel/laravel my-new-project

这行命令会做几件事：

立即学习“PHP免费学习笔记（深入）”；

1. 从Packagist（Composer的默认包仓库）找到

   laravel/laravel

   登录后复制
   这个包。
2. 将这个包（实际上是一个项目骨架）下载到当前目录下的

   my-new-project

   登录后复制
   文件夹中。
3. 进入

   my-new-project

   登录后复制
   文件夹。
4. 根据

   laravel/laravel

   登录后复制
   项目骨架中的

   composer.json

   登录后复制
   文件，自动执行

   composer install

   登录后复制
   ，下载并安装Laravel框架及其所有依赖。

整个过程下来，你就拥有了一个可以直接运行的Laravel项目。这种方式极大地简化了新项目的启动流程，避免了手动下载、配置依赖的繁琐。

当然，如果你追求的是一个“完全从零开始”的空项目，甚至不依赖任何框架骨架，那么你可以在一个空目录中，先手动创建

composer.json

composer init

composer install

composer create-project

登录后复制

的真实场景与最佳实践是什么？

composer create-project

最典型的应用场景，就是启动各种PHP框架项目。无论是Laravel、Symfony、Lumen、Yii，还是CodeIgniter（虽然CodeIgniter用Composer不是那么普遍，但也有其方式），它们都有官方或社区提供的项目骨架包。用

create-project

最佳实践方面，有几点我觉得挺重要的：

• 明确版本： 很多时候，我们不希望总是拉取最新版本，特别是当团队有特定版本要求时。你可以这样指定版本：

  composer create-project laravel/laravel my-new-project "9.*"

  登录后复制

  这样就能确保你拿到的是Laravel 9系列的最新稳定版。版本约束的写法和

  composer.json

  登录后复制
  里是一样的。

• 理解骨架： 在使用任何

  create-project

  登录后复制
  命令之前，最好对你正在创建的骨架有所了解。它会创建哪些目录？包含哪些默认配置？有没有一些特殊的初始化脚本会运行？比如Laravel的骨架会生成

  .env

  登录后复制
  文件，并运行

  key:generate

  登录后复制
  。了解这些能避免一些不必要的疑惑。

• --prefer-dist

  登录后复制
  vs

  --prefer-source

  登录后复制
  ： 默认情况下，Composer会尝试下载打包好的发行版（

  --prefer-dist

  登录后复制
  ），这通常更快，也更节省空间。如果你需要修改框架核心代码，或者想调试框架内部，才应该考虑

  --prefer-source

  登录后复制
  ，它会通过Git克隆完整的仓库，这会带来

  .git

  登录后复制
  目录，也更慢一些。一般项目开发，用默认的

  --prefer-dist

  登录后复制
  就足够了。
• 安全性考量： 既然是拉取一个完整的项目，你就得信任这个骨架的来源。确保你使用的包是来自官方或信誉良好的开发者。避免使用不明来源的

  create-project

  登录后复制
  模板，以防引入恶意代码。
• 后期定制： 即使是从骨架开始，项目初期也可能需要进行一些定制化。例如，修改默认的命名空间、调整目录结构（虽然不推荐大改框架默认结构），或者集成一些公司内部的基础库。这些都应该在项目创建后，尽早进行。

总的来说，

create-project

如果我想从一个完全空的PHP目录开始，Composer要怎么初始化？

嗯，有时候我们确实不需要一个大而全的框架骨架，可能只是想写个小工具，或者构建一个纯粹的库，甚至只是想在一个现有但没有Composer的项目里引入依赖。这时候，

composer init

create-project

composer.json

你在一个空的目录里运行：

composer init

然后，Composer会像一个友好的向导一样，问你一系列问题：

• Package name (

  vendor/package

  登录后复制
  ): 这是你项目的唯一标识，比如

  my-company/my-awesome-tool

  登录后复制
  。如果你是开发一个库，这很重要；如果是应用，可以随意一些，但最好保持规范。
• Description: 简短描述你的项目是做什么的。
• Author: 你的名字和邮箱。
• Minimum Stability:

  dev

  登录后复制
  、

  alpha

  登录后复制
  、

  beta

  登录后复制
  、

  RC

  登录后复制
  、

  stable

  登录后复制
  。如果你不确定，

  stable

  登录后复制
  通常是最好的选择，它会阻止安装不稳定的包。
• License: 你的项目使用的开源许可证，比如

  MIT

  登录后复制
  、

  GPL-3.0-only

  登录后复制
  。
• Define your dependencies (require)?: 这里你可以开始添加你的项目依赖。Composer会提示你输入包名（例如

  monolog/monolog

  登录后复制
  ）和版本约束（例如

  ^2.0

  登录后复制
  ）。你可以添加多个。
• Define your dev dependencies (require-dev)?: 同样，你可以添加开发环境才需要的依赖，比如测试框架（

  phpunit/phpunit

  登录后复制
  ）。

当你回答完所有问题，Composer就会在当前目录生成一个

composer.json

Hour One

AI文字到视频生成

37

查看详情

{
    "name": "my-company/my-awesome-tool",
    "description": "A simple PHP tool for awesome stuff.",
    "type": "project",
    "license": "MIT",
    "autoload": {
        "psr-4": {
            "MyCompany\MyAwesomeTool\": "src/"
        }
    },
    "authors": [
        {
            "name": "Your Name",
            "email": "your.email@example.com"
        }
    ],
    "require": {
        "php": ">=8.0",
        "monolog/monolog": "^2.0"
    },
    "require-dev": {
        "phpunit/phpunit": "^9.5"
    }
}

注意，这里我手动添加了一个

autoload

composer init

autoload

psr-4

src/

MyCompanyMyAwesomeTool

生成

composer.json

composer install

这个命令会根据

composer.json

vendor/

composer.lock

vendor/autoload.php

src/

require __DIR__ . '/vendor/autoload.php';

管理项目依赖时，

composer.json

登录后复制

和

composer.lock

登录后复制

各有什么作用？

在Composer的世界里，

composer.json

composer.lock

composer.json

composer.json

"monolog/monolog": "^2.0"

>=2.0.0 <3.0.0

这个文件是项目的心脏，它包含了：

• 项目元数据： 项目名称、描述、作者、许可证等。
• 依赖项（

  require

  登录后复制
  ）： 生产环境所需的包及其版本约束。
• 开发依赖项（

  require-dev

  登录后复制
  ）： 仅在开发或测试环境所需的包。
• 自动加载规则（

  autoload

  登录后复制
  ）： 如何自动加载你的项目类文件（PSR-4、PSR-0、classmap等）。
• 脚本（

  scripts

  登录后复制
  ）： 定义可以在Composer生命周期事件中运行的自定义命令。

composer.json

composer update

composer.lock

composer.lock

composer install

composer update

这个文件的核心作用是确保环境一致性。想象一下，你和你的团队成员在不同的机器上开发同一个项目。如果只依赖

composer.json

composer install

composer.lock

composer install

composer.lock

composer.lock

composer.json

composer.lock

composer install

总结与版本控制策略：

• composer.json

  登录后复制
  应该始终被提交到版本控制系统（如Git）。

• composer.lock

  登录后复制
  对于应用程序（Application）项目，也应该始终被提交到版本控制系统。这确保了所有开发人员、测试环境和生产环境都使用完全相同的依赖版本，保证了环境的一致性和可重复性。
• 对于库（Library）项目，

  composer.lock

  登录后复制
  通常不应该被提交到版本控制系统。因为库的消费者有权决定他们想要使用哪个版本的依赖，库只需要声明它兼容的版本范围即可。

理解这两个文件的作用，并正确地将它们纳入你的版本控制策略，是使用Composer进行高效、稳定项目管理的关键。当你需要更新依赖时，运行

composer update

composer.json

composer.lock

composer install

composer.lock

以上就是Composer如何创建新项目_从零开始初始化PHP工程的详细内容，更多请关注php中文网其它相关文章！