PEAR_REST::retrieveData (Previous) (Next) PEAR_REST::useLocalCache
View this page in Last updated: Sun, 28 Sep 2008
English | Dutch | French | German | Hungarian | Japanese | Polish | Plain HTML

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.

Paramètres

chaîne de caractères $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.

Valeurs renvoyées

Aucune exception n'est lancée.

Note

Cette fonction ne peut pas être appelée de façon statique.

PEAR_REST::retrieveData (Previous) (Next) PEAR_REST::useLocalCache
Download Documentation Last updated: Sun, 28 Sep 2008
Do you think that something on this page is wrong? Please file a bug report or add a note.
User Notes:
There are no user contributed notes for this page.