Расширения Plesk могут использовать Composer для установки зависимостей и управления ими. Подробную информацию о Composer можно найти на сайте: https://getcomposer.org/.

В этом разделе мы расскажем, как правильно настроить расширение, если оно использует менеджер зависимостей Composer.

Чтобы проиллюстрировать эту настройку, Plesk предлагает следующий пример проекта: https://github.com/plesk/ext-composer-example.

Настройка

Основы настройки проекта для использования Composer описаны в разделе composer.json: Project Setup документации Composer. Для успешной интеграции с Plesk необходимы следующие параметры настройки.

Пример файла composer.json.

Местоположение папки „vendor“

Рекомендуем разместить папку vendor/ следующим образом:

"config": {
    "vendor-dir": "src/plib/vendor"
},

Использование пространств имен

По умолчанию при разработке расширений мы требуем выполнения Соглашения по именованию классов, чтобы гарантировать их правильную работу с Plesk. Использование Composer позволяет использовать пространства имен вместо длинных имен, которые требует Соглашение по именованию классов.

Только убедитесь, что используемые пространства имен правильно загружены в composer.json.

"autoload": {
        "psr-0": {
                "Composer_": [
                        "modules/composer-example/library/",
                        "src/plib/library/"
                ]
        },
        "psr-4": {
                "PleskExt\\Composer\\": [
                         "modules/composer-example/library/Composer/",
                         "src/plib/library/Composer/"
                ]
        }
},

Более подробную информацию о пространствах имен можно найти в разделе документации Composer Autoloading.

Упаковка расширения

Процесс упаковки расширения с помощью Composer требует добавления еще одного дополнительного шага по сравнению с обычным процессом.

Установка зависимостей

Прежде всего, необходимо скачать и установить все необходимые зависимости. Для этого выполните следующую команду:

composer --no-dev install

Более подробную информацию об установке зависимостей смотрите в разделе документации Composer Installing Dependencies.

Создание пакета

Как только зависимости установлены, вы можете создать архив ZIP.