Quatre étapes pour vous apprendre à installer et utiliser Composer sur Debian11 !

Cet article est écrit par la rubrique composertutorial pour vous présenter l'installation et l'utilisation étape par étape de Composer sur Debian11. Il est très détaillé~ J'espère qu'il sera utile aux amis qui en ont besoin !

Composer est un outil de gestion des dépendances PHP populaire, principalement pour faciliter l'installation et la mise à jour des dépendances du projet. Composer fonctionne en vérifiant de quels autres packages dépend un projet particulier, puis en les installant pour vous avec les versions appropriées en fonction des exigences du projet. Composer est également couramment utilisé pour démarrer de nouveaux projets basés sur des frameworks PHP populaires tels que Symfony et Laravel.

Dans ce guide, vous installerez et utiliserez Composer sur un serveur Debian 11.

Prérequis

Pour suivre ce tutoriel, vous devez configurer un serveur Debian 11, inclure un utilisateur non root sudo et activer le pare-feu. Vous pouvez le faire en suivant notre guide de configuration initiale du serveur Debian 11. sudo 并启用防火墙。你可以按照我们的Debian 11 初始服务器设置指南来做。

第一步 - 安装依赖项

除了可能已经包含在您的 Debian 11 系统中的依赖项之外，Composer 需要php-cli 来在命令行中执行 PHP 脚本，以及unzip 来提取压缩文件。

首先要更新软件包管理器的缓存。

sudo apt update

接下来，安装依赖项。你将需要curl 来下载Composer，需要php-cli 来安装和运行它。php-mbstring 包是必要的，它为你在本教程中要使用的一个库提供功能。git 被Composer用来下载项目依赖，而unzip 是用来提取压缩包的。所有东西都可以用下面的命令来安装。

sudo apt install curl php-cli php-mbstring git unzip

安装好所有的依赖项后，现在你可以安装Composer了。

第二步 - 下载和安装Composer

Composer提供了一个用PHP编写的安装程序。你将下载它，确认它没有损坏，然后用它来安装Composer。

首先，确保你在你的主目录中。

cd ~

然后，使用curl 检索安装程序。

curl -sS https://getcomposer.org/installer -o composer-setup.php

接下来，验证安装程序是否与Composer公钥/签名页面上的最新安装程序的SHA-384哈希值一致。为了方便验证步骤，你可以使用下面的命令，以编程方式从composer页面获取最新的哈希值，并将其存储在一个shell变量中。

HASH=`curl -sS https://composer.github.io/installer.sig`

要输出获得的值，请运行。

echo $HASH

Output55ce33d7678c5a611085589f1f3ddf8b3c52d662cd01d4ba75c0ee0459970c2200a51f492d557530c71c15d8dba01eae复制代码

现在执行以下PHP代码，如Composer下载页面中提供的，以验证安装脚本是否可以安全运行。

php -r "if 
(hash_file('SHA384', 'composer-setup.php') === '$HASH') { 
echo 'Installer verified'; 
} 
else { echo 'Installer corrupt'; unlink('composer-setup.php'); 
} 
echo PHP_EOL;"

你的输出将是以下内容。

OutputInstaller verified

如果你收到的信息是Installer corrupt ，你需要再次下载安装脚本并验证你使用的是正确的哈希值。然后运行命令，再次验证安装程序。一旦你有一个经过验证的安装程序，你就可以继续了。

要在全局范围内安装composer ，使用下面的命令下载并安装Composer作为全系统的命令，命名为composer 在/usr/local/bin 。

sudo php composer-setup.php --install-dir=/usr/local/bin --filename=composer

你的输出将是以下内容。

OutputAll settings correct for using Composer
Downloading...

Composer (version 2.3.10) successfully installed to: /usr/local/bin/composer
Use it: php /usr/local/bin/composer

通过运行这个命令测试你的安装。

composer

然后你的输出将显示Composer的版本和参数，类似于下面的内容。

Output  ______
  / ____/___  ____ ___  ____  ____  ________  _____
 / /   / __ \/ __ `__ \/ __ \/ __ \/ ___/ _ \/ ___/
/ /___/ /_/ / / / / / / /_/ / /_/ (__  )  __/ /
\____/\____/_/ /_/ /_/ .___/\____/____/\___/_/
                    /_/
Composer version 2.3.10 2022-07-13 15:48:23Usage:
  command [options] [arguments]

Options:
  -h, --help                     Display help for the given command. When no command is given display help for the list command
  -q, --quiet                    Do not output any message
  -V, --version                  Display this application version
      --ansi|--no-ansi           Force (or disable --no-ansi) ANSI output
  -n, --no-interaction           Do not ask any interactive question
      --profile                  Display timing and memory usage information
      --no-plugins               Whether to disable plugins.
      --no-scripts               Skips the execution of all scripts defined in composer.json file.
  -d, --working-dir=WORKING-DIR  If specified, use the given directory as working directory.
      --no-cache                 Prevent use of the cache
  -v|vv|vvv, --verbose           Increase the verbosity of messages: 1 for normal output, 2 for more verbose output and 3 for debug. . .

这就验证了Composer已经成功地安装在你的系统上，并且在整个系统中是可用的。

**注意：**如果你喜欢为你在这台服务器上托管的每个项目都有单独的Composer可执行文件，你可以以每个项目为基础在本地安装它。NPM的用户将熟悉这种方法。当你的系统用户没有权限在全系统安装软件时，这种方法也很有用。

要做到这一点，请使用命令php composer-setup.php 。这将在你的当前目录下生成一个composer.phar 文件，可以用 ./composer.phar command.

现在你已经安装了Composer，在下一步你将学习如何使用Composer来管理PHP的依赖性。

第3步 - 在PHP项目中使用Composer

PHP项目经常依赖外部库，而管理这些依赖关系和它们的版本可能很棘手。Composer通过跟踪你的依赖关系并使其他人更容易安装它们来解决这个问题。

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

你不需要手动创建这个文件，因为这样做很容易出错，可能会导致语法错误。当你使用composer require 命令向你的项目添加一个依赖关系时，Composer会自动生成composer.json

Première étape - Installer les dépendances 🎜En plus des dépendances qui peuvent déjà être incluses sur votre système Debian 11, Composer nécessite php-cli pour s'exécuter Scripts PHP depuis la ligne de commande et décompresser pour extraire les fichiers compressés. 🎜🎜Mettez d’abord à jour le cache du gestionnaire de packages. 🎜

cd ~

🎜 Ensuite, installez les dépendances. Vous aurez besoin de curl pour télécharger Composer et de php-cli pour l'installer et l'exécuter. Le package php-mbstring est requis pour fournir les fonctionnalités d'une bibliothèque que vous utiliserez dans ce didacticiel. git est utilisé par Composer pour télécharger les dépendances du projet, tandis que unzip est utilisé pour extraire les packages compressés. Tout peut être installé à l'aide des commandes suivantes. 🎜

mkdir slugify

🎜Après avoir installé toutes les dépendances, vous pouvez maintenant installer Composer. 🎜

Étape 2 - Télécharger et installer Composer🎜🎜Composer fournit un programme d'installation écrit en PHP. Vous allez le télécharger, vérifier qu'il n'est pas corrompu, puis l'utiliser pour installer Composer. 🎜🎜Tout d’abord, assurez-vous que vous êtes dans votre répertoire personnel. 🎜

cd slugify

🎜Ensuite, utilisez curl pour récupérer l'installateur. 🎜

composer require cocur/slugify

🎜 Ensuite, vérifiez que le programme d'installation correspond au hachage SHA-384 du dernier programme d'installation sur la page Clé publique/signature du compositeur. Pour faciliter l'étape de vérification, vous pouvez utiliser la commande suivante pour obtenir par programme la dernière valeur de hachage de la page du compositeur et la stocker dans une variable shell. 🎜

OutputUsing version ^4.1 for cocur/slugify
./composer.json has been created
Running composer update cocur/slugify
Loading composer repositories with package information
Updating dependencies
Lock file operations: 1 install, 0 updates, 0 removals
  - Locking cocur/slugify (v4.1.0)
Writing lock file
Installing dependencies from lock file (including require-dev)
Package operations: 1 install, 0 updates, 0 removals
  - Downloading cocur/slugify (v4.1.0)
  - Installing cocur/slugify (v4.1.0): Extracting archive
Generating autoload files

🎜Pour afficher les valeurs obtenues, exécutez. 🎜

ls -l

Outputtotal 12-rw-r--r-- 1 sammy sammy   59 Aug  2 22:19 composer.json-rw-r--r-- 1 sammy sammy 3462 Aug  2 22:19 composer.lockdrwxr-xr-x 4 sammy sammy 4096 Aug  2 22:19 vendor

🎜 Exécutez maintenant le code PHP suivant, tel que fourni dans la page de téléchargement de Composer, pour vérifier que le script d'installation peut s'exécuter en toute sécurité. 🎜

cat composer.json

🎜Votre résultat sera le suivant. 🎜

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

🎜Si vous recevez le message Installateur corrompu, vous devez télécharger à nouveau le script d'installation et vérifier que vous utilisez le hachage correct. Exécutez ensuite la commande pour vérifier à nouveau le programme d’installation. Une fois que vous avez un installateur vérifié, vous êtes prêt à continuer. 🎜🎜Pour installer composer globalement, utilisez la commande suivante pour télécharger et installer Composer en tant que commande à l'échelle du système nommée composer dans /usr/local/ bin code>. 🎜<div class="code" style="position:relative; padding:0px; margin:0px;"><div class="code" style="position:relative; padding:0px; margin:0px;"><pre class="brush:php;toolbar:false">nano test.php</pre><div class="contentsignin">Copier après la connexion</div></div><div class="contentsignin">Copier après la connexion</div></div>🎜Votre résultat sera le suivant. 🎜<div class="code" style="position:relative; padding:0px; margin:0px;"><div class="code" style="position:relative; padding:0px; margin:0px;"><pre class="brush:php;toolbar:false">&lt;?php require __DIR__ . &amp;#39;/vendor/autoload.php&amp;#39;; use Cocur\Slugify\Slugify;$slugify = new Slugify();echo $slugify-&gt;slugify('Hello World, this is a long sentence and I need to make a slug from it!');</pre><div class="contentsignin">Copier après la connexion</div></div><div class="contentsignin">Copier après la connexion</div></div>🎜 Testez votre installation en exécutant cette commande. 🎜<div class="code" style="position:relative; padding:0px; margin:0px;"><div class="code" style="position:relative; padding:0px; margin:0px;"><pre class="brush:php;toolbar:false">php test.php</pre><div class="contentsignin">Copier après la connexion</div></div><div class="contentsignin">Copier après la connexion</div></div>🎜Ensuite, votre sortie affichera la version et les paramètres de Composer, similaires à ce qui est ci-dessous. 🎜<div class="code" style="position:relative; padding:0px; margin:0px;"><div class="code" style="position:relative; padding:0px; margin:0px;"><pre class="brush:php;toolbar:false">Outputhello-world-this-is-a-long-sentence-and-i-need-to-make-a-slug-from-it</pre><div class="contentsignin">Copier après la connexion</div></div><div class="contentsignin">Copier après la connexion</div></div>🎜Cela vérifie que Composer a été installé avec succès sur votre système et qu'il est disponible dans tout le système. 🎜🎜**REMARQUE :** Si vous préférez avoir un exécutable Composer distinct pour chaque projet que vous hébergez sur ce serveur, vous pouvez l'installer localement pour chaque projet. Les utilisateurs de NPM connaîtront cette approche. Cette méthode est également utile lorsque l'utilisateur de votre système n'est pas autorisé à installer des logiciels à l'échelle du système. 🎜🎜Pour cela, utilisez la commande <code>php composer-setup.php. Cela générera un fichier composer.phar dans votre répertoire actuel. Vous pouvez utiliser la commande ./composer.phar.🎜🎜Maintenant que Composer est installé, dans la prochaine étape. étape Vous apprendrez à utiliser Composer pour gérer les dépendances PHP. 🎜

Étape 3 - Utiliser Composer dans les projets PHP 🎜🎜Les projets PHP s'appuient souvent sur des bibliothèques externes, et la gestion de ces dépendances et de leurs versions peut être délicate. Composer résout ce problème en suivant vos dépendances et en permettant aux autres de les installer plus facilement. 🎜🎜Pour utiliser Composer dans votre projet, vous avez besoin d'un fichier composer.json. Le fichier composer.json indique à Composer les dépendances qu'il doit télécharger pour votre projet et les versions de chaque package qu'il est autorisé à installer. Ceci est important pour maintenir la cohérence de votre projet et éviter d'installer une version instable qui pourrait entraîner des problèmes de rétrocompatibilité. 🎜🎜Vous n'avez pas besoin de créer ce fichier manuellement car cela est sujet aux erreurs et peut entraîner des erreurs de syntaxe. Lorsque vous utilisez la commande composer require pour ajouter une dépendance à votre projet, Composer génère automatiquement un fichier composer.json. Vous pouvez ajouter des dépendances supplémentaires en utilisant la même méthode sans modifier manuellement ce fichier. 🎜

使用Composer在项目中安装一个包作为依赖的过程包括以下步骤。

• 确定应用程序需要什么样的库。
• 在Packagist.org（Composer的官方软件包库）上研究一个合适的开源库。
• 选择你想依赖的软件包。
• 运行composer require ，在composer.json 文件中包含该依赖性，并安装该软件包。

你可以用一个演示应用程序来测试一下。

这个应用程序的目标是将一个给定的句子转换成一个叫做slug的URL友好字符串。slug通常用于将页面标题转换为URL路径，例如本教程中URL的最后部分。

首先导航到你的主目录。

cd ~

然后创建一个目录。将其称为slugify 。

mkdir slugify

创建完毕后，换到该目录中。

cd slugify

现在是时候在Packagist.org上搜索一个可以帮助生成蛞蝓的软件包。如果你在Packagist上搜索 "slug "这个词，你会得到一个与下面类似的结果。

列表中每个软件包的右侧会有两个数字。箭头朝下的图标旁边的数字代表该软件包被安装了多少次，而带星形图标的数字代表软件包在GitHub上被加了多少次星。你还可以根据这些数字对搜索结果重新排序。一般来说，安装次数多、星级多的软件包往往更稳定，因为有很多人在使用它们。检查软件包的描述是否相关也很重要，以确保它是你所需要的。

对于这个教程，你需要一个字符串到蛞蝓的转换器。从搜索结果来看，软件包cocur/slugify 是一个很好的匹配，有合理数量的安装和星级。

Packagist上的软件包有一个供应商名称和一个软件包名称。每个包都有一个唯一的标识符（命名空间），其格式与GitHub用于其存储库的格式相同，即 vendor/package.你要安装的库使用命名空间cocur/slugify 。你需要这个命名空间，以便在你的项目中需要该包。

现在你知道了你要安装的软件包，运行composer require ，把它作为一个依赖项包括进去，同时为项目生成composer.json 文件。

composer require cocur/slugify

当Composer下载依赖关系时，你的输出将返回如下。

OutputUsing version ^4.1 for cocur/slugify
./composer.json has been created
Running composer update cocur/slugify
Loading composer repositories with package information
Updating dependencies
Lock file operations: 1 install, 0 updates, 0 removals
  - Locking cocur/slugify (v4.1.0)
Writing lock file
Installing dependencies from lock file (including require-dev)
Package operations: 1 install, 0 updates, 0 removals
  - Downloading cocur/slugify (v4.1.0)
  - Installing cocur/slugify (v4.1.0): Extracting archive
Generating autoload files

正如这个输出所表明的，Composer会自动决定使用哪个版本的软件包。如果你现在检查你的项目目录，它将包含两个新文件：composer.json 和composer.lock ，以及一个vendor 目录。

ls -l

Outputtotal 12-rw-r--r-- 1 sammy sammy   59 Aug  2 22:19 composer.json-rw-r--r-- 1 sammy sammy 3462 Aug  2 22:19 composer.lockdrwxr-xr-x 4 sammy sammy 4096 Aug  2 22:19 vendor

composer.lock 文件是用来存储每个已安装软件包的版本信息的。它也确保在别人克隆你的项目并安装其依赖项时使用相同的版本。vendor 目录是项目依赖项所在的地方。vendor 文件夹不需要提交到版本控制中，你只需要包括composer.json 和composer.lock 文件。

当安装一个已经包含composer.json 文件的项目时，运行composer install ，以便下载项目的依赖项。

接下来，查看版本约束。如果你检查你的composer.json 文件的内容，你会有类似下面的内容。

cat composer.json

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

你可能会注意到在composer.json 的版本号之前有一个特殊的字符^ 。Composer支持几种不同的约束和格式来定义所需的软件包版本，以提供灵活性，同时也保持你的项目稳定。自动生成的composer.json 文件所使用的圆点(^)运算符是推荐的运算符，以实现最大的互操作性，遵循语义版本学。在这种情况下，它将4.1定义为最小兼容版本，并允许更新到5.0以下的任何未来版本。

一般来说，你不需要在你的composer.json 文件中篡改版本约束。然而，有些情况可能需要你手动编辑约束。例如，当你所需要的库的一个主要新版本发布时，你想要升级，或者当你想要使用的库不遵循语义版本划分时。

下面是一些例子，让你更好地了解Composer版本约束的工作方式。

约束	意义	允许的版本示例
^1.0	>= 1.0 < 2.0	1.0, 1.2.3, 1.9.9
^1.1.0	>= 1.1.0 < 2.0	1.1.0, 1.5.6, 1.9.9
~1.0	>= 1.0 < 2.0.0	1.0, 1.4.1, 1.9.9
~1.0.0	>= 1.0.0 < 1.1	1.0.0, 1.0.4, 1.0.9
1.2.1	1.2.1	1.2.1
1.*	>= 1.0 < 2.0	1.0.0, 1.4.5, 1.9.9
1.2.*	>= 1.2 < 1.3	1.2.0, 1.2.3, 1.2.9

要想更深入地了解Composer的版本约束，请查阅官方文档。

接下来，你将学习如何用Composer自动加载依赖项。

第四步 - 包括自动加载脚本

由于PHP本身不会自动加载类，Composer提供了一个自动加载脚本，你可以把它包含在你的项目中，让自动加载发挥作用。这在处理你的依赖关系时很有帮助。

你唯一需要做的是在任何类实例化之前在你的PHP脚本中包含vendor/autoload.php 文件。这个文件在你添加第一个依赖项时由Composer自动生成。

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

nano test.php

添加以下代码，引入vendor/autoload.php 文件，加载cocur/slugify 依赖关系，并创建一个slug。

test.php

<?php
require __DIR__ . &#39;/vendor/autoload.php&#39;; 
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 和ENTER 来完成。

现在运行该脚本。

php test.php

这将产生以下输出。

Outputhello-world-this-is-a-long-sentence-and-i-need-to-make-a-slug-from-it

当新版本出来时，依赖关系需要更新，所以你将在最后一步中学习如何处理这个问题。

第5步 - 更新项目的依赖关系

每当你想把你的项目依赖关系更新到最新的版本时，运行update 命令。

composer update

这将检查你在项目中作为需求添加的库的较新版本。如果发现一个新的版本，并且它与composer.json 文件中定义的版本约束兼容，Composer将替换之前安装的版本。composer.lock 文件将被更新以反映这些变化。

你也可以像下面这样指定一个或多个特定的库来更新它们。

composer update vendor/package vendor2/package2

请确保在你更新你的依赖关系后提交你的composer.json 和composer.lock 文件的变化，这样无论谁在项目中工作，都可以访问相同的软件包版本。

总结

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

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

Ce qui précède est le contenu détaillé de. pour plus d'informations, suivez d'autres articles connexes sur le site Web de PHP en chinois!