Snel zoeken in grote catalogi: zo koppelt u Elasticsearch of OpenSearch aan Shopware 6, van installatie en configuratie tot indexering, test en beheer.
Zoeksnelheid en kwaliteit van de zoekresultaten bepalen in de online handel de tevredenheid en de conversie. Shopware 6 biedt daarvoor een koppeling met Elasticsearch en OpenSearch: gedistribueerde zoekmachines die grote catalogi in milliseconden doorzoeken, filters en facetten berekenen en tijdens het typen suggesties geven.
De standaardzoekfunctie van Shopware werkt op de MySQL-database. Dat volstaat voor kleine assortimenten, maar wordt traag bij tienduizenden artikelen, veel eigenschappen en veel verkeer. Elasticsearch of OpenSearch nemen dan het zoeken naar producten, de listings en het filteren in Storefront en Store-API over.
Dit artikel beschrijft vereisten, installatie, configuratie, indexering, test en beheer. De basis van het platform vindt u op onze pagina over Shopware-ontwikkeling.
Elasticsearch is een gedistribueerde zoek- en analyse-engine op basis van de Lucene-bibliotheek. Hij indexeert documenten, beantwoordt fulltext- en gestructureerde zoekopdrachten met een lage latentie en schaalt over meerdere nodes. Hij is ontwikkeld door Elastic.
Na de licentiewijziging van Elastic in 2021 heeft Amazon Web Services met OpenSearch een fork van Elasticsearch en Kibana gepubliceerd. OpenSearch valt onder de Apache 2.0-licentie, wordt door een community doorontwikkeld en blijft bij de belangrijkste API’s compatibel. Shopware ondersteunt beide systemen en raadt voor nieuwe installaties OpenSearch aan.
Is de koppeling actief, dan lopen het zoeken naar producten, categorielistings en filters via de zoekindex in plaats van via SQL. De Admin kan daarnaast een eigen Admin-zoekfunctie op basis van de engine gebruiken. Welke aanpak loont, hangt af van catalogus, verkeer en hosting; ons overzicht over Shopware-hosting helpt bij de afweging.
# Pakket downloaden (versie aanpassen)
wget https://artifacts.opensearch.org/releases/bundle/opensearch/2.19.0/opensearch-2.19.0-linux-x64.deb
# Installeren, sinds OpenSearch 2.12 met beheerderswachtwoord
sudo env OPENSEARCH_INITIAL_ADMIN_PASSWORD=IhrSicheresPasswort dpkg -i opensearch-2.19.0-linux-x64.deb
# Service starten en bij het opstarten activeren
sudo systemctl enable --now opensearch
# Bereikbaarheid controleren
curl -k -u admin:IhrSicheresPasswort https://localhost:9200/
Voor Elasticsearch verloopt de installatie op dezelfde manier met het Elastic-pakket en de service elasticsearch. In ontwikkelomgevingen is een Docker-container het snelst ingericht. In productie past u de heapgrootte (ongeveer de helft van het beschikbare RAM, maximaal 31 GB), opslagpaden en toegangsgegevens in de configuratie aan.
De koppeling wordt niet in de Admin, maar via omgevingsvariabelen in de .env of .env.local aangestuurd:
SHOPWARE_ES_ENABLED=1
SHOPWARE_ES_HOSTS=https://benutzer:passwort@localhost:9200
SHOPWARE_ES_INDEXING_ENABLED=1
SHOPWARE_ES_INDEX_PREFIX=sw
SHOPWARE_ES_THROW_EXCEPTION=0
De variabelen betekenen: SHOPWARE_ES_ENABLED schakelt het zoeken via de engine in, SHOPWARE_ES_INDEXING_ENABLED staat het schrijven naar de index toe, SHOPWARE_ES_INDEX_PREFIX scheidt meerdere webshops op één cluster, en SHOPWARE_ES_THROW_EXCEPTION bepaalt of bij een storing een fout verschijnt (1) of Shopware stil terugvalt op het zoeken in de database (0).
bin/console cache:clear
bin/console es:index
bin/console es:create:alias
bin/console es:status
Bij de eerste run is deze volgorde aan te raden: indexering inschakelen, maar het zoeken nog uitgeschakeld laten, de index opbouwen, dan SHOPWARE_ES_ENABLED=1 instellen en de cache legen. Zo blijft de webshop tijdens de indexering bereikbaar. De indexering loopt via de message queue, dus de worker moet draaien. Met bin/console dal:refresh:index start u later een volledige herindexering.
Met SHOPWARE_ADMIN_ES_ENABLED=1 en SHOPWARE_ADMIN_ES_INDEXING_ENABLED=1 gebruikt ook de zoekfunctie in de Admin de engine. De index daarvoor bouwt u op met bin/console es:admin:index.
curl -k -u benutzer:passwort https://localhost:9200/_cluster/health moet green of yellow melden (bij één enkele node is geel normaal).bin/console es:status toont indexen, alias en aantal documenten. Het aantal producten moet overeenkomen met de catalogus.var/log/prod.log) en de logs van de zoekmachine op fouten.SHOPWARE_ES_HOSTS; leg bij zelfondertekende certificaten de CA vast.bin/console es:reset kunt u een beschadigde index opnieuw opbouwen.es:status), leeg de cache en controleer of SHOPWARE_ES_ENABLED echt op 1 staat.Kan ik Elasticsearch en OpenSearch zonder meer uitwisselen?
In principe wel, Shopware spreekt beide via dezelfde configuratie aan. Controleer wel de ondersteunde versies in de release notes van uw Shopware-versie.
Mijn hostingpartij biedt geen zoekmachine aan. Wat nu?
Gebruik een managed service zoals Amazon OpenSearch Service of Elastic Cloud, of blijf bij het zoeken in de database tot de catalogus het vereist. Welke opties er zijn, laat ons artikel over Shopware-hosting zien.
Hoe vaak moet ik opnieuw indexeren?
Shopware werkt de index bij wijzigingen automatisch bij via de worker. Een volledige herindexering is zinvol na Shopware-updates en na wijzigingen aan eigenschappen of aan de indexconfiguratie.
Kan ik de weging van de resultaten aanpassen?
Ja. De weging van de zoekvelden stelt u in de Admin in onder Instellingen → Zoeken; verdergaande boostingregels kunnen via een plugin worden toegevoegd. Hoe zoiets tot stand komt, leest u op onze pagina over Shopware-pluginontwikkeling.
Wilt u weten of de overstap voor uw webshop loont? Onze shopanalyse controleert zoekfunctie, performance en conversie.