LocalRedirect

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

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

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

Обратите внимание!В функции LocalRedirect в качестве статуса можно установить только те, которые относятся к редиректам, то есть имеют код 3хх. Остальные статусы игнорируются, при попытке их установки будет передан статус 302.

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

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

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

События

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

Параметр	Описание	С версии
url	URL на который будет перенаправлен браузер. Допустимо использование как относительных адресов, так и адресов ведущих на другие сайты и начинающихся со следующих протоколов: "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");
?>