Rozwiązywanie problemów
Napraw problemy z wtyczką Sylius, od nieudanej instalacji po import, który się nie kończy.
Zawsze zaczynaj od kontroli, które niczego nie zmieniają. Nie klikaj Disconnect w Sylius ani w Fullmetrix, żeby „zacząć od nowa”. W Sylius odłączenie przerywa powiązanie, a kodu nie można użyć ponownie. W Fullmetrix usuwa zaimportowane dane.
Kilka kontroli na tej stronie dotyczy kodu projektu. Przekaż je swojemu programiście, razem z godziną i dokładnym komunikatem problemu.
Composer odmawia zainstalowania wtyczki
Programista uruchamia to polecenie, aby sprawdzić, co blokuje instalację.
composer why-not fullmetrix/sylius-plugin '*'Zwykłe przyczyny to wersja PHP niższa niż 8.1, brakujące rozszerzenie cURL lub JSON albo wersja Sylius, Symfony lub Doctrine spoza listy w Zgodności. Programista rozwiązuje zależności na swoim komputerze, a potem wdraża powstały plik composer.lock. Kopiowanie folderu vendor/ z jednego komputera na drugi to zły pomysł, jeśli wersje PHP się różnią.
Symfony nie ładuje wtyczki
Jeśli bin/console cache:clear kończy się błędem albo nie istnieje żadna trasa Fullmetrix, sprawdź, czy config/bundles.php zawiera ten wiersz.
Fullmetrix\SyliusPlugin\FullmetrixPlugin::class => ['all' => true],Programista uruchamia następnie composer dump-autoload i czyści pamięć podręczną w tym samym środowisku co działająca witryna. Przy kilku serwerach sprawdza każdy z nich.
Strona Fullmetrix nie pojawia się w panelu administracyjnym
- Otwórz bezpośrednio adres
/admin/fullmetrixswojego sklepu na koncie administratora. Jeśli strona się pojawia, brakuje tylko menu, często z powodu niestandardowego menu administracyjnego lub motywu. - Jeśli adres zwraca błąd 404, trasy nie są zaimportowane. Programista sprawdza plik
config/routes/fullmetrix.yaml, a potem uruchamiabin/console debug:router fullmetrix_admin_connection, co musi pokazać trasę. - Czyści pamięć podręczną, a Ty odświeżasz stronę.
Migracja kończy się błędem
- Wykonaj kopię zapasową bazy danych, zanim spróbujesz ponownie.
- Programista sprawdza
bin/console doctrine:migrations:statusi pierwszy wyświetlony błąd. - Sprawdza, czy użytkownik bazy danych ma prawo tworzyć tabele.
- Nie tworzy tabel ręcznie i nie oznacza migracji jako wykonanej bez zrozumienia błędu.
Komunikaty o błędach połączenia
Gdy połączenie się nie powiedzie, strona pokazuje Connection failed, a po nim powód. Niektóre powody wracają po francusku. Cytujemy je poniżej tak, jak się pojawiają.
| Wyświetlony powód | Co oznacza | Co zrobić |
|---|---|---|
invalid_code_format | Kod nie ma formatu FMTX-XXXX-XXXX-XXXX | Skopiuj go ponownie z Fullmetrix. Nigdy nie zawiera liter O i I ani cyfr 0 i 1. |
storage_failed | Wtyczka nie zdołała zapisać swoich ustawień | Migracja prawdopodobnie nie została uruchomiona. Programista uruchamia bin/console doctrine:migrations:migrate. |
| Code de connexion introuvable | Ten kod nie istnieje w Fullmetrix | Skopiuj ponownie kod wyświetlony w Twojej organizacji, bez dodatkowych znaków |
| Plateforme incorrecte pour ce code | Kod został utworzony dla innej platformy | W Fullmetrix wróć do wyboru platformy, wybierz Sylius, a potem skopiuj wyświetlony kod i spróbuj ponownie |
| Ce code est déjà associé à un autre site | Jakiś sklep już przyjął ten kod | Zobacz następną sekcję |
| Trop de tentatives, réessayez dans quelques minutes. | Zbyt wiele prób w krótkim czasie | Poczekaj dziesięć minut, zanim spróbujesz ponownie |
| Cette boutique est déjà connectée à une autre Organization. | Sklep należy już do innej organizacji Fullmetrix | Użyj tej organizacji albo najpierw usuń z niej sklep |
| Cette boutique a déjà bénéficié d'un essai Fullmetrix... | Bezpłatny okres próbny został już wykorzystany dla tego sklepu | Wymagana jest subskrypcja, zobacz Rozliczenia |
invalid_response, register_failed albo komunikat sieciowy | Serwer nie zdołał prawidłowo połączyć się z Fullmetrix | Programista sprawdza, czy PHP może otwierać wychodzące połączenia HTTPS do fullmetrix.com (zapora, proxy, DNS, certyfikaty) |
Nie udostępniaj aktywnego kodu
Kod jest tajny. Jeśli wysyłasz zrzut ekranu strony Fullmetrix w Sylius, całkowicie zasłoń pole Connection code.
Kod jest „już powiązany z inną witryną”
Kod działa tylko raz. Komunikat Ce code est déjà associé à un autre site pojawia się, gdy ponawiasz próbę z kodem, który został już przyjęty, na przykład po kliknięciu Disconnect w Sylius albo gdy pierwsza użyła go inna instalacja (na przykład witryna testowa).
Jeśli karta sklepu w Fullmetrix nadal działa, nie trzeba nic robić. Jeśli sklep został odłączony w Sylius i chcesz go połączyć ponownie, potrzebujesz nowego kodu. Otwórz Ustawienia, potem Integracje, kliknij Odłącz na karcie Sylius, potwierdź, a następnie dodaj sklep ponownie, aby otrzymać świeży kod. To kasuje dane zaimportowane do Fullmetrix, które są potem importowane ponownie z Twojego sklepu.
Połączono, ale import się nie kończy
- W Sylius otwórz Marketing, potem Fullmetrix i spójrz na ramkę Sync activity. Zanotuj, czy pokazuje Waiting for sync, Sync in progress czy Sync complete.
- Przeczytaj ramkę Recent activity. Wiersz
sync_errorzawiera przyczynę błędu. Zanotuj ją, zanim klikniesz Clear logs. - W Fullmetrix przeczytaj kartę Sylius w Ustawieniach, w zakładce Integracje. Komunikat Ostatnia synchronizacja nie mogła dotrzeć do Twojego sklepu oznacza, że Fullmetrix nie zdołał wywołać Twojej witryny.
- Programista sprawdza, czy adresy
/fullmetrix/api/przechodzą przez proxy, pamięć podręczną i zaporę. Jeśli korzystasz z Cloudflare, postępuj zgodnie z Cloudflare i zapory. - Sprawdza logi PHP i serwera WWW z czasu wystąpienia problemu oraz to, czy każdy serwer uruchamia tę samą wersję wtyczki.
Po błędzie przycisk Synchronizuj ustępuje miejsca przyciskom Wznów i Resetuj. Gdy przyczyna zostanie usunięta, kliknij Wznów, aby kontynuować od miejsca, w którym import się zatrzymał. Jeśli Wznów nie jest oferowany, kliknij Resetuj, co zeruje postęp i uruchamia synchronizację ponownie bez kasowania zamówień, które już zaimportowano. Pozostałe stany karty opisuje Stan synchronizacji.
Adres sklepu w Fullmetrix jest błędny
Karta pokazuje adres wysłany przez wtyczkę podczas łączenia. Jeśli to adres wewnętrzny, adres HTTP albo inna domena, panel administracyjny został otwarty pod tym adresem albo Symfony nie ufa proxy stojącemu przed witryną. Programista poprawia konfigurację proxy. Aby zapisać właściwy adres, sklep trzeba potem połączyć ponownie z nowym kodem, jak wyjaśniono wyżej.
Śledzenie odwiedzających nic nie odbiera
- Sprawdź, czy strona Fullmetrix w Sylius nadal pokazuje Connected.
- Testuj na publicznej stronie sklepu, a nie w panelu administracyjnym.
- Wyczyść wszelką pamięć podręczną stron stojącą przed witryną.
- Wykonaj test po zaakceptowaniu plików cookie, jeśli działa baner zgody.
- Sprawdź dostarczanie w Skrypcie śledzenia.
Skontaktuj się z pomocą techniczną
Jeśli problem nie ustępuje, skontaktuj się z nami i podaj poniższe informacje.
- Publiczny adres sklepu i nazwę Twojej organizacji w Fullmetrix.
- Wersje Sylius, wtyczki, PHP, Symfony i Doctrine.
- Dokładny komunikat, godzinę jego pojawienia się i strefę czasową.
- Wynik
bin/console debug:router fullmetrix_admin_connection. - Zrzut ekranu ramek Sync activity i Recent activity, z zasłoniętym kodem.
Nigdy nie wysyłaj hasła, kodu połączenia ani fragmentu produkcyjnej bazy danych.