Composer

Composer — стандартный менеджер зависимостей для PHP, который позволяет управлять библиотеками и их версиями. В Bitrix Framework он открывает доступ к современным инструментам разработки:

• ORM-аннотациям,

• интерфейсу командной строки CLI,

• сторонним библиотекам.

Установить ComposerУстановить Composer

Composer можно установить:

• глобально — для работы в любой папке сервера,

• локально — только для текущего проекта.

Проверьте, что Composer работает командой:

composer -V
        # Должна отобразиться версия, например:
        # Composer version 2.8.5 2025-01-21 15:23:40
        

Настроить зависимости в проектеНастроить зависимости в проекте

Для корректной и безопасной работы Composer в Bitrix необходимо правильно организовать структуру проекта.

Где разместить composer.jsonГде разместить composer.json

По умолчанию система ищет файл composer.json в папке /home/bitrix/www/bitrix/. Рекомендуется размещать composer.json за пределами DOCUMENT_ROOT, например, в /home/bitrix/. Это предотвратит публичный доступ к конфигурации.

Добавьте в файл /home/bitrix/www/bitrix/.settings.php путь к composer.json.

return [
            'composer' => [
                'value' => [
                    'config_path' => '/home/bitrix/composer.json'
                ]
            ]
        ];
        

Если вы разрабатываете собственные модули — размещайте composer.json в папке /local/.

Как подключить стандартные зависимостиКак подключить стандартные зависимости

Подключите файл со стандартными зависимостями Bitrix Framework composer-bx.json.

1. Установите плагин Composer Merge Plugin.

2. В файл composer.json добавьте:

   {
               "require": {
                   "wikimedia/composer-merge-plugin": "^2.0"
               },
               "extra": {
                   "merge-plugin": {
                       "include": [
                           "/path/to/bitrix/composer-bx.json"
                       ]
                   }
               }
           }
           

   Путь /path/to/bitrix/ — полный путь к папке bitrix на вашем сервере, например, /home/bitrix/www/bitrix/.

Как установить зависимостиКак установить зависимости

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

composer install
        

Все зависимости установятся в папку /vendor/, которую Composer создаст рядом с файлом composer.json. Автозагрузчик /vendor/autoload.php будет подключаться автоматически.