使用 Composer 制品库
本文档介绍如何快速使用 Composer 制品仓库,方便团队在项目进行统一的制品管理与版本控制。内容包含如何进行制品包制作、认证配置与制品推拉。
阅读该篇文档需要准备好以下内容:
- 安装 Composer
- 《基础操作》——创建项目
- 制品仓库选择 Composer 类型。
制作 Composer 包(可选阅读)
安装 Composer
在终端中执行下载 Copmoser 命令。
curl -sS https://getcomposer.org/installer | php
添加至环境变量,方便全局运行命令。
mv composer.phar /usr/local/bin/composer
初始化
新建 Demo 目录。
mkdir composer-demo && cd composer-demo
初始化 Composer 包,按照提示输入初始化信息。
composer inits
初始化完成后会在同一目录下新增 composer.json
文件作为该 Composer 包的配置文件。
配置认证文件
前往 Composer 包的文件目录,新建 auth.json
文件。您可以使用自动生成配置或手动配置两种方式进行配置。
自动生成配置
点击网页上的「使用访问令牌生成配置」按钮,复制内容后粘贴至 auth.json
文件内。
手动配置
复制网页上的命令,并将其中的 < PASSWORD >
替换为您的服务密码。
推送
根据 CODING 制品库页面给出的推送命令,将 Composer 包文件打包成 zip
并使用 cURL
等工具推送至仓库。
推送时需按照提示输入您在 auth.json
文件中填写的密码,并将 < version >
替换为拟定的版本号。
推送完成后即可在 CODING 制品库看到已推送的包。
拉取
进入 Composer 包的文件目录,设置仓库地址。相关命令已在 CODING 页面生成。
使用 CODING 制品库代替 Composer 官方的源(可选)。
composer config repo.packagist false
执行拉取命令,将 < package >
包替换为拟拉取的包。
composer require < PACKAGE >:< VERSION >
输入服务邮箱与密码后成功拉取。
设置代理
当 CODING 私有制品仓库不存在想要拉取的制品时,将尝试从配置的代理地址拉取。您可以添加第三方制品源,用以获取特定仓库中的制品。无需额外设置,CODING 将会按照顺序从上到下依次检索相应的制品包。
代理设置的详细说明,请参考《制品代理》
