Статьи веб-программиста: Composer: настройка автозагрузки в проекте

В предыдущей статье было объяснено, как создать проект, подключить к нему нужные пакеты. Кратко была упомянута автозагрузка классов пакетов, которую организует автоматически Composer. А как быть, если мы хотим, чтобы написанные нами классы тоже имели возможность автозагрузки через Composer, например, если мы создаем проект-библиотеку, которая будет использоваться в других проектах? Разберёмся!

Сначала создаем проект, как и в прошлый раз - всё то же самое. Когда же нам понадобится сделать автозагрузку созданных нами классов, обратимся к composer.json в корне проекта. Если полистаем папки, увидим, что такие файлы есть в уже установленных пакетах, и в них есть раздел autoload. Вот такой раздел нужно создать и в нашем composer.json.
В этом разделе нужно перечислить пространства имён, классы, папки и файлы, которые мы хотим загружать автоматически через Composer. Почему так много типов? На самом деле, в основном указывают только пространства имён, а остальное реже.

В разделе autoload допустимы 4 вида указаний:

• psr-0 - устаревшее, не рассматривается.
• psr-4 - основной тип, описывающий пространства имён. Например:

  
    "autoload": {
      "psr-4": {
        "Namespace1\\": "our_classes/",
        "Namespace2\\": "our_classes/some_sub_classes/",
      }
    }
  

  Таким образом мы сообщаем Composer'у, где располагаются наши пространства имён и описания классов.
• classmap - для поиска просто классов. Нужно указать папки, где искать классы. Например:

  
      "autoload": {
          "classmap": ["other_classes/"]
      }
  

  Этим мы говорим, что указанную папку нужно просканировать и найти классы, которые тоже следует автозагружать, но они не соответствуют стандарту PSR-4.
• files - для подключения файлов, которые должны включаться (require, include и т.п.). Нужно указать файлы. Например:

  
      "autoload": {
          "files": ["lib/some_file.php"]
      }
  

  А здесь мы просто указываем файл, который должен быть включён. В нём могут находиться какие-то функции и прочий код.

Подробнее: https://getcomposer.org/doc/04-schema.md#autoload

После того, как мы изменили composer.json, запускаем:

php composer.phar dump-autoload

Этим Composer обновляет свои файлы автозагрузки, выполняя указания, полученные в разделе autoload.

На этом всё. Теперь вы можете публиковать проект, и когда его скачают и захотят использовать как библиотеку, его классы и файлы будут подключены автоматически.