Wie aktiviert und konfiguriert man das PHP Opcache-Modul in ServBay

ServBay ist eine leistungsstarke lokale Webentwicklungsumgebung, die speziell für Entwickler konzipiert wurde und verschiedene Technologie-Stacks, darunter PHP, integriert. Um Entwicklern zu helfen, die Performance von PHP-Anwendungen zu optimieren, ist das Opcache-Modul für jede unterstützte PHP-Version in ServBay bereits vorinstalliert. In diesem Artikel erfahren Sie, wie Sie Opcache in ServBay aktivieren und konfigurieren und wie es Ihre PHP-Entwicklung und das Testen beschleunigt.

Einführung in das Opcache-Modul

Opcache ist eine offizielle Erweiterung von PHP, die die Ausführungsgeschwindigkeit von PHP-Code verbessert. Das Kernprinzip besteht darin, vorkompilierte PHP-Skripte als Bytecode im Shared Memory zu cachen. Bei erneuten Zugriffen auf dieselben Skripte kann der gecachte Bytecode direkt verwendet werden, ohne dass Parsing, Kompilierung und Optimierung erneut durchgeführt werden müssen. Dies reduziert den Verbrauch von CPU und Speicher deutlich und beschleunigt die Reaktionszeiten von Anwendungen.

Warum ist Opcache für Entwickler wichtig?

• Beschleunigung von Entwicklung & Tests: Das Aktivieren von Opcache in Ihrer lokalen Entwicklungsumgebung macht Ihre Anwendung spürbar schneller, verkürzt Ladezeiten und erhöht Ihre Produktivität.
• Produktionsumgebung simulieren: In den meisten Live-Umgebungen ist Opcache aktiviert, um die Performance zu steigern. Die Aktivierung in der lokalen Umgebung ermöglicht es, einen produktionsnahen Zustand zu simulieren.
• Reduzierung des Ressourcenverbrauchs: Besonders bei großen Frameworks oder komplexen Anwendungen senkt Opcache die Nutzung der lokalen Systemressourcen erheblich.

Hauptfunktionen von Opcache

• Bytecode-Cache: Herzstück der Erweiterung, speichert kompilierte PHP-Dateien.
• Shared Memory: Cache wird im gemeinsamen Speicher abgelegt, sodass mehrere PHP-Prozesse darauf zugreifen können.
• Automatisches Verfallsmanagement: Opcache kann so konfiguriert werden, dass regelmäßig nach Dateiaktualisierungen gesucht wird, um die Aktualität des Caches zu gewährleisten.
• Flexible Konfiguration: Vielseitig anpassbar, sodass Entwickler individuelle Anpassungen je nach Anforderung vornehmen können.
• Integrierter Support: Als offizielle PHP-Erweiterung tief in den PHP-Kern eingebunden.

ServBay-Unterstützung für Opcache

Für alle integrierten PHP-Versionen (wie PHP 7.4, 8.0, 8.1, 8.2, 8.3, 8.4 usw.) liefert ServBay das jeweilige Opcache-Modul bereits vorinstalliert aus. Sie müssen nichts herunterladen oder kompilieren und können das Modul bequem über die grafische Oberfläche oder durch Editieren der Konfiguration aktivieren.

Wie aktiviert man das Opcache-Modul

Es gibt zwei Hauptwege, in ServBay Opcache zu aktivieren: per grafischer Benutzeroberfläche (GUI) oder durch manuelles Bearbeiten der Konfigurationsdateien.

Methode 1: Aktivierung über die ServBay-GUI (empfohlen)

Dies ist die einfachste und schnellste Methode.

1. Öffnen Sie die ServBay-App.
2. Klicken Sie in der Seitenleiste auf Languages (Sprachen).
3. Wählen Sie die gewünschte PHP-Version aus, z.B. PHP 8.3.
4. Öffnen Sie auf der rechten Seite der PHP-Detailseite den Reiter Extensions (Erweiterungen).
5. Suchen Sie in der Liste nach der OPcache-Erweiterung.
6. Aktivieren Sie den Schalter links neben OPcache.
7. Klicken Sie unten auf der Seite auf den Button Save (Speichern).
8. ServBay informiert Sie, dass ein Neustart des entsprechenden PHP-Pakets notwendig ist, um die Änderung wirksam zu machen. Klicken Sie auf Restart (Neustart).

Nach dem Neustart ist das Opcache-Modul aktiviert.

Methode 2: Manuelles Bearbeiten der Konfigurationsdatei

Für detailliertere Einstellungen oder wenn Sie die Konfiguration lieber manuell verwalten, bearbeiten Sie die .ini-Datei von Opcache.

1. Datei finden: Die Konfigurationsdatei für Opcache liegt im conf.d-Verzeichnis der jeweiligen PHP-Version. In diesem Verzeichnis werden die Einstellungen für alle geladenen PHP-Erweiterungen gespeichert.
   • Für PHP 8.3 z. B. ist der Pfad normalerweise:

     /Applications/ServBay/etc/php/8.3/conf.d/opcache.ini

   • Passen Sie die Versionsnummer im Pfad entsprechend Ihrer PHP-Version an.
2. Datei bearbeiten: Öffnen Sie die Datei opcache.ini mit Ihrem bevorzugten Texteditor.
   • In der Regel enthält diese Datei bereits das Konfigurations-Schema für Opcache; viele Zeilen sind jedoch auskommentiert. Suchen Sie nach dem Abschnitt [Zend Opcache].
   • Heben Sie die Auskommentierung (entfernen Sie das ; am Zeilenanfang) über der Zeile zend_extension = opcache.so auf, um sicherzustellen, dass die Erweiterung geladen wird.
   • Ändern oder ergänzen Sie nach Bedarf weitere Opcache-Parameter. Ein typisches Beispiel (die Parametervarianten werden im nächsten Abschnitt erläutert):

     [Zend Opcache]
     ; Ensure the extension is loaded
     zend_extension = opcache.so
     
     ; Basic Configuration (example values)
     opcache.enable = 1                 ; Opcache global aktivieren (1=aktiviert, 0=deaktiviert)
     opcache.memory_consumption = 128   ; Speichergröße für den Opcode-Cache (in MB)
     opcache.interned_strings_buffer = 8; Speicher für internierte Strings (in MB)
     opcache.max_accelerated_files = 4000 ; Maximale Anzahl der zu cachenden Dateien
     opcache.revalidate_freq = 60       ; Wie oft auf Dateiänderungen geprüft wird (in Sekunden). 0 = bei jeder Anfrage prüfen (langsam, aber gut für Entwicklung)
     opcache.fast_shutdown = 1          ; Schnelles Herunterfahren aktivieren
     opcache.enable_cli = 1             ; Opcache für die PHP CLI (Kommandozeile) aktivieren

   • Speichern Sie die Datei opcache.ini.
3. PHP-Paket neu starten: Navigieren Sie in der ServBay-App zum jeweiligen PHP-Paket (zu finden unter Packages (Pakete) in der Seitenleiste und dann PHP auswählen) und klicken Sie auf den Neustart-Button.

Nach manueller Bearbeitung und Neustart werden Opcache und die neue Konfiguration aktiv.

Überprüfen, ob das Opcache-Modul geladen ist

Der zuverlässigste Weg, Opcache zu prüfen, ist der Blick in die PHP-Konfigurationsinformation (phpinfo()).

1. phpinfo.php anlegen: Erstellen Sie im Webverzeichnis in ServBay eine Datei wie phpinfo.php. Das Standardwebverzeichnis ist /Applications/ServBay/www/. Erstellen Sie zur besseren Übersicht ggf. ein Unterverzeichnis, z. B. /Applications/ServBay/www/servbay.demo/, und platzieren Sie die Datei dort. Der Inhalt:

   <?php
   phpinfo();
   ?>

2. Seite im Browser aufrufen: Stellen Sie sicher, dass Ihr Webserver (Caddy, Nginx o. Ä.) läuft und für das richtige Verzeichnis konfiguriert ist. Öffnen Sie die entsprechende URL im Browser.
   • Liegt die Datei in /Applications/ServBay/www/servbay.demo/ und zeigen Sie per ServBay-Domain servbay.demo darauf, dann besuchen Sie z. B. http://servbay.demo/phpinfo.php.
   • Liegt die Datei im Standardverzeichnis /Applications/ServBay/www/ und die Standard-Domain zeigt darauf, ist die URL z. B. http://localhost/phpinfo.php oder die von ServBay bereitgestellte Adresse.
3. Opcache-Infos suchen: Scrollen Sie auf der angezeigten phpinfo()-Seite oder verwenden Sie die Suchfunktion (Cmd+F bzw. Ctrl+F), um nach "Opcache" zu suchen.
   • Wird Opcache erfolgreich geladen, erscheint ein eigener Abschnitt "Zend Opcache". Hier sehen Sie Version, Status und aktuelle Konfigurationswerte.
   • Ist der Abschnitt "Zend Opcache" nicht zu finden, wurde das Modul nicht geladen. Gehen Sie die obenstehenden Schritte noch einmal durch und prüfen Sie Ihre Einstellungen.

Abbildung: Zend Opcache-Block in der phpinfo-Ausgabe finden

Erklärung der wichtigsten Opcache-Parameter

Opcache bietet zahlreiche Konfigurationsoptionen, die Sie je nach Bedarf in der Datei opcache.ini anpassen können. Die wichtigsten Parameter mit Erklärung:

[Zend Opcache]
; Stellt sicher, dass die Erweiterung geladen ist
zend_extension = opcache.so

; Aktiviert Opcache. 0 = deaktiviert, 1 = aktiviert. Die GUI schaltet diesen Wert.
opcache.enable = 1

; Anteil des Shared Memory in MB für cachierten Bytecode.
; Anhand der Projektgröße und des verfügbaren Speichers anpassen. Große Projekte benötigen mehr.
opcache.memory_consumption = 128

; Shared Memory für internierte Zeichenketten (z. B. Klassen- und Methodennamen), in MB.
; Bei Frameworks mit vielen Strings (wie Symfony) ggf. Wert erhöhen.
opcache.interned_strings_buffer = 8

; Maximale Anzahl an Dateien, die von Opcache gecacht werden können.
; Übersteigt die Anzahl der Projektdateien diesen Wert, werden einige nicht gecacht. Legen Sie ihn daher etwas höher als die tatsächliche Datei-Anzahl.
opcache.max_accelerated_files = 10000

; Zeitintervall für das Prüfen auf Scriptänderungen (Sekunden).
; In Produktionsumgebungen meist ein hoher Wert (z. B. 300 oder 600), evtl. auch 0 (nur manuelles Cache Leeren).
; **Für lokale Entwicklung klein einstellen, z. B. 1 oder 2 Sekunden.** Bei 0 prüft Opcache jede Anfrage auf Änderungen (langsamer, aber für Entwicklung hilfreich).
opcache.revalidate_freq = 2

; Schnelles Speicherbereinigung nach Anfrageende.
opcache.fast_shutdown = 1

; Opcache für PHP CLI (Kommandozeile) aktivieren.
; Nützlich für Skripte, Composer, Unit-Tests etc.; meist sinnvoll.
opcache.enable_cli = 1

; Soll freier Shared Memory freigegeben werden? Kann in einigen Fällen Speicher sparen, beeinträchtigt aber ggf. die Leistung. Meist Standard oder deaktiviert lassen.
; opcache.enable_file_override = 0

; Sollen beim Cachen die Kommentare ignoriert werden? Aktivieren spart Speicher, beeinflusst aber ggf. Tools, die auf Kommentare zugreifen.
; opcache.save_comments = 1

; Dokumentationskommentare (DocBlocks) beim Cachen beibehalten. Für Tools wie PHPUnit, Doctrine etc. notwendig.
; opcache.load_comments = 1

; Optimierungslevel. Je höher, desto stärker (und langsamer die Kompilierung). Der Standard ist meist ausreichend.
; opcache.optimization_level = 0x7FFFBBFF

Beachten Sie: Nach Änderungen an der Datei opcache.ini ist stets ein Neustart des entsprechenden PHP-Paketes notwendig.

Häufig gestellte Fragen (FAQ)

• Frage: Ist Opcache standardmäßig aktiviert?
  Antwort: Unter ServBay ist Opcache zwar vorinstalliert, aber in der Regel nicht standardmäßig aktiv. Sie müssen es gemäß obigen Schritten manuell einschalten.
• Frage: Beeinflusst Opcache meinen Entwicklungs-Workflow?
  Antwort: Opcache beschleunigt Ihre Anwendung deutlich. Im Entwicklungsbetrieb empfiehlt es sich, opcache.revalidate_freq sehr niedrig (z. B. 1 oder 2) oder auf 0 zu setzen, damit geänderte Dateien sofort erkannt werden. Im Produktivbetrieb setzen Sie den Wert höher bzw. auf 0 und nutzen manuelles Leeren des Caches.
• Frage: Cacht Opcache PHP-CLI-Skripte?
  Antwort: Standardmäßig nicht. Sie können aber opcache.enable_cli auf 1 setzen, um Opcache für Kommandozeilen-Tools wie Composer, Unit-Tests etc. zu aktivieren.
• Frage: Wie viel Speicher sollte ich für Opcache bereitstellen?
  Antwort: Der Wert von opcache.memory_consumption hängt von Größe und Komplexität Ihres Projekts ab. Für typische lokale Entwicklungsprojekte reichen meist 128MB oder 256MB. Wenn Ihr Projekt sehr groß ist oder im phpinfo()-Output die Opcache-Auslastung als kritisch angezeigt wird, erhöhen Sie diesen Wert.
• Frage: Was muss ich nach Änderungen an opcache.ini tun?
  Antwort: Nach jeder Änderung müssen Sie das entsprechende PHP-Paket neu starten, damit die Änderungen wirksam werden.

Fazit

Opcache ist ein leistungsfähiges und benutzerfreundliches PHP-Performance-Tool. ServBay bietet Entwicklern komfortable Möglichkeiten, das Opcache-Modul zu aktivieren und anzupassen – wahlweise schnell über die intuitive GUI oder flexibel per Konfigurationsdatei. Mit nur wenigen Schritten steigern Sie so die Lade- und Antwortgeschwindigkeit Ihrer PHP-Anwendungen in der ServBay-Umgebung spürbar und optimieren Ihre lokale Entwicklung sowie das Testing. Durch eine durchdachte Anpassung der Opcache-Parameter holen Sie noch mehr für Ihr individuelles Projekt und Ihre Arbeitsweise heraus. Aktivieren Sie Opcache in ServBay und erleben Sie jetzt den enormen Leistungssprung für Ihre PHP-Projekte!