PEAR_REST::saveCache
Prev Next

PEAR_REST::saveCache

PEAR_REST::saveCache() – Sauvegarde la valeur récupérée depuis une ressource REST distante dans le cache local

Synopsis

require_once '/REST.php';

void PEAR_REST::saveCache ( string $url , mixed $contents , array $lastmodified , bool $nochange = false )

Description

Utiliser pour sauvearder une ressource après sa récupération. Puisque la variable de configuration cache_ttl est utilisé pour déterminer le moment où l'on doit analyser le serveur distant et que le cache HTTP est également utilisé, il est possible de se retrouver dans cette situation :

  1. Ressource REST à récupérer

  2. Mise en cache de la ressource

  3. quelques jours plus tard, nouvelle récupération de la ressource REST

  4. Le cache HTTP retourne un en-tête 304, non modifié

Dans cette situation, cela n'a aucun sens de sauvegarder le contenu de la ressource une nouvelle fois. Dans ce cas, la date et heure du dernier accès peut être sauvegardé dans l'identifiant de cache en passant la valeur TRUE dans le dernier paramètre.

Parameter

string $url

l'URL de la ressource REST

mixed $contents

Contenu récupéré depuis la ressource REST (ignoré si le dernier paramètre vaut TRUE)

array $lastmodified

Les en-têtes ETag et LastModified récupérés depuis le serveur distant, utilisés pour le cache HTTP.

mixed $nochange

Si FALSE, le cache est sauvegardé normalement. Si TRUE, seul le paramètre $lastmodified est sauvegardé dans l'identifiant du fichier de cache.

Throws

No exceptions thrown.

Note

This function can not be called statically.

Prev PEAR_REST Next
PEAR_REST::retrieveData PEAR Manual PEAR_REST::useLocalCache