Torna al blog

Come configurare un sito WordPress o Drupal localmente con ddev

2021-12-224 min di lettura

DDEV è uno strumento open source che consente di configurare rapidamente siti locali utilizzando Docker. Non è necessario conoscere concetti complessi su Docker per poter avere i tuoi siti locali WordPress o Drupal funzionanti. Puoi consultare la loro documentazione ufficiale qui https://ddev.com/get-started/ e qui https://ddev.readthedocs.io/en/stable/

I passaggi/comandi elencati di seguito sono quelli di cui ho avuto più bisogno, quindi sto spostando questa nota sul web come riferimento per me stesso, in futuro, o per aiutare altri che potrebbero averne bisogno.

Come installare DDEV

  1. Installa homebrew, seguendo i passaggi su: https://brew.sh/
  2. Assicurati di avere Docker installato. Puoi seguire i passaggi su questo link se non sei sicuro di come fare.
  3. Installa ddev (MAC): brew install drud/ddev/ddev
  4. Devi eseguire ddev config una volta per progetto per configurarlo. Esegui questo dalla cartella in cui intendi avere tutti i file relativi al progetto. Ti verranno poste tre domande:
    1. Qual è il nome del sito?
      • Ti consiglio di scegliere una parola facile da ricordare. Verrà utilizzata per il dominio locale che dovrai usare per aprire il sito nel browser. Esempio: Se scegli localsite come nome del progetto, accederai al sito dal browser usando https://localsite.ddev.site/ 
    2. Qual è la posizione della docroot?
      1. Questa è la cartella in cui hai clonato o intendi clonare i file per il progetto. Consiglio di creare una cartella chiamata web nella stessa cartella da cui esegui il comando ddev config dal passaggio 1. 
    3. Che tipo di progetto è? Come Drupal, PHP, WordPress, ecc.
  5. Devi eseguire ddev start per avere il progetto attivo e funzionante. Puoi eseguire il comando dall'esterno della cartella se ricordi il nome del progetto.
  6. Vuoi importare un database? Puoi eseguire ddev import-db –file=dumpfile.sql.gz dalla directory del progetto. Eliminerà il database prima di importare il nuovo backup del database.
  7. E per quanto riguarda se hai bisogno di eseguire comandi composer, drush o wp-cli? Dovresti eseguire ddev ssh
  8. Stai riscontrando un errore e hai bisogno di vedere i log? Dovresti eseguire: ddev logs -f
  9. Ho avuto bisogno di eseguire questo comando prima di poter eseguire drush su alcuni dei miei progetti Drupal: ddev composer require drush/drush
  10. Hai bisogno di ottenere l'URL dei siti, la porta o verificare se i servizi sono attivi? ddev describe ti fornirà tali informazioni.
  11. Se hai bisogno che i tuoi siti locali utilizzino https, dovresti eseguire: mkcert -install
  12. Hai bisogno di eseguire il debug del codice PHP con xdebug? Dovrai eseguire ddev xdebug per abilitarlo. ddev xdebug off lo disattiverà di nuovo.
  13. Sei su Mac e i tuoi siti locali sono molto lenti, dovresti eseguire ddev config global –mutagen-enabled e questo abiliterà mutagen globalmente. Noterai subito la differenza.
  14. Se hai seguito il passaggio 12 e hai bisogno di aggiornare molti file (magari aggiornando plugin o moduli?), mutagen potrebbe essere lento a rilevare i file aggiornati, quindi potresti dover eseguire ddev mutagen sync per accelerare il processo di sincronizzazione.
  15. Hai bisogno di testare il tuo sito con una versione PHP diversa, quindi puoi usare ddev config –php-version 8.0 8.0 può essere qualsiasi versione PHP di cui hai bisogno.
  16. Per installare memcached:
    1. Nell'ultima versione di ddev dovrai eseguire: ddev get drud/ddev-memcached && ddev restart
    2. Per WordPress, in wp-config.php, dovrai aggiungere le seguenti righe:
/**
 * Impostazioni Memcache.
 */
$memcached_servers = [
    'default' => [
        'ddev-YOUR_PROJECT_NAME-memcached:11211',
    ]
];

# sostituisci la chiave per progetto e mantienila in git
define( 'WP_CACHE_KEY_SALT', 'random_cache_key_salt' );