Przejdź do głównej zawartości

Rozwiązywanie problemów

Praktyczny przewodnik diagnostyczny po nagłówkach cache, synchronizacji skryptów JavaScript oraz współpracy z pamięcią obiektową Redis.

Aby sprawdzić, w jaki sposób Rapida obsłużyła dane zapytanie, podejrzyj nagłówek odpowiedzi HTTP X-Rapida-Cache w Narzędziach programistycznych przeglądarki (zakładka Sieć / Network) lub w konsoli:

Okno terminala
curl -I https://twojsklep.pl/
  • X-Rapida-Cache: HIT: Strona została zaserwowana bezpośrednio z gotowego statycznego pliku HTML na dysku. WordPress i baza danych nie zostały nawet uruchomione.
  • X-Rapida-Cache: MISS: Dla tego adresu nie było jeszcze pliku w buforze. Strona została wygenerowana przez PHP, odesłana do przeglądarki i jednocześnie zapisana na dysku dla kolejnych wizyt.
  • X-Rapida-Cache: BYPASS; reason=<powód>: Buforowanie zostało celowo pominięte z przyczyn technicznych.
  • reason=logged_in: Odwiedzający jest zalogowany w WordPressie. Zalogowani użytkownicy otrzymują strony dynamiczne, aby nie wyświetlić prywatnych danych klienta lub administratora innym osobom.
  • reason=cart_session: Wykryto aktywne ciasteczko koszyka WooCommerce (woocommerce_items_in_cart lub wp_woocommerce_session_*).
  • reason=excluded_url: Adres pasuje do reguły na liście Nigdy nie buforuj adresów URL.
  • reason=query_param: Adres zawiera niezdefiniowany parametr URL (np. ?szukaj=fraza).
  • reason=method_not_get: Żądanie HTTP zostało wysłane metodą POST, PUT lub DELETE.
  • reason=woocommerce_endpoint: Odwiedzono adres koszyka, kasy lub konta klienta.

Rozwiązywanie problemów z opóźnianiem skryptów (Delay JS)

Dział zatytułowany „Rozwiązywanie problemów z opóźnianiem skryptów (Delay JS)”

Gdy włączona jest funkcja Opóźniaj JavaScript, zbędne skrypty czekają z wykonaniem do momentu pierwszej interakcji użytkownika ze stroną (ruch kursora, przewinięcie, kliknięcie).

  • Suwak zdjęć (slider) ładuje się pusty przed poruszeniem myszą.
  • Formularz z własną walidacją nie reaguje natychmiast na kliknięcie.
  1. Sprawdź parametr ?norapida: Dopisując ?norapida do adresu URL, upewnij się, czy problem występuje również z całkowicie wyłączoną wtyczką Rapida.
  2. Dodaj wykluczenie ze skryptów: W Rapida > CSS & JS > Opóźniaj JavaScript odszukaj pole Wykluczenia z opóźniania i wprowadź nazwę uchwytu lub pliku (np. swiper.min.js).
  3. Włącz tryb bezpieczny: Zaznacz opcję Opóźniaj tylko skrypty zewnętrzne, dzięki czemu własne skrypty motywu i sklepu wykonają się od razu, a opóźnione zostaną tylko kody śledzące, pixele i czaty.

Brak nagłówka i uprawnienia drop-inu advanced-cache.php

Dział zatytułowany „Brak nagłówka i uprawnienia drop-inu advanced-cache.php”

Rapida wymaga, aby WordPress ładował plik wp-content/advanced-cache.php przy każdym wejściu na stronę.

  • Nagłówek X-Rapida-Cache w ogóle nie pojawia się w odpowiedzi serwera.
  • W zakładce Stan witryny (Site Health) pojawia się komunikat o nieaktywnym drop-inie.
  1. Upewnij się, czy w pliku wp-config.php znajduje się wpis:
    define( 'WP_CACHE', true );
  2. Sprawdź, czy plik wp-content/advanced-cache.php istnieje i ma prawa odczytu 0644.
  3. Jeśli wcześniej na stronie działała inna wtyczka buforująca, usuń stary plik advanced-cache.php i zapisz ustawienia w panelu Rapida, aby wygenerować prawidłowy plik.

Rapida odpowiada za buforowanie całych stron HTML na dysku (page cache). Nie zastępuje ani nie koliduje z pamięciami obiektowymi w RAM, takimi jak Redis Object Cache czy Object Cache Pro.

  • Rapida działa bezproblemowo obok aktywnego Redisa.
  • Wyczyszczenie strony w Rapidzie nie powoduje zrzucenia całej bazy obiektowej Redisa.
  • W zakładce Narzędzia Rapida automatycznie wykrywa połączenie z serwerem Redis i wyświetla status połączenia.