SurrogateInterface

string getName()

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

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

string

ResponseCacheStrategyInterface createCacheStrategy()

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

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

ResponseCacheStrategyInterface

Экземпляр ResponseCacheStrategyInterface

bool hasSurrogateCapability(Request $request)

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

Параметры

Request

$request

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

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

addSurrogateCapability(Request $request)

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

Параметры

Request

$request

addSurrogateControl(Response $response)

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

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

Параметры

Response

$response

bool needsParsing(Response $response)

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

Параметры

Response

$response

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

bool	true, если ответ нужно обработать, иначе false

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

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

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

Параметры

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

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

string

Исключения

RuntimeException
Exception