CONVIRO
Engineering

Magento 2 modulio diegimas per Composer: gidas žingsnis po žingsnio

Praktinis gidas, kaip įdiegti Magento 2 modulį per Composer: privačios saugyklos, auth.json, setup:upgrade, gamybinio režimo žingsniai, atnaujinimas, pašalinimas ir dažnos klaidos.

Conviro
2026 m. lapkričio 19 d.7 min. skaitymo
Magento 2 modulio diegimas per Composer: gidas žingsnis po žingsnio
Prieinama kalba:PLLTFRESENDEETNLITTRARPT
Šiame straipsnyje

Magento 2 modulio diegimas per Composer atrodo taip: pridedate tiekėjo saugyklą (repository) ir, jei ji privati, prisijungimo duomenis, paleidžiate composer require, įjungiate modulį, paleidžiate bin/magento setup:upgrade, o jei parduotuvė veikia gamybiniame režime (production mode), sukompiliuojate kodą ir sugeneruojate statinį turinį. Galiausiai išvalote talpyklą (cache). Komandų vos kelios, tačiau svarbi jų eilės tvarka ir diegimo režimas (deploy mode).

Šiame gide visą seką parodome naudodami nemokamą Conviro for Magento modulį kaip pavyzdį, o tada aptariame atnaujinimą, pašalinimą ir klaidas, su kuriomis greičiausiai susidursite.

Svarbiausia

  • Kiekvieną komandą paleiskite iš Magento šakninio katalogo kaip failų sistemos savininkas, pasidarę atsarginę kopiją ir pirmiausia testinėje aplinkoje.
  • Kūrėjo režime (developer mode) reikia setup:upgrade ir talpyklos išvalymo; gamybiniame režime dar reikia kompiliavimo ir statinio turinio generavimo.
  • Šalinkite atvirkštine tvarka: pirmiausia atjunkite integraciją, tada išjunkite modulį, pašalinkite paketą ir paleiskite setup:upgrade.

Prieš pradedant: reikalavimai

Prieš liesdami gamybinę aplinką, patikrinkite:

  • SSH prieiga ir Composer serveryje. Diegimo per Composer iš administravimo skydelio atlikti neįmanoma.
  • Nauja atsarginė kodo ir duomenų bazės kopija, o idealiu atveju – ir testinė kopija (staging), kurioje galėsite viską išbandyti.
  • Tinkamas vartotojas. Komandas paleiskite kaip failų sistemos savininkas, o ne kaip root, kitaip susidursite su failų teisių problemomis.
  • Jūsų diegimo režimas. Jį sužinosite komanda bin/magento deploy:mode:show.
  • Priežiūros langas gamybinei aplinkai: prieš pradėdami paleiskite bin/magento maintenance:enable, baigę – bin/magento maintenance:disable.

Conviro moduliui dar reikia Magento Open Source 2.4.4 ar naujesnės versijos su PHP 7.4 arba 8.1–8.4, HTTPS parduotuvės adreso, veikiančio Magento cron ir išeinančio HTTPS ryšio į api.conviro.io. Modulio (rašymo metu – 1.4.1 versija) diegimas išbandytas su šiais deriniais:

Magento PHP Tema
2.4.4-p13 8.1 Luma
2.4.7-p4 8.3 Luma
2.4.9 8.4 Luma ir Hyvä 1.5.2

Adobe Commerce veikia ta pačia sistema, tačiau su juo modulis dar neišbandytas, Hyvä Checkout taip pat neišbandytas, o parduotuvės su Magento 2.4.0–2.4.3 lieka su modulio versija 1.3.5.

Magento 2 modulio diegimas per Composer žingsnis po žingsnio

1 žingsnis: pridėkite Composer saugyklą ir prisijungimo duomenis

Privatūs moduliai platinami per paties tiekėjo Composer saugyklą. Iš Magento šakninio katalogo:

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

Pirmoji komanda prideda saugyklą į composer.json. Antroji įrašo prisijungimo duomenis į šalia esantį auth.json. Conviro atveju vartotojo vardas yra api, o slaptažodis – API raktas iš Developers → API Keys Conviro skydelyje. Daugiau apie Conviro API rasite kūrėjų puslapyje.

