Come installare la piattaforma eCommerce Magento su Ubuntu 24.04

Magento è una piattaforma eCommerce open-source e ben nota scritta in PHP. Magento è una soluzione eCommerce robusta e potente utilizzata da oltre 240.000 commercianti in tutto il mondo. Magento è una piattaforma versatile e scalabile per costruire un negozio eCommerce. È adatta per costruire negozi online piccoli, medi e grandi. Magento ti consente di creare e ospitare i tuoi negozi online sul tuo server.

In questa guida, ti guideremo attraverso l’installazione di Magento eCommerce sul server Ubuntu 22.04.

Prerequisiti

Per iniziare con questa guida, assicurati di aver preparato quanto segue:

• Un Ubuntu 24.04 con almeno 4GB di memoria.
• Un utente non root con privilegi sudo.
• Un nome di dominio puntato a un indirizzo IP del server.

Installazione delle dipendenze

Prima di passare all’installazione, devi assicurarti che le dipendenze di Magento siano installate. In questa sezione, installerai i pacchetti software per Magento, che includono OpenSearch, Nginx, MySQL server, PHP-FPM, Redis, Composer e Git.

Per prima cosa, installa i pacchetti ‘ apt-transport-https ‘ e ‘ gnupg ‘ con il seguente comando:

sudo apt install apt-transport-https gnupg -y

Esegui il seguente comando per aggiungere la chiave GPG di OpenSearch e il repository per le distribuzioni basate su Debian/Ubuntu.

curl -o- https://artifacts.opensearch.org/publickeys/opensearch.pgp | \  
sudo gpg --dearmor --batch --yes -o /usr/share/keyrings/opensearch-keyring

echo "deb [signed-by=/usr/share/keyrings/opensearch-keyring] https://artifacts.opensearch.org/releases/bundle/opensearch/2.x/apt stable main" | \  
sudo tee /etc/apt/sources.list.d/opensearch-2.x.list

Ora aggiorna l’indice dei pacchetti di Ubuntu e installa le dipendenze con il seguente comando apt. Con questo, installerai i pacchetti OpenSearch, Nginx, MySQL, PHP-FPM, Redis, Composer e Git.

sudo apt update && sudo apt install opensearch nginx mysql-server composer git redis-server php-fpm php-bcmath php-common php-mbstring php-xmlrpc php-soap php-gd php-xml php-intl php-mysql php-cli php-redis php-ldap php-zip php-curl php-imagick

Immetti Y per confermare l’installazione.

Dopo l’installazione, controlla tutti i servizi per assicurarti che siano in esecuzione.

Controlla il servizio Nginx con il seguente comando. Vedrai che il servizio Nginx è in esecuzione e abilitato.

sudo systemctl is-enabled nginx  
sudo systemctl status nginx

Ora controlla il server MySQL con il comando qui sotto. Puoi vedere nell’output qui sotto che il server MySQL è in esecuzione.

sudo systemctl is-enabled mysql  
sudo systemctl status mysql

Controlla il servizio PHP-FPM utilizzando il seguente comando. Il PHP-FPM dovrebbe essere in esecuzione e abilitato automaticamente.

sudo systemctl is-enabled php8.3-fpm  
sudo systemctl status php8.3-fpm

Controlla il server Redis utilizzando il comando qui sotto. Dovresti vedere che Redis è in esecuzione e abilitato.

sudo systemctl is-enabled redis-server  
sudo systemctl status redis-server

Infine, controlla la versione di Composer con il seguente comando. Dovresti avere Composer v2.7 installato sul tuo sistema.

sudo -u www-data composer -v

Configurazione di OpenSearch

Dopo aver installato le dipendenze, devi configurare OpenSearch. Magento utilizza OpenSearch per la ricerca avanzata dei prodotti e l’indicizzazione. In questa sezione, aumenterai la memoria heap massima predefinita e disabiliterai il plugin di sicurezza di OpenSearch (solo per un ambiente di sviluppo).

Apri il file ‘ /etc/opensearch/jvm.options ‘ utilizzando il seguente editor nano.

