Зарегистрировать файлы классов Loader::registerAutoLoadClasses
Модуль: main — подключать отдельно не нужно
Метод Loader::registerAutoLoadClasses связывает имена классов с путями к файлам. Автозагрузчик подключает такой файл сразу, без поиска по пространствам имен. Метод нужен для классов, которые лежат не по правилам PSR-4, например классов классического API в модуле.
Сигнатура метода в классе Bitrix\Main\Loader:
public static function registerAutoLoadClasses($moduleName, array $classes)
Параметры
Обязательные параметры обозначены *
|
Параметр |
Тип |
Описание |
|
moduleName* |
|
Задает код модуля. Если код задан, пути в |
|
classes* |
|
Задает классы. Ключ — полное имя класса, регистр не важен. Значение — путь к файлу:
|
Тип moduleName в таблице описывает назначение аргумента. Сигнатура PHP объявляет только тип classes.
Возвращаемое значение
Метод ничего не возвращает. Метод не проверяет, что файлы существуют.
Исключения
| Исключение | Когда возникает |
|---|---|
Bitrix\Main\LoaderException |
Код модуля — пустая строка, а массив классов не пустой |
Особенности
- Для модуля автозагрузчик берет каталог из
/local/modules/или/bitrix/modules/— там, где includeModule нашел модуль. Если модуль еще не подключен, автозагрузчик берет/bitrix/modules/. Если задана константаREPOSITORY_ROOT, для модулей из/bitrix/modules/автозагрузчик берет каталог модуля в ней. - Если файла нет, при обращении к классу PHP выбрасывает ошибку
Error.
Примеры
Пример. Код регистрирует класс из файла в /upload/ и вызывает его:
<?php
use Bitrix\Main\Loader;
require $_SERVER['DOCUMENT_ROOT'] . '/bitrix/modules/main/include/prolog_before.php';
$file = '/upload/units_helper_' . uniqid() . '.php';
try
{
file_put_contents($_SERVER['DOCUMENT_ROOT'] . $file, '<?php class UnitsHelper { public static function title() { return "Units"; } }');
Loader::registerAutoLoadClasses(null, ['UnitsHelper' => $file]);
echo UnitsHelper::title();
}
finally
{
@unlink($_SERVER['DOCUMENT_ROOT'] . $file);
}
Код выведет Units. Пример создает файл класса и затем удаляет его, поэтому код работает без подготовки.