Neįtraukite auth.json į versijų kontrolę. Tame pačiame faile paprastai laikomi ir jūsų repo.magento.com raktai.

2 žingsnis: paleiskite composer require ir setup:upgrade

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

Šios trys komandos – bet kurio Magento 2 modulio diegimo pagrindas:

  1. composer require atsisiunčia paketą į vendor/ ir užfiksuoja jį composer.json bei composer.lock failuose. Abu failus įtraukite į versijų kontrolę (commit), kad visose aplinkose būtų įdiegta ta pati versija.
  2. module:enable užregistruoja modulį faile app/etc/config.php.
  3. setup:upgrade pritaiko modulio duomenų bazės schemos ir duomenų pataisas (patches) ir atnaujina modulių registrą.

3 žingsnis: sukompiliuokite, sugeneruokite statinį turinį ir išvalykite talpyklą

Gamybiniame režime sugeneruotas kodas ir statiniai failai nekuriami pagal poreikį, todėl paleiskite:

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

Kūrėjo režime abu žingsnius praleiskite. Bet kuriame režime baikite komanda:

bin/magento cache:flush

Tada patikrinkite, ar modulis aktyvus, ir išjunkite priežiūros režimą (maintenance mode):

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

4 žingsnis: prijunkite modulį administravimo skydelyje

Daugumą modulių po įdiegimo reikia sukonfigūruoti. Conviro atveju atidarykite Stores › Settings › Conviro Setup. 7 žingsnių vedlys atlieka aplinkos patikrinimą, tada spustelite Connect to Conviro, patvirtinate parduotuvę Conviro skydelyje ir grįžtate į Magento. Į Magento nekopijuojamas joks API raktas ar prieigos žetonas (token).

Vedlys sukuria mažiausių teisių Magento integraciją (OAuth 1.0a), leidžia pasirinkti parduotuvių rodinius (store views), ką sinchronizuoti ir kuriuos DI veiksmus leisti, o viską patikrina bandomuoju įvykiu. Vėliau Integration Health kortelė skiltyje Stores › Configuration › Conviro › AI Chat tikrina ryšį, autentifikavimą, webhook, katalogą, užsakymus, cron, versiją ir aplinką bei pateikia taisymo instrukcijas. Kiekvienas žingsnis aprašytas diegimo puslapyje ir diegimo dokumentacijoje. Prijungimui reikia Conviro plano su API prieiga – Pro ar aukštesnio (žr. kainas).

Magento 2 modulio atnaujinimas ir pašalinimas

Atnaujinimas

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

Kaip ir anksčiau, kompiliuokite ir generuokite statinį turinį tik gamybiniame režime. Išleidus naują versiją, Magento administravimo skydelyje parodomas pranešimas su tikslia komanda, o jūsų konfigūracija, API raktas ir integracija išsaugomi.

Pašalinimas

Eilės tvarka svarbi: atsijungiama sąrankos vedlyje, o jo nebelieka, kai tik modulis pašalinamas.

  1. Atsijunkite Conviro sąrankos vedlyje.
  2. Išjunkite modulį: bin/magento module:disable Conviro_AiChat
  3. Pašalinkite paketą: composer remove conviro/module-aichat
  4. Paleiskite bin/magento setup:upgrade.

Gamybiniame režime, kaip įprasta, iš naujo sukompiliuokite kodą, sugeneruokite statinį turinį ir išvalykite talpyklą. Conviro ištrina parduotuvės duomenis praėjus 30 dienų po atsijungimo arba iš karto, jei taip pasirenkate. Visi žingsniai išvardyti pašalinimo dokumentacijoje.

Dažnos Magento 2 diegimo klaidos ir kaip jas ištaisyti