sudo nano /etc/opensearch/jvm.options

Cambia l’allocazione di memoria predefinita per OpenSearch come necessario. In questo caso, utilizzeremo 2GB per OpenSearch.

-Xms2g  
-Xmx2g

Salva il file ed esci.

Ora apri la configurazione predefinita di OpenSearch ‘ /etc/opensearch/opensearch.yml ‘ con l’editor nano.

sudo nano /etc/opensearch/opensearch.yml

Aggiungi la seguente configurazione per disabilitare il plugin di sicurezza in OpenSearch. Per dimostrazione, puoi disabilitarlo, ma per la produzione, devi abilitare il plugin di sicurezza e impostare i certificati TLS per la tua installazione di OpenSearch.

plugins.security.disabled: true

Quando hai finito, salva ed esci dal file.

Successivamente, esegui il comando qui sotto per ricaricare il gestore systemd. Dopo aver installato OpenSearch, devi ricaricare il gestore systemd.

sudo systemctl daemon-reload

Ora avvia, abilita e verifica il servizio Opensearch con il seguente comando:

sudo systemctl enable --now opensearch  
sudo systemctl status opensearch

Nell’output seguente, puoi vedere che OpenSearch è in esecuzione e abilitato.

Infine, controlla la tua installazione di OpenSearch utilizzando il seguente comando ‘ curl ‘. Questo ti mostrerà informazioni di base sulla tua installazione di OpenSearch.

curl -X GET http://localhost:9200

Qui sotto puoi vedere che OpenSearch 2.14 è in esecuzione sul server Ubuntu.

Configurazione di PHP-FPM

In questa sezione, modificherai la configurazione predefinita di PHP-FPM e abiliterai l’estensione Opcache attraverso il file ‘php.ini’. Aumenterai il memory_limit predefinito e regolerai l’opzione date.timezone.

Apri la configurazione di PHP-FPM ‘ /etc/php/8.3/fpm/php.ini’ con il seguente editor nano.

sudo nano /etc/php/8.3/fpm/php.ini

Cambia la configurazione predefinita con la seguente. Inoltre, regola il date.timezone e il memory_limit con il tuo attuale ambiente server.

date.timezone = Europe/Amsterdam

Quando hai finito, salva il file ed esci.

Ora esegui il comando qui sotto per riavviare il servizio PHP-FPM e applicare le tue modifiche.

sudo systemctl restart php8.3-fpm

Configurazione del server MySQL

Ora che hai configurato PHP-FPM, nella prossima sezione configurerai l’installazione del server MySQL e creerai un nuovo database e utente per Magento.

Metti in sicurezza la tua installazione del server MySQL eseguendo il comando qui sotto.

sudo mysql_secure_installation

Qui sotto ti verrà chiesto delle configurazioni del server MySQL:

• Immetti y per abilitare il componente VALIDATE PASSWORD.
• Immetti 1 per impostare il livello di forza della password su MEDIO.
• Immetti y quando ti viene chiesto di cambiare la password root di MySQL.
• Immetti y per rimuovere l’utente anonimo predefinito.
• Immetti y per vietare il login remoto per l’utente root di MySQL.
• Immetti y di nuovo per rimuovere il database di test predefinito da MySQL.
• Infine, immetti y per ricaricare i privilegi delle tabelle di MySQL e applicare le modifiche.

Dopo aver configurato MySQL, devi creare un nuovo database e utente per Magento.

Accedi al server MySQL con il seguente comando. Digita la tua password root di MySQL quando richiesto.

sudo mysql -u root -p

Ora esegui le seguenti query per creare un nuovo database e utente per Magento. In questo esempio, creerai un nuovo utente e database ‘ magento ‘ con la password ‘ M4gentoPassw0rd__ ‘.

Assicurati di cambiare i seguenti dettagli con le tue informazioni. Inoltre, la password di MySQL per Magento dovrebbe avere un carattere speciale, un numero e una maiuscola.

