Todos os produtos
Search
Central de documentação

CDN:Funções de cache

Última atualização: Sep 18, 2026

A função set_cache_ttl define o tempo de vida (TTL) de recursos em cache com base no caminho ou no código de status HTTP.

set_cache_ttl

Sintaxe

set_cache_ttl(type, ttl)

Parâmetros

Parâmetro

Tipo

Descrição

type

caractere

Tipo de cache. Valores válidos: path, code.

ttl (quando type é path)

numérico

TTL para os recursos correspondentes, em segundos.

ttl (quando type é code)

caractere

Valores de TTL para códigos de status HTTP específicos, no formato <code>=<seconds>,.... Por exemplo, '301=10,302=5'.

Valor de retorno

Retorna true em caso de sucesso e false caso contrário.

Exemplos

Defina o TTL por caminho

Use type='path' para aplicar um TTL aos recursos que correspondem a um padrão de URI. O valor de ttl é numérico, em segundos.

if eq(substr($uri, -4, -1), '.mp4') {
    set_cache_ttl('path', 5)    // match .mp4 files: cache for 5 seconds
}
if match_re($uri, '^/201801/mp4/') {
    set_cache_ttl('path', 50)   // match /201801/mp4/ prefix: cache for 50 seconds
}
if match_re($uri, '^/201802/flv/') {
    set_cache_ttl('path', 10)   // match /201802/flv/ prefix: cache for 10 seconds
}

Defina o TTL por código de status HTTP

Use type='code' para atribuir valores de TTL a códigos de status HTTP específicos. O valor de ttl é uma string no formato <status-code>=<seconds>, com várias entradas separadas por vírgulas.

if match_re($uri, '^/image') {
    set_cache_ttl('code', '301=10,302=5')   // for /image URIs: cache 301 for 10s, 302 for 5s
}
Defina valores de TTL separados para nomes de arquivos e URIs.