Performance Revolution: konfiguracja i pomoc

Prześlij ZIP w Moduły > "Module Manager", zainstaluj go i kliknij "Configure". Menu zaplecza to Wydajność, z pozycjami Panel, Pamięć podręczna, Zasoby, Zapytania, Kopia zapasowa, Ustawienia i Sprawdzanie systemu.

Przed włączeniem kolejnych warstw zanotuj działanie strony głównej, kategorii, produktu, koszyka, konta i zamówienia. Testuj zarówno w przeglądarce klienta, jak i pracownika. Wybierz właściwy sklep i wykonaj kopię konfiguracji przed zmianą pamięci podręcznej rdzenia lub reguł CDN.

Zacznij w Ustawienia > Backend cache. Proces PHP wymaga zapisu do katalogów pamięci podręcznej PrestaShop i generowanych zasobów. Instalacja pamięci obiektowej Redis PrestaShop wymaga też dostępu do odpowiedniej klasy pamięci podręcznej rdzenia i plików konfiguracji. Działania Cloudflare wymagają tokena z uprawnieniami do wybranej strefy i żądanych operacji.

Zapisz i sprawdź wybrany adapter na ekranie Panel. Jeśli Redis nie łączy się, sprawdź nazwę hosta, port, uwierzytelnianie, bazę i obsługę Redis w PHP. Nie zakładaj, że wybór backendu modułu włącza również pamięć obiektową rdzenia.

Otwórz Pamięć podręczna > Przegląd, aby znaleźć przełączniki zakresów Globalny cache, "Front Office", Panel administracyjny i API. Domyślnie są włączone. Przełącznik globalny steruje użyciem pamięci podręcznej modułu, a przełączniki zakresów ograniczają odpowiednie konteksty żądań.

Użyj Pamięć podręczna > Warstwy do sterowania warstwami, Przeglądarka do przeglądania wpisów, Strony do danych pamięci stron oraz Presety do przeglądu dostępnych ustawień wstępnych. Przeczytaj ustawienie wstępne przed zastosowaniem, ponieważ zmienia kilka opcji jednocześnie.

Otwórz Ustawienia > Buforowanie fragmentów.

Programista może zapisać fragment kategorii w pamięci podręcznej z uwzględnieniem jej tożsamości:

{mpr_cache id="category_products" ttl=3600 tags=["product","category"] vary=["category" => $category.id]}
  {foreach from=$products item=product}
    {include file='catalog/_partials/miniatures/product.tpl' product=$product}
  {/foreach}
{/mpr_cache}

Klucz pamięci podręcznej zawiera język, sklep, walutę i domyślną grupę klientów, chyba że wyłączono uwzględnianie kontekstu. Dodaj do vary każdą inną wartość wpływającą na fragment. Nie umieszczaj treści specyficznej dla klienta we współdzielonym fragmencie bez odpowiedniego różnicowania lub dynamicznego zastępowania.

Użyj dynamicznych symboli zastępczych dla obsługiwanych wartości bieżącego żądania:

<span class="cart-count">{mpr_dynamic name="cart_count"}</span>
<span class="cart-total">{mpr_dynamic name="cart_total"}</span>
<span class="customer-name">{mpr_dynamic name="customer_name" default=""}</span>
<span class="csrf-token">{mpr_dynamic name="csrf_token"}</span>

Obsługiwane nazwy obejmują też wartości klienta, języka, waluty i sklepu. Własny dostawca może użyć actionMPRDynamicContent:

public function hookActionMPRDynamicContent($params)
{
    if (($params['name'] ?? '') === 'loyalty_points') {
        return (string) $this->getCurrentCustomerPoints();
    }
    return $params['default'] ?? '';
}

Otwórz Ustawienia > Pamięć podręczna zapytań.

Użyj Zapytania do przeglądania zebranych zapytań. Włącz profilowanie podczas diagnozy, a przed pozostawieniem go na stałe oceń narzut.

Otwórz Ustawienia > Optymalizacja zasobów. Włączaj i testuj na motywie po jednej zmianie.

Włączenie generowanego CSS nie uruchamia przeglądarki podczas żądania sklepu. Zbuduj go osobnymi procesami roboczymi. Stan wygenerowanego początkowego CSS informuje o gotowości. Proces "Critical CSS" wymaga Node 22.12 lub nowszego i skonfigurowanego środowiska przeglądarki. Generuj i wdrażaj według dołączonej instrukcji procesu.

Te polecenia CLI sprawdzają lub inicjalizują pracę; same nie kończą generowania w przeglądarce:

