本页内容
- 前提条件
- 更新系统
- 在 Rocky Linux 8.4 上安装 PHP
- 在 Rocky Linux 8.4 上安装 PHP Composer
- 测试 PHP Composer
- 结论
PHP Composer 是 PHP 使用最广泛的依赖管理器。它可以让你声明项目所需的依赖,并会替你管理(安装/更新)这些依赖。
下载、安装和更新依赖可能是一件麻烦事,还可能让你无法专心编写代码。依赖管理器会替你处理这些事务,让开发工作更轻松。
在 Composer 出现之前,管理项目依赖有几种不同的选择,例如 PEAR 和 PHP Package Manager。如今,Composer 已成为 PHP 依赖管理事实上的标准。
如果你仍在使用 PEAR 或 PHP Package Manager,那么或许是时候做出改变了。使用 Composer 有以下几个理由:
- 它用 PHP 编写,无需安装额外软件(如 Python)
- 它同时支持全局包和本地/私有包
- 已有成千上万的库和应用程序依赖它,因此使用 Composer 后,你可以轻松找到各种包和更新。
前提条件
要在 Rocky Linux 8.4 上安装 PHP Composer,你需要满足以下条件:
- 系统上已安装 PHP 5.3 或更高版本(且必须能够运行 Phar 扩展)。
- 安装需要 root 权限。
更新系统
在进行其他操作之前,请确保系统软件包都是最新的。运行以下命令更新系统软件包。
sudo dnf check-update
sudo dnf update -y
在 Rocky Linux 8.4 上安装 PHP
在安装 composer 之前,你需要在系统上安装 PHP 和 PHP 解释器。
默认情况下,AppStream 仓库自带 PHP 7.2、7.3 和 7.4。你可以运行下面的命令列出所有可用的 PHP 版本。
sudo dnf module list php
你将看到如下所示的输出。

在本指南中,我们将安装 PHP 7.4。你应当选择适合自身需求的 PHP 版本,不过请务必不仅依据本指南,还要依据诸如此类的兼容性报告来做出决定。
运行以下命令启用并安装 PHP 7.4。
sudo dnf module enable php:7.4
sudo dnf install php php-cli php-gd php-curl php-zip -y
sudo dnf install php-mbstring php-opcache php-intl php-mysqlnd -y
现在可以运行此命令来检查 PHP 是否已正确安装。
php -v
你应当会得到以下输出。

在 Rocky Linux 8.4 上安装 PHP Composer
现在系统上已经安装了某个版本的 PHP,你可以用它来下载并安装 Composer 二进制文件。
首先,运行以下命令下载最新版本的 Composer。
php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
接下来,我们将验证下载的文件没有损坏。我们应当始终验证下载的文件,以确保它没有损坏。Composer 可能非常敏感,错误可能会影响你使用 Composer 的方式。执行以下代码来验证安装程序文件没有损坏。
HASH=`curl -sS https://composer.github.io/installer.sig`
echo $HASH
php -r "if (hash_file('SHA384', '/tmp/composer-setup.php') === '$HASH') { echo 'Installer verified'; } else { echo 'Installer corrupt'; unlink('composer-setup.php'); } echo PHP_EOL;"
验证成功时,你应当会看到如下所示的文本“Installer verified”。如果没有得到预期的输出,文件很可能已损坏,你应当尝试重新下载。然后重复验证过程,直到得到预期的“Installer verified”输出。

现在你有两种在系统上安装 Composer 的方式。
方式 1 是在系统上全局安装 Composer,这意味着它可以从系统的任何目录访问,并可在任何位置使用。如果你想把 composer 用作命令行工具,而不只是作为 PHP 项目的依赖管理器,就选择这种方式。
如果选择这种方式,请运行以下命令。
sudo php composer-installer.php --filename=composer --install-dir=/usr/local/bin
上述命令会在 /usr/local/bin 中全局安装 Composer,命令名为 composer。
现在可以运行此命令来检查 Composer 是否已正确安装。
composer
你应当会得到以下输出。

方式 2 是在当前目录本地安装 Composer,使其仅供这个特定项目使用。
要本地安装 Composer,请运行以下命令。
sudo php composer-setup.php
上述命令会在当前目录本地安装 Composer,使其仅供这个特定项目使用。你可以通过运行 ./composer.phar
测试 PHP Composer
现在你已经安装了 Composer,可以用它创建一个新项目来测试 Composer 的安装。
一条经验法则是,你应当始终为所处理的每个项目创建单独的目录。运行以下命令为测试项目创建一个新目录,并进入新创建的目录。
cd && mkdir php-composer-test && cd php-composer-test
现在可以运行以下命令,用 Composer 初始化一个新项目。
composer init
上述命令会按照你选择的所有细节初始化一个新项目。

composer init 命令还会在当前目录创建一个新的 composer.json 文件,如下所示。这是一个 JSON 格式的文件,包含项目的全部需求。Composer 使用该文件为你的项目安装所需的依赖。

现在是时候为项目加载一个包了。前往 https://packagist.org,搜索一个要安装到项目中的包。
例如,如果你想安装 Remove Stop Words 包,它可以帮助我们从字符串中移除停用词。如果你在 Packagist 上搜索“Remove Stop Words”这个词条,应当会看到如下结果。

要添加新包,请运行 composer require 命令,并选择要加载到当前项目的包(不带任何版本)。
composer require rap2hpoutre/remove-stop-words
Composer 会自动决定使用该包的哪个版本。Composer 会从 Packagist 把包下载到当前目录,并解压该包的内容。
它还会用这个新包的详细信息更新 composer.json 文件。它还会创建一个新文件 composer.lock,以及一个新的 vendor 目录,如下所示。

Composer 使用 composer.lock 文件锁定当前项目中已安装的包版本。该文件用于避免与同一包的其他安装产生冲突,或在你克隆项目时避免冲突。vendor 目录包含项目的所有依赖。
要更新项目依赖,请运行 composer update 命令。Composer 会先查看 composer.lock 文件,弄清已安装的包版本,然后用 Packagist 上可用的最新版本更新该包。
composer update
示例输出:

要更新特定的包,请运行以下命令。
composer update vendor/package
要移除特定的包,请运行以下命令。
composer remove vendor/package
例如,如果你不再需要 Remove Stop Words 包,可以运行以下命令将它从项目中卸载。
composer remove rap2hpoutre/remove-stop-words
示例输出:

注意:强烈建议不要删除 vendor 目录或其内容,因为该目录包含运行应用程序所需通过 Composer 安装的所有依赖。
结论
在本文中,你学习了如何在 Rocky Linux 8.4 上安装 PHP 依赖管理器 PHP Composer,以初始化新项目、加载新包、更新已有包或将其从项目中卸载。你还学习了一些用于管理项目依赖的基本 Composer 命令。
如果你有任何问题或反馈,请在下方留言。