Современному PHP разработчику так или иначе приходится иметь дело с менеджером зависимостей по имени Composer. В частности, мне время от времени на разных проектах приходится с помощью Composer устанавливать всевозможные библиотеки. Написал небольшую шпаргалку, которая позволит в будущем сэкономить пару лишних минут при вводе команд.
SSH обязателен!
Сразу же хочу отметить, если вы работаете с удалённым хостингом, доступ к нему по SSH обязателен.
Иначе ничего не выйдет.
На локальном сервере же придётся немножко поработать с командной строкой.
Установка Composer
Composer может быть установлен, как локально, так и глобально (на уровне операционной системы).
Вариант с операционной системой рассматривать не буду, ибо систем этих множество даже в рамках линейки Linux.
Да и локальный вариант мне нравится больше.
Заключается он в скачивании и использовании одного единственного файла «composer.phar».
Скачать файл можно по ссылке ниже:
https://getcomposer.org/download/
Есть два варианта скачивания.
Первый — с помощью командной строки. Он описан в верхней части страницы.
Второй, и более понятный для многих, это скачивание по ссылке, которая расположена в нижней части страницы, а именно в разделе «Manual Download»
Далее обратите внимание, если ваш проект работает под PHP 7.2 или выше, то скачиваем по верхней ссылке.
Если же проект использует древнюю версию PHP, то скачиваем по ссылке, где рядом текст «PHP 5.3 to PHP 7.1».
Далее, скаченный файл «composer.phar» закачиваем на свой сервер, в тот каталог, где планируется установка пакета.
Предлагаю, установить в качестве эксперимента установить «B24PhpSDK» - библиотеку для работы с REST API Битрикс24 на языке PHP.
Как установить библиотеку с помощью Composer
Для последующей работы, на своём сервере, я создал каталог «project», куда и загрузил файл «composer.phar».
Далее, на своём локальном компьютере, необходимо открыть программу для подключения по SSH и подключиться к вашему серверу.
Затем, делаем текущим каталог куда мы загрузили файл.
Сделать это можно с помощью команды:
cd /путь к каталогу, куда загрузили файл
Теперь отправимся на сайт разработчика библиотеки «B24PhpSDK». И находим то место, где он пишет команду для установки.
Разработчик советует сделать так:
Однако в нашем случае слово «composer» необходимо заменить на «php composer.phar».
Полная команда будет звучать так:
php composer.phar require bitrix24/b24phpsdk
Что делать, если установленная на сервере версия PHP по умолчанию отличается от необходимой?
Представим ситуацию, на сервере версией PHP по умолчанию является, к примеру, 7.4.
А для установки библиотеки необходим PHP 8.4.
В частности, при установке библиотеки «B24PhpSDK» на моём сервере я, как раз после ввода команды выше, получил сообщение об ошибке:
«Cannot use bitrix24/b24phpsdk's latest version 3.0.0 as it requires php 8.4.* || 8.5.* which is not satisfied by your platform.»
Здесь сообщается о том, что версия PHP должна быть не ниже 8.4.
Для того чтобы решить данный вопрос, на сервере уже должна быть установлена требуемая версия PHP, а в нашей команде мы должны указать путь к интерпретатору с нужной версией.
В моём случае команда будет такая:
/opt/php84/bin/php composer.phar require bitrix24/b24phpsdk
После её ввода будут установлены все необходимые пакеты, создана папка «vendor», которую можно подключать в свой проект.
В общем, поставленная в рамках этой статьи будет выполнена.
Заключение
Если вы не знаете путь к вашему интерпретатору, напишите хостинг провайдеру. Он наверняка поможет, как с составлением команды, так и с установкой новой версии PHP, если таковая не установлена.
На этом мою растянувшеюся на 3 листа шпаргалку я завершаю.
Напоминаю!
Если у вас остались вопросы и предложения, их всегда можно озвучить в группе VK по ссылке ниже:
Также можно подписаться на мой канал в MAX:
С уважением, Владимир Егоров.
