Добавление пакета Composer

Для добавления пакета Composer, необходимо получить транспортный токен Gitflic. С инструкцией по получению токена можно ознакомиться на странице.

В документации ниже встречается атрибут <домен_gitflic> На его место необходимо указать домен, в зависимости от версии:

  • для SaaS версии registry.gitflic.ru

  • для self-hosted localhost:8080

Домен и порт для self-hosted версии может отличаться.

Файл настроек .composer/config.json

Чтобы зарегистрировать composer-реестр пакетов, вам необходимо добавить его в config.json файл (который обычно можно найти в ~/.composer/config.json)

Значение атрибута url зависит от уровня доступа:

Уровень URL
Проект http(s)://<домен_gitflic>/project/{projectAlias}/package/-/composer
Компания http(s)://<домен_gitflic>/company/{companyAlias}/package/-/composer
Инстанс http(s)://<домен_gitflic>/package/-/composer
Переменная в URL Описание
projectAlias Псевдоним проекта
companyAlias Псевдоним компании

Пример использования для компании:


{
    "repositories": [{
        "type": "composer",
        "url": "https://gitflic.ru/company/<companyAlias>/package/-/composer"
    }]
}

Конфигурационный файл auth.json

Чтобы получить доступ к реестру пакетов с использованием имени пользователя и транспортного токена, необходимо указать их в auth.json файле следующим образом:

{
  "http-basic": {
    "gitflic.ru": {
      "username": "<username>",
      "password": "<Транспортный токен>"
    }
  }
}

Публикация пакета

После выполнения настройки конфигурационных файлов можно публиковать пакет. Для этого необходимо выполнить PUT-запрос (Для примера указана загрузка на компанию):

curl --location --request PUT 'https://gitflic.ru/company/<companyAlias>/package/-/composer' \
                          --user <username>:<Транспортный токен> \
                          --header 'Content-Type: application/zip' \
                          --upload-file <Путь до файла>

Запрос поддерживает необязательный параметр version, он нужен в том случае если в composer.json не определено поле с версией. Например, https://gitflic.ru/company/<companyAlias>/package/-/composer?version=1.0.0

Установка пакета

Чтобы установить из реестра пакетов, выполните следующую команду:

composer require {packageName}

Также вы можете указать версию пакета:

composer require {packageName}:{packageVersion}

Параметр Описание
packageName Имя пакета.
packageVersion Пакетная версия.