La classe APCIterator

(PECL apc >= 3.1.1)

Introduction

La classe APCIterator simplifie l'itération sur des caches APC volumineux. C'est utile car cela permet d'itérer sur des gros caches par lots, en récupérant un nombre défini d'entrées par instance de verrou, permettant ainsi de libérer les verrous pour d'autres activités, plutôt que de bloquer tout le cache pour récupérer (par défaut) 100 entrées. Aussi, l'utilisation d'expressions rationelles est plus efficace, car l'implémentation a été faite au niveau C.

Synopsis de la classe

APCIterator implements Iterator {

/* Méthodes */

public __construct ( string $cache [, mixed $search = NULL [, int $format = APC_ITER_ALL [, int $chunk_size = 100 [, int $list = APC_LIST_ACTIVE ]]]] )

public current ( void ) : mixed

public getTotalCount ( void ) : int

public getTotalHits ( void ) : int

public getTotalSize ( void ) : int

public key ( void ) : string

public next ( void ) : bool

public rewind ( void ) : void

public valid ( void ) : bool

}

Sommaire

APCIterator::__construct — Construit un objet d'itération APCIterator
APCIterator::current — Récupère l'élément en cours
APCIterator::getTotalCount — Récupère le nombre total d'éléments
APCIterator::getTotalHits — Récupère le nombre total de cache hits
APCIterator::getTotalSize — Récupère la taille totale du cache
APCIterator::key — Récupère la clé de l'itérateur
APCIterator::next — Déplace le pointeur vers l'élément suivant
APCIterator::rewind — Rembobine l'itérateur
APCIterator::valid — Vérifie si la position courante de l'itérateur est valide

add a note

User Contributed Notes 1 note

down

Stefan W ¶

11 years ago


This class will NOT EXIST if the APC extension is installed but disabled in your php.ini.

This is an important difference to functions like apc_store(), which will still exist and be callable even when APC is disabled. In many installations, the default settings are

   apc.enabled = on
   apc.enable_cli = off

which means that APCIterator exists for HTTP requests, but not with the "cli" SAPI. The solution is to either set "apc.enable_cli" to "on" (with the resultant startup penalty for CLI scripts), or to check the relevant ini settings before your script tries to access APCIterator.

add a note