Завершить приложение Application::terminate
Модуль: main — подключать отдельно не нужно
Метод Application::terminate завершает приложение без отправки ответа. Метод end вызывает его сам после отправки ответа. Код приложения вызывает метод, когда уже отправил ответ сам.
Метод выполняет шаги по порядку.
- Выполняет завершающие действия старого ядра, например обработчики события
OnAfterEpilog. - Закрывает сессию PHP.
- Выполняет фоновые задачи из addBackgroundJob. Запросы к базе данных в задачах идут только к основному серверу.
- Сохраняет управляемый кеш, отключается от базы данных и вызывает
exit.
Сигнатура метода в классе Bitrix\Main\Application:
public function terminate($status = 0)
Параметры
| Параметр | Тип | Описание |
|---|---|---|
| status | int |
Задает код завершения скрипта для exit. По умолчанию — 0 |
Тип в таблице описывает назначение аргумента. Сигнатура PHP не объявляет его.
Возвращаемое значение
Метод завершает скрипт и не возвращает управление.
Особенности
- Повторный вызов во время завершения ничего не делает. Так фоновая задача может вызвать
endилиterminateбез зацикливания. - Если фоновая задача выбросила исключение, метод пишет его в журнал и выполняет остальные задачи. После всех задач метод выбрасывает последнее исключение. Шаг 4 тогда не выполняется: управляемый кеш не сохранится, а исключение получит глобальный обработчик ошибок.
Примеры
Пример. Код добавляет две фоновые задачи с разным приоритетом и завершает приложение:
<?php
use Bitrix\Main\Application;
require $_SERVER['DOCUMENT_ROOT'] . '/bitrix/modules/main/include/prolog_before.php';
$application = Application::getInstance();
$application
->addBackgroundJob(
function ()
{
echo "low\n";
},
[],
Application::JOB_PRIORITY_LOW
)
->addBackgroundJob(
function ($unit)
{
echo "normal $unit\n";
},
['kg']
)
;
echo "response\n";
$application->terminate();
echo 'never';
Код выведет:
response
normal kg
low
Смотрите также
Была ли статья полезна?
Предыдущая
Следующая