Le comportement de ces fonctions est affecté par la configuration dans le fichier php.ini.
Bien que les réglages par défaut d'APCu fonctionnent correctement sur de nombreuses installations, il est utile de penser à ajuster ces paramètres de configuration.
Une question importante pour la configuration d'APCu est
quelle est la taille adéquate qui doit être allouée dans la mémoire à APCu.
La directive ini qui contrôle ce paramètre est apc.shm_size.
Le paragraphe ci-dessous est important pour répondre à cette question.
Une fois le serveur lancé, le script apc.php, disponible avec
l'extension, peut être copié dans le document root et exécuté par le
navigateur. Ce script fournit une analyse détaillée du fonctionnement interne
de APCu. Si la bibliothèque GD est activée dans PHP alors le script peut afficher
des graphiques pertinents. Par exemple, si APCu est en fonctionnement, le nombre
Cache full count (sur la gauche) indique le nombre de fois que
le cache a atteint sa capacité maximale et a été obligé de supprimer toute entrée
qui n'a pas été appelée dans les dernières apc.ttl secondes.
Ce nombre doit être le plus petit possible pour une configuration optimale.
Si le cache est constamment rempli, il sera obligé de libérer de l'espace ce qui
aura pour conséquence de diminuer ses performances.
La méthode la plus simple pour minimiser ce nombre est d'allouer plus de mémoire à
APCu.
Lorsque APCu est compilé avec mmap (Memory Mapping), il n'utilisera qu'un seul
segment de mémoire, contrairement au cas où APCu est construit avec
SHM (SysV Shared Memory) qui utilise plusieurs segments de mémoire. MMAP n'a
pas de limite maximale comme SHM dans /proc/sys/kernel/shmmax.
En général, l'utilisation de MMAP est recommandée car il réclame la mémoire
plus vite lorsque le serveur web est redémarré et réduit l'impact sur
l'allocation de mémoire au démarrage.
| Nom | Défaut | Modifiable | Historique |
|---|---|---|---|
| apc.enabled | "1" | PHP_INI_SYSTEM | |
| apc.shm_segments | "1" | PHP_INI_SYSTEM | |
| apc.shm_size | "32M" | PHP_INI_SYSTEM | |
| apc.entries_hint | "4096" | PHP_INI_SYSTEM | |
| apc.ttl | "0" | PHP_INI_SYSTEM | |
| apc.gc_ttl | "3600" | PHP_INI_SYSTEM | |
| apc.mmap_file_mask | NULL | PHP_INI_SYSTEM | |
| apc.slam_defense | "1" | PHP_INI_SYSTEM | |
| apc.enable_cli | "0" | PHP_INI_SYSTEM | |
| apc.use_request_time | "0" | PHP_INI_ALL | Antérieurement à APCu 5.1.19, la valeur par défaut était "1". |
| apc.serializer | "php" | PHP_INI_SYSTEM | Antérieurement à APCu 5.1.15, la valeur par défaut était "default". |
| apc.coredump_unmap | "0" | PHP_INI_SYSTEM | |
| apc.preload_path | NULL | PHP_INI_SYSTEM |
Voici un éclaircissement sur l'utilisation des directives de configuration.
apc.enabled
bool
apc.enabled peut être mis à 0 pour désactiver APC.
Cela peut s'avérer utile lorsqu'APC est compilé statiquement dans PHP
puisqu'il n'y a pas d'autre moyen de le désactiver (lorsque APC est
compilé en tant que DSO, la ligne extension
dans le fichier php.ini peut simplement être mise en
commentaire).
apc.shm_segments
int
Le nombre de segments de mémoire partagée à allouer au cache de compilation
Si APC manque de mémoire partagée mais que apc.shm_size
est mis à la valeur maximale autorisée par le système, alors augmenter
cette valeur peut empêcher APC d'épuiser sa mémoire.
apc.shm_size
string
La taille de chaque segment de mémoire partagée donnée en notation abrégée comme indiquée dans cette FAQ. Par défaut, certains systèmes (dont la plus part des variants de BSD) ont une limite très basse pour la taille d'un segment de mémoire partagée.
apc.entries_hint
int
Un "indice" sur le nombre de variables distinctes qui peuvent être stockées. Mettre à zéro ou dans le doute omettre.
apc.ttl
int
La durée en seconde qu'une entrée de cache est autorisée à
rester inactive dans son emplacement, au cas où cet emplacement
est réclamée par une autre entrée. Laisser à zéro cette valeur
signifie que potentiellement, le cache d'APC pourrait être
rempli par des entrées jamais appelées alors que de nouvelles
entrées ne seront pas mises en cache. Lorsqu'un événement signalant le manque
de mémoire disponible se produit, le cache sera complètement effacé si
apc.ttl est égal à 0. Sinon, lorsque
apc.ttl est strictement supérieur à 0, APC tentera
de retirer les entrées dont la durée de vie a expiré.
apc.gc_ttl
int
La durée en seconde qu'une entrée de cache peut rester dans la liste du ramasse-miettes. Cette valeur fournit une sûreté intégrée dans le cas où un processus s'arrête pendant qu'il exécute le code d'un fichier source mis en cache; si ce fichier est modifié, la mémoire allouée pour l'ancienne version ne sera pas réclamée tant que la durée de vie n'est pas atteinte. Mettre à zéro pour désactiver cette fonctionnalité.
apc.mmap_file_mask
string
Si APCu a été compilé avec l'option MMAP en utilisant
--enable-mmap, ce paramètre reçoit le masque de
fichier de type mktemp-style à passer au module mmap pour déterminer
si la région de la mémoire utilisant mmap sera sauvegardée par le biais
d'un fichier ou par celui de la mémoire partagée.
Dans le cas où la sauvegarde se fait par le biais d'un fichier,
le masque sera de la forme /tmp/apc.XXXXXX
(avec exactement 6 X).
Pour utiliser shm_open/mmap de la norme POSIX, le masque doit contenir
.shm, comme dans l'exemple suivant:
/apc.shm.XXXXXX. Ce paramètre peut être défini par
/dev/zero pour utiliser l'interface
/dev/zero du noyau avec une mémoire utilisant mmap
anonymement. Laisser ce paramètre indéfini forcera un mmap anonyme.
apc.slam_defense
int
Au démarrage ou lors de la modification d'un fichier dans un serveur
très occupé, plusieurs processus peuvent entrer en compétition
pour mettre en cache un même fichier en même temps. Cette option
permet de définir la proportion des processus qui ne tenteront pas
de mettre en cache le même fichier au même instant, exprimée en
pourcentage. Autrement dit, elle définit la probabilité qu'un
seul processus n'essaie pas d'accéder au cache. Par exemple
définir apc.slam_defense
à 75 signifie qu'il y a 75% de chance pour
qu'un processus ne mette pas en cache un fichier non présent dans le
cache. Donc plus cette valeur est haute et plus la protection
contre le cache slam est importante. Mettre cette valeur à
0 désactive cette option.
apc.enable_cli
int
Principalement utilisé pour les tests et le débogage. Définir ce paramètre permet d'activer APC dans la version CLI de PHP. En temps normal, il n'est pas idéal de créer, alimenter et détruire le cache APC à chaque requête CLI. Cependant, dans de nombreux scénarios de test il est utile de pouvoir activer facilement APC dans la version CLI de PHP.
apc.serializer
string
Ce paramètre permet à APC d'utiliser un linéariseur tiers
apc.coredump_unmap
bool
Active la gestion par APC de signaux, tels que SIGSEGV, qui provoquent l'écriture de fichiers core dump lorsqu'ils sont reçus. Quand ces signaux sont reçus, APC essaiera de désallouer le segment de mémoire partagée réservé à mmap dans le but de l'exclure du fichier core dump. Cette option peut améliorer la stabilité du système lorsque des signaux fatals sont reçus et qu'APC est configuré avec un long segment de mémoire partagée.
Cette option est potentiellement dangereuse. Désallouer un segment de mémoire partagée utilisé par mmap dans le gestionnaire de signaux fatals peut causer un comportement imprévisible si une erreur fatale survient.
Note:
Bien que certains noyaux peuvent fournir la possibilité d'ignorer de nombreux types de mémoire partagée lorsqu'ils génèrent un fichier core dump, ces implémentations peuvent aussi ignorer d'importants segments de mémoire partagée tels que le tableau de bord d'Apache.
apc.preload_path
string
Optionnel, définit un chemin vers le répertoire où APC chargera les données du cache au démarrage.
apc.use_request_time
bool
Utilise la requête start time de l'interface SAPI pour la durée de vie (TTL).