Документация для разработчиков
Темная тема

LocalRedirect

Описание и параметры

LocalRedirect(
 string url,
 bool skip_security_check=false,
 string status="302 Found"
);

Выполняет перенаправление браузера на указанную страницу.

Примечание. Для административной части перенаправление браузера можно использовать только до вывода какого-либо контента (т.е. до подключения файла prolog_admin_after.php или prolog_admin.php). В публичной части - никаких ограничений не накладывается.


Параметры функции

ПараметрОписание С версии
urlURL на который будет перенаправлен браузер. Допустимо использование как относительных адресов, так и адресов ведущих на другие сайты и начинающихся со следующих протоколов: "http://", "https://", "ftp://".
skip_security_checkНеобязательный. Значение true позволяет пропустить проверку модуля безопасности на фишинг.8.0.3
statusНеобязательный. Параметр устанавливает код (статус) в HTTP-заголовке ответа. Например, "301 Moved permanently". Параметр добавлен в версии 8.5.1.8.5.1

События

OnBeforeLocalRedirect - происходит перед редиректом, в обработчик передаётся url.

ПараметрОписание С версии
urlURL на который будет перенаправлен браузер. Допустимо использование как относительных адресов, так и адресов ведущих на другие сайты и начинающихся со следующих протоколов: "http://", "https://", "ftp://".6.5.4
skip_security_checkНеобязательный. Значение true позволяет пропустить проверку модуля безопасности на фишинг.6.5.4
bExternalПризнак того, что передан полный или относительный путь.6.5.4

OnLocalRedirect - происходит во время редиректа после установки заголовка Location. Никакие параметры при этом не возвращаются в обработчик. С версии 6.5.4.


Примеры использования

<?
// полный URL на другой сайт
LocalRedirect("http://www.bitrixsoft.ru/");

// относительный путь от корня текущего сайта
LocalRedirect("/ru/index.php");

// относительный путь к файлу в текущем каталоге текущего сайта
LocalRedirect("index.php");
?>


© «Битрикс», 2001-2020, «1С-Битрикс», 2020
Наверх