PHP Composer知识库

概述

Artifactory支持PHP的作曲家存储库建立在其现有的高级工件管理支持之上。

对Composer的Artifactory支持提供:

将所有存储库类型的Composer包从Artifactory配置到Composer命令行工具。
为托管在Artifactory本地存储库中的Composer包计算元数据。
通过远程存储库访问远程Composer元数据存储库(Packagist和Artifactory Composer存储库)和包存储库(如Github, Bitbucket等)远程存储库提供代理和缓存功能。
根据项目或开发团队分配访问权限。
支持PHP Composer版本1和2 (虚拟存储库仅支持Composer版本2)，
支持从远程存储库下载Drupal 7和8版文件．

页面内容

集成的好处

JFrog Artifactory和PHP Composer库

配置

局部存储库

要启用Composer包元数据的计算，请从政府模块，转到存储库|存储库|本地并设置PHP作曲家成为包类型当您创建本地Composer存储库时。

Composer v2支持

除了V1, Artifactory还支持PHP Composer V2。从Artifactory 7.24.1 (SaaS版本)开始，本地PHP存储库将自动在V2这支持更快的下载时间和更强的性能。
PHP Metadata V2索引支持本地存储库，并遵循以下规则:

您现有的Composer存储库将保持不变，启用Composer V1 Indexing复选框将设置为默认值。
从这个Artifactory版本及以上版本开始，所有新创建的Composer存储库都将设置为Composer version 2。“启用作曲器V1索引”字段被禁用。

V1索引可以在本地基本存储库配置中启用或禁用，并且在应用更改后需要完全重新索引。

部署Composer包

Composer客户端没有提供部署包的方法，而是依赖于源代码控制存储库来托管Composer包代码。要将Composer包部署到Artifactory中，您需要使用Artifactory REST API或者是Web UI．

Composer包通常是一个简单的存档邮政编码或者一个tar.gz文件，其中包含项目代码以及composer.json描述包的文件。

版本

为了让Artifactory索引您上传的包，每个包必须指定它的版本。有三种方法指定包版本:

包括版本包中的属性composer.json文件
设置一个composer.version通过REST(或在现有包上)部署包时的属性
使用版本字段，当通过UI部署时

远程存储库

的公共Composer存储库不包含任何实际的二进制包;它包含指向包代码所在的相应源代码控制存储库的包索引。

由于大多数公共Composer包都托管在GitHub上，我们建议创建一个Composer远程存储库作为…的缓存代理github.com,指定packagist.org作为公共包索引文件的位置。Artifactory中的Composer远程存储库可以进行代理packagist.org和其他用于索引文件的Artifactory Composer存储库，以及版本控制系统，如GitHub或BitBucket，或其他用于二进制文件的Artifactory实例中的本地Composer存储库。

编写器构件(例如邮政编码，tar.gz从远程存储库请求的文件)被缓存对需求．您可以从远程存储库缓存中删除下载的构件，但是您不能手动将构件部署到远程存储库。

定义要代理的远程存储库github.com以及公共的Composer Packagist存储库，请遵循以下步骤:

