Загрузить класс по имени Loader::autoLoad

Модуль: main — подключать отдельно не нужно

Метод Loader::autoLoad — автозагрузчик классов ядра. Ядро регистрирует его через spl_autoload_register в файле /bitrix/modules/main/include/autoload.php. PHP вызывает метод сам при первом обращении к классу, вызывать его в коде не нужно.

Сигнатура метода в классе Bitrix\Main\Loader:

public static function autoLoad($className)

Параметры

Обязательные параметры обозначены *

Параметр Тип Описание
className* string Задает полное имя класса

Типы в таблице описывают назначение аргументов. Сигнатура PHP не объявляет их.

Возвращаемое значение

Метод ничего не возвращает. Если метод не находит класс по пространствам имен, он ничего не делает, и PHP переходит к следующему автозагрузчику.

Особенности

Метод ищет класс по порядку:

  1. Псевдоним из registerClassAliases. Метод создает псевдоним и завершает работу.
  2. Прямой путь из registerAutoLoadClasses. Метод подключает файл без проверки. Если файла нет, PHP выбрасывает ошибку Error.
  3. Пространство имен из registerNamespace. Метод начинает с самого длинного пространства имен класса и укорачивает его, пока не найдет файл. В каталоге метод ищет файл с исходным регистром пути, затем в нижнем регистре.

После загрузки класса метод создает его зарегистрированные псевдонимы.

Для класса с суффиксом Table, например Vendor\Units\UnitTable, метод ищет и файл без суффикса — Unit.php или unit.php.

Метод не ищет по пространствам имен класс, в имени которого есть символы, кроме латинских букв, цифр, _ и косых черт.

Примеры

Пример. Код загружает класс ядра, который еще не загружен, без обращения к нему:

<?php
use Bitrix\Main\Loader;

require $_SERVER['DOCUMENT_ROOT'] . '/bitrix/modules/main/include/prolog_before.php';

$before = class_exists('Bitrix\Main\Text\Emoji', false);
Loader::autoLoad('Bitrix\Main\Text\Emoji');

var_export([$before, class_exists('Bitrix\Main\Text\Emoji', false)]);

Если пролог не загрузил класс Emoji, код выведет:

array (
  0 => false,
  1 => true,
)

Смотрите также