CREATE DATABASE magento;  
CREATE USER 'magento'@'localhost' IDENTIFIED BY 'M4gentoPassw0rd__';  
GRANT ALL PRIVILEGES ON magento.* to 'magento'@'localhost';  
FLUSH PRIVILEGES;

Successivamente, esegui la seguente query per verificare i privilegi per l’utente ‘ magento ‘. Assicurati che il tuo utente possa accedere al database ‘ magento ‘.

SHOW GRANTS FOR magento@localhost;

Infine, digita quit per uscire dal server MySQL.

Installazione di Magento tramite la riga di comando

In questa sezione, scaricherai il codice sorgente di Magento e installerai le dipendenze PHP utilizzando Composer. Poi, installerai Magento utilizzando la riga di comando. Infine, genererai un crontab per Magento.

Vai alla directory ‘ /var/www ‘ e scarica il codice sorgente di Magento utilizzando il seguente comando wget. Controlla la pagina GitHub di Magento e prendi l’URL dell’ultima versione di Magento.

cd /var/www  
wget https://github.com/magento/magento2/archive/refs/tags/2.4.7.tar.gz

Dopo che il download è completo, estrai il codice sorgente di Magento e rinomina la directory estratta in ‘magento2’. Con questo, la tua installazione di Magento dovrebbe trovarsi in ‘/var/www/magento2’.

tar -xf 2.4.7.tar.gz  
mv magento2-* magento2

Ora esegui il comando qui sotto per creare directory aggiuntive per Composer e cambiare la proprietà della directory ‘ /var/www ‘ all’utente ‘ www-data ‘.

sudo mkdir -p /var/www/{.config,.cache}  
sudo chown -R www-data:www-data /var/www

Poi, esegui il seguente comando per dare all’utente ‘ www-data ‘ il permesso di leggere, scrivere ed eseguire all’interno della directory ‘ /var/www/magento2 ‘.

sudo chmod u+rwx /var/www/magento2

Successivamente, vai alla directory ‘ /var/www/magento2 ‘ e installa le dipendenze PHP per Magento con il comando Composer qui sotto. Questo garantirà che le tue dipendenze per Magento siano installate.

cd /var/www/magento2  
sudo -u www-data composer install

Dopo aver installato le dipendenze, esegui il comando qui sotto per consentire all’utente ‘ www-data ‘ il permesso di ‘ rwx ‘ per entrambe le directory ‘ generated ‘ e ‘ var ‘ all’interno della radice web di Magento.

sudo chown -R www-data:www-data /var/www/magento2/var /var/www/magento2/generated  
sudo chmod u+rwx /var/www/magento2/var /var/www/magento2/generated  
sudo chmod g+rw /var/www/magento2/var /var/www/magento2/generated

Ora esegui il seguente comando per avviare l’installazione di Magento. Assicurati di cambiare i dettagli dell’URL, del database MySQL, dell’utente amministratore e della password per la tua installazione di Magento.

sudo -u www-data bin/magento setup:install \  
--base-url=http://howtoforge.local \  
--db-host=localhost \  
--db-name=magento2 \  
--db-user=magento \  
--db-password=M4gentoPassw0rd__ \  
--admin-firstname=bob \  
--admin-lastname=admin \  
--admin-email=[email protected] \  
--admin-user=bob \  
--admin-password=BobAdm1nP4ssword \  
--currency=USD \  
--timezone=Europe/Amsterdam \  
--use-rewrites=1 \  
--session-save=redis \  
--search-engine=opensearch \  
--opensearch-host=127.0.0.1 \  
--opensearch-port=9200 \  
--opensearch-enable-auth=0 \  
--opensearch-index-prefix=magento22 \  
--opensearch-timeout=30

Qui sotto puoi vedere l’inizio dell’installazione di Magento:

Una volta completato, vedrai l’output ‘ Installazione di Magento completata.’ e il percorso dell’URL admin per la tua installazione di Magento. Assicurati di salvare l’URL generato per la pagina di amministrazione di Magento.

Per terminare l’installazione di Magento, esegui il seguente comando per generare il crontab per Magento e avviare l’indicizzazione per Magento.

sudo -u www-data bin/magento cron:install  
sudo -u www-data bin/magento cron:run --group index

