Composer 安装与使用

封面图 • 2026-01-11 • PHP

Composer 是 PHP 项目中用于依赖管理的工具，它可以帮助你管理项目中所需的第三方库（如框架、工具等）。以下是一个关于 **Composer 安装与使用** 的详细指南：

---

## 📦 一、Composer 安装

### ✅ 1. 系统要求
- PHP 7.2 或更高版本
- 有命令行访问权限（Linux/macOS/Windows）

---

### 🧩 2. 安装 Composer（推荐方式）

#### 方法一：通过官方安装脚本（推荐）

在终端或命令行中运行以下命令：

```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
```

> 注意：如果你使用的是 Windows，可以下载 [Composer-Setup.exe](https://getcomposer.org/Composer-Setup.exe) 并直接运行。

---

#### 方法二：使用 Homebrew（仅限 macOS）

```bash
brew install composer
```

---

### ✅ 3. 验证安装

运行以下命令确认 Composer 是否安装成功：

```bash
composer --version
```

如果输出类似 `Composer version 2.x.x`，说明安装成功。

---

## 🛠️ 二、Composer 基本使用

### 📁 1. 初始化项目（创建 `composer.json`）

在项目根目录下执行：

```bash
composer init
```

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

---

### 📦 2. 添加依赖包

例如，添加 Laravel 框架：

```bash
composer require laravel/framework
```

或者添加一个特定版本的包：

```bash
composer require vendor/package:1.0.0
```

---

### 🧹 3. 安装依赖

当你克隆了一个项目时，需要安装其依赖：

```bash
composer install
```

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

---

### 🔄 4. 更新依赖

更新所有依赖到最新版本（不推荐生产环境）：

```bash
composer update
```

也可以只更新某个包：

```bash
composer update vendor/package
```

---

### 🧱 5. 自动加载（autoload）

Composer 会自动生成 `vendor/autoload.php` 文件，用于自动加载类。在项目中引入即可：

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

---

## 🧩 三、常用命令汇总

| 命令 | 说明 |
|------|------|
| `composer init` | 创建 `composer.json` 文件 |
| `composer require package` | 添加依赖包 |
| `composer install` | 安装依赖 |
| `composer update` | 更新依赖 |
| `composer show` | 查看已安装的包 |
| `composer search keyword` | 搜索包 |
| `composer dump-autoload` | 重新生成自动加载文件 |

---

## 📚 四、Composer 常见问题

### ❌ 1. 权限问题（Linux/macOS）

如果你遇到权限错误，可以尝试使用 `sudo` 或更改 `vendor` 目录的权限：

```bash
sudo chown -R $USER vendor/
```

### ❌ 2. 无法连接到 Packagist

检查你的网络是否正常，或设置镜像：

```bash
composer config -g repo.packagist composer https://packagist.phpcomposer.com
```

---

## 🧪 五、使用 Composer 创建 PHP 项目（示例）

```bash
composer create-project laravel/laravel my-project
```

这将创建一个 Laravel 项目并自动安装所有依赖。

---

## 📝 六、composer.json 示例

```json
{
    "name": "myproject/my-package",
    "description": "My PHP project",
    "require": {
        "php": ">=7.4",
        "laravel/framework": "^8.0"
    },
    "autoload": {
        "psr-4": {
            "App\\": "app/"
        }
    }
}
```

---

## 📘 七、更多资源

- [Composer 官方文档](https://getcomposer.org/doc/)
- [Packagist 包仓库](https://packagist.org/)
- [Composer 中文文档](https://www.kancloud.cn/leowang/learn-composer/168442)

---

如果你有任何具体问题，比如“如何安装某个包”、“如何配置 Composer”，欢迎随时提问！