Manuel PHP

Table des matières

Préface
I. Au moment de commencer
II. Installation et configuration
III. Référence du langage
IV. Sécurité
V. Caractéristiques
VI. Référence des fonctions
VII. PHP et le moteur interne Zend
VIII. FAQ : foire Aux Questions
IX. Annexes
Remerciements



LXXXIV. Fonctions Memcache

Introduction

Le module “Memcache” fournit une interface procédurale maniable ainsi qu’orientée objet à “Memcache”, un démon fortement efficace dans la gestion du cache, qui est principalement destiné à faire baisser la charge des bases de données dans les applications web dynamiques.

Plus d’informations concernant “Memcache” peuvent être consultées sur http://www.danga.com/memcached/.

Pré-requis

Ce module utilise les fonctions de la bibliothèque zlib pour supporter la compression des données à la volée. Zlib est donc requis pour installer ce module.

PHP 4.3.3 ou supérieur est requis pour utiliser l’extension “Memcache”.

Installation

Cette extension PECL n’est pas intégrée à PHP. Des informations sur l’installation de ces extensions PECL peuvent être trouvées dans le chapitre du manuel intitulé Installation des extensions PECL. D’autres informations comme les notes sur les nouvelles versions, les téléchargements, les sources des fichiers, les informations concernant les mainteneurs ainsi qu’un CHANGELOG, peuvent être trouvées ici : http://pecl.php.net/package/memcache.

Pour utiliser ces fonctions, vous devez compiler PHP avec le support MemCache en utilisant l’option de configuration “–enable-memcache[=DIR]”.

Les utilisateurs de Windows doivent activer la bibliothèque “php_memcache.dll” dans le “php.ini” pour pouvoir utiliser ces fonctions. Vous pouvez télécharger ces bibliothèques DLL pour ces extensions PECL depuis la page de téléchargement de PHP sous sur la page http://snaps.php.net/.

Configuration à l'exécution

Le comportement de ces fonctions est affecté par la configuration dans le fichier “php.ini”.

Tableau 1. Options de configuration Memcache

Nom Défaut Modifiable Changelog
memcache.allow_failover “1” PHP_INI_ALL Disponible depuis Memcache 2.0.2
memcache.max_failover_attempts “20” PHP_INI_ALL Disponible depuis Memcache 2.1.0
memcache.chunk_size “8192” PHP_INI_ALL Disponible depuis Memcache 2.0.2
memcache.default_port “11211” PHP_INI_ALL Disponible depuis Memcache 2.0.2

Pour plus de détails sur les constantes PHP_INI_*, reportez-vous à Annexe G.

Voici un éclaircissement sur l’utilisation des directives de configuration.

“memcache.allow_failover” booléen

Si l’on doit basculer sur d’autres serveurs en cas d’erreur.

“memcache.max_failover_attempts” entier

Définit combien de serveurs à essayer lorsque l’on fixe ou récupère des données. Utilisez seulement en conjonction avec memcache.allow_failover.

“memcache.chunk_size” entier

Les données doivent être transférées en morceaux de cette taille ; Configurer cette valeur à une petite valeur provoque plus d’écritures sur le réseau. Essayez d’augmenter cette valeur à 32768 si vous rencontrez des ralentissements inexplicables.

“memcache.default_port” chaîne de caractères

Le numéro du port TCP par défaut à utiliser lors de la connexion au serveur memcache si aucun autre port n’est spécifié.

Types de ressources

Il n’y a qu’une seule ressource utilisée par le module “Memcache” : c’est le lien identifiant représentant la connexion du serveur de cache.

Constantes pré-définies

Tableau 2. Constantes MemCache

Nom Description
“MEMCACHE_COMPRESSED” (entier) Utilisée pour activer à la volée la compression des données avec les fonctions Memcache::set(), Memcache::add() et Memcache::replace().

Exemples

Memcache::add – Ajout d’un élément au serveurMemcache::addServer – Ajoute un serveur “memcache” à la liste de connexionMemcache::close – Ferme la connexion avec le serveur “Memcache”Memcache::connect – Ouvre une connexion avec le serveur “Memcache”memcache_debug – Active ou non l’affichage des informations de débogageMemcache::decrement – Décrémente la valeur d’un élémentMemcache::delete – Efface un élément du serveur de cacheMemcache::flush – Efface tous les éléments existant sur le serveur de cacheMemcache::get – Récupère un élément du serveur de cacheMemcache::getExtendedStats – Récupère des statistiques de tous les serveurs dans la listeMemcache::getServerStatus – Retourne le statut du serveurMemcache::getStats – Lit les statistiques du serveurMemcache::getVersion – Retourne le numéro de version du serveurMemcache::increment – Incrément la valeur d’un élémentMemcache::pconnect – Ouvre un connexion persistante à un serveur de cacheMemcache::replace – Remplace une valeur d’un élément existantMemcache::set – Stocke des données dans le serveur de cacheMemcache::setCompressThreshold – Active la compression automatique des valeurs largesMemcache::setServerParams – Modifit les paramètres et les statuts du serveur pendant l’exécution

Travail collaboratif

Contribuez, en ajjoutant des elements a cette page de manuel :

Merci de votre aide
L’equipe Php.fr

 


Index | Afficher le texte source | Anciennes révisions | Derniers changements | Connexion
©2007 Wiki Copyright