Composer для автозагрузки классов битрикс

Содержание:

1. Эволюция разработчика
2. Что такое composer?
3. Настройка под битрикс
4. Внедрение composer в папку /bitrix/
5. Настройка автозагрузки
6. Дальнейшее использование

Update: В версии 18.0.5 bitrix начал использовать composer внутри продукта в режиме разработки. Подробнее ознакомьтесь в документации https://dev.1c-bitrix.ru/learning/course/index.php?COURSE_ID=43&LESSON_ID=4637&LESSON_PATH=3913.3516.4776.2483.4637

Эволюция разработчика

Что такое composer?

Настройка под битрикс

1. на уровне с корневой папкой проекта(т.е. на одном уровне у вас будут лежать: public_html(htdocs), vendor, composer.json)
2. в папке  /bitrix/
3. в папке  /local/
4. Кто-то может расположить в корне проекта, но этот подход однозначно не правильный.

Внедрение composer в папку /local/

public_html/local/composer.phar
public_html/local/vendor/*
public_html/local/composer.json
Файл composer.lock должен быть под git.
 Если другой человек скачает ваш проект, ему достаточно выполнить composer install и он получит все пакеты тех же версий, что и у вас, а точнее те, что зафиксированы в файле composer.lock.
 без этого файла при загрузке пакетов могут быть получены версии пакетов отличные от ваших.
Шаг 2
Скачиваем composer.phar файл с сайта https://getcomposer.org (последнюю версию скачиваем отсюда) либо качаем из консоли.
Шаг 3
Закидываем файл в папку  /local/
и дальше два пути:
Если у вас уже есть подготовленный файлик composer.json , то выполняем:
php composer.phar install
Если вы устанавливаете composer в первый раз и у вас нет своего готового composer.json , то выполняем:
php composer.phar init
 Выше в примерах использовал стандартную запись php composer.phar init.
 Обычно путь до php на разных хостингах отличается, т.е. пишут сокращенно php(либо у вас создан алиас на php).
 Например, в моём случае, php лежит по адресу /opt/php56/bin/ и нужно писать:
/opt/php56/bin/php composer.phar init
И учтите, что если в команде пишите composer.phar, то вы должны находиться именно в той директории, где он лежит.
В результате он запросит у вас данные по проекту, инициализируйте проект вашими данными.
В итоге сгенерируется  composer.json и нужно выполнить команду install
Подтянуться все зависимости, и загрузятся в папку /vendor/, которая предварительно будет создана в папке /local/.
Шаг 4
И самое главное — composer автоматически сгенерирует файл /local/vendor/autoload.php, который надо будет добавить в init.php:
require_once($_SERVER['DOCUMENT_ROOT'] . '/local/vendor/autoload.php');
Настройка автозагрузки
Теперь можно переводить существующие у вас в проекте классы на автозагрузку через composer. Если вы придерживались стандарта psr-0 или не придерживались можете посмотреть тут, как это подключить и офиц. документация.
Если придерживались psr-4, заполняется анналогично psr-0:
{
    "autoload": {
        "psr-4": {
            "Vendor\\Namespace\\": "/../local/php_interface/classes/"
        }
    }
}
Подробнее по psr-4 идем по ссылке
Если вы изменили файл composer.json, то нужно выполнить update:
php composer.phar update
Дальнейшее использование
Дальше при создании классов придерживайтесь стандарта psr-4. Т.е. если вы захотите создать новое пространство имен или новый класс вам нужно придерживаться стандарта именования папок и файлов и composer автоматически подтянет их.
Хочу вас обрадовать composer умеет не только автозагрузку классов. Его основное предназначение управлять зависимостями. Рассмотрим пример использования(скоро будет).