Composer 是什么

在 PHP 的世界里，总会遇到这样一种场景：一个功能刚准备动手实现，却发现早就有人写好了更成熟、更稳定的版本。与其重复造轮子，不如直接使用现成的工具。问题随之而来——这些工具该如何统一管理、自动加载、版本控制？这正是 Composer 存在的意义。

Composer 是什么

简单来说，Composer 是 PHP 的依赖管理工具。

它做的事情其实很朴素：
把项目中需要用到的第三方库统一记录下来，然后一键安装、自动加载、按版本管理。

可以把它理解成：

• PHP 版的 npm（前端）

• PHP 版的 pip（Python）

但相比手动下载源码再复制粘贴，Composer 的优势在于——规范、自动、可控。

为什么一定要用 Composer

没有使用 Composer 的项目，通常会出现这些情况：

• 各种工具类散落在项目里

• 不同版本混用，容易冲突

• 引入文件一堆 require

• 换电脑就跑不起来

而使用 Composer 之后：

• 所有依赖集中在一个文件中（composer.json）

• 一条命令安装全部依赖

• 自动加载类（不用再手动 require）

• 团队协作更轻松

一句话总结：让项目从“能跑”变成“工程化”。

核心文件：composer.json

Composer 的核心就是这个文件。

一个典型示例：

{
  "name": "yijing/miniprogram-backend",
  "require": {
    "php": ">=7.4",
    "twig/twig": "^3.0",
    "wechatpay/wechatpay": "^1.4",
    "overtrue/chinese-calendar": "^1.0",
    "6tail/lunar-php": "^1.4"
  }
}

这里面最重要的是 require：

• 左边：包名

• 右边：版本约束

例如：

• ^1.4 表示：1.x 都可以，但不升级到 2.0

• >=7.4 表示最低 PHP 版本

最常用的几个命令

Composer 并不复杂，真正高频使用的就几个命令。

1. 安装依赖

composer install

作用：

• 根据 composer.json 下载依赖

• 生成 vendor/ 目录

• 生成 autoload.php

2. 添加新依赖

composer require monolog/monolog

作用：

• 自动写入 composer.json

• 自动下载安装

3. 更新依赖

composer update

作用：

• 按版本规则升级依赖

4. 自动加载优化

composer dump-autoload

作用：

• 刷新自动加载（开发中很常用）

自动加载（最核心的价值）

传统写法：

require 'lib/a.php';
require 'lib/b.php';
require 'lib/c.php';

使用 Composer 后，只需要：

require 'vendor/autoload.php';

之后所有依赖都会自动加载。

这背后的机制叫：PSR-4 自动加载规范。

一个真实使用示例

比如需要一个“黄历功能”，不用自己写算法，直接引入：

composer require 6tail/lunar-php

然后代码中直接用：

<?php

require 'vendor/autoload.php';

use Lunar\Lunar;

$lunar = Lunar::fromDate(new DateTime());
echo $lunar->toFullString();

一个复杂的农历系统，几行代码就完成了。

Composer 的运行原理（简单理解）

流程其实很清晰：

1. 读取 composer.json

2. 去包仓库（默认 Packagist）查找依赖

3. 下载到 vendor/

4. 生成自动加载文件

5. 项目通过 autoload 使用所有库

常见问题

下载慢

可以切换国内镜像：

composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/

版本冲突

通常是多个库依赖不同版本，可以通过：

composer why-not 包名 版本

来分析原因。

vendor 目录要不要提交？

答案是：不要

只需要提交：

• composer.json

• composer.lock

其他人只需执行：

composer install

即可恢复完整环境。

一个更高级的用法（项目结构）

很多成熟项目会这样配置：

"autoload": {
  "psr-4": {
    "App\\": "src/"
  }
}

这样就可以直接：

use App\Controller\UserController;

不用再手动加载文件，结构非常清晰。

写在最后

Composer 的价值，并不只是“装库”。

它真正改变的是开发方式：

• 从零散脚本 → 工程化项目

• 从手动管理 → 自动化管理

• 从单人开发 → 团队协作

当项目开始变大、功能开始变复杂时，这种变化会变得非常明显。

如果说 PHP 是工具，那么 Composer 更像是“工具的管理者”。
一旦习惯，再也很难回到没有它的开发方式。