Installare Magento 2.4.8 richiede un ambiente aggiornato, coerente e configurato correttamente per garantire un funzionamento stabile sia in produzione sia in locale. Per lavorare in modo efficiente con questa versione, è fondamentale rispettare i requisiti minimi e seguire una procedura chiara per l’installazione.
Questa guida descrive in modo dettagliato tutti i passaggi necessari per predisporre un ambiente di sviluppo locale utilizzando DDEV e installare Magento 2.4.8 tramite Composer e CLI. Tutte le informazioni riportate derivano esclusivamente dal materiale fornito.
Requisiti minimi per Magento 2.4.8
Prima di procedere con l’installazione, è essenziale verificare che l’ambiente di sviluppo soddisfi i requisiti aggiornati. Magento 2.4.8 necessita delle seguenti componenti tecniche:
PHP 8.1 o 8.2 e relative estensioni
È richiesta una delle due versioni di PHP:
- PHP 8.1
- PHP 8.2
In entrambi i casi, devono essere presenti queste estensioni:
- curl
- dom
- gd
- intl
- mbstring
- openssl
- pdo_mysql
- soap
- xsl
- zip
- sodium
- bcmath
Queste estensioni sono indispensabili per il corretto funzionamento delle funzioni di base del sistema, della gestione delle immagini, dell’internazionalizzazione, delle connessioni esterne e della comunicazione con il database.
Composer 2.x
Magento richiede Composer nella serie 2.x, necessario per scaricare il progetto e gestirne le dipendenze.
Database: MySQL 8.0 o MariaDB 10.4+
Il sistema può funzionare con:
- MySQL 8.0
oppure - MariaDB 10.4+
Entrambe le soluzioni sono compatibili con Magento 2.4.8.
Motore di Ricerca: Elasticsearch 7.17 o OpenSearch 1.x
Dal ramo Magento 2.4.0 in avanti, è obbligatorio configurare un motore di ricerca esterno. Sono ammessi due varianti:
- Elasticsearch 7.17
- OpenSearch 1.x
DDEV versione 1.19 o superiore
DDEV deve essere installato e aggiornato almeno alla versione 1.19.
Memoria RAM
- Minimo richiesto: 2 GB
- Consigliato: 4 GB, soprattutto se si attivano moduli aggiuntivi o i sample data.
Setup Completo: DDEV + Magento 2.4.8
Di seguito è riportato il flusso completo per configurare un ambiente locale con Magento 2.4.8.
1. Inizia un nuovo progetto Magento
All’interno di una nuova cartella, esegui:
cd path/to/project
ddev config --project-type=php --docroot=pub --php-version=8.1
Questo comando imposta il progetto per l’uso con PHP 8.1 e configura pub come document root.
2. Aggiungi Elasticsearch alla configurazione DDEV
Per integrare Elasticsearch nel progetto, modifica il file .ddev/config.yaml aggiungendo:
webimage_extra_packages: []
additional_services:
elastic:
image: docker.elastic.co/elasticsearch/elasticsearch:7.17.0
ports:
- "9200:9200"
environment:
- discovery.type=single-node
- xpack.security.enabled=false
Questa configurazione permette di avviare un servizio Elasticsearch 7.17 in modalità single-node, con la sicurezza disattivata per l’ambiente locale.
3. Avvia l’ambiente DDEV
Lancia:
ddev start
Questo comando crea e avvia i container necessari per l’ambiente di sviluppo Magento.
4. Scarica Magento 2.4.8 tramite Composer
Per installare i file del progetto:
composer create-project --repository-url=https://repo.magento.com/ magento/project-community-edition=2.4.8 magento
Questa operazione scarica Magento 2.4.8 direttamente dal repository ufficiale.
5. Configura le chiavi di autenticazione
Quando richiesto durante la procedura di installazione del progetto tramite Composer:
- Inserisci la chiave pubblica
- Inserisci la chiave privata
Le chiavi provengono dal Magento Marketplace (account personale sviluppatore o merchant).
6. Imposta i permessi corretti
Entra nel container:
ddev ssh
cd /var/www/html
Poi esegui i comandi:
find var generated vendor pub/static pub/media app/etc -type f -exec chmod g+w {} +
find var generated vendor pub/static pub/media app/etc -type d -exec chmod g+ws {} +
chmod u+x bin/magento
Questi comandi applicano i permessi necessari affinché Magento possa scrivere nelle proprie directory e utilizzare correttamente la CLI.
Installazione di Magento 2.4.8 tramite CLI
Adesso puoi procedere all’installazione completa.
Da dentro il container (ddev ssh), esegui:
bin/magento setup:install \
--base-url="http://$(ddev describe --json | jq -r .router_http_address)/" \
--db-host=db --db-name=db --db-user=db --db-password=db \
--admin-firstname=Admin --admin-lastname=User \
--admin-email=admin@example.com --admin-user=admin --admin-password=Admin123! \
--language=it_IT --currency=EUR --timezone=Europe/Rome \
--use-rewrites=1 --search-engine=elasticsearch7 --elasticsearch-host=elastic --elasticsearch-port=9200
Questa operazione installa:
- database
- schema Magento
- utente admin
- configurazione lingua
- configurazione valuta
- configurazione timezone
- collegamento al motore Elasticsearch
Al termine, Magento sarà installato correttamente nell’ambiente locale gestito da DDEV.
Configurazioni Post-Installazione
Dopo l’installazione, è possibile eseguire alcune configurazioni aggiuntive.
Modalità di sviluppo
Per verificare la modalità attiva:
bin/magento deploy:mode:show
L’output dovrebbe indicare:
developer
Reindex e Cache
Per rigenerare gli indici:
bin/magento indexer:reindex
Per svuotare la cache:
bin/magento cache:flush
Lingua italiana
Magento include l’opzione nativa it_IT. Puoi selezionarla dall’amministrazione:
Stores → Configuration → General
URL amministrativo
Magento genera automaticamente un URL admin casuale. È possibile personalizzarlo secondo le proprie necessità.
Installare i Sample Data (opzionale)
I Sample Data permettono di avere prodotti demo utili per verificare la corretta configurazione del catalogo.
Per installarli:
ddev ssh
composer require magento/sample-data:2.4.8 --no-update
composer update
bin/magento sampledata:deploy
bin/magento setup:upgrade
bin/magento indexer:reindex
Questo flusso aggiunge i dati di esempio e li rende operativi dopo l’aggiornamento dello schema.
Sicurezza e Attività di Sviluppo Quotidiane
Magento richiede alcune attività ricorrenti anche in locale. Il materiale fornito elenca le operazioni essenziali.
Esecuzione dei cron
Per eseguire i cron tramite DDEV:
ddev exec bin/magento cron:run
Attivare HTTPS locale
Per attivare un certificato locale nell’ambiente DDEV:
ddev use https
Backup del database e snapshot
Per esportare rapidamente il database:
ddev export-db
Questo comando consente di salvare lo stato attuale del database locale.
Aggiornare Magento
Per aggiornare Magento all’ultima versione compatibile:
composer update magento/project-community-edition --with-dependencies
bin/magento setup:upgrade
Conclusione
Questa guida contiene, in modo completo e rigoroso, tutti i passaggi riportati nel materiale fornito per installare e configurare Magento 2.4.8 in un ambiente locale basato su DDEV.
I requisiti minimi, la procedura con Composer, l’integrazione con Elasticsearch, le configurazioni di permessi, l’installazione via CLI, le attività post-installazione, la gestione opzionale dei sample data e le operazioni quotidiane per cron, HTTPS e backup costituiscono il flusso completo necessario per predisporre un ambiente di sviluppo funzionale e aggiornato.