Szybkie wyszukiwanie w dużych katalogach: jak podłączyć Elasticsearch lub OpenSearch do Shopware 6, od instalacji i konfiguracji po indeksowanie, testy, utrzymanie i obsługę języka polskiego.
Szybkość wyszukiwania i trafność wyników decydują w e-commerce o zadowoleniu klientów i konwersji. Shopware 6 oferuje w tym celu integrację z Elasticsearch i OpenSearch: rozproszonymi wyszukiwarkami, które przeszukują duże katalogi w milisekundy, obliczają filtry i fasety oraz podpowiadają wyniki już podczas wpisywania.
Standardowa wyszukiwarka Shopware działa na bazie danych MySQL. Wystarcza to przy małym asortymencie, ale przy dziesiątkach tysięcy produktów, wielu właściwościach i dużym ruchu staje się wolna. Wtedy Elasticsearch lub OpenSearch przejmują wyszukiwanie produktów, listingi i filtrowanie w Storefront i Store API.
W tym artykule opisujemy wymagania, instalację, konfigurację, indeksowanie, testy i utrzymanie, a także kwestie ważne dla sklepów w Polsce, takie jak obsługa polskiej odmiany wyrazów i znaków diakrytycznych. Podstawowe informacje o platformie znajdą Państwo na naszej stronie poświęconej tworzeniu sklepów w Shopware.
Elasticsearch to rozproszony silnik wyszukiwania i analizy oparty na bibliotece Lucene. Indeksuje dokumenty, odpowiada na zapytania pełnotekstowe i strukturalne z niskim opóźnieniem oraz skaluje się na wiele węzłów. Jego twórcą jest firma Elastic.
Po zmianie licencji przez Elastic w 2021 roku Amazon Web Services opublikował OpenSearch, fork Elasticsearch i Kibany. OpenSearch jest dostępny na licencji Apache 2.0, rozwija go społeczność, a w zakresie najważniejszych API pozostaje kompatybilny. Shopware obsługuje oba systemy; od wersji 6.5 integracja korzysta z klienta OpenSearch, a adres serwera ustawia się zmienną OPENSEARCH_URL.
Gdy integracja jest aktywna, wyszukiwanie produktów, listingi kategorii i filtry działają na indeksie wyszukiwarki zamiast na zapytaniach SQL. Panel administracyjny może dodatkowo korzystać z własnego wyszukiwania opartego na tym silniku. To, które rozwiązanie się opłaca, zależy od katalogu, ruchu i hostingu; w ocenie pomoże nasze zestawienie dotyczące hostingu Shopware.
# Pobranie pakietu (dostosować wersję)
wget https://artifacts.opensearch.org/releases/bundle/opensearch/2.19.0/opensearch-2.19.0-linux-x64.deb
# Instalacja, od OpenSearch 2.12 z hasłem administratora
sudo env OPENSEARCH_INITIAL_ADMIN_PASSWORD=TwojeBezpieczneHaslo dpkg -i opensearch-2.19.0-linux-x64.deb
# Uruchomienie usługi i włączenie przy starcie systemu
sudo systemctl enable --now opensearch
# Sprawdzenie dostępności
curl -k -u admin:TwojeBezpieczneHaslo https://localhost:9200/
W przypadku Elasticsearch instalacja przebiega analogicznie, z pakietem Elastic i usługą elasticsearch. W środowiskach deweloperskich najszybciej uruchomić kontener Docker. W środowisku produkcyjnym należy w konfiguracji dostosować rozmiar sterty (heap, około połowy dostępnej pamięci RAM, maksymalnie 31 GB), ścieżki danych i dane dostępowe.
Integracją nie steruje się w panelu administracyjnym, lecz za pomocą zmiennych środowiskowych w pliku .env lub .env.local:
OPENSEARCH_URL=https://uzytkownik:haslo@localhost:9200
SHOPWARE_ES_ENABLED=1
SHOPWARE_ES_INDEXING_ENABLED=1
SHOPWARE_ES_INDEX_PREFIX=sw
SHOPWARE_ES_THROW_EXCEPTION=0
Znaczenie zmiennych: OPENSEARCH_URL wskazuje host lub listę hostów rozdzielonych przecinkami (w starszych instrukcjach dla Shopware 6.4 występuje jeszcze SHOPWARE_ES_HOSTS), SHOPWARE_ES_ENABLED włącza wyszukiwanie przez silnik, SHOPWARE_ES_INDEXING_ENABLED pozwala zapisywać dane w indeksie, SHOPWARE_ES_INDEX_PREFIX rozdziela kilka sklepów na jednym klastrze, a SHOPWARE_ES_THROW_EXCEPTION decyduje, czy przy awarii pojawi się błąd (1, wartość domyślna), czy Shopware po cichu przełączy się na wyszukiwanie w bazie danych (0).
bin/console cache:clear
bin/console es:index
bin/console es:create:alias
bin/console es:status
Przy pierwszym uruchomieniu warto zachować następującą kolejność: włączyć indeksowanie, ale pozostawić wyszukiwanie wyłączone, zbudować indeks, następnie ustawić SHOPWARE_ES_ENABLED=1 i wyczyścić cache. Dzięki temu sklep pozostaje dostępny podczas indeksowania. Indeksowanie odbywa się przez kolejkę wiadomości (message queue), więc worker musi działać. Poleceniem bin/console dal:refresh:index --use-queue można później zlecić pełne ponowne indeksowanie.
Po ustawieniu ADMIN_OPENSEARCH_URL i SHOPWARE_ADMIN_ES_ENABLED=1 także wyszukiwarka w panelu administracyjnym korzysta z silnika. Indeks dla niej buduje się poleceniem bin/console es:admin:index.
curl -k -u uzytkownik:haslo https://localhost:9200/_cluster/health powinno zwrócić green lub yellow (przy jednym węźle stan żółty jest normalny).bin/console es:status pokazuje indeksy, alias i liczbę dokumentów. Liczba produktów powinna odpowiadać katalogowi.var/log/, pliki prod-*.log) oraz logi wyszukiwarki pod kątem błędów.OPENSEARCH_URL; przy certyfikatach samopodpisanych dodać CA.bin/console es:reset pozwala zbudować uszkodzony indeks od nowa.es:status), wyczyścić cache, upewnić się, że SHOPWARE_ES_ENABLED rzeczywiście ma wartość 1.Czy Elasticsearch i OpenSearch można dowolnie zamieniać?
Co do zasady tak, Shopware obsługuje oba systemy przez tę samą konfigurację. Należy jednak sprawdzić obsługiwane wersje w release notes używanej wersji Shopware.
Mój hosting nie oferuje wyszukiwarki. Co dalej?
Można skorzystać z usługi zarządzanej, takiej jak Amazon OpenSearch Service lub Elastic Cloud, albo pozostać przy wyszukiwaniu w bazie danych, dopóki katalog tego nie wymaga. Dostępne opcje przedstawiamy w artykule o hostingu Shopware.
Jak często trzeba indeksować od nowa?
Shopware aktualizuje indeks przy zmianach samodzielnie, za pośrednictwem workera. Pełne ponowne indeksowanie ma sens po aktualizacjach Shopware, zmianach właściwości lub konfiguracji indeksu.
Jak wyszukiwarka radzi sobie z językiem polskim?
Polski jest językiem fleksyjnym, więc klienci szukają tych samych produktów w różnych formach („buty”, „butów”) i często bez polskich znaków. OpenSearch i Elasticsearch oferują wtyczkę analysis-stempel z analizatorem dla języka polskiego oraz filtr asciifolding. Ich wykorzystanie w Shopware wymaga dostosowania konfiguracji indeksu przez programistę i warto je przetestować na rzeczywistych frazach z polskiego sklepu.
Czy mogę dostosować wagę wyników?
Tak. Wagę pól wyszukiwania ustawia się w panelu administracyjnym w sekcji Ustawienia → Wyszukiwanie, a dalsze reguły boostingu można dodać za pomocą wtyczki. Jak powstaje taka wtyczka, opisujemy na stronie o tworzeniu wtyczek Shopware.
Chcą Państwo wiedzieć, czy zmiana opłaci się w Państwa sklepie? Nasza analiza sklepu sprawdza wyszukiwanie, wydajność i konwersję.