php modules/mprperformancerevolution/cli/critical-css.php --targets
php modules/mprperformancerevolution/cli/critical-css.php --seed
php modules/mprperformancerevolution/cli/critical-css.php --status
php modules/mprperformancerevolution/cli/page-type-css.php --status

Odbuduj dane CSS offline po istotnych zmianach arkuszy, szablonów, skryptów lub treści. Gdy wygenerowanych danych brak lub są nieprawidłowe, moduł wraca do pełnych arkuszy.

Otwórz Ustawienia > Natychmiastowa nawigacja.

Wbudowana polityka wyklucza koszyk, zamówienie, konto, logowanie, linki z parametrami zapytania, pliki, linki nofollow i narzędzia modułu. Serwer również weryfikuje żądania spekulacyjne.

Otwórz Ustawienia > Zdjęcia.

Kodowanie AVIF podczas działania może używać GD imageavif lub Imagick z obsługą AVIF. GD AVIF zwykle wymaga PHP 8.1 lub nowszego. Generowanie partiami może też używać dołączonego backendu Python, jeśli dostępne są Python, Pillow, pillow_avif i wykonywanie procesów. WebP korzysta z obsługiwanych funkcji GD.

Dla obrazów list produktów obowiązują dodatkowe wewnętrzne wartości domyślne: filtr typów obrazów jest domyślnie wyłączony, a lista typów to default_sm,default_md,default_lg,home_default,product_main,product_main_2x. Nie są to osobne widoczne pola standardowego formularza Zdjęcia. Podobnie wewnętrzny współczynnik próbkowania RUM wynosi 0.1.

Aby uruchomić kontrolowaną partię, wykonaj w zainstalowanym sklepie:

php modules/mprperformancerevolution/scripts/generate-images-cli.php --quality=50 --webp-quality=80 --webp --limit=100

Użyj powtarzalnego --path=PATH, aby ograniczyć pracę wewnątrz katalogu głównego sklepu. --force ponownie generuje istniejące warianty. Przed większą partią przejrzyj liczby konwersji, pominięć i błędów.

Otwórz Ustawienia > Pamięć podręczna stron na serwerze źródłowym.

To rzeczywista pamięć pełnych stron na serwerze źródłowym, używająca menedżera pamięci modułu. Jest niezależna od buforowania HTML w CDN i fragmentów Smarty. Żądania koszyka, konta, zamówienia, administracji, AJAX, niebezpiecznych ciasteczek sesyjnych i nieznanych zapytań omijają ją zgodnie z polityką działania.

Włącz ją dopiero po sprawdzeniu czystej anonimowej strony i wymaganych przypadków pominięcia. Wywołaj ten sam anonimowy URL dwukrotnie i sprawdź X-MPR-PageCache. Następnie testuj logowanie, tworzenie koszyka, zmiany waluty/języka i strony prywatne w osobnych sesjach przeglądarki.

Otwórz Ustawienia > Pamięć podręczna stron CDN. Zacznij od domyślnej polityki ciasteczek "Strict".

Po zapisaniu użyj Akcje CDN, aby zastosować i zweryfikować reguły oraz sprawdzić wynik. Zmiana polityki ciasteczek ponownie stosuje reguły i czyści strefę. Nie uznawaj nieudanego lub oczekującego przejścia reguł za zakończoną konfigurację.

Osobno testuj buforowanie anonimowe i pomijanie prywatnych żądań. Logowania, koszyki, zamówienie, strony konta, AJAX, chronione trasy modułów, personalizacja i niebezpieczne stany żądań nie mogą współdzielić anonimowego HTML. Zachowaj okres przechowywania generowanych zasobów, gdy długotrwały HTML nadal odwołuje się do starych zasobów.

Moduł wysyła nagłówki pamięci podręcznej i wykonuje obsługiwane operacje Cloudflare. To, jak brzeg sieci faktycznie buforuje, nadal zależy od reguł strefy, uprawnień tokena API i tego, czy odpowiedź może być buforowana. Niektóre metody czyszczenia Cloudflare nie są dostępne w każdym planie.

Otwórz Ustawienia > Rozgrzewanie cache.

Skopiuj rzeczywiście wygenerowany token do harmonogramu serwera. Typowe polecenie uruchamiające:

* * * * * php /var/www/html/modules/mprperformancerevolution/cron.php --token=YOUR_TOKEN --max-tasks=20 --max-seconds=55 --context=cron

Dostosuj ścieżki PHP i sklepu. Program obsługuje także zadeklarowane czyszczenie, oczekujące unieważnienia/czyszczenia, zadania obrazów i konserwację CSS zgodnie ze stanem zadań. Osobno sprawdź włączenie funkcji i zaplanowanie jej zadania.