从政府模块，转到存储库|存储库|远程存储库并设置PHP的作曲家成为它的包类型
设置库的关键，并输入存储库URL(例如:https://github.com/）在URL字段，如下所示。
在作曲家设置部分中,选择GitHub随着Git提供者，并保留默认值注册网址(如。https://packagist.org/）.
最后,点击保存&完成．

URL vs.注册URL

为了避免混淆:

的URL是Git提供程序的URL，实际的二进制包驻留在那里。

的注册网址引用包索引文件保存托管元数据的URL。

要代理一个公共Composer注册表，请设置注册网址字段到索引文件的位置，如上面所示。要在另一个Artifactory实例中代理Composer存储库，请同时设置URL场和注册网址字段到远程Artifactory存储库的API URL。例如:https://jfrog-art.com/artifactory/api/composer/composer-local．

将远程存储库设置为与Drupal 7和Drupal 8相反的包类型

从Artifactory版本7.24.1 (SaaS用户)及更高版本支持Composer V2，允许从远程存储库下载Drupal版本7和8文件。
定义要代理的远程存储库Drupal文件以及公共ComposerPackagist存储库遵循以下步骤。

从政府模块，转到存储库|存储库|远程存储库|基本页签并设置PHP的作曲家成为它的包类型．
将URL设置为https://ftp.drupal.org/．
在PHP Composer Settings部分下，设置注册网址字段https://packages.drupal.org/

虚拟存储库

一个虚拟存储库在Artifactory中定义的聚合来自本地和远程存储库的PHP包，这些存储库包含在虚拟存储库中。使用虚拟存储库非常有用，因为用户将继续使用虚拟存储库，而管理员可以管理包含的存储库，替换默认部署目标，并且这些更改对用户是透明的。

要定义一个虚拟PHP Composer存储库，请遵循以下步骤:

创建一个新的虚拟存储库政府模块,在存储库|知识库|虚拟,点击新的虚拟存储库并设置PHP的作曲家随着包类型．
设置库的关键价值。
属性下包含的底层本地和远程PHP Composer存储库存储库部分。
您还可以选择配置您的默认部署存储库。

您可以在“高级”选项卡中设置以下内容。

Artifactory请求可以检索远程工件

一个Artifactory实例可以从另一个Artifactory实例中的虚拟存储库请求工件。此复选框指定当尝试解析另一个Artifactory实例请求的工件时，虚拟存储库是否应该通过远程存储库进行搜索。例如，当Artifactory部署在网状(网格)架构中时，您可以使用此特性，并且您不希望Artifactory的所有远程实例充当其他Artifactory实例的代理。

使用Composer命令行

一旦安装了Composer客户端，您就可以通过Artifactory的命令行界面访问Composer存储库。

Composer存储库必须在路径中加上api/ Composer前缀

当通过Artifactory访问Composer存储库时，存储库URL必须加上前缀api /作曲家在路上。这适用于所有Composer命令，包括作曲家安装．

例如，如果你单独使用Artifactory或作为本地服务使用，你可以使用下面的URL访问你的Composer存储库:

http://localhost:8081/artifactory/api /作曲家/<库关键>

或者，如果您正在使用Artifactory Cloud, URL将是:

https:// < server name > .jfrog.io / artifactory /api /作曲家/<库关键>

创建了Composer存储库之后，从应用程序模块转到Artifactory|工件|工件存储库浏览器并点击给我介绍获取代码片段，您可以使用它来设置您的Composer存储库URLjson文件。

作曲家配置。json文件

Windows: % userprofile % \ .composer \ json
Linux: ~ / .composer / json

替换默认存储库

中为Composer命令行指定的默认存储库json文件如下:

{"repositories": [{"type": "composer"， "url": "https://localhost:8081/artifactory/api/composer/composer-local"}， {"packagist": false}]}

使用安全URL (HTTPS)被认为是一种最佳实践，但您也可以使用不安全URL (HTTP)安全http配置假：

{"config": {"secure-http": false}， "repositories":[…]]}

身份验证

从2020年11月，GitHub在通过REST API进行身份验证时不再接受帐户密码，而是要求使用基于令牌的身份验证，例如a个人访问令牌的所有已验证API操作GitHub.com．

清理本地作曲器缓存

Composer客户端保存已下载包的缓存以及元数据响应。
我们建议在第一次使用Artifactory之前删除Composer缓存(包括包和元数据响应)，这是为了确保您的缓存只包含来自Artifactory请求的元素，而不是直接来自Package的元素。要清除Composer缓存，运行以下命令:

清理Composer缓存

作曲家clear-cache

composer.lock文件

在您的项目目录中已经有composer.lock文件中包含不同的经销url(下载url)比Artifactory，您需要删除它，否则，运行时作曲家安装命令时，编写器客户端将使用composer.lock文件的url

查看单个编写器包信息

Artifactory允许您直接从UI查看Composer包的选定元数据。
从应用程序模块，转到工件|树并向下钻取以选择要检查的包存档文件。元数据显示在作曲家信息选项卡。

内容

空间工具