Extension OPcache : activation, configuration et vérification

Fonctionnement de l extension PHP OPcache
OPcache compile le code PHP une fois, le conserve en mémoire et le réutilise pour accélérer les requêtes suivantes.

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 ?

  1. PHP lit le fichier source.
  2. Le moteur compile ce code en opcodes.
  3. OPcache conserve ces opcodes en mémoire partagée.
  4. 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
Les quatre points essentiels de la configuration OPcache : activation, mémoire, fichiers et horodatage
Les réglages essentiels à vérifier avant d’ajuster OPcache.

À quoi servent ces directives ?

  • opcache.enable active OPcache pour les requêtes web.
  • opcache.memory_consumption réserve la mémoire partagée destinée au bytecode.
  • opcache.interned_strings_buffer réserve de la mémoire aux chaînes internées.
  • opcache.max_accelerated_files limite le nombre de scripts conservés.
  • opcache.validate_timestamps demande à OPcache de détecter les fichiers modifiés.
  • opcache.revalidate_freq définit l’intervalle de cette vérification.
  • opcache.save_comments conserve 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 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=1 sauf 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.

Pour aller plus loin