Spec-Zone.ru › Symfony 4.1

Esi

class Esi extends AbstractSurrogate

Esi реализует возможности ESI для экземпляров Request и Response.

Для получения дополнительной информации ознакомьтесь со следующими заметками W3C:

  • Спецификация языка ESI 1.0 (http://www.w3.org/TR/esi-lang)

  • Спецификация архитектуры Edge (http://www.w3.org/TR/edge-arch)

Свойства

protected $contentTypes из AbstractSurrogate
protected $phpEscapeMap из AbstractSurrogate

Методы

__construct(array $contentTypes = array('text/html', 'text/xml', 'application/xhtml+xml', 'application/xml')) из AbstractSurrogate
ResponseCacheStrategyInterface createCacheStrategy()

Возвращает новый экземпляр стратегии кэширования.

из AbstractSurrogate
bool hasSurrogateCapability(Request $request)

Проверяет, что хотя бы один суррогат обладает возможностью суррогатирования.

из AbstractSurrogate
addSurrogateCapability(Request $request)

Добавляет возможность суррогатирования к заданному Request.

из AbstractSurrogate
bool needsParsing(Response $response)

Проверяет, нужно ли анализировать Response на наличие тегов суррогата.

из AbstractSurrogate
string handle(HttpCache $cache, string $uri, string $alt, bool $ignoreErrors)

Обрабатывает суррогат из кэша.

из AbstractSurrogate
removeFromControl(Response $response)

Удаляет суррогат из заголовка Surrogate-Control.

из AbstractSurrogate
string getName()

Возвращает имя суррогата.

addSurrogateControl(Response $response)

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

string renderIncludeTag(string $uri, string $alt = null, bool $ignoreErrors = true, string $comment = '')

Отображает тег суррогата.

Response process(Request $request, Response $response)

Заменяет теги суррогата в Response на содержимое включённого ресурса.

Подробности

__construct(array $contentTypes = array('text/html', 'text/xml', 'application/xhtml+xml', 'application/xml'))

Параметры

array $contentTypes Массив типов контента, которые должны быть обработаны для получения информации о суррогате (по умолчанию: text/html, text/xml, application/xhtml+xml и application/xml)

ResponseCacheStrategyInterface createCacheStrategy()

Возвращает новый экземпляр стратегии кэширования.

Возвращаемое значение

ResponseCacheStrategyInterface Экземпляр ResponseCacheStrategyInterface

bool hasSurrogateCapability(Request $request)

Проверяет, что хотя бы один суррогат обладает возможностью суррогирования.

Параметры

Request $request

Возвращаемое значение

bool true, если один суррогат обладает возможностью суррогирования, иначе false

addSurrogateCapability(Request $request)

Добавляет Surrogate-возможность к заданному запросу.

Параметры

Request $request

bool needsParsing(Response $response)

Проверяет, нужно ли анализировать ответ для поиска тегов суррогата.

Параметры

Response $response

Возвращаемое значение

bool true, если ответ нуждается в анализе, иначе false

string handle(HttpCache $cache, string $uri, string $alt, bool $ignoreErrors)

Обрабатывает суррогат из кэша.

Параметры

HttpCache $cache Экземпляр HttpCache
string $uri Основной URI
string $alt Альтернативный URI
bool $ignoreErrors Игнорировать ошибки или нет

Возвращаемое значение

string

Исключения

RuntimeException
Exception

protected removeFromControl(Response $response)

Удаляет суррогат из заголовка Surrogate-Control.

Параметры

Response $response

string getName()

Возвращает имя суррогата.

Возвращаемое значение

string

addSurrogateControl(Response $response)

Добавляет HTTP-заголовки, указывающие, что ответ должен быть обработан для суррогата.

Этот метод добавляет заголовок Surrogate только если в ответе есть теги суррогата.

Параметры

Response $response

string renderIncludeTag(string $uri, string $alt = null, bool $ignoreErrors = true, string $comment = '')

Отображает тег суррогата.

Параметры

string $uri URI
string $alt Альтернативный URI
bool $ignoreErrors Игнорировать ошибки или нет
string $comment Комментарий для добавления в тег esi:include

Возвращаемое значение

string

Response process(Request $request, Response $response)

Заменяет теги суррогата в ответе содержимым включённого ресурса.

Параметры

Request $request
Response $response

Возвращаемое значение

Response

© 2004–2017 Fabien Potencier
Licensed under the MIT License.
https://api.symfony.com/4.1/Symfony/Component/HttpKernel/HttpCache/Esi.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API