CONVIRO
Engineering

Magento 2 mooduli paigaldamine Composeriga: samm-sammuline juhend

Praktiline juhend Magento 2 mooduli paigaldamiseks Composeriga: privaatsed repositooriumid, auth.json, setup:upgrade, tootmisrežiimi sammud, uuendamine, eemaldamine ja levinud…

Conviro
19. november 20267 min lugemist
Magento 2 mooduli paigaldamine Composeriga: samm-sammuline juhend
Saadaval keeltes:PLLTFRESENDEETNLITTRARPT
Selles artiklis

Magento 2 mooduli paigaldamine Composeriga käib nii: lisad mooduli pakkuja repositooriumi (privaatse repositooriumi puhul ka mandaadid), käivitad composer require, lülitad mooduli sisse, käivitad bin/magento setup:upgrade, kompileerid ja juurutad staatilise sisu, kui pood on tootmisrežiimis, ning tühjendad vahemälu. Käske on vaid käputäis, kuid nende järjekord ja juurutusrežiim (deploy mode) on olulised.

See juhend käib kogu järjekorra läbi tasuta Conviro for Magento mooduli näitel ning käsitleb seejärel uuendamist, eemaldamist ja vigu, millele kõige tõenäolisemalt otsa satud.

Peamised järeldused

  • Käivita kõik käsud Magento juurkataloogis failisüsteemi omaniku kasutajana, pärast varukoopia tegemist ja kõigepealt testkeskkonnas.
  • Arendusrežiimis piisab käsust setup:upgrade ja vahemälu tühjendamisest; tootmisrežiimis on vaja ka kompileerimist ja staatilise sisu juurutamist.
  • Eemalda vastupidises järjekorras: kõigepealt korista ära integratsioon, seejärel lülita moodul välja, eemalda pakett ja käivita setup:upgrade.

Enne alustamist: eeldused

Kontrolli need asjad üle, enne kui toodangukeskkonda puudutad:

  • SSH-ligipääs ja Composer serveris. Composeriga paigaldust ei saa teha halduspaneelist.
  • Värske varukoopia koodist ja andmebaasist ning ideaalis testkeskkonna koopia, kus katsetada.
  • Õige kasutaja. Käivita käsud failisüsteemi omaniku, mitte rootina, muidu tekitad endale õiguste probleeme.
  • Sinu juurutusrežiim. Kontrolli seda käsuga bin/magento deploy:mode:show.
  • Hooldusaken toodangu jaoks: enne bin/magento maintenance:enable, pärast bin/magento maintenance:disable.

Conviro mooduli jaoks on lisaks vaja Magento Open Source'i versiooni 2.4.4 või uuemat koos PHP 7.4 või 8.1–8.4-ga, HTTPS-iga poe URL-i, töötavat Magento croni ja väljuvat HTTPS-ühendust aadressile api.conviro.io. Moodul (selle kirjutamise ajal versioon 1.4.1) on paigaldustestitud järgmistel kombinatsioonidel:

Magento PHP Teema
2.4.4-p13 8.1 Luma
2.4.7-p4 8.3 Luma
2.4.9 8.4 Luma ja Hyvä 1.5.2

Adobe Commerce töötab samal raamistikul, kuid seda pole veel testitud. Hyvä Checkout on testimata ning versioonidel 2.4.0–2.4.3 töötavad poed jäävad mooduli versioonile 1.3.5.

Magento 2 mooduli paigaldamine Composeriga samm-sammult

1. samm: lisa Composeri repositoorium ja mandaadid

Privaatseid mooduleid jagatakse mooduli pakkuja enda Composeri repositooriumist. Käivita Magento juurkataloogis:

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

Esimene käsk lisab repositooriumi faili composer.json. Teine salvestab mandaadid selle kõrval asuvasse faili auth.json. Conviro puhul on kasutajanimi api ja parool API-võti, mille leiad Conviro töölaualt jaotisest Developers → API Keys. Conviro API kohta loe lähemalt arendajate lehelt.

Hoia auth.json versioonihaldusest väljas. Tavaliselt on samas failis ka sinu repo.magento.com võtmed.

2. samm: käivita composer require ja setup:upgrade

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

Need kolm käsku on iga Magento 2 mooduli paigalduse tuum:

  1. composer require laadib paketi kausta vendor/ ning kirjutab selle failidesse composer.json ja composer.lock. Lisa mõlemad failid versioonihaldusesse, et igas keskkonnas paigalduks sama versioon.
  2. module:enable registreerib mooduli failis app/etc/config.php.
  3. setup:upgrade rakendab mooduli andmebaasi skeemi- ja andmepaigad (schema/data patches) ning uuendab moodulite registrit.

3. samm: kompileeri, juuruta ja tühjenda vahemälu

Tootmisrežiimis ei genereerita koodi ega staatilisi faile vajaduse peale, seega käivita:

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

Arendusrežiimis jäta mõlemad vahele. Mõlemas režiimis lõpeta käsuga:

bin/magento cache:flush

Seejärel kontrolli, et moodul on aktiivne, ja lülita hooldusrežiim välja:

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

4. samm: ühenda moodul halduspaneelis

Enamik mooduleid vajab pärast paigaldamist seadistamist. Conviro puhul ava Stores › Settings › Conviro Setup. Seitsmesammuline viisard teeb kõigepealt keskkonna kontrolli, seejärel klõpsad Connect to Conviro, kinnitad poe Conviro töölaual ja naased Magentosse. Magentosse ei kopeerita ühtegi API-võtit ega tokenit.

