Composer 用法

封面图 • 2025-11-09 • PHP

“Composer” 是一个在 PHP 开发中非常常用的工具，主要用于管理项目依赖（即第三方库或包）。它允许你声明项目所依赖的库，并自动处理这些库的安装、更新和加载。

---

## 一、Composer 的基本用法

### 1. 安装 Composer

如果你还没有安装 Composer，可以通过以下方式安装：

- **Windows**：[https://getcomposer.org/download/](https://getcomposer.org/download/)
- **Linux/macOS**：使用命令行安装：

```bash
php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
php composer-setup.php
php -r "unlink('composer-setup.php');"
```

然后将 `composer.phar` 移动到系统路径中：

```bash
sudo mv composer.phar /usr/local/bin/composer
```

验证安装：

```bash
composer --version
```

---

### 2. 初始化项目（创建 `composer.json` 文件）

在你的项目根目录下运行：

```bash
composer init
```

这会引导你创建一个 `composer.json` 文件，用于定义项目的元数据和依赖项。

---

### 3. 添加依赖包

例如，添加 `guzzlehttp/guzzle` 这个 HTTP 客户端库：

```bash
composer require guzzlehttp/guzzle
```

这会自动下载并安装该包，并更新 `composer.json` 和 `composer.lock` 文件。

---

### 4. 安装依赖

如果你从别人那里获取了一个项目，需要安装所有依赖：

```bash
composer install
```

这会根据 `composer.json` 和 `composer.lock` 文件安装所有依赖。

---

### 5. 更新依赖

更新所有依赖到最新版本（注意：可能不稳定）：

```bash
composer update
```

或者只更新某个包：

```bash
composer update guzzlehttp/guzzle
```

---

### 6. 自动加载（Autoloading）

Composer 支持自动加载类。在 `composer.json` 中配置 `autoload`：

```json
{
    "autoload": {
        "psr-4": {
            "MyApp\\": "src/"
        }
    }
}
```

然后运行：

```bash
composer dump-autoload
```

这样就可以在代码中直接使用类而无需手动 `require`。

---

## 二、常用命令总结

| 命令 | 说明 |
|------|------|
| `composer init` | 初始化项目，生成 `composer.json` |
| `composer require package/name` | 添加依赖 |
| `composer install` | 安装依赖 |
| `composer update` | 更新依赖 |
| `composer dump-autoload` | 重新生成自动加载文件 |
| `composer show` | 查看已安装的包 |
| `composer self-update` | 更新 Composer 自身 |

---

## 三、Composer 的作用

- 管理项目依赖
- 自动加载类
- 支持 PSR-4、PSR-0 等标准
- 提供包仓库（Packagist）
- 支持私有包和自定义仓库

---

## 四、示例：一个简单的 `composer.json`

```json
{
    "name": "my-project/my-app",
    "description": "My PHP Project",
    "require": {
        "guzzlehttp/guzzle": "^7.0"
    },
    "autoload": {
        "psr-4": {
            "MyApp\\": "src/"
        }
    }
}
```

---

如果你是初学者，建议从 `composer require` 和 `composer install` 开始，逐步了解其他命令。

需要我帮你写一个具体的 `composer.json` 或者解释某个包的用法吗？