Todos los productos
Search
Centro de documentos

CDN:Funciones de caché

Última actualización: Sep 18, 2026

set_cache_ttl establece el tiempo de vida (TTL) de los recursos almacenados en la caché según la ruta o el código de estado HTTP.

set_cache_ttl

Sintaxis

set_cache_ttl(type, ttl)

Parámetros

Parámetro

Tipo

Descripción

type

character

Tipo de caché. Valores válidos: path, code.

ttl (cuando type es path)

numeric

TTL de los recursos coincidentes, en segundos.

ttl (cuando type es code)

character

Valores de TTL para códigos de estado HTTP específicos, con el formato <code>=<seconds>,.... Por ejemplo, '301=10,302=5'.

Valor de retorno

Devuelve true si la operación se completa correctamente; de lo contrario, devuelve false.

Ejemplos

Establecer el TTL por ruta

Use type='path' para aplicar un TTL a los recursos que coinciden con un patrón de URI. El valor de ttl es numérico y se expresa en 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
}

Establecer el TTL por código de estado HTTP

Use type='code' para asignar valores de TTL a códigos de estado HTTP específicos. El valor de ttl es una cadena con el formato <status-code>=<seconds>, donde varias entradas se separan con comas.

if match_re($uri, '^/image') {
    set_cache_ttl('code', '301=10,302=5')   // for /image URIs: cache 301 for 10s, 302 for 5s
}
Establezca valores de TTL independientes para los nombres de archivo y las URI.