Сбросить результат подключения модуля Loader::clearModuleCache
Модуль: main — подключать отдельно не нужно
Метод Loader::clearModuleCache сбрасывает запомненный результат подключения модуля. Класс ModuleManager вызывает метод сам, когда регистрирует модуль или удаляет его регистрацию. Вызывайте метод, если модуль установили в обход ModuleManager в том же запросе после неудачного вызова includeModule.
Сигнатура метода в классе Bitrix\Main\Loader:
public static function clearModuleCache($moduleName)
Параметры
Обязательные параметры обозначены *
| Параметр | Тип | Описание |
|---|---|---|
| moduleName* | string |
Задает код модуля. Для результата includeModule передайте код в нижнем регистре, для результата includeSharewareModule — в том регистре, в котором его передавали |
Типы в таблице описывают назначение аргументов. Сигнатура PHP не объявляет их.
Возвращаемое значение
Метод ничего не возвращает.
Исключения
| Исключение | Когда возникает |
|---|---|
Bitrix\Main\LoaderException |
Код модуля пустой или не строка |
Особенности
- Метод сбрасывает результаты
includeModuleи includeSharewareModule и запомненный каталог модуля. Для модуляmainметод сбрасывает только результатincludeSharewareModule. - Метод не отменяет регистрацию пространства имен и уже подключенный
include.php. ПовторныйincludeModuleдобавит каталогlibв пространство имен еще раз. - Пока модуль не подключат снова, автозагрузчик ищет классы модуля из
registerAutoLoadClassesв/bitrix/modules/, даже если модуль лежит в/local/modules/.
Примеры
Пример. Код сбрасывает результат после неудачного подключения и пробует снова:
<?php
use Bitrix\Main\Loader;
require $_SERVER['DOCUMENT_ROOT'] . '/bitrix/modules/main/include/prolog_before.php';
$first = Loader::includeModule('vendor.units');
// здесь код может установить модуль
Loader::clearModuleCache('vendor.units');
$second = Loader::includeModule('vendor.units');
var_dump($first, $second);
Если модуль так и не установили, код выведет:
bool(false)
bool(false)
Смотрите также
Была ли статья полезна?
Предыдущая