Požymis Tikėtina priežastis Sprendimas
„Allowed memory size exhausted“ vykdant Composer PHP atminties limitas Paleiskite COMPOSER_MEMORY_LIMIT=-1 composer require ...
Kompiliuojant pritrūksta atminties CLI atminties limitas Paleiskite php -d memory_limit=2G bin/magento setup:di:compile
Saugykla grąžina 401 arba prašo prisijungimo duomenų Neteisingas raktas arba vartotojo vardas Pakartokite http-basic komandą; vartotojo vardas yra api
„Permission denied“ kataloguose generated/, var/ ar pub/static/ Komandos paleistos kaip root arba kaip kitas vartotojas Sutvarkykite failų savininką ir paleiskite iš naujo kaip failų sistemos savininkas
„Please upgrade your database“ Nepaleistas setup:upgrade Paleiskite bin/magento setup:upgrade
Duomenys nebesinchronizuojami, būklės kortelė žymi cron Neveikia cron Paleiskite bin/magento cron:install ir patikrinkite crontab -l

Cron svarbesnis, nei atrodo. Conviro atsiskaitymo, registracijos ir prekės išsaugojimo įvykius įrašo į vietinę eilę, kurią Magento cron pristato fone. Be to, modulis suprojektuotas taip, kad parduotuvės puslapiai nekviestų Conviro iš PHP, o užsakymai būtų apdorojami net tada, kai Conviro nepasiekiamas. Pirmiausia visą eigą išbandykite testinėje aplinkoje; po diegimo pravers mūsų DI pokalbių roboto testavimo kontrolinis sąrašas.

Dažniausiai užduodami klausimai

Ar kūrėjo režime reikia paleisti setup:di:compile?

Ne. Kūrėjo režime kodas generuojamas pagal poreikį, todėl įdiegus modulį pakanka setup:upgrade ir cache:flush. Gamybiniame režime taip pat paleiskite setup:di:compile ir setup:static-content:deploy, kitaip parduotuvės puslapiai ir administravimo skydelis gali sutrikti, nes trūks sugeneruoto kodo ir statinių failų.

Kur Composer saugo privačios saugyklos prisijungimo duomenis?

Komanda composer config http-basic.<host> <user> <password> įrašo juos į auth.json projekto šakniniame kataloge, šalia composer.json. Jei pridėsite --global, jie bus saugomi jūsų vartotojo Composer namų kataloge (Composer home). Bet kuriuo atveju neįtraukite auth.json į versijų kontrolę, kad raktai nenutekėtų.

Kaip patikrinti, ar Magento 2 modulis įjungtas?

Paleiskite bin/magento module:status – gausite įjungtų ir išjungtų modulių sąrašą. Galite pridėti ir modulio pavadinimą, pavyzdžiui, bin/magento module:status Conviro_AiChat. Jei modulis nurodytas kaip išjungtas, paleiskite module:enable, tada setup:upgrade ir išvalykite talpyklą.

Ar galima įdiegti Magento modulį be SSH prieigos?

Per Composer – ne. Conviro moduliui serveryje reikia SSH arba CLI prieigos ir Composer. Jei jūsų priegloba (hosting) jų nesuteikia, paprašykite, kad diegimą atliktų prieglobos paslaugų teikėjas arba jūsų agentūra. Enterprise plane Conviro komanda modulį įdiegia be papildomo mokesčio.

Tolesni žingsniai

Įdiekite modulį testinėje aplinkoje, pereikite sąrankos vedlį ir patikrinkite Integration Health kortelę, o tik tada pakartokite viską gamybinėje aplinkoje. Ką modulis daro prisijungus, išsamiai aprašėme Magento 2 DI pokalbių modulio apžvalgoje. Pasiruošę prijungti parduotuvę? Susikurkite Conviro paskyrą.

Dalintis:

Paskelbė

Conviro

Dalinamės įžvalgomis apie AI grįstą klientų palaikymą, pokalbių robotų automatizavimą ir SaaS augimo strategijas.

Kurkite su Conviro

Sujunkite pokalbių darbo eigas su savo sistemomis

Prieš projektuodami diegimą peržiūrėkite kūrėjų išteklius ir integracijos modelius.

Susiję straipsniai

Daugiau įrašų