Com instal·lar extensions al Magento amb Composer

A més d'instal·lar les extensions de Magento manualment a través d'SSH, també pots ampliar-ne les capacitats utilitzant el Commerce Marketplace d'Adobe com a repositori per afegir-les. Per exemple, pots adquirir un tema per canviar l'aparença, un paquet d'idioma o algun mòdul per afegir diferents pagaments en línia utilitzant Composer per instal·lar-los.

En aquest article expliquem els primers passos que has de seguir per instal·lar un mòdul del repositori oficial mitjançant Composer i també t'indicarem diferents accions que pots dur a terme per administrar aquestes extensions.

Obtenció i configuració de claus

Primer caldrà iniciar sessió o registrar-te a Adobe Magento, així podràs obtenir les claus necessàries per a Composer fent clic a Access Keys del teu perfil del Marketplace.

Des d'aquesta ubicació podràs generar o obtenir les claus per a la versió corresponent de Magento.

Tens més informació a la documentació oficial sobre com obtenir les claus fent clic aquí.

Un cop obtingudes les claus, accedeix al servidor per SSH i copia el fitxer d'exemple d'autenticació per a Composer:

# cp /var/www/html/magento2/auth.json.sample /var/www/html/magento2/auth.json

Després, edita el fitxer copiat de les credencials:

# nano /var/www/html/magento2/auth.json

I introdueix les claus pública i privada dins de les cometes en cada apartat corresponent:

"username": "<public-key>",
"password": "<private-key>"

També afegeix o comprova l'existència del repositori de Magento al fitxer de Composer:

# nano /var/www/html/magento2/composer.json

El fitxer ha de contenir les línies següents; si no les conté, pots afegir-les després del primer claudàtor:

"repositories": [
  {
    "type": "composer",
    "url": "https://repo.magento.com/"
  }
],

Tens més informació a la documentació oficial sobre Composer fent clic aquí.

Actualització de Composer

Abans d'instal·lar l'extensió, és possible que et demani l'actualització de Composer; per tant, executa:

# composer update

Però si has instal·lat Composer a través del repositori apt o similar, l'actualització no estarà disponible i donarà error. Per això, obtén l'instal·lador de Composer:

# php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"

Abans d'instal·lar-lo, comprova el camí de la instal·lació actual:

# which composer

Mostrarà el camí, per exemple /usr/bin/composer (per defecte a la imatge preinstal·lada). Per instal·lar-lo al mateix directori, executa l'ordre següent indicant el camí del directori binari:

# php composer-setup.php --install-dir=/usr/bin --filename=composer

Posteriorment, podràs actualitzar Composer amb normalitat:

# composer update 

Instal·lació d'un mòdul

Un cop hagis completat tots els passos previs, pots adquirir el mòdul desitjat des del Market; un cop completat el procés, a My Purchases haurà d'aparèixer l'extensió o les extensions disponibles:

Amb això, pots comprovar el nom a "Component name" i instal·lar el mòdul mitjançant Composer:

# composer require stripe/stripe-payments

Després caldrà registrar l'extensió a Magento actualitzant-lo:

# php bin/magento setup:upgrade

Tot i que, si es tracta d'un entorn de producció, posteriorment caldrà executar:

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

Finalment, és recomanable netejar la memòria cau de Magento:

# php bin/magento cache:flush && php bin/magento cache:clean

Amb aquesta última acció, el mòdul estarà instal·lat i actiu a Magento.

A continuació t'expliquem diverses accions que et poden ser útils per administrar mòduls.

Verificació de l'estat dels mòduls

Verifica l'estat dels mòduls instal·lats consultant-lo a la base de dades de Magento:

# mysql -u root -e "SELECT * from magento.setup_module"

Consulta de l'estat dels mòduls utilitzant el binari de Magento:

# bin/magento module:status

Consulta de l'estat d'un únic mòdul utilitzant el binari:

# bin/magento module:status nombre-modulo

Activar o desactivar un mòdul

Activació d'un mòdul:

# bin/magento module:enable nombre-modulo --clear-static-content

Desactivació d'un mòdul:

# bin/magento module:disable nombre-modulo --clear-static-content

Actualització o instal·lació d'una versió específica d'un mòdul

Actualització d'un mòdul:

# composer update vendedor/nombre-modulo

Instal·lació d'un mòdul especificant-ne la versió:

# composer require 'vendedor/nombre-modulo ^x.x.x'

Actualització de Magento per registrar la instal·lació o l'actualització d'un mòdul:

# bin/magento setup:upgrade --keep-generated

Neteja la memòria cau de Magento:

# bin/magento setup:static-content:deploy -f

# bin/magento cache:clean

Desinstal·lació d'un mòdul:

Eliminació del mòdul:

# composer remove stripe/stripe-payments

Registra la desinstal·lació del mòdul a Magento:

# php bin/magento setup:upgrade

Reconfigura Magento:

# php bin/magento setup:di:compile

Neteja la memòria cau de Magento:

# php bin/magento setup:static-content:deploy -f

# php bin/magento cache:clean

Esperem que aquest article t'hagi estat útil. Si tens consultes sobre aquesta o qualsevol altra qüestió relacionada amb els teus servidors a Clouding, no dubtis a contactar amb soporte@clouding.io. Som aquí per ajudar-te!