Ręczny przebieg po wdrożeniu może używać:

php modules/mprperformancerevolution/cli/warm-cache.php --full --both --url-set=all --concurrency=1 --resolve-ip=127.0.0.1 --max-seconds=120

Użyj --edge tylko dla brzegu sieci, --cron dla trybu cron i --help dla obsługiwanych argumentów. Przeczytaj podsumowanie stanów wyłączenia, błędów lub blokady zapisu zewnętrznego. Wstrzymany lub ograniczony budżetem przebieg może być oczekiwany przy zachowawczych ustawieniach domyślnych.

Otwórz Ustawienia > Monitorowanie. Włącz zbieranie metryk jest domyślnie włączone, Przechowywanie metryk wynosi 30 dni, a Metryki prawdziwych użytkowników są włączone. Wewnętrzne próbkowanie RUM wynosi 10 procent. Metryki pulpitu obejmują stan adaptera, trafienia, braki trafień, współczynnik trafień, pamięć, wolne zapytania i dostępne pomiary TTFB, FCP, LCP, CLS oraz INP.

Otwórz Ustawienia > Tryb dev, aby tymczasowo zawiesić ustawienia pamięci podręcznej. Tryb dev jest początkowo nieaktywny, zachowuje poprzednią konfigurację i przywraca ją po wyłączeniu lub wygaśnięciu. Tryb debugowania pracownika jest początkowo wyłączony i włącza komunikaty deweloperskie PrestaShop tylko dla rozpoznanych pracowników ze zweryfikowanym ciasteczkiem debugowania modułu.

W Ustawienia > Debugowanie opcje Nakładka debugowania, Włącz panel debugowania i Panel profilera są domyślnie wyłączone. Dozwolone adresy IP i Dozwolone identyfikatory pracowników są początkowo puste. Profiler: tylko pracownicy jest domyślnie włączony. Ogranicz dostęp do diagnostyki podczas testów i wyłącz ją po zakończeniu.

Opcjonalne pliki profilera są w optional-overrides/classes/Hook.php i optional-overrides/classes/db/Db.php. Użyj zabezpieczonej procedury instalacji nadpisań profilera, aby sprawdzić istniejące nadpisania. Wyczyść stan klas/pamięci PrestaShop według tej procedury. Nie nadpisuj niezwiązanych nadpisań bezwarunkowym kopiowaniem. Gdy opcjonalne nadpisania profilera przestaną być potrzebne, usuń je tą samą procedurą.

Po każdej zmianie konfiguracji sprawdź stronę główną, listę, produkt, koszyk i zamówienie, następnie nagłówki pamięci i powody pominięcia w osobnych sesjach klientów. Hooki katalogu, stanów magazynowych, cen i treści unieważniają obsługiwane tagi pamięci, ale zmiany motywu, integracji i reguł CDN mogą nadal wymagać jawnego wyczyszczenia.

Jeśli adapter różni się od wybranego, sprawdź dostępność backendu i ustalanie punktu połączenia Redis. Jeśli strona omija pamięć, przeczytaj powód diagnostyczny przed zwiększaniem limitów lub zmianą polityki ciasteczek. Przy nieaktualnym HTML sprawdź osobno warstwy serwera źródłowego i brzegu sieci oraz potwierdź zakończenie unieważniania.

Jeśli łączenie, odraczanie lub zmiany CSS psują komponent, wyłącz daną opcję, wyczyść jej wygenerowane pliki lub pamięć podręczną i sprawdź ponownie. Dla generowanego CSS sprawdź stan i dziennik procesu roboczego. Przy błędach obrazów sprawdź kodery i uprawnienia zapisu. Przy oczekującym rozgrzewaniu sprawdź program uruchamiający, przełącznik funkcji, obciążenie hosta i budżety.

Przed odinstalowaniem usuń zainstalowane opcjonalne nadpisania profilera i przejrzyj aktywne reguły CDN. Wyłącz lub usuń reguły brzegu sieci należące do modułu przez procedurę CDN, aby strefa nie buforowała nadal prywatnych tras bez zamierzonej ochrony serwera źródłowego. Zapisz kopię potrzebnej konfiguracji i wygenerowanych danych.

Odinstalowanie usuwa zadania harmonogramu, mechanizm startowy debugowania pracowników, zainstalowaną klasę pamięci Redis, menu modułu i jego tabele bazy danych. Następnie przejrzyj konfigurację pamięci rdzenia PrestaShop i zewnętrznego CDN; nie zakładaj, że Module Manager cofa całą konfigurację zdalną.

Wymaga PrestaShop 1.6.1 lub nowszego oraz PHP 7.1 lub nowszego.