CONVIRO
Engineering

Magento 2 extensie installeren met Composer: stappenplan

Een praktische uitleg voor het installeren van een Magento 2-extensie met Composer: private repositories, auth.json, setup:upgrade, stappen voor production mode, updates,…

Conviro
19 november 20267 min leestijd
Magento 2 extensie installeren met Composer: stappenplan
In dit artikel

Magento 2 extensie installeren met Composer gaat zo: je voegt de repository van de leverancier toe (plus inloggegevens als die private is), voert composer require uit, schakelt de module in, draait bin/magento setup:upgrade, compileert en deployt de statische content als de winkel in production mode staat, en leegt de cache. Het zijn maar een handvol commando's, maar de volgorde en de deploy mode doen ertoe.

Deze gids loopt de volledige reeks door met de gratis extensie Conviro for Magento als uitgewerkt voorbeeld, en behandelt daarna updaten, verwijderen en de fouten die je het vaakst tegenkomt.

Belangrijkste punten

  • Voer elk commando uit vanuit de Magento-root als eigenaar van het bestandssysteem, na een back-up en eerst op staging.
  • Developer mode heeft setup:upgrade en een cache flush nodig; production mode heeft daarnaast compilatie en het deployen van statische content nodig.
  • Verwijder in omgekeerde volgorde: ruim eerst de integratie op, en schakel daarna uit, verwijder en upgrade.

Voordat je begint: vereisten

Controleer dit voordat je aan productie komt:

  • SSH-toegang en Composer op de server. Een installatie op basis van Composer kan niet vanuit het beheerpaneel.
  • Een verse back-up van code en database, en bij voorkeur een stagingkopie om op te testen.
  • De juiste gebruiker. Voer commando's uit als eigenaar van het bestandssysteem, niet als root, anders krijg je problemen met rechten.
  • Je deploy mode. Controleer die met bin/magento deploy:mode:show.
  • Een onderhoudsvenster voor productie: bin/magento maintenance:enable vooraf, bin/magento maintenance:disable achteraf.

Specifiek voor de extensie van Conviro heb je ook Magento Open Source 2.4.4 of hoger nodig met PHP 7.4 of 8.1–8.4, een HTTPS-URL voor de winkel, een draaiende Magento-cron en uitgaand HTTPS-verkeer naar api.conviro.io. De installatie van de extensie (op het moment van schrijven versie 1.4.1) is getest op:

Magento PHP Thema
2.4.4-p13 8.1 Luma
2.4.7-p4 8.3 Luma
2.4.9 8.4 Luma en Hyvä 1.5.2

Adobe Commerce draait op hetzelfde framework maar is nog niet getest, Hyvä Checkout is niet getest, en winkels op 2.4.0–2.4.3 blijven op extensie 1.3.5.

Magento 2 extensie installeren met Composer, stap voor stap

Stap 1: Voeg de Composer-repository en inloggegevens toe

Private extensies komen uit de eigen Composer-repository van de leverancier. Vanuit de Magento-root:

composer config repositories.conviro composer https://repo.conviro.io
composer config http-basic.repo.conviro.io api <CONVIRO_API_KEY>

Het eerste commando voegt de repository toe aan composer.json. Het tweede slaat de inloggegevens op in auth.json, in dezelfde map. Bij Conviro is de gebruikersnaam api en het wachtwoord een API-sleutel uit Developers → API Keys in het Conviro-dashboard. Meer over de API van Conviro lees je op de pagina voor developers.

Houd auth.json buiten versiebeheer. Je sleutels voor repo.magento.com staan meestal in hetzelfde bestand.

Stap 2: Voer composer require en setup:upgrade uit

composer require conviro/module-aichat
bin/magento module:enable Conviro_AiChat
bin/magento setup:upgrade

Deze drie commando's vormen de kern van elke installatie van een Magento 2-module:

  1. composer require downloadt het pakket naar vendor/ en legt het vast in composer.json en composer.lock. Commit beide bestanden, zodat elke omgeving dezelfde versie installeert.
  2. module:enable registreert de module in app/etc/config.php.
  3. setup:upgrade voert de databaseschema- en datapatches van de module uit en werkt het moduleregister bij.

Stap 3: Compileren, deployen en de cache legen

In production mode worden gegenereerde code en statische bestanden niet op verzoek gebouwd, dus voer je dit uit:

bin/magento setup:di:compile
bin/magento setup:static-content:deploy -f

In developer mode sla je beide over. In beide modes sluit je af met:

bin/magento cache:flush

Controleer daarna of de module actief is en zet de onderhoudsmodus uit:

bin/magento module:status Conviro_AiChat
bin/magento maintenance:disable

Stap 4: Koppel de extensie in de admin

De meeste extensies moeten na de installatie nog worden geconfigureerd. Voor Conviro open je Stores › Settings › Conviro Setup. Een wizard van 7 stappen voert een controle van de omgeving uit; daarna klik je op Connect to Conviro, keur je de winkel goed in het Conviro-dashboard en keer je terug naar Magento. Je kopieert geen API-sleutel of token naar Magento.

