什么是 Composer？

在开始安装之前,简单了解一下 Composer 是什么，会让你更有动力去学习它。

Composer 是 PHP 的依赖管理工具。

你可以把它想象成 PHP 世界的 npm（Node.js）或 pip（Python），它的主要作用是：

1. 管理依赖：允许你在项目中声明所依赖的外部库（Symfony、Laravel、Monolog 等），并自动将它们下载和安装到你的项目中。
2. 自动加载：它会自动生成一个 autoload.php 文件，你只需要在项目入口文件中引入它，就可以使用所有已安装库的类，无需手动写 require 或 include。
3. 版本控制：可以指定依赖库的版本，确保项目的稳定性和可复现性。

安装前准备：环境要求

在安装 Composer 之前，你的系统必须满足以下基本条件：

1. PHP 环境：你的电脑上必须已经安装了 PHP。
   • 如何检查？打开终端（Windows 是命令提示符或 PowerShell，macOS/Linux 是终端），输入 php -v。
   • 如果看到类似 PHP 8.1.2 (cli) ... 的输出，说明 PHP 已安装。
   • 注意：Composer 需要 PHP 7.2 或更高版本，版本过低需要先升级 PHP。
2. PHP CLI (命令行界面)：确保你安装的是 PHP 的 CLI 版本，而不是 Apache 或 Nginx 模块下的 PHP，CLI 版本可以在命令行中直接执行 PHP 脚本。

第一步：安装 PHP（如果尚未安装）

如果你还没有 PHP 环境，需要先安装它，推荐使用集成环境包，它们会一次性安装好 PHP、Web服务器、数据库等所有工具，非常方便。

安装完集成环境后,通常它会自动将 PHP 添加到系统环境变量中，你可以在任意终端使用 php -v 命令。

第二步：下载并安装 Composer

Composer 的安装非常简单，官方推荐使用一个安装脚本，这个脚本会自动检测你的 PHP 环境，下载 Composer 的 .phar 文件，并将其移动到系统路径中，以便全局使用。

通用安装步骤（适用于所有操作系统）

1. 打开终端

   • Windows: 按 Win + R，输入 cmd 或 powershell，然后回车。
   • macOS / Linux: 打开“启动台”或“应用程序” -> “实用工具” -> “终端”。

2. 执行安装命令 在终端中，输入以下命令并回车，这个命令会从 Composer 官网下载安装脚本并执行它。

   
   （图片来源网络，侵删）

   php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
   php -r "if (hash_file('sha384', 'composer-setup.php') === 'e21205b4df2ce03911c1549cc9c17d9bcb00b3b8d499a31307e544b9f5e3e5e5') { 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-setup.php 安装脚本。
   • 第二行：验证下载的脚本是否完整（通过校验 SHA384 哈希值），确保文件未被篡改。
   • 第三行：执行安装脚本，它会下载 composer.phar 文件。
   • 第四行：删除临时的安装脚本。

3. 移动 Composer 到全局路径 安装脚本默认只会在当前目录下生成 composer.phar 文件，为了让你在任何目录下都能使用 composer 命令，需要将它移动到系统的全局路径（/usr/local/bin）。

   • 在 macOS 或 Linux 上：

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

     提示：sudo 可能需要你输入用户密码。

   • 在 Windows 上：

     • 找到 composer.phar 文件所在的位置（通常是你当前打开的终端所在的目录）。
     • 将 composer.phar 文件复制到 PHP 的安装目录下，如果你的 PHP 安装在 C:\php，就把 composer.phar 复制到 C:\php。
     • 将 C:\php 添加到系统的 环境变量 的 Path 中，这样系统才能在任何地方找到 composer 命令。
     • 更简单的方法：在执行完安装脚本后，直接运行 move composer.phar C:\php\composer (假设你的 PHP 在 C:\php)，然后手动配置环境变量。

第三步：验证安装

完成以上所有步骤后,最关键的一步来了：验证 Composer 是否安装成功。

1. 关闭并重新打开你的终端，这一步是为了让新的环境变量（如果刚配置了的话）生效。

2. 在任意目录下,输入以下命令：

   composer --version

3. 如果安装成功，你会看到类似下面的输出，显示出了 Composer 的版本号：

   Composer version 2.5.1 2025-09-05 12:11:19

4. 如果提示 'composer' 不是内部或外部命令...，这通常意味着系统找不到 composer 命令，请检查以下两点：

   • Windows: 确认 composer.phar 所在的目录（C:\php）是否已添加到系统 Path 环境变量中，可以重启电脑后再试。
   • macOS/Linux: 确认你是否用 sudo mv 成功将文件移动到了 /usr/local/bin/composer。

第四步：配置国内镜像（非常重要！）

Composer 默认从国外的 packagist.org 仓库下载依赖，由于网络原因，速度可能会非常慢，甚至失败，强烈建议你切换到国内镜像源。

这里推荐使用 阿里云镜像。

1. 全局配置（推荐） 这样配置后，你所有使用 Composer 的项目都会使用这个镜像。

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

2. 临时配置 如果只是想让当前项目使用镜像，可以执行：

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

3. 如何恢复默认？ 如果你想换回官方源，可以执行：

   composer config -g repo.packagist composer https://packagist.org

配置完成后,你再次使用 composer require 命令时，下载速度会快很多！

Composer 基本使用入门

安装成功后,你可以尝试在任意一个 PHP 项目目录中使用 Composer。

1. 初始化项目 进入你的项目根目录（例如一个空文件夹），执行：

   composer init

   它会引导你创建一个 composer.json 文件，这是项目的依赖配置文件。

2. 安装一个依赖 我们想安装一个强大的调试工具 barryvdh/laravel-debugbar（即使你不是 Laravel 项目，它也可以工作）。

   # 在项目根目录执行
   composer require barryvdh/laravel-debugbar

   执行后,Composer 会：

   • 分析依赖关系。
   • 从镜像源下载所有需要的库到 vendor/ 目录。
   • 更新 composer.json 和 composer.lock 文件。

3. 使用自动加载 在你的 PHP 脚本中，你可以这样引入自动加载器：

   <?php
   // 引入 Composer 生成的自动加载文件
   require 'vendor/autoload.php';
   // 现在你可以直接使用已安装库的类了
   use Barryvdh\Debugbar\LaravelDebugbar;
   // ... 你的代码 ...

   这样,laravel-debugbar 的所有功能就可以在你的脚本中使用了。

常见问题

• Q: 提示 "The 'openssl' extension is missing..." 错误？

  • A: 这说明你的 PHP 安装缺少 openssl 扩展，你需要编辑你的 php.ini 文件，找到 ;extension=openssl 这一行，去掉前面的分号 ，然后保存，重启你的 Web 服务器或命令行环境。

• Q: 在 Windows 上安装很慢或失败？

  • A: 确保你的系统没有开启“代理服务器”设置，或者尝试使用管理员权限运行终端，如果问题依旧，可以尝试手动下载 composer.phar 文件，然后按第二步的说明进行移动。

• Q: composer update 和 composer install 有什么区别？

  • A:
    • composer install: 当你拿到别人的项目时，这个命令会根据项目根目录下的 composer.lock 文件（记录了精确的版本号）来安装依赖，确保开发环境与生产环境完全一致。
    • composer update: 这个命令会根据 composer.json 文件中定义的版本规则（如 ^1.0）去查找最新的兼容版本，并更新 composer.lock 文件，通常在需要升级依赖时使用。

恭喜你！现在你已经成功安装并配置好了 Composer，可以开始享受现代化 PHP 开发带来的便利了！