Подготовить ядро Application::initialize

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

Метод Application::initialize подготавливает ядро к обработке запроса. Пролог ядра вызывает метод сам сразу после getInstance. Вызывать метод в коде приложения не нужно.

Метод появился в версии main новее 26.150.0. В более ранних версиях ту же работу выполняет устаревший метод initializeExtendedKernel.

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

public function initialize(array $params): void

Параметры

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

Параметр Тип Описание
params* array Задает данные запроса для initializeContext. Для HttpApplication — ключи get, post, files, cookie, server, env

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

Метод ничего не возвращает.

Особенности

  • Метод выполняется один раз. Повторный вызов ничего не делает.
  • Метод вызывает initializeContext, добавляет системные фоновые задачи и регистрирует сервисы модуля main из его .settings.php.
  • Системные фоновые задачи — агенты, почтовые события, счетчики пользователей, а на сайтах без модуля bitrix24 — обновление правил веб-защиты и уведомлений о безопасности. Метод добавляет агенты и почтовые события, только если в настройках главного модуля включен их запуск на хитах. Константа BX_SENDPULL_COUNTER_QUEUE_DISABLE со значением true отключает задачу счетчиков.
  • После вызова isInitialized возвращает true.

Примеры

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

<?php
use Bitrix\Main\Application;

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

$application = Application::getInstance();

if (method_exists($application, 'initialize'))
{
    $context = $application->getContext();
    $application->initialize(['get' => [], 'post' => [], 'files' => [], 'cookie' => [], 'server' => [], 'env' => []]);
    var_dump($application->getContext() === $context);
}
else
{
    echo 'not available';
}

В версии с методом код выведет bool(true). Пролог уже подготовил ядро, и повторный вызов не меняет контекст. В версии main 26.150.0 код выведет not available.

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