Viisard loob minimaalsete õigustega Magento integratsiooni (OAuth 1.0a), laseb valida poevaated, mida sünkroonida ja milliseid AI-toiminguid lubada, ning kontrollib kõike testsündmusega. Pärast seda kontrollib Integration Healthi kaart jaotises Stores › Configuration › Conviro › AI Chat ühendust, autentimist, webhooke, kataloogi, tellimusi, croni, versiooni ja keskkonda ning annab parandusjuhised. Paigaldusleht ja paigaldusdokumentatsioon käsitlevad iga sammu. Ühendamiseks on vaja API-ligipääsuga Conviro paketti ehk Pro või kõrgemat paketti (vaata hinnakirja).

Magento 2 mooduli uuendamine ja eemaldamine

Uuendamine

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

Nagu varemgi, kompileeri ja juuruta ainult tootmisrežiimis. Kui ilmub uus versioon, näitab Magento halduspaneel teadet koos täpse käsuga ning sinu seadistus, API-võti ja integratsioon säilivad.

Eemaldamine

Järjekord on oluline: ühenduse katkestamine käib seadistusviisardis, mis kaob, kui moodul on eemaldatud.

  1. Katkesta ühendus Conviro seadistusviisardis.
  2. Lülita moodul välja: bin/magento module:disable Conviro_AiChat
  3. Eemalda pakett: composer remove conviro/module-aichat
  4. Käivita bin/magento setup:upgrade.

Tootmisrežiimis kompileeri uuesti, juuruta uuesti staatiline sisu ja tühjenda vahemälu nagu tavaliselt. Conviro kustutab poe andmed 30 päeva pärast ühenduse katkestamist või kohe, kui nii valid. Eemaldamise dokumentatsioonis on kõik sammud kirjas.

Levinud vead ja nende parandamine

Sümptom Tõenäoline põhjus Lahendus
"Allowed memory size exhausted" Composeri töö ajal PHP mälupiirang Käivita COMPOSER_MEMORY_LIMIT=-1 composer require ...
Kompileerimisel saab mälu otsa CLI mälupiirang Käivita php -d memory_limit=2G bin/magento setup:di:compile
Repositoorium annab vea 401 või küsib mandaate Vale võti või kasutajanimi Käivita http-basic käsk uuesti; kasutajanimi on api
"Permission denied" kaustas generated/, var/ või pub/static/ Käsud käivitati rootina või vale kasutajana Paranda omandiõigused ja käivita käsud uuesti failisüsteemi omanikuna
"Please upgrade your database" setup:upgrade on käivitamata Käivita bin/magento setup:upgrade
Andmed ei sünkroonu, Integration Healthi kaart märgib croni Cron ei tööta Käivita bin/magento cron:install ja kontrolli crontab -l

Cron on olulisem, kui esmapilgul tundub. Conviro kirjutab kassa, registreerimise ja toote salvestamise sündmused kohalikku järjekorda, mille Magento cron taustal edasi saadab. Moodul on ka üles ehitatud nii, et poe lehed ei pöördu PHP kaudu Conviro poole ja tellimused töödeldakse ka siis, kui Conviro pole kättesaadav. Testi kogu voog kõigepealt testkeskkonnas; pärast paigaldamist aitab meie AI-vestlusroboti testimise kontroll-loend.

Korduma kippuvad küsimused

Kas arendusrežiimis on vaja käivitada setup:di:compile?

Ei. Arendusrežiimis genereeritakse kood vajaduse peale, nii et pärast mooduli paigaldamist piisab käskudest setup:upgrade ja cache:flush. Tootmisrežiimis käivita ka setup:di:compile ja setup:static-content:deploy, muidu võivad poe avalik pool ja halduspaneel katki minna, sest genereeritud kood ja staatilised failid puuduvad.

Kuhu salvestab Composer privaatse repositooriumi mandaadid?

composer config http-basic.<host> <user> <password> kirjutab need projekti juurkataloogi faili auth.json, faili composer.json kõrvale. Kui lisad lipu --global, salvestatakse need hoopis sinu kasutaja Composeri kodukataloogi. Mõlemal juhul hoia auth.json versioonihaldusest väljas, et võtmed ei lekiks.

Kuidas kontrollida, kas Magento 2 moodul on sisse lülitatud?

Käivita bin/magento module:status, et näha sisse- ja väljalülitatud mooduleid, või lisa käsule mooduli nimi, näiteks bin/magento module:status Conviro_AiChat. Kui moodul on väljalülitatud, käivita module:enable, seejärel setup:upgrade ja tühjenda vahemälu.

Kas Magento moodulit saab paigaldada ilma SSH-ligipääsuta?

Composeriga mitte. Conviro moodul vajab serveris SSH- või CLI-ligipääsu ja Composerit. Kui sinu majutus neid ei paku, palu paigaldus teha oma majutusteenuse pakkujal või agentuuril. Enterprise-paketi puhul paigaldab Conviro meeskond mooduli ilma lisatasuta.

Järgmised sammud

Tee paigaldus läbi testkeskkonnas, käi seadistusviisard läbi ja kontrolli Integration Healthi kaarti, enne kui sama toodangus kordad. Ülevaate sellest, mida moodul pärast ühendamist teeb, leiad meie Magento 2 vestlusmooduli tutvustusest. Valmis ühendama? Loo Conviro konto.

Jaga:

Avaldanud

Conviro

Jagame teadmisi AI-põhise klienditoe, vestlusrobotite automatiseerimise ja SaaS-i kasvustrateegiate kohta.

Arenda Conviro baasil

Ühenda vestluspõhised töövood oma süsteemidega

Tutvu arendaja ressursside ja integratsioonimustritega enne, kui lahenduse ülesehituse kavandad.

Seotud artiklid

Veel postitusi