Configuration à l'exécution

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

Le tableau suivant répertorie et explique les paramètres de configuration fournis par l'extension WinCache :

Options de configuration WinCache

Nom	Défaut	Minimum	Maximum	Modifiable	Historique
wincache.fcenabled	"1"	"0"	"1"	INI_ALL	Disponible depuis WinCache 1.0.0
wincache.fcenabledfilter	"NULL"	"NULL"	"NULL"	INI_SYSTEM	Disponible depuis WinCache 1.0.0
wincache.fcachesize	"24"	"5"	"255"	INI_SYSTEM	Disponible depuis WinCache 1.0.0
wincache.fcndetect	"1"	"0"	"1"	INI_SYSTEM	Disponible depuis WinCache 1.1.0
wincache.maxfilesize	"256"	"10"	"2048"	INI_SYSTEM	Disponible depuis WinCache 1.0.0
wincache.ocenabled	"1"	"0"	"1"	INI_ALL	Disponible depuis WinCache 1.0.0. Supprimé depuis 2.0.0.0
wincache.ocenabledfilter	"NULL"	"NULL"	"NULL"	INI_SYSTEM	Disponible depuis WinCache 1.0.0. Supprimé depuis 2.0.0.0
wincache.ocachesize	"96"	"15"	"255"	INI_SYSTEM	Disponible depuis WinCache 1.0.0. Supprimé depuis 2.0.0.0
wincache.filecount	"4096"	"1024"	"16384"	INI_SYSTEM	Disponible depuis WinCache 1.0.0
wincache.chkinterval	"30"	"0"	"300"	INI_SYSTEM	Disponible depuis WinCache 1.0.0
wincache.ttlmax	"1200"	"0"	"7200"	INI_SYSTEM	Disponible depuis WinCache 1.0.0
wincache.enablecli	0	0	1	INI_SYSTEM	Disponible depuis WinCache 1.0.0
wincache.ignorelist	NULL	NULL	NULL	INI_ALL	Disponible depuis WinCache 1.0.0
wincache.namesalt	NULL	NULL	NULL	INI_SYSTEM	Disponible depuis WinCache 1.0.0
wincache.ucenabled	1	0	1	INI_SYSTEM	Disponible depuis WinCache 1.1.0
wincache.ucachesize	8	5	85	INI_SYSTEM	Disponible depuis WinCache 1.1.0
wincache.scachesize	8	5	85	INI_SYSTEM	Disponible depuis WinCache 1.1.0
wincache.rerouteini	NULL	NULL	NULL	INI_SYSTEM	Disponible depuis WinCache 1.2.0. Retiré dans la version 1.3.7
wincache.reroute_enabled	1	0	1	INI_SYSTEM|INI_PERDIR	Disponible depuis WinCache 1.3.7
wincache.srwlocks	1	0	1	INI_SYSTEM	Disponible depuis WinCache 1.3.6.3. Supprimé depuis la version 2.0.0.0
wincache.filemapdir	NULL	NULL	NULL	INI_SYSTEM	Disponible depuis WinCache 1.3.7.4

Pour plus de détails sur les modes INI_*, reportez-vous à Où une directive de configuration peut être modifiée.

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

wincache.fcenabled bool

Active ou désactive la fonctionnalité de cache de fichiers.

wincache.fcenabledfilter string

Définit une liste séparée par des virgules, d'identificateurs de site Web IIS où le cache de fichiers doit être activé ou désactivé. Ce paramètre fonctionne en conjonction avec wincache.fcenabled : Si wincache.fcenabled est réglé à 1, alors les sites listés dans wincache.fcenabledfilter auront le cache de fichiers désactivé; si wincache.fcenabled est réglé à 0, alors les sites listés dans wincache.fcenabledfilter auront le cache de fichiers activé.

wincache.fcachesize int

Définit la taille maximale de mémoire (en mégaoctets) qui est allouée pour le cache de fichiers. Si la taille totale de tous les fichiers en cache dépasse la valeur spécifiée dans ce paramètre, alors la plupart des fichiers périmés seront retirés du cache de fichiers.

wincache.fcndetect bool

Active ou désactive les notifications de détection de modification de fichier. Si la notification est supportée, alors elle sera utilisée pour rafraîchir l'opcode ainsi que les entrées du fichier présentes dans le cache aussitôt la modification correspondante des fichiers effectuée sur le système de fichiers. Si la notification n'est pas supportée, par exemple lors de l'utilisation de fichiers partagés par le réseau, alors Wincache vérifiera les modifications de fichiers à intervalle régulier spécifié par le paramètre wincache.chkinterval.

wincache.maxfilesize int

Définit la taille maximale autorisée (en kilo-octets) pour un fichier unique qui sera mis en cache. Si un fichier a une taille supérieure à la valeur spécifiée, le fichier ne sera pas mis en cache. Ce paramètre s'applique à la mémoire cache de fichier seulement.

wincache.ocenabled bool

Avertissement

Cette option a été SUPPRIMEE depuis la version 2.0.0.0

Active ou désactive la fonctionnalité de cache opcode

wincache.ocenabledfilter string

Avertissement

Cette option a été SUPPRIMEE depuis la version 2.0.0.0

Définit une liste séparée par des virgules, d'identificateurs de site Web IIS où le cache opcode doit être activé ou désactivé. Ce paramètre fonctionne en conjonction avec wincache.ocenabled : Si wincache.ocenabled est réglé à 1, alors les sites listés dans wincache.ocenabledfilter auront le cache opcode désactivé; si wincache.ocenabled est réglé à 0, alors les sites listés dans wincache.ocenabledfilter auront le cache opcode activé.

wincache.ocachesize int

Avertissement

Cette option a été SUPPRIMEE depuis la version 2.0.0.0

Définit la taille maximale de mémoire (en mégaoctets) qui est allouée pour le cache opcode. Si la taille du cache opcode dépasse la valeur spécifiée, alors l'opcode le plus ancien sera retiré du cache. Il est à noter que la taille du cache d'opcode doit être au moins 3 fois plus grande que la taille du cache de fichiers. Si ce n'est pas le cas la taille du cache opcode sera automatiquement augmentée.

wincache.filecount int

Définit combien de fichiers sont censés être mis en cache par l'extension, de sorte à ce qu'un montant de mémoire suffisant soit alloué au démarrage. Si le nombre de fichiers excède la valeur spécifiée, WinCache ré-allouera plus de mémoire comme demandé.

wincache.chkinterval int

Définit la fréquence (en secondes) à laquelle l'extension vérifiera les changements de fichier de façon à rafraîchir le cache. Mettre cette option à 0 permet de désactiver le rafraîchissement du cache. Les changements de fichiers ne seront pas reflétés dans le cache à moins que l'entrée de cache soit supprimée par le récupérateur, que le pool d'applications IIS soit recyclé, ou que la fonction wincache_refresh_if_changed soit appelée.

wincache.ttlmax int

Définit le temps de vie maximale (en secondes) pour une entrée de cache sans être utilisée. Définir ce paramètre à 0 désactive le récupérateur de cache, de façon à ce que les entrées du cache ne soient jamais supprimées du cache pendant la durée de vie du processus de travail IIS.

wincache.enablecli bool

Définit si le cache est activé lorsque PHP fonctionne en ligne de commande (CLI) .

wincache.ignorelist string

Définit une liste de fichiers qui ne doivent pas être mis en cache par l'extension. La liste des fichiers est spécifiée en utilisant des noms de fichiers uniquement, séparés par le symbole pipe - "|".

Exemple #1 wincache.ignorelist exemple

wincache.ignorelist = "index.php|misc.php|admin.php"

wincache.namesalt string

Définit une chaîne qui sera utilisée lors du nommage des objets spécifiques à l'extension qui seront stockés dans la mémoire partagée. Ce paramètre est utilisé afin d'éviter les conflits qui peuvent être provoqués si d'autres applications dans un processus de travail IIS tentent d'accéder à la mémoire partagée. La longueur de la chaîne namesalt ne peut être supérieure à 8 caractères.

wincache.ucenabled bool

Active ou désactive la fonctionnalité de cache utilisateur.

wincache.ucachesize int

Définit la taille maximale de mémoire (en mégaoctets) qui est allouée pour le cache utilisateur. Si la taille totale des variables stockées dans le cache utilisateur dépasse la valeur spécifiée, alors les plus anciennes variables seront retirées du cache.

wincache.scachesize int

Définit la taille maximale de mémoire, en méga-octets, à allouer pour le cache de la session. Si la taille totale des données stockées dans le cache de la session excède la valeur spécifiée, alors les données les plus anciennes seront supprimées du cache.

wincache.rerouteini string

Avertissement

Cette option a été SUPPRIMEE depuis la version 1.3.7. Voir wincache.reroute_enabled pour des fonctionnalités similaires depuis la version 1.3.7.

Indique un chemin absolu ou relatif vers le fichier reroute.ini contenant une liste de fonctions PHP dont les implémentations devraient être remplacées par les équivalents Wincache. Si un chemin relatif est passé, il est supposé relatif au fichier php-cgi.exe.

wincache.reroute_enabled bool

Active ou désactive le reroutage de certaines fonctions d'entrées sorties sur des fichiers au travers du cache fichier

wincache.srwlocks bool

Avertissement

Cette option a été SUPPRIMEE depuis la version 2.0.0.0

Active ou désactive l'utilisation de verrous partagés en lecture écriture. Le désactiver peut être utile lorsque surviennent des problèmes d'interblocage dans WinCache.

wincache.filemapdir string

Spécifie un chemin absolu vers un dossier où WinCache va stocker les fichiers temporaires utilisés pour les segments de mémoire partagés.

Ce dossier doit être sur la machine locale et non sur un système de fichier en réseau.

Si le dossier n'est pas précisé, WinCache va utiliser le Windows System Page File pour tous les segments de mémoire partagés.

[Editor's note: fixed typo]

Just a quick note about something I've discovered through debugging a recent WinCache issue:

If you change the wincache.scachesize value, you MUST shutdown all php-cgi.exe instances and manually delete the wincache_session_*.tmp file. 

The wincache_session_*.tmp file will in the directory specified by session.save_path in the php.ini file.

An example session file name would look like: wincache_session_1_565779.tmp

If you don't delete this file, you will run into corruption in cross-process shared memory segments for the WinCache session handler.  These will show up as 500 errors from your IIS server.

Thx!

    --E.

wincache.php showed in Session Cache Overview that the Available Memory was returning NAN B.  

A Google search returned nothing specific to this.  

Stopping the App Pool and Deleting the *session*.tmp file in the windows temp directory solved this issue. (Thanks to previous noter)