De wizard maakt een Magento-integratie met minimale rechten aan (OAuth 1.0a), laat je kiezen welke store views, wat er wordt gesynchroniseerd en welke AI-acties zijn toegestaan, en controleert alles met een testevent. Daarna controleert de Integration Health-kaart onder Stores › Configuration › Conviro › AI Chat verbinding, authenticatie, webhooks, catalogus, bestellingen, cron, versie en omgeving, met herstelinstructies. De installatiepagina en de installatiedocumentatie behandelen elke stap. Voor het koppelen heb je een Conviro-abonnement met API-toegang nodig, Pro of hoger (zie de prijzen).

Een Magento 2-module updaten en verwijderen

Updaten

composer update conviro/module-aichat
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento setup:static-content:deploy -f
bin/magento cache:flush

Ook hier compileer en deploy je alleen in production mode. De Magento-admin toont een melding met het exacte commando zodra er een nieuwe versie uitkomt, en je configuratie, API-sleutel en integratie blijven behouden.

Verwijderen

De volgorde is belangrijk: het ontkoppelen gebeurt in de configuratiewizard, en die is weg zodra de module is verwijderd.

  1. Ontkoppel in de configuratiewizard van Conviro.
  2. Schakel de module uit: bin/magento module:disable Conviro_AiChat
  3. Verwijder het pakket: composer remove conviro/module-aichat
  4. Voer bin/magento setup:upgrade uit.

Compileer in production mode opnieuw, deploy de statische content opnieuw en leeg zoals gewoonlijk de cache. Conviro verwijdert de data van de winkel 30 dagen na het ontkoppelen, of direct als je daarvoor kiest. De documentatie over verwijderen somt elke stap op.

Veelvoorkomende fouten en hoe je ze oplost

Symptoom Waarschijnlijke oorzaak Oplossing
"Allowed memory size exhausted" tijdens Composer Geheugenlimiet van PHP Voer COMPOSER_MEMORY_LIMIT=-1 composer require ... uit
Compilatie loopt zonder geheugen Geheugenlimiet van de CLI Voer php -d memory_limit=2G bin/magento setup:di:compile uit
401 of een vraag om inloggegevens van de repository Verkeerde sleutel of gebruikersnaam Voer het http-basic-commando opnieuw uit; de gebruikersnaam is api
"Permission denied" in generated/, var/ of pub/static/ Commando's uitgevoerd als root of als de verkeerde gebruiker Herstel het eigenaarschap en voer ze opnieuw uit als eigenaar van het bestandssysteem
"Please upgrade your database" setup:upgrade niet uitgevoerd Voer bin/magento setup:upgrade uit
Data synchroniseert niet meer, de health-kaart meldt cron Cron draait niet Voer bin/magento cron:install uit en controleer crontab -l

Cron is belangrijker dan het lijkt. Conviro schrijft events van checkout, registratie en het opslaan van producten naar een lokale wachtrij die Magento-cron op de achtergrond aflevert. De extensie is bovendien zo ontworpen dat storefrontpagina's Conviro niet aanroepen vanuit PHP en dat bestellingen gewoon worden verwerkt als Conviro onbereikbaar is. Test de hele flow eerst op staging; onze testchecklist voor AI-chatbots helpt je na de installatie verder.

Veelgestelde vragen

Moet ik setup:di:compile uitvoeren in developer mode?

Nee. Developer mode genereert code op verzoek, dus na het installeren van een module zijn setup:upgrade en cache:flush genoeg. Voer in production mode ook setup:di:compile en setup:static-content:deploy uit, anders kunnen de storefront en de admin breken doordat gegenereerde code en statische bestanden ontbreken.

Waar slaat Composer de inloggegevens voor een private repository op?

composer config http-basic.<host> <user> <password> schrijft ze naar auth.json in de root van je project, naast composer.json. Voeg --global toe om ze in plaats daarvan in de Composer-home van je gebruiker op te slaan. Houd auth.json in beide gevallen buiten versiebeheer, zodat sleutels niet uitlekken.

Hoe controleer ik of een Magento 2-module is ingeschakeld?

Voer bin/magento module:status uit voor een lijst van ingeschakelde en uitgeschakelde modules, of voeg de modulenaam toe, bijvoorbeeld bin/magento module:status Conviro_AiChat. Staat de module als uitgeschakeld vermeld, voer dan module:enable uit, daarna setup:upgrade en een cache flush.

Kan ik een Magento-extensie installeren zonder SSH-toegang?

Niet met Composer. De extensie van Conviro heeft SSH- of CLI-toegang en Composer op de server nodig. Biedt je host dat niet, vraag dan je hostingprovider of bureau om de installatie uit te voeren. Op het Enterprise-abonnement installeert het team van Conviro de extensie zonder extra kosten.

Volgende stappen

Voer de installatie uit op staging, doorloop de configuratiewizard en controleer de Integration Health-kaart voordat je het op productie herhaalt. Wil je zien wat de extensie doet zodra hij gekoppeld is, lees dan ons overzicht van de Magento 2-extensie voor AI-chat. Klaar om te koppelen? Maak je Conviro-account aan.

Delen:

Gepubliceerd door

Conviro

Deelt inzichten over AI-aangedreven klantenservice, chatbot-automatisering en SaaS-groeistrategieën.

Bouw op Conviro

Koppel gespreksworkflows aan je stack

Bekijk ontwikkelaarsbronnen en integratiepatronen voordat je de implementatie ontwerpt.

Gerelateerde artikelen

Meer berichten