Composer的基本使用

封面图 • 2025-11-10 • 读书区

Composer 是 PHP 的依赖管理工具，广泛用于 PHP 项目的依赖管理和自动加载。它可以帮助开发者轻松地安装、更新和管理项目所需的库和框架。以下是 Composer 的基本使用方法：

---

### 1. 安装 Composer
首先需要在系统中安装 Composer。以下是常见的安装方式：

#### 方法一：通过官方脚本安装
运行以下命令来下载并安装 Composer：
```bash
php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
php -r "if (hash_file('sha384', 'composer-setup.php') === '55d6ead61b29c7bdee5cccfb50076874187bd9f21f65d8991d46ec5cidf3f3634af30a77bccc88eaaefbfbeb469a88') { echo 'Installer verified'; } else { echo 'Installer corrupt'; unlink('composer-setup.php'); } echo PHP_EOL;"
php composer-setup.php
php -r "unlink('composer-setup.php');"
```

安装完成后，将 `composer.phar` 文件移动到系统的 PATH 中（例如 `/usr/local/bin/composer`），以便全局可用。

#### 方法二：通过包管理器安装
- **Linux/macOS**:
  ```bash
  sudo apt install composer   # Ubuntu/Debian
  brew install composer      # macOS
  ```
- **Windows**: 可以从 [Composer 官方网站](https://getcomposer.org/download/) 下载安装程序。

---

### 2. 初始化项目
在项目根目录下运行以下命令初始化一个 Composer 配置文件 `composer.json`：
```bash
composer init
```
该命令会引导你填写项目信息，包括名称、描述、作者等。完成后会生成一个 `composer.json` 文件。

---

### 3. 添加依赖
可以使用 `require` 命令为项目添加依赖。例如，安装 `monolog/monolog` 日志库：
```bash
composer require monolog/monolog
```

如果需要指定版本号，可以加上版本约束：
```bash
composer require monolog/monolog:^2.0
```

---

### 4. 自动加载类文件
Composer 提供了自动加载功能，可以通过 PSR-4 或 PSR-0 标准加载类文件。默认情况下，安装的依赖包会自动配置好自动加载规则。

如果需要手动配置自动加载，可以在 `composer.json` 文件中添加如下内容：
```json
{
    "autoload": {
        "psr-4": {
            "App\\": "src/"
        }
    }
}
```
然后运行以下命令生成自动加载文件：
```bash
composer dump-autoload
```

---

### 5. 更新依赖
当需要更新依赖时，可以运行以下命令：
```bash
composer update
```
这会根据 `composer.json` 文件中的依赖范围更新所有包。

如果只想更新某个特定包，可以指定包名：
```bash
composer update vendor/package
```

---

### 6. 删除依赖
如果需要移除某个依赖，可以运行以下命令：
```bash
composer remove vendor/package
```

---

### 7. 查看已安装的依赖
可以通过以下命令查看当前项目中已安装的依赖及其版本：
```bash
composer show
```

如果只想查看某一个依赖的信息，可以加上包名：
```bash
composer show vendor/package
```

---

### 8. 创建可执行脚本
如果希望生成一个可执行的脚本文件，可以使用 `bin` 字段。例如：
```json
{
    "bin": ["bin/my-script"]
}
```
然后运行以下命令：
```bash
composer install
```
生成的脚本会放在 `vendor/bin` 目录下，可以通过 `composer bin` 命令调用。

---

### 9. 锁定依赖版本
运行以下命令生成 `composer.lock` 文件，锁定依赖的具体版本：
```bash
composer update --lock
```

---

### 10. 使用 Composer 创建新项目
Composer 提供了一些常用的模板项目，可以直接创建。例如，创建一个 Laravel 框架项目：
```bash
composer create-project laravel/laravel my-laravel-app
```

---

### 总结
Composer 是 PHP 开发中不可或缺的工具，能够极大地简化依赖管理和开发流程。通过上述步骤，你可以快速上手 Composer 并将其应用到实际项目中。如果有更多复杂需求，可以参考 [Composer 官方文档](https://getcomposer.org/doc/) 获取更多信息。