Jak włączyć i skonfigurować moduł PHP Opcache w ServBay

ServBay to potężne lokalne środowisko do tworzenia aplikacji webowych, zaprojektowane z myślą o programistach i integrujące wiele technologii, w tym PHP. Aby ułatwić optymalizację wydajności aplikacji PHP, ServBay ma preinstalowany moduł Opcache dla każdej obsługiwanej wersji PHP. Ten poradnik szczegółowo opisuje, jak włączyć i skonfigurować Opcache w ServBay oraz jak to rozwiązanie przyspieszy Twój proces tworzenia i testowania kodu PHP.

Czym jest moduł Opcache?

Opcache to oficjalne rozszerzenie PHP przeznaczone do zwiększania wydajności wykonywania kodu PHP. Jego podstawowa zasada działania polega na buforowaniu prekompilowanych bajtów PHP w pamięci współdzielonej. Dzięki temu każdy kolejny dostęp do tego samego skryptu wykorzystuje już zbuforowany kod bajtowy, co eliminuje konieczność ponownej analizy, kompilacji i optymalizacji kodu. Efektem jest wyraźne zmniejszenie zużycia CPU i pamięci RAM oraz szybsza odpowiedź aplikacji.

Dlaczego Opcache jest ważny dla programistów?

• Szybszy rozwój i testy: Włączenie Opcache w lokalnym środowisku pozwala na szybsze działanie aplikacji, skracając czas ładowania stron i zwiększając efektywność pracy.
• Symulacja środowiska produkcyjnego: Większość środowisk produkcyjnych wykorzystuje Opcache do zwiększenia wydajności. Włączenie Opcache lokalnie pozwala lepiej odwzorować warunki produkcyjne.
• Redukcja zużycia zasobów: Opcache znacząco obniża wykorzystanie zasobów lokalnego komputera, szczególnie przy złożonych aplikacjach lub dużych frameworkach.

Kluczowe cechy Opcache

• Cache kodu bajtowego: Podstawowa funkcjonalność, która polega na buforowaniu skompilowanego kodu PHP.
• Współdzielona pamięć: Przechowywanie cache w pamięci współdzielonej, dostępnej dla wielu procesów PHP.
• Automatyczna walidacja: Możliwość ustawienia automatycznego sprawdzania zmian w plikach, by cache zawsze był aktualny.
• Elastyczna konfiguracja: Szerokie opcje ustawień, dopasowywane do indywidualnych potrzeb projektu.
• Wbudowane wsparcie: Oficjalne rozszerzenie ściśle zintegrowane z jądrem PHP.

Wsparcie Opcache w ServBay

ServBay posiada preinstalowany moduł Opcache dla każdej integrowanej wersji PHP (np. PHP 7.4, 8.0, 8.1, 8.2, 8.3, 8.4 itd.). Nie musisz niczego pobierać ani kompilować – Opcache można włączyć i skonfigurować w prosty sposób poprzez graficzny interfejs ServBay lub edytując plik konfiguracyjny.

Jak włączyć moduł Opcache

W ServBay możesz aktywować Opcache na dwa sposoby: poprzez graficzny interfejs użytkownika (GUI) lub ręcznie edytując plik konfiguracyjny.

Sposób 1: Włączanie przez GUI ServBay (zalecane)

To najprostsza i najszybsza metoda.

1. Otwórz aplikację ServBay.
2. W nawigacji bocznej kliknij Języki (Languages).
3. Wybierz wersję PHP, dla której chcesz włączyć Opcache, np. PHP 8.3.
4. W panelu szczegółów PHP po prawej stronie kliknij zakładkę Rozszerzenia (Extensions).
5. Znajdź na liście rozszerzenie OPcache.
6. Przełącz przełącznik obok OPcache, aby go aktywować.
7. Kliknij przycisk Zapisz (Save) na dole strony.
8. ServBay poprosi Cię o ponowne uruchomienie odpowiedniego pakietu PHP w celu zastosowania zmian. Kliknij Uruchom ponownie (Restart).

Po restarcie Opcache będzie włączony.

Sposób 2: Ręczna edycja pliku konfiguracyjnego

Jeśli potrzebujesz precyzyjniejszej konfiguracji lub preferujesz zarządzanie ustawieniami przez plik konfiguracyjny, możesz edytować plik .ini Opcache.

1. Zlokalizuj plik konfiguracyjny: Plik konfiguracyjny Opcache znajduje się w katalogu conf.d wybranej wersji PHP. Katalog ten zawiera ustawienia wszystkich rozszerzeń ładowanych przez daną wersję PHP.
   • Dla PHP 8.3, domyślna ścieżka do pliku będzie następująca:

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

   • Zmień numer wersji w ścieżce na tę, której używasz.
