Rozwiązywanie problemów
Praktyczny przewodnik diagnostyczny po nagłówkach cache, synchronizacji skryptów JavaScript oraz współpracy z pamięcią obiektową Redis.
Znaczenie nagłówka X-Rapida-Cache
Dział zatytułowany „Znaczenie nagłówka X-Rapida-Cache”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:
curl -I https://twojsklep.pl/Możliwe wartości nagłówka
Dział zatytułowany „Możliwe wartości nagłówka”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.
Najczęstsze przyczyny BYPASS
Dział zatytułowany „Najczęstsze przyczyny BYPASS”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_cartlubwp_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,PUTlubDELETE.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).
Objawy konfliktów
Dział zatytułowany „Objawy konfliktów”- Suwak zdjęć (slider) ładuje się pusty przed poruszeniem myszą.
- Formularz z własną walidacją nie reaguje natychmiast na kliknięcie.
Krok po kroku: jak to naprawić
Dział zatytułowany „Krok po kroku: jak to naprawić”- Sprawdź parametr ?norapida: Dopisując
?norapidado adresu URL, upewnij się, czy problem występuje również z całkowicie wyłączoną wtyczką Rapida. - 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). - 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-Cachew ogóle nie pojawia się w odpowiedzi serwera. - W zakładce Stan witryny (Site Health) pojawia się komunikat o nieaktywnym drop-inie.
Rozwiązanie
Dział zatytułowany „Rozwiązanie”- Upewnij się, czy w pliku
wp-config.phpznajduje się wpis:define( 'WP_CACHE', true ); - Sprawdź, czy plik
wp-content/advanced-cache.phpistnieje i ma prawa odczytu0644. - Jeśli wcześniej na stronie działała inna wtyczka buforująca, usuń stary plik
advanced-cache.phpi zapisz ustawienia w panelu Rapida, aby wygenerować prawidłowy plik.
Zgodność z pamięcią obiektową Redis
Dział zatytułowany „Zgodność z pamięcią obiektową Redis”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.