Instalacja

mycache dostarczamy jako pakiet binarny dopasowany do Twojego środowiska (wersja PHP, loader). Nie udostępniamy kodu źródłowego. Integracja z WordPress/WooCommerce odbywa się przez drop-in object-cache.php w wersji szyfrowanej ionCube lub SourceGuardian.

Co otrzymujesz
  • Rozszerzenie PHP: mycache.so (Linux) / odpowiedni binarny moduł dla platformy
  • Szyfrowany drop-in: object-cache.php (ionCube lub SourceGuardian)
  • Pliki pomocnicze: instrukcja, changelog, informacje o konfiguracji
  • Dostęp do pobierania w panelu klienta (aktywna licencja)
Wymagania
  • PHP 8.2 / 8.3 / 8.4+
  • WordPress + WooCommerce (zalecane)
  • Aktywny loader: ionCube lub SourceGuardian (dla drop-in)
  • Możliwość załadowania rozszerzenia PHP (php.ini / panel hostingu)
  • Dostępny katalog cache (preferowany /dev/shm lub alternatywa)
Czas wdrożenia

Standardowo instalacja zajmuje kilka minut, jeśli masz dostęp do konfiguracji PHP. Na hostingu współdzielonym może być potrzebna pomoc administracji.

Jeśli nie wiesz, jaki loader masz dostępny, wybierz w zamówieniu „Nie wiem (sprawdzić)” — przygotujemy właściwą paczkę.

Krok po kroku

Poniższe kroki są uniwersalne dla większości środowisk (VPS, serwer dedykowany, część hostingów). W praktyce różni się tylko sposób dopisania rozszerzenia do konfiguracji PHP.

1) Pobierz paczkę binarną

Zaloguj się do panelu klienta i przejdź do sekcji Pobieranie. Pobierz paczkę przygotowaną pod Twoje środowisko (PHP + loader).

  • Rozszerzenie: mycache.so
  • Drop-in: object-cache.php (zaszyfrowany)

2) Wgraj pliki na serwer

Wgraj mycache.so w miejsce, z którego PHP może ładować rozszerzenia (np. katalog extensions lub wskazany przez hosting).

Jeśli masz kilka wersji PHP (np. osobno dla CLI i FPM), upewnij się, że instalujesz dla właściwej instancji.

3) Włącz rozszerzenie mycache w PHP

Dodaj w konfiguracji PHP wpis ładujący rozszerzenie, np. w php.ini lub pliku .ini dla modułów:

extension=mycache.so

Po zmianie konfiguracji zrestartuj PHP-FPM / serwer WWW (lub użyj panelu hostingu do restartu PHP).

4) Skopiuj drop-in do WordPress

Skopiuj dostarczony object-cache.php do:

wp-content/object-cache.php

Drop-in jest dostarczany w wersji szyfrowanej (ionCube/SourceGuardian) i jest kompatybilny z WordPress API wp_cache_*.

Rekomendowana konfiguracja

mycache działa domyślnie bez dodatkowych ustawień. Poniżej parametry, które najczęściej warto dopasować. Ustawienia można wprowadzić w php.ini albo per-request (drop-in może ustawiać je przez ini_set()).

Parametr Przykład Opis
mycache.dir /dev/shm/mycache Katalog na pliki cache. Preferowany RAM (/dev/shm), ale może być też katalog na dysku.
mycache.fanout 256 Liczba podkatalogów (potęga 2) — pomaga utrzymać szybkie operacje FS.
mycache.chmod_mode 504 (octal 0770) Uprawnienia katalogów/plików. Katalogi dostają SGID (dziedziczenie grupy).
mycache.max_bytes 0 / 1073741824 Limit rozmiaru cache (0 = brak). Po przekroczeniu działa best-effort evict do ~90% limitu.
Wskazówka: jeśli masz wiele stron na jednym serwerze, zalecamy osobne katalogi per host (multi-tenant). Drop-in może to realizować automatycznie.

Loader: ionCube / SourceGuardian

Drop-in object-cache.php jest szyfrowany i wymaga aktywnego loadera. To standardowa praktyka przy dystrybucji binarnej i ochronie logiki integracji.

  • Jeśli masz ionCube — wybierz paczkę ionCube
  • Jeśli masz SourceGuardian — wybierz paczkę SourceGuardian
  • Jeśli nie wiesz — wybierz „Nie wiem (sprawdzić)” w zamówieniu

Weryfikacja działania

Po instalacji możesz potwierdzić działanie na kilka sposobów:

  • W phpinfo() powinna pojawić się sekcja mycache oraz informacje o wersji.
  • W WordPressie: spadek liczby zapytań SQL i poprawa TTFB (po rozgrzaniu cache).
  • W logach: brak komunikatu o „extension not loaded” (drop-in przechodzi wtedy w tryb niepersystentny).

Najczęstsze problemy

  • Rozszerzenie nie ładuje się — niezgodna wersja PHP lub architektura; pobierz właściwą paczkę.
  • Błąd loadera — brakuje ionCube/SourceGuardian lub jest niezgodna wersja loadera.
  • Brak uprawnień do katalogu — ustaw odpowiedni mycache.dir i chmod_mode.
  • /dev/shm niedostępne — ustaw alternatywną ścieżkę katalogu cache (np. prywatny katalog w obrębie konta).
W razie potrzeby skontaktuj się z nami — podaj wersję PHP, typ loadera i informacje o hostingu.

Potrzebujesz pomocy we wdrożeniu?

Skontaktuj się z nami w sprawie instalacji, konfiguracji lub doboru paczki binarnej dla Twojego środowiska.

Kontakt Zobacz plany