Composer 安装与配置详解

Composer 是 PHP 的依赖管理工具，它能够帮助开发者轻松地管理和安装项目所需的库。本文将详细介绍如何在不同操作系统上安装和配置 Composer，并提供一些常用的 Composer 命令。

0. 前言

Composer 允许你在项目中声明所需的库，并自动下载和管理这些库及其依赖关系。无论是 Windows、Linux 还是 macOS，都可以方便地安装和使用 Composer。

1. 在 Windows 上安装 Composer

步骤 1: 下载并运行安装程序

1. 访问 Composer 官方下载页面，下载 Composer-Setup.exe。
2. 运行下载的安装程序，并按照提示完成安装。安装程序会自动设置环境变量，使你可以在命令行中任何位置使用 composer 命令。

步骤 2: 验证安装

打开命令提示符窗口，输入以下命令来验证 Composer 是否正确安装：

composer --version

如果安装成功，命令会输出 Composer 的版本号。

2. 在 Unix/Linux/macOS 上安装 Composer

使用本地安装方式

1. 打开终端。

2. 运行以下命令来下载 composer.phar 文件，并验证其完整性：

   php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
   php -r "if (hash_file('sha384', 'composer-setup.php') === '<hash_value>') { echo 'Installer verified'; } else { echo 'Installer corrupt'; unlink('composer-setup.php'); } echo PHP_EOL;"
   php composer-setup.php
   php -r "unlink('composer-setup.php');"

   注意：<hash_value> 需要替换为官网提供的最新哈希值，用于验证下载文件的真实性。

3. 将下载的 composer.phar 文件存放到任意目录，执行 PHP 命令的时候指明路径即可。

使用全局安装方式

1. 如果需要将 Composer 安装为全局命令，可以将 composer.phar 移动到统一的可执行目录下，并创建一个别名：

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

2. 确保 /usr/local/bin/ 目录在你的 PATH 环境变量中。可以通过编辑 .bashrc 或 .zshrc 文件来添加路径：

   export PATH=$PATH:/usr/local/bin

3. 通过直接运行 composer 命令来使用 Composer。

验证安装

无论使用哪种安装方法，都可以通过运行以下命令来测试 Composer 是否正确安装：

composer --version

如果安装成功，命令会输出 Composer 的版本号。

3. 配置 Composer

创建 composer.json 文件

Composer 的主配置文件是 composer.json，位于项目根目录。你可以手动创建这个文件，也可以通过如下命令生成：

composer init

此命令会通过一系列提示引导你创建 composer.json 文件。

配置 composer.json 文件

在 composer.json 文件中，主要关注以下几个区域：

• require: 列出项目的依赖包和版本。
• require-dev: 列出开发时的依赖。
• autoload: 设置自动加载机制，使得项目可以自动加载 PHP 类。

示例 composer.json 文件：

{
    "name": "your/project-name",
    "description": "A description of your project.",
    "keywords": ["keyword1", "keyword2"],
    "license": "MIT",
    "type": "project",
    "require": {
        "php": ">=7.4",
        "monolog/monolog": "^2.0"
    },
    "require-dev": {
        "phpunit/phpunit": "^9.0"
    },
    "autoload": {
        "psr-4": {
            "App\\": "src/"
        }
    }
}

安装和更新依赖

配置好 composer.json 后，通过运行以下命令安装依赖：

composer install

或者更新依赖：

composer update

4. 常用 Composer 命令

升级 Composer 版本

composer self-update

查看全局配置

composer config -gl

安装依赖

composer install

更新依赖

composer update

添加依赖

composer require monolog/monolog

移除依赖

composer remove monolog/monolog

搜索包

composer search monolog

显示已安装的包

composer show

更换中国镜像源

为了加快下载速度，可以更换为国内的镜像源：

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

取消镜像源修改：

composer config -g --unset repos.packagist

通过以上步骤，你应该能够在不同的操作系统上成功安装和配置 Composer，并掌握一些常用的 Composer 命令。希望这篇文章对你有所帮助！