介绍#

Composer是一个在PHP中进行依赖关系管理的工具。它允许您申报项目所依赖的库,它将管理(安装/更新)它们为你。

依赖关系管理#

作曲家是与百胜或Apt一样的软件包管理器。对,它处理“包”或库,但它在一个纯项目上管理它们基础,将其安装在目录中(例如。小贩)在您的项目中。默认情况下,它不会全局安装任何内容。因此,它是一个依赖项经理。然而,为了方便起见,它确实通过全球性的命令。

这个想法并不新鲜,作曲家受到了节点的强烈启发净现值和鲁比的捆扎机.

假设:

  1. 您的项目依赖于许多库。
  2. 其中一些库依赖于其他库。

作曲家:

  1. 允许您声明所依赖的库。
  2. 找出可以安装和需要安装哪些软件包的版本,以及安装它们(意味着它会将它们下载到您的项目中)。
  3. 您可以在一个命令中更新所有依赖项。

请参阅基本用途有关声明的更多详细信息,请参见第章依赖关系。

系统要求#

最新版本的Composer需要运行PHP7.2.5。长期支持版本(2.2.x)仍然提供对PHP 5.3.2+的支持,以防您陷入困境遗留PHP版本。还有一些敏感的php设置和编译标志需要,但在使用安装程序时,会警告您不相容性。

Composer需要几个支持应用程序才能有效工作更高效地处理包依赖性的过程。用于减压文件,Composer依赖于以下工具7赫兹(或7岁),gzip公司,焦油,unrar公司,解压缩x赫兹对于版本控制系统,Composer无缝集成使用Fossil、Git、Mercurial、Perforce和Subversion,从而确保应用程序对图书馆存储库的平稳操作和管理。之前使用Composer,确保这些依赖项正确安装在系统。

Composer是多平台的,我们努力使它在Windows上运行得同样好,Linux和macOS。

安装-Linux/Unix/macOS#

下载Composer可执行文件#

Composer提供了一个方便的安装程序,您可以直接从命令行。请随意下载此文件或在上查看github如果您想了解更多有关安装程序内部工作的信息。来源是普通PHP。

简而言之,有两种安装Composer的方法。本地作为您的项目,或全局作为系统范围的可执行文件。

本地#

要在本地安装Composer,请在项目目录中运行安装程序。请参见下载页面以获取说明。

安装程序将检查一些PHP设置,然后下载作曲家.phar到您的工作目录。此文件是Composer二进制文件。这是一个PHAR(PHP存档),这是PHP的存档格式,可以在命令行等。

现在运行php作曲家.phar以运行Composer。

您可以使用--安装直径选项,并使用--文件名选项。什么时候?在执行以下操作时运行安装程序下载页面说明添加以下参数:

php作曲家-setup.php--install-dir=bin--filename=composer

现在运行php-bin/作曲家以便运行Composer。

全球#

您可以将Composer PHAR放置在任何您想要的位置。如果你把它放在一个目录中这是你的一部分路径,您可以全局访问它。在Unix系统上,您可以甚至可以使其可执行并调用,而无需直接使用php(电话)口译员。

在运行以下安装程序之后下载页面说明您可以运行此命令将composer.phar移动到路径中的目录:

mv作曲家.phar/usr/local/bin/composer

如果您只想为您的用户安装,并且避免需要root权限,你可以使用~/.本地/bin而在某些Linux发行版。

注:如果上述操作因权限问题而失败,您可能需要再次运行具有苏多.

注:在某些版本的macOS上/用户使用程序目录不存在于违约。如果收到错误“/usr/local/bin/composer:No such file ordirectory”,则必须在继续之前手动创建目录:mkdir-p/usr/local/bin.

注:有关更改PATH的信息,请阅读维基百科文章和/或使用您选择的搜索引擎。

现在运行作曲家为了运行Composer而不是php作曲家.phar.

安装-Windows#

使用安装程序#

这是在计算机上设置Composer的最简单方法。

下载并运行编写器-Setup.exe。它会的安装最新的Composer版本并设置PATH,以便您可以呼叫作曲家从命令行中的任何目录。

注:关闭当前终端。使用新终端测试使用情况:这是这很重要,因为PATH只有在终端启动时才被加载。

手动安装#

更改到您的路径并按照以下步骤运行安装程序下载页面说明下载作曲家.phar.

创建新的作曲家.bat旁边的文件作曲家.phar以下为:

使用cmd.exe:

C: \bin>echo@php“%~dp0composer.phar”%*>composer.bat

使用PowerShell:

PS C:\bin>设置内容作曲家.bat'@php“%~dp0composer.phar”%*'

如果尚未将目录添加到PATH环境变量中,请将其添加到该环境变量中。有关更改PATH变量的信息,请参阅这篇文章和/或使用您选择的搜索引擎。

关闭当前终端。测试新终端的使用情况:

C: \Users\username>作曲家-V
作曲家版本2.4.0 2022-08-16 16:10:48

Docker图像#

Composer在一些地方发布为Docker容器,请参阅作曲家/docker自述文件.

示例用法:

docker pull作曲家/作曲家docker运行--rm-it-v“$(pwd):/app”composer/composer安装

将Composer添加到现有Dockerfile文件您可以简单地从预先构建的低大小图像中复制二进制文件:

#最新版本COPY--from=composer/composer:latest-bin/composer/usr/bin/compose#特定版本COPY--from=composer/composer:2-bin/compose/usr/bin/composer

阅读图像描述了解更多使用信息。

注:Docker特定问题应提交关于composer/docker存储库.

注:您也可以使用作曲家而不是作曲家/作曲家作为上面的图像名称。它更短,是Docker的官方图片,但不是由我们直接发布的,因此通常会延迟几天发布新版本。重要:短别名图像没有仅二进制的等价物,因此对于副本--来自更好地使用作曲家/作曲家个。

使用作曲家#

现在您已经安装了Composer,可以使用它了!前往下一章是简短的演示。

基本用途

发现打字错误了吗?此文档中有问题吗?分叉和编辑它!