Объект приложения и контекст

В Bitrix Framework объект приложения предоставляет доступ к ядру, а контекст — к данным текущего запроса. Примеры ниже выполняйте после подключения пролога, который инициализирует ядро.

Объект приложенияОбъект приложения

Приложение в Bitrix Framework инициализирует ядро и служит точкой входа. Через объект приложения можно получить соединение с базой данных и управляемый кэш.

• Наследование. Каждое приложение наследует Bitrix\Main\Application. Например, Bitrix\Main\HttpApplication обрабатывает HTTP-запросы.

• Singleton. Приложение реализует шаблон Singleton, то есть создает только один экземпляр объекта в рамках одного запроса. Получить его можно так:

use Bitrix\Main\Application;

$application = Application::getInstance();

КонтекстКонтекст

Контекст связан с текущим запросом и содержит объект запроса, ответ и серверные параметры.

• Наследование. Базовый класс контекста — Bitrix\Main\Context. Класс Bitrix\Main\HttpContext наследует его для работы с HTTP-запросами.

• Получение контекста. Чтобы получить контекст текущего хита, используйте:

use Bitrix\Main\Application;

$context = Application::getInstance()->getContext();

Если приложение — Bitrix\Main\HttpApplication, вызов вернет Bitrix\Main\HttpContext.

Сервер, сайт и языкСервер, сайт и язык

Контекст предоставляет данные окружения текущего запроса.

• getServer() — возвращает объект Bitrix\Main\Server с серверными параметрами. Например, метод getDocumentRoot() этого объекта возвращает путь к корневому каталогу сайта.

• getSite() — возвращает строковый идентификатор текущего сайта или null, если сайт в контексте не задан.

• getLanguage() — возвращает строковый идентификатор текущего языка или null, если язык в контексте не задан.

Чтобы получить серверные параметры и идентификаторы сайта и языка, используйте:

use Bitrix\Main\Application;

$context = Application::getInstance()->getContext();
$server = $context->getServer();
$documentRoot = $server->getDocumentRoot();
$siteId = $context->getSite();
$languageId = $context->getLanguage();

ЗапросЗапрос

Контекст включает в себя запрос, который содержит переданные параметры и информацию о методе запроса.

• Получение запроса. Чтобы получить запрос, выполните:

use Bitrix\Main\Application;

$context = Application::getInstance()->getContext();
$request = $context->getRequest();

• Класс запроса. Запрос — экземпляр класса, наследующего Bitrix\Main\Request. Для HTTP-запросов это Bitrix\Main\HttpRequest, который предоставляет доступ к параметрам.

Доступ к параметрамДоступ к параметрам

Метод get() возвращает параметр из объединенных GET- и POST-данных. При совпадении имен используется значение из POST. Чтобы получить параметр some_name, используйте:

use Bitrix\Main\Application;

$request = Application::getInstance()->getContext()->getRequest();
$value = $request->get('some_name');

Чтобы вывести строковое значение параметра в HTML, используйте:

use Bitrix\Main\Application;
use Bitrix\Main\Text\HtmlFilter;

$request = Application::getInstance()->getContext()->getRequest();
$value = $request->get('some_name');

if (is_string($value))
{
    echo HtmlFilter::encode($value);
}