Puoi controllare l’elenco del crontab per l’utente ‘www-data’ con il seguente comando:

crontab -u www-data -l

Puoi vedere qui sotto che il crontab per Magento è stato generato.

Infine, esegui il comando qui sotto per cancellare la cache della tua installazione di Magento. Con questo, hai completato l’installazione di Magento, ora devi configurare il server web Nginx.

sudo -u www-data bin/magento cache:clean

Configurazione del blocco server Nginx

A questo punto, la tua installazione di Magento è terminata, ora creerai un nuovo server Nginx per eseguire la tua installazione di Magento. Assicurati di avere un nome di dominio puntato al tuo indirizzo IP del server.

Crea una nuova configurazione del blocco server Nginx ‘ /etc/nginx/sites-available/magento.conf ‘ con l’editor nano.

sudo nano /etc/nginx/sites-available/magento.conf

Inserisci la seguente configurazione e assicurati di cambiare l’opzione server_name con il tuo nome di dominio Magento.

upstream fastcgi_backend {  
 server unix:/run/php/php8.3-fpm.sock;  
}  
  
server {  
 listen 80;  
 listen [::]:80;  
 server_name howtoforge.local;  
 set $MAGE_ROOT /var/www/magento2/;  
 include /var/www/magento2/nginx.conf.sample;  
 client_max_body_size 2M;  
  
 access_log /var/log/nginx/magento.access;  
 error_log /var/log/nginx/magento.error;  
}

Quando hai finito, salva ed esci dal file.

Ora esegui il comando qui sotto per attivare il blocco server ‘ magento.conf ‘ e verificare la sintassi di Nginx. Assicurati di ottenere l’output ‘ la sintassi è ok - il test ha avuto successo ‘.

sudo ln -s /etc/nginx/sites-available/magento.conf /etc/nginx/sites-enabled/  
sudo nginx -t

Infine, riavvia il servizio Nginx con il seguente comando per applicare la tua nuova configurazione del blocco server. Dopo che il comando è stato eseguito, la tua installazione di Magento sarà disponibile.

sudo systemctl restart nginx

Mettere in sicurezza Magento con HTTPS

Se stai eseguendo Magento in un dominio pubblico, devi metterlo in sicurezza con HTTPS. In questa sezione, metterai in sicurezza la tua installazione di Magento con HTTPS tramite Certbot e Letsencrypt.

Installa Certbot e il plugin Certbot Nginx utilizzando il seguente comando. Immetti Y per confermare l’installazione.

sudo apt install certbot python3-certbot-nginx

Dopo che l’installazione è completa, esegui il comando qui sotto per generare certificati SSL/TLS da Letsencrypt. Assicurati di cambiare l’indirizzo email e il nome di dominio qui sotto con le tue informazioni.

sudo certbot --nginx --agree-tos --no-eff-email --redirect --hsts --staple-ocsp --email [email protected] -d howtoforge.local

La tua installazione di Magento dovrebbe essere automaticamente messa in sicurezza con HTTPS quando il processo è completato. I tuoi certificati SSL/TLS si trovano nella directory ‘ /etc/letsencrypt/live/domain.com ‘.

Accesso a Magento

Apri il tuo browser web e visita il tuo nome di dominio Magento come https://howtoforge.local. Se la tua installazione ha avuto successo, vedrai la pagina indice predefinita di Magento come la seguente.

Ora, visita l’URL di amministrazione di Magento, che è https://howtoforge.local/admin_ze87mmj. Controlla il processo di installazione.

Inserisci il tuo utente amministratore e la password per Magento e premi Login.

Se hai successo, dovresti ottenere il cruscotto di amministrazione di Magento come il seguente:

Conclusione

Congratulazioni! Hai completato l’installazione di Magento eCommerce sul server Ubuntu 24.04. Hai installato Magento con il LEMP Stack (Linux, Nginx, MySQL e PHP-FPM), OpenSearch e Redis. Hai anche messo in sicurezza Magento con HTTPS tramite Certbot e Letsencrypt.