Composer是一个在PHP中进行依赖关系管理的工具。它允许您申报项目所依赖的库,它将管理(安装/更新)它们为你。
依赖关系管理#
作曲家是不与百胜或Apt一样的软件包管理器。对,它处理“包”或库,但它在一个纯项目上管理它们基础,将其安装在目录中(例如。小贩
)在您的项目中。由默认情况下,它不会全局安装任何内容。因此,它是一个依赖项经理。然而,为了方便起见,它确实通过全球性的命令。
这个想法并不新鲜,作曲家受到了节点的强烈启发净现值和鲁比的捆扎机.
假设:
- 您的项目依赖于许多库。
- 其中一些库依赖于其他库。
作曲家:
- 允许您声明所依赖的库。
- 找出可以安装和需要安装哪些软件包的版本,以及安装它们(意味着它会将它们下载到您的项目中)。
- 您可以在一个命令中更新所有依赖项。
请参阅基本用途有关声明的更多详细信息,请参见第章依赖关系。
系统要求#
最新版本的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,可以使用它了!前往下一章是简短的演示。
基本用途→
发现打字错误了吗?此文档中有问题吗?分叉和编辑它!