2. Edytuj plik konfiguracyjny: Otwórz plik opcache.ini ulubionym edytorem tekstu.
   • Najczęściej plik ten zawiera podstawową konfigurację Opcache, lecz linie są skomentowane. Odnajdź sekcję [Zend Opcache].
   • Usuń średnik z początku linii zend_extension = opcache.so, aby upewnić się, że rozszerzenie jest ładowane.
   • W razie potrzeby zmodyfikuj lub dodaj inne parametry Opcache. Przykładowa konfiguracja (wyjaśnienie poniżej):

     [Zend Opcache]
     ; Ensure the extension is loaded
     zend_extension = opcache.so
     
     ; Basic Configuration (example values)
     opcache.enable = 1                 ; Enable Opcache globally (1=enabled, 0=disabled)
     opcache.memory_consumption = 128   ; Amount of memory for opcode cache (in MB)
     opcache.interned_strings_buffer = 8; Amount of memory for interned strings (in MB)
     opcache.max_accelerated_files = 4000 ; Maximum number of files to cache
     opcache.revalidate_freq = 60       ; How often to check file timestamps for updates (in seconds). 0 = check on every request (slow), but good for development.
     opcache.fast_shutdown = 1          ; Enable fast shutdown
     opcache.enable_cli = 1             ; Enable Opcache for the PHP CLI (Command Line Interface)

   • Zapisz plik opcache.ini.
3. Restartuj pakiet PHP: W aplikacji ServBay znajdź odpowiedni pakiet PHP (na pasku bocznym w menu Pakiety (Packages), następnie wybierz PHP) i kliknij przycisk restartu.

Po ręcznej edycji i restarcie pakietu PHP Opcache i jego konfiguracja zostaną zastosowane.

Jak sprawdzić, czy Opcache został poprawnie załadowany

Niezawodnym sposobem weryfikacji, czy Opcache działa, jest sprawdzenie konfiguracji PHP za pomocą funkcji phpinfo().

1. Utwórz plik phpinfo.php: W katalogu głównym Twojej strony ServBay utwórz nowy plik PHP, np. phpinfo.php. Domyślny katalog główny to /Applications/ServBay/www/. Możesz utworzyć podkatalog, np. /Applications/ServBay/www/servbay.demo/, a tam umieścić plik phpinfo.php. Plik powinien zawierać:

   <?php
   phpinfo();
   ?>

2. Odwiedź phpinfo.php: Upewnij się, że Twój serwer WWW (np. Caddy lub Nginx) jest uruchomiony i skonfigurowany do obsługi odpowiedniego katalogu. Następnie otwórz w przeglądarce odpowiedni adres URL.
   • Jeśli Twój plik znajduje się w /Applications/ServBay/www/servbay.demo/ i domena servbay.demo skierowana jest na ten katalog, adres będzie np. http://servbay.demo/phpinfo.php.
   • Jeśli plik jest w głównym katalogu /Applications/ServBay/www/, a ServBay domyślnie go obsługuje, adres to najczęściej http://localhost/phpinfo.php lub domyślny lokalny adres ServBay.
3. Wyszukaj informacje o Opcache: Na stronie phpinfo() przewiń w dół lub użyj wyszukiwarki przeglądarki (Cmd+F lub Ctrl+F), wpisując "Opcache".
   • Jeśli moduł został załadowany poprawnie, zobaczysz oddzielną sekcję "Zend Opcache", w której znajdziesz wersję, status i aktualne ustawienia Opcache.
   • Jeśli nie widzisz sekcji "Zend Opcache", moduł nie został uruchomiony. Wróć i sprawdź kroki aktywacji oraz konfiguracji.

Ilustracja: lokalizacja bloku konfiguracyjnego Zend Opcache na stronie phpinfo

Szczegółowy opis parametrów konfiguracji Opcache

Opcache posiada liczne opcje konfiguracji, które można dostosować do specyficznych potrzeb projektu. Parametry te ustawia się w pliku opcache.ini. Oto najważniejsze z nich wraz z wyjaśnieniem:

[Zend Opcache]
; Upewnij się, że rozszerzenie jest załadowane
zend_extension = opcache.so

; Włączenie Opcache (0 = wyłączone, 1 = włączone). Przełącznik w GUI również ustawia ten parametr.
opcache.enable = 1

; Ilość pamięci współdzielonej (MB) do przechowywania zbuforowanego kodu PHP.
; Dostosuj do wielkości projektu i dostępnej pamięci RAM. Duże projekty wymagają więcej pamięci.
opcache.memory_consumption = 128

; Ilość pamięci (MB) przeznaczonej na internowane ciągi znaków, np. nazwy klas czy metod.
; Frameworki używające wielu nazw (np. Symfony) mogą wymagać wyższej wartości.
opcache.interned_strings_buffer = 8

; Maksymalna liczba plików, które mogą być zbuforowane przez Opcache.
; Jeśli liczba plików w projekcie jest większa, część z nich nie będzie buforowana. Ustaw wartość wyższą niż ilość plików PHP w projekcie.
opcache.max_accelerated_files = 10000

; Częstotliwość sprawdzania zmian w plikach przez Opcache (w sekundach).
; Na produkcji zazwyczaj ustaw się dużą wartość (np. 300 lub 600), a nawet 0 (nie sprawdza, wymaga ręcznego czyszczenia cache).
; **W środowisku deweloperskim zalecamy niską wartość, np. 1 lub 2 sekundy.** Ustawienie 0 oznacza, że każdorazowo przy żądaniu sprawdzane są zmiany w plikach – nieco wolniejsze, ale korzystne podczas pracy nad kodem.
opcache.revalidate_freq = 2

; Szybkie zwalnianie pamięci po zakończeniu żądania. Zazwyczaj zalecane ustawienie włączone.
opcache.fast_shutdown = 1

; Włączenie Opcache dla PHP CLI (interfejs wiersza poleceń).
; Jest to korzystne podczas wykonywania skryptów CLI lub korzystania z Composer – przyspiesza te operacje. Zalecane włączenie.
opcache.enable_cli = 1

; Czy pozwolić na zwolnienie nieużywanej pamięci współdzielonej. W niektórych przypadkach może wspierać odzysk pamięci, ale nieznacznie obniżyć wydajność. Zazwyczaj pozostaw domyślne (wyłączone).
; opcache.enable_file_override = 0

; Czy ignorować komentarze przy cache'owaniu ścieżek do plików. Pozwala oszczędzić trochę pamięci, ale może wpływać na narzędzia zależne od komentarzy.
; opcache.save_comments = 1

; Czy zachowywać docbloki (komentarze dokumentacyjne) przy cache'owaniu. Niezbędne dla narzędzi wykorzystujących docbloki (np. PHPUnit, Doctrine) – ustawione na włączone.
; opcache.load_comments = 1

; Poziom optymalizacji. Wyższa wartość = wyższa optymalizacja, ale może wydłużać czas kompilacji. Domyślna wartość jest najczęściej optymalna.
; opcache.optimization_level = 0x7FFFBBFF

Pamiętaj, że każda zmiana w opcache.ini wymaga ponownego uruchomienia odpowiedniego pakietu PHP, aby nowe ustawienia zaczęły obowiązywać.

Najczęściej zadawane pytania (FAQ)

• Czy Opcache jest domyślnie włączony?
  W ServBay Opcache jest preinstalowany, ale domyślnie zwykle wyłączony. Aktywuj go zgodnie z instrukcją powyżej.
• Czy Opcache wpływa na mój workflow deweloperski?
  Włączenie Opcache przyspiesza aplikację. W trakcie prac programistycznych ustaw opcache.revalidate_freq na niską wartość (np. 1 lub 2) lub 0, by móc natychmiast widzieć zmiany. Po zakończeniu pracy i wdrożeniu kodu produkcyjnego zwiększ tę wartość, a czyszczenie cache wykonuj ręcznie.
• Czy Opcache cache'uje skrypty PHP CLI?
  Domyślnie nie. Ustaw opcache.enable_cli = 1, aby aktywować Opcache także dla PHP CLI. Przyspiesza to Composer, testy jednostkowe i inne narzędzia CLI.
• Ile pamięci przydzielić dla Opcache?
  Wartość opcache.memory_consumption zależy od rozmiaru i złożoności Twojego projektu. Dla większości projektów lokalnych wystarczy 128MB lub 256MB. Jeśli projekt jest bardzo duży lub pojawią się ostrzeżenia o przepełnionym cache w phpinfo(), możesz zwiększyć tę wartość.
• Co zrobić po edycji opcache.ini?
  Po każdej modyfikacji pliku .ini musisz zrestartować odpowiedni pakiet PHP, aby nowe ustawienia zaczęły obowiązywać.

Podsumowanie

Opcache to niezwykle efektywne i przyjazne narzędzie do optymalizacji wydajności PHP. ServBay daje łatwą możliwość zarządzania tym modułem – zarówno przez intuicyjny graficzny interfejs, jak i elastyczne pliki konfiguracyjne. Dzięki kilku prostym krokom możesz uruchomić Opcache w ServBay i drastycznie przyspieszyć ładowanie oraz responsywność aplikacji PHP, ulepszając tym samym swój lokalny proces deweloperski i testowanie. Odpowiednie dostrojenie parametrów Opcache pozwala jeszcze lepiej zoptymalizować środowisko zgodnie z wymaganiami projektu. Zacznij już teraz korzystać z Opcache w ServBay i odkryj różnicę w wydajności PHP!