Out html

Материал из Eludia
Перейти к: навигация, поиск

Описание

Эта низкоуровневая функция выводит на клиент заданную строку и устанавливает флаг $_REQUEST {__response_sent} = 1, сообщая ядру о том, что вся автоматика при формировании ответа отменяется.

Если имеется возможность и смысл, то out_html сжимает (gzip) содержимое: когда такое происходит, она устанавливает заголовок 'Content-Encoding'. Кроме того, в любом случае она устанавливает устанавливает заголовки 'Content-Type' (который можно переопределить как $_REQUEST {__content_type}) и 'Content-Length'.

Первый параметр "зарезервирован под опции" — но пока ни одной опции придумать не удалось. На всякий случай, туда желательно ставить пустой хэш.

Данная процедура в норме должна использоваться относительно редко: а именно, в тех случаях, когда программируется действие, по окончании которого требуется нестандартный HTTP-ответ. Для справки: стандартными ответами считаются:

В унаследованном коде приложений можно встретить фрагменты, где идёт прямое обращение к глобальной переменной $r (традиционно это был Apache->request, позже, с адаптацией новых серверных API, его эмуляция). В настоящее время рекомендуется (по возможности) использовать out_html вместо $r -> print, так как при этом снимается необходимость устанавливать основные заголовки. С другой стороны, out_html не может вытеснить $r -> print полностью: например, в тех случаях, когда ответ формируется длительное время и отправляется на клиент частями.

Синопсис (Perl 5)

	out_html ({}, q {
		<html>
			<body onLoad="window.top.close()">
			</body>
		</html>
	});
Персональные инструменты
Пространства имён

Варианты
Действия
Навигация
Разработчику
Администратору
Инструменты