Debian 11 安装 Composer：详细教程与使用指南

注意：如果您希望在这台服务器上为每个项目使用独立的Composer可执行文件，可以在每个项目基础上本地安装它。NPM的用户应该对这种方法很熟悉。当您的系统用户没有权限在整个系统中安装软件时，这种方法也很有用。
要实现这一点，请使用命令 php composer-setup.php。这将在当前目录中生成一个 composer.phar 文件，可以使用 ./composer.phar 命令执行。现在您已经安装了Composer，在下一步中，您将学习如何使用Composer来管理PHP依赖项。

第三步 – 在PHP项目中使用Composer

PHP项目经常依赖于外部库，管理这些依赖库及其版本可能会很棘手。Composer通过跟踪您的依赖关系并使其更易于他人安装，解决了这个问题。

为了在项目中使用Composer，您需要一个 composer.json 文件。composer.json 文件告诉Composer需要为您的项目下载哪些依赖项，以及可安装的每个软件包的版本。这对于保持项目一致性、避免安装可能导致向后兼容性问题的不稳定版本非常重要。

您不需要手动创建这个文件，因为这样做容易出错且可能会导致语法错误。当您使用 composer 命令添加依赖项到您的项目时，Composer会自动生成 composer.json 文件。您可以通过相同的方式添加其他依赖项，无需手动编辑这个文件。

使用Composer在项目中安装依赖包的过程包括以下步骤：

• 识别应用程序需要哪种类型的库。
• 在Packagist.org（Composer的官方包仓库）上研究合适的开源库。
• 选择您想要依赖的软件包。
• 运行 composer require 命令将依赖项添加到 composer.json 文件并安装软件包。

您可以用演示应用程序测试一下。

这个应用的目标是将给定的句子转换为一个适用于URL的字符串，称为“slug”。slug通常用于将页面标题转换为URL路径，例如本教程的URL的最后一部分。

从开始菜单中进入您的用户文件夹：

1. cd ~

然后创建一个名为 slugify 的目录。

1. mkdir slugify

创建完成后，请切换到该目录。

1. cd slugify

现在是时候在Packagist.org上搜索一个能够帮助生成简洁URL的软件包了。如果您在Packagist上搜索“slug”，您会得到一个类似以下的结果。

列表中的每个软件包右侧会显示两个数字。箭头向下的图标旁边的数字表示该软件包被安装的次数，星星图标旁边的数字表示该软件包在 GitHub 上被标星的次数。您也可以根据这些数字重新排序搜索结果。一般来说，安装次数和标星次数更多的软件包更加稳定，因为有很多人在使用。同时，检查软件包描述也很重要，以确保它符合您的需求。

为了这个教程，您需要一个将字符串转换成slug的工具。从搜索结果来看，cocur/slugify 这个包是一个很好的选择，安装量和星级评价都相当合理。

Packagist上的软件包具有供应商名称和软件包名称。每个软件包都有一个唯一的标识符（命名空间），格式与GitHub用于其代码库的格式相同，为 供应商/软件包。您想要安装的库使用命名空间 cocur/slugify。您需要命名空间以便在您的项目中引用该软件包。

现在您知道要安装的包，运行 composer require 命令来将其作为依赖项包含进来，并生成项目的 composer.json 文件。

1. composer require cocur/slugify

当Composer下载完依赖项时，您的输出将返回以下内容。

使用版本 ^4.1 的 cocur/slugify。./composer.json 文件已创建。正在运行 composer update cocur/slugify。

加载 Composer 仓库信息。

更新依赖项：

• 锁定文件操作：1 个安装，0 个更新，0 个移除
• 锁定 cocur/slugify (v4.1.0)

正在写入锁定文件。

正在从锁定文件安装依赖项（包括开发依赖）：

• 包操作：1 个安装，0 个更新，0 个移除
• 下载 cocur/slugify (v4.1.0)
• 安装 cocur/slugify (v4.1.0)：正在解压归档文件

正在生成自动加载文件。

根据此输出，Composer 会自动决定要使用的软件包版本。如果您现在检查项目目录，将会包含两个新文件：composer.json 和 composer.lock，以及一个 vendor 目录。

1. ls -l

composer.lock 文件用于存储每个已安装软件包的版本信息。它还确保当有人克隆您的项目并安装其依赖项时，使用的是相同的版本。vendor 目录是项目依赖项的存放位置。vendor 文件夹不需要提交到版本控制中，您只需要包含 composer.json 和 composer.lock 文件即可。

{
  "require": {
    "cocur/slugify": "^4.1"
  }
}

第四步 – 引入自动加载脚本

由于 PHP 本身不会自动加载类，Composer 提供了一个自动加载脚本，你可以将其包含在项目中，以使自动加载正常工作。这有助于在处理依赖关系时使用。

只需要在您的 PHP 脚本中，在任何类实例化之前包含 vendor/autoload.php 文件即可。当您添加第一个依赖项时，Composer 会自动生成这个文件。

您可以在您的应用程序中测试它。创建 test.php 文件，并在您喜欢的文本编辑器中打开它。这里使用的是 nano。

1. nano test.php

将以下代码添加到项目中，引入 vendor/autoload.php 文件，加载 cocur/slugify 依赖项，并创建 slug。

<?php

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

use Cocur\Slugify\Slugify;

$slugify = new Slugify();

echo $slugify->slugify('Hello World!'); // 输出: hello-world

?>

<?php
require __DIR__ . '/vendor/autoload.php'; 
use Cocur\Slugify\Slugify;

$slugify = new Slugify();

echo $slugify->slugify('Hello World, this is a long sentence and I need to make a slug from it!');

保存文件并退出编辑器。如果你正在使用nano编辑器，可以通过按下 CTRL + X，然后按 Y 和回车键来实现。

现在运行脚本。

1. php test.php

这将产生以下输出：

当新版本发布时，依赖需要更新，所以你将在最后一步学习如何处理它们。

步骤5 — 更新项目依赖

当你想要将项目依赖更新到最新版本时，请运行更新命令。

1. composer update

这将检查您在项目中添加为要求的库的较新版本。如果找到一个较新的版本，并且它与 composer.json 文件中定义的版本限制兼容，Composer 将替换之前安装的版本。composer.lock 文件将被更新以反映这些更改。

您还可以通过以下方式指定更新一个或多个特定的库：

1. composer update vendor/package vendor2/package2

更新依赖后，务必将更改提交到你的 composer.json 和 composer.lock 文件中，这样项目中的其他人才能得到相同的软件包版本。

结论

Composer 是每个 PHP 开发者都应该拥有的强大工具。在本教程中，你在 Debian 11 上安装了 Composer 并将其用于一个项目中。现在你知道如何安装和更新依赖项了。

除了提供一种可靠的管理项目依赖关系的方法外，Composer 还为共享和发现社区创建的 PHP 包建立了新的标准。