OPcache accélère PHP en conservant en mémoire partagée le bytecode déjà compilé des scripts. PHP n’a donc plus besoin de relire, analyser et compiler les mêmes fichiers à chaque requête.
L’extension est intégrée à PHP depuis la version 5.5. Sur une installation moderne, elle est souvent déjà disponible, mais il faut vérifier qu’elle est réellement chargée et activée dans le bon environnement : ligne de commande, PHP-FPM ou module Apache.
Comment fonctionne OPcache ?
- PHP lit le fichier source.
- Le moteur compile ce code en opcodes.
- OPcache conserve ces opcodes en mémoire partagée.
- Les requêtes suivantes réutilisent directement la version compilée.
OPcache évite donc une partie du travail de préparation du code. Il ne met pas en cache les réponses HTTP, les résultats SQL ou les objets métier.
Vérifier si OPcache est disponible
Depuis un terminal :
php -v
php -m | grep -i opcache
php --ri "Zend OPcache"
La dernière commande affiche la configuration réellement chargée par le PHP utilisé en ligne de commande.
Attention : PHP CLI et PHP-FPM peuvent utiliser deux fichiers php.ini différents. Pour connaître les fichiers lus par le terminal :
php --ini
Pour PHP-FPM, il faut vérifier le pool ou utiliser temporairement phpinfo() depuis le serveur web, puis supprimer cette page car elle expose de nombreuses informations techniques.
Installer et activer l’extension
Sur Debian ou Ubuntu, le paquet correspondant à la version de PHP peut être installé ainsi :
sudo apt update
sudo apt install php-opcache
Après toute modification, redémarrez le service qui exécute PHP, par exemple :
sudo systemctl restart php8.4-fpm
Adaptez le numéro de version à votre installation. Dans de nombreux paquets PHP, le chargement de l’extension est configuré automatiquement. Sinon, OPcache se charge comme une extension Zend :
zend_extension=opcache
Configuration de départ
Voici une base volontairement prudente à adapter à la taille de l’application et à la mémoire disponible :
opcache.enable=1
opcache.memory_consumption=128
opcache.interned_strings_buffer=16
opcache.max_accelerated_files=10000
opcache.validate_timestamps=1
opcache.revalidate_freq=2
opcache.save_comments=1

À quoi servent ces directives ?
opcache.enableactive OPcache pour les requêtes web.opcache.memory_consumptionréserve la mémoire partagée destinée au bytecode.opcache.interned_strings_bufferréserve de la mémoire aux chaînes internées.opcache.max_accelerated_fileslimite le nombre de scripts conservés.opcache.validate_timestampsdemande à OPcache de détecter les fichiers modifiés.opcache.revalidate_freqdéfinit l’intervalle de cette vérification.opcache.save_commentsconserve les commentaires de documentation, encore utilisés par certains outils et frameworks.
Développement et production
En développement, gardez généralement la validation des dates active afin que les modifications du code soient détectées :
opcache.validate_timestamps=1
opcache.revalidate_freq=0
En production, certaines équipes désactivent cette validation pour supprimer les vérifications de fichiers :
opcache.validate_timestamps=0
Dans ce cas, le processus de déploiement doit obligatoirement réinitialiser OPcache ou redémarrer PHP-FPM. Sinon, l’application peut continuer à exécuter l’ancienne version du code.
Contrôler l’état du cache
La fonction opcache_get_status() retourne notamment l’utilisation de la mémoire, le nombre de scripts en cache et les statistiques de hits :
<?php
$status = opcache_get_status(false);
var_dump([
'enabled' => $status !== false,
'memory' => $status['memory_usage'] ?? null,
'statistics' => $status['opcache_statistics'] ?? null,
]);
N’exposez pas cette page publiquement. Utilisez-la temporairement, dans un environnement protégé, ou depuis un outil d’administration sécurisé.
Les principales fonctions OPcache
- opcache_compile_file() compile et met un script en cache sans l’exécuter.
- opcache_get_configuration() retourne la configuration du cache.
- opcache_get_status() retourne son état et ses statistiques.
- opcache_invalidate() invalide un fichier précis.
- opcache_is_script_cached() indique si un script est présent dans le cache.
- opcache_reset() demande la réinitialisation complète du cache.
OPcache n’est pas APCu
Les deux extensions utilisent de la mémoire partagée, mais elles ne répondent pas au même besoin :
- OPcache conserve le code PHP compilé.
- APCu conserve des données applicatives placées explicitement dans le cache.
Une application peut utiliser les deux simultanément.
Bonnes pratiques
- Mesurez l’utilisation réelle avec
opcache_get_status()avant d’augmenter la mémoire. - Vérifiez le taux de remplissage et le nombre de redémarrages du cache.
- Conservez
opcache.save_comments=1sauf si vous maîtrisez toutes les dépendances de l’application. - Intégrez l’invalidation ou le redémarrage de PHP-FPM au déploiement.
- Ne publiez jamais une page de diagnostic OPcache sans protection.
