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