PHP OPcache erklärt: Bytecode-Cache prüfen, aktivieren und richtig einstellen
PHP OPcache einfach erklärt: wie der Bytecode-Cache funktioniert, wie Sie ihn prüfen und aktivieren und welche php.ini-Werte sinnvoll sind.
OPcache ist der eingebaute Bytecode-Cache von PHP. Er gehört zu den einfachsten und wirksamsten Massnahmen, um WordPress, TYPO3, Shopware, Laravel oder jede andere PHP-Anwendung zu beschleunigen. Die PHP-Dokumentation beschreibt den Zweck so: OPcache speichert vorkompilierten Bytecode der Skripte im Shared Memory, damit PHP die Skripte nicht bei jeder Anfrage neu laden und parsen muss. In diesem Artikel erfahren Sie, wie das funktioniert, wie Sie prüfen, ob OPcache aktiv ist, und welche Einstellungen in der php.ini wichtig sind.
Was OPcache genau macht
Ohne Cache durchläuft PHP bei jedem Seitenaufruf dieselben Schritte:
- PHP-Dateien von der Festplatte lesen
- Den Quelltext in Tokens zerlegen und parsen
- Daraus Bytecode (Opcodes) erzeugen
- Den Bytecode ausführen
Ein CMS lädt pro Aufruf oft Hunderte Dateien. Die Schritte 1 bis 3 sind bei unverändertem Code jedes Mal identisch, also reine Verschwendung. OPcache erledigt sie einmal, legt das Ergebnis im gemeinsamen Arbeitsspeicher ab, und alle folgenden Anfragen führen direkt den fertigen Bytecode aus.
Wichtig ist die Abgrenzung zu anderen Caches:
| Cache | Was wird gespeichert | Wirkung |
|---|---|---|
| OPcache | Kompilierter PHP-Code | PHP startet schneller, Logik und Datenbankabfragen laufen weiterhin |
| Seiten-Cache (Plugin, FastCGI-Cache, Varnish) | Fertiges HTML | PHP läuft gar nicht mehr |
| Objekt-Cache (Redis, Memcached) | Ergebnisse von Datenbankabfragen | Entlastet die Datenbank |
| Browser-Cache | Dateien beim Besucher | Wiederholte Aufrufe ohne Download |
OPcache ersetzt also keinen Seiten-Cache, sondern ergänzt ihn. Er wirkt überall dort, wo PHP tatsächlich ausgeführt wird, etwa im Admin-Bereich, im Warenkorb oder bei eingeloggten Benutzern. Die Folge ist eine kürzere Serverzeit und damit eine bessere Time to First Byte.
Ist OPcache bei Ihnen aktiv?
OPcache ist seit PHP 5.5 Bestandteil von PHP. Mit PHP 8.5 (veröffentlicht am 20. November 2025) wurde er laut den offiziellen Upgrade-Hinweisen fest in die PHP-Binärdatei eingebaut und wird immer geladen. Ob er auch tatsächlich cacht, steuern aber weiterhin die Einstellungen opcache.enable und opcache.enable_cli.
So prüfen Sie den Status:
- phpinfo(): Legen Sie kurzzeitig eine Datei mit
<?php phpinfo();an und suchen Sie den Abschnitt «Zend OPcache». Steht dort «Opcode Caching: Up and Running», ist alles in Ordnung. Löschen Sie die Datei danach wieder. - Kommandozeile:
php -i | grep opcachezeigt die Einstellungen der CLI. Achtung: Die CLI kann anders konfiguriert sein als PHP-FPM oder das Apache-Modul. - Im Hosting-Panel: Bei vielen Shared-Hosting-Anbietern lässt sich OPcache in den PHP-Einstellungen des Kundenpanels ein- und ausschalten. Fehlt die Option, fragen Sie Ihren Hoster.
OPcache aktivieren
Bis PHP 8.4 wird OPcache als Zend-Extension geladen. In der php.ini steht dann:
zend_extension=opcache
opcache.enable=1
Ab PHP 8.5 entfällt die Zeile zend_extension. Laut den Upgrade-Hinweisen erzeugt sie nun eine Warnung, weil keine separate opcache.so bzw. php_opcache.dll mehr gebaut wird. Entfernen Sie sie bei einem Upgrade deshalb aus Ihrer Konfiguration. Falls Sie zusätzlich Xdebug verwenden: OPcache muss vor Xdebug geladen werden.
Nach jeder Änderung an der php.ini starten Sie PHP-FPM bzw. den Webserver neu, zum Beispiel mit systemctl restart php8.4-fpm (Name je nach Distribution und Version).
Die wichtigsten Einstellungen
Die folgende Tabelle zeigt die Standardwerte gemäss PHP-Handbuch (Stand PHP 8.4/8.5):
| Einstellung | Standard | Bedeutung |
|---|---|---|
opcache.enable | 1 | Cache für Webanfragen ein/aus |
opcache.enable_cli | 0 | Cache für die Kommandozeile |
opcache.memory_consumption | 128 | Shared Memory in MB, Minimum 8 |
opcache.interned_strings_buffer | 8 | Speicher für mehrfach verwendete Zeichenketten in MB |
opcache.max_accelerated_files | 10000 | Maximale Anzahl gecachter Dateien (200 bis 1 000 000) |
opcache.validate_timestamps | 1 | Prüft, ob Dateien geändert wurden |
opcache.revalidate_freq | 2 | Prüfintervall in Sekunden |
opcache.save_comments | 1 | Behält DocBlock-Kommentare im Cache |
opcache.jit | disable | JIT-Compiler (siehe unten) |
opcache.jit_buffer_size | 64M | Speicher für JIT-Code (vor PHP 8.4: 0) |
memory_consumption und max_accelerated_files
Ist der Speicher voll oder die maximale Dateizahl erreicht, kann OPcache keine weiteren Skripte aufnehmen und muss den Cache irgendwann komplett neu aufbauen. Das kostet spürbar Leistung. Grosse Installationen mit vielen Plugins oder Composer-Abhängigkeiten überschreiten die Standardwerte leicht.
Eine Besonderheit von max_accelerated_files: PHP verwendet intern die nächstgrössere Primzahl aus einer festen Liste (unter anderem 7963, 16229, 32531, 65407). Ein Wert von 20000 ergibt also effektiv 32531 Plätze.
Die passenden Werte ermitteln Sie nicht nach Gefühl, sondern anhand der Statusdaten (siehe nächster Abschnitt). Erhöhen Sie die Werte, wenn der Cache voll ist oder Neustarts auftreten.
validate_timestamps und revalidate_freq
Mit den Standardwerten prüft OPcache höchstens alle 2 Sekunden, ob sich eine Datei geändert hat. Das ist bequem, kostet aber bei jeder Prüfung Dateisystemzugriffe.
Auf Produktionsservern mit kontrollierten Deployments können Sie opcache.validate_timestamps=0 setzen. Dann prüft PHP gar nicht mehr. Das PHP-Handbuch weist ausdrücklich darauf hin, dass Änderungen in diesem Fall erst wirksam werden, wenn Sie den Cache mit opcache_reset() oder opcache_invalidate() leeren oder den Webserver bzw. PHP-FPM neu starten. Vergessen Sie das, sehen Besucher nach einem Update weiterhin den alten Code.
Für Websites, auf denen Updates über das CMS-Backend eingespielt werden, etwa WordPress mit automatischen Plugin-Updates, ist validate_timestamps=1 die sichere Wahl. Ein höherer Wert für revalidate_freq, zum Beispiel 60, reduziert die Prüfungen, verzögert aber das Sichtbarwerden von Änderungen um bis zu diese Anzahl Sekunden.
save_comments
Das Abschalten spart etwas Speicher, kann laut Handbuch aber Anwendungen und Frameworks beschädigen, die Annotationen in Kommentaren auswerten, etwa Doctrine oder PHPUnit. Lassen Sie den Standardwert, sofern Sie es nicht ausführlich getestet haben.
OPcache überwachen
Die Funktion opcache_get_status(false) liefert die wichtigsten Kennzahlen, ohne Details zu jedem Skript:
<?php
$s = opcache_get_status(false);
if ($s === false) { exit("OPcache ist nicht aktiv\n"); }
$st = $s['opcache_statistics'];
printf("Trefferquote: %.2f %%\n", $st['opcache_hit_rate']);
printf("Skripte im Cache: %d von max. %d Schlüsseln\n", $st['num_cached_scripts'], $st['max_cached_keys']);
printf("Neustarts wegen Speicher / Hash-Tabelle: %d / %d\n", $st['oom_restarts'], $st['hash_restarts']);
printf("Speicher frei: %.1f MB\n", $s['memory_usage']['free_memory'] / 1048576);
Rufen Sie das Skript über den Webserver auf, nicht über die Kommandozeile, denn die CLI hat ihren eigenen Cache. Schützen Sie die Datei vor öffentlichem Zugriff oder löschen Sie sie nach der Prüfung.
So interpretieren Sie die Werte:
| Kennzahl | Hinweis auf | Massnahme |
|---|---|---|
oom_restarts > 0 | Speicher war voll | memory_consumption erhöhen |
hash_restarts > 0 | Zu viele Dateien | max_accelerated_files erhöhen |
cache_full = true | Cache ist voll | Beide Werte prüfen |
Wenig free_memory bei interned_strings_usage | Zeichenketten-Puffer knapp | interned_strings_buffer erhöhen |
Niedrige opcache_hit_rate | Häufige Neukompilierung | Neustarts und Einstellungen prüfen |
Nach einem Neustart ist die Trefferquote zunächst niedrig, weil der Cache erst gefüllt wird. Beurteilen Sie die Werte daher erst nach einiger Laufzeit.
JIT und Preloading
JIT-Compiler
Seit PHP 8.0 enthält OPcache einen Just-in-Time-Compiler, der häufig ausgeführten Code in Maschinencode übersetzt. Seit PHP 8.4 ist er standardmässig deaktiviert (opcache.jit=disable), der Puffer von 64 MB ist aber bereits vorgesehen. Zum Einschalten setzen Sie opcache.jit=tracing, was das Handbuch für die meisten Nutzer empfiehlt.
Der JIT bringt vor allem bei rechenintensivem Code etwas. Typische Websites verbringen viel Zeit mit Datenbank- und Dateizugriffen, dort ist der Effekt oft gering. Messen Sie deshalb vor und nach dem Aktivieren, statt sich auf Pauschalaussagen zu verlassen. Ab PHP 8.4 bricht PHP übrigens mit einem Fehler ab, wenn ein aktivierter JIT nicht initialisiert werden kann.
Preloading
Seit PHP 7.4 kann OPcache mit opcache.preload beim Serverstart ein Skript ausführen, das Klassen und Funktionen dauerhaft in den Speicher lädt. Laut Handbuch erfordert jede Änderung einen Neustart des PHP-Prozesses, unter Windows wird Preloading nicht unterstützt, und der Gewinn an Geschwindigkeit wird mit höherem Grundverbrauch an Speicher erkauft. Preloading lohnt sich daher eher für Frameworks auf eigenen Servern als für typische CMS-Installationen im Shared Hosting.
Beispielkonfiguration für einen Produktionsserver
Eine mögliche Ausgangsbasis für einen eigenen Server mit PHP-FPM. Passen Sie die Werte anhand Ihrer Statusdaten an:
opcache.enable=1
opcache.memory_consumption=256
opcache.interned_strings_buffer=16
opcache.max_accelerated_files=20000
opcache.validate_timestamps=1
opcache.revalidate_freq=60
opcache.save_comments=1
Wer Deployments per Skript durchführt und danach PHP-FPM neu lädt, kann zusätzlich opcache.validate_timestamps=0 setzen.
Checkliste
- OPcache laut
phpinfo()aktiv («Up and Running») - Bei PHP 8.5: veraltete Zeile
zend_extension=opcacheentfernt -
opcache_get_status()zeigt keineoom_restartsundhash_restarts - Freier Speicher und Trefferquote nach einigen Stunden Laufzeit geprüft
-
validate_timestampspassend zum Update-Verfahren gewählt - Bei
validate_timestamps=0: Cache-Reset oder FPM-Reload im Deployment eingebaut - JIT nur nach Messung aktiviert
- Ergebnis mit TTFB-Messung überprüft, etwa in PageSpeed Insights
OPcache ist nur ein Baustein. Für schnelle Antwortzeiten kombinieren Sie ihn mit einem Seiten-Cache, aktueller PHP-Version und Gzip- oder Brotli-Komprimierung.