Cosa vedremo in questa guida

In questa guida vedremo come installare Valet+ in ambiente Mac OS per poter lavorare con Magento 1 e Magento 2 utilizzando diverse versioni di php. Questa guida nasce dall’esperienza di installazione di Valet+, gli errori commessi e alcuni trucchi per evitare problemi.

Iniziamo con l’installazione di Valet +

Prima di tutto segui la guida all’installazione fornita dal repository github ufficiale, la trovi a questo link https://github.com/weprovide/valet-plus, ma ti riassumo i comandi qui sotto:

  • Apri il terminale
  • Installa Homebrew:

/usr/bin/ruby -e “$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)”

  • Se hai già Homebrew installato aggiornalo, brew update
  • Installa questo brew tap henkrehorst/php
  • Installa questo brew install valet-php@7.1
  • Installa questo brew install valet-php@7.2
  • Installa questo brew install valet-php@5.6
  • Installa questo brew install composer
  • Poi composer global require weprovide/valet-plus
  • Lancia questo comando nano ~/.bash_profile
  • Incolla questo e salva export PATH=”$PATH:$HOME/.composer/vendor/bin”
  • Lancia questo comando valet fix
  • Lancia questo comando valet install

NOTA: la versione 2.0 ha degli errori usa: composer global require weprovide/valet-plus:1.0.27

Se vuoi rimuovere la soluzione puoi usare il comando:

composer global remove weprovide/valet-plus

Ora secondo la guida dovrebbe essere stato tutto installato correttamente. Puoi quindi navigare nella cartella del tuo progetto e lanciare i seguenti comandi:

valet link miosito

e poi

valet secure miosito

Con il browser potrai quindi utilizzare https://miosito.test e visualizzare il sito.

Se funziona tutto, bene, sei fortunato. In caso contrario segui questa seconda parte della guida:

  • Apri una nuova finestra nel terminale
  • Installa questo brew tap henkrehorst/homebrew-php
  • Installa tutte le versioni di php che potrebbero essere necessarie:
brew install valet-php@7.2
brew install valet-php@7.1
brew install valet-php@7.0
brew install valet-php@5.6
  • Apri una nuova finestra nel terminale e controlla quale versione php sta girando, il nostro obiettivo di ora è togliere il php preinstallato su mac e installare i 4 che ci servono con valet
  • Rimuoviamo il php di default di mac, potrebbero volerci più tentativi, in base al pc potrebbe avere nomi diversi:
brew remove php@7.1
brew remove php@7
brew remove php7
brew unlink php@7.1
brew unlink php@7
brew unlink php7
  • Facciamo una pulizia di Homebrew brew cleanup
  • Ora forziamo l’utilizzo del nostro php:
brew link valet-php@7.1 –force
  • Per controllare che sia impstato il php che vogliamo lanciare questo comando:
which php
  • Per essere corretto deve uscire “/usr/local/opt/valet-php@7.1/bin/php”
  • Aprire una nuova finestra nel terminale e fare valet install
  • Prova a scrivere bestemmia.test nel browser

Se ancora non dovesse funzionare, vai avanti con questi passaggi:

  • Disinstalliamo delle cose:
pecl uninstall apc
pecl uninstall apcu
pecl uninstall apcu_bc
  • E cerchiamo il nostro php.ini con questo comando:
php -i | grep php.ini
  • Apriamo il file per modificarlo, cancelliamo tutte le righe prima dell’intestazione [PHP] e incolliamo queste:
extension_dir = “/usr/local/lib/php/pecl/20160303”
zend_extension=”xdebug.so”
extension=”geoip.so”
extension=”apcu.so”
extension=”apc.so”
  • Salva
  • Riavviamo il php php brew services restart valet-php@7.1
  • Aprire una nuova finestra nel terminale e fare valet install
  • Prova a navigare miosito.test di nuovo.

Per utilizzare mysql e mysqldump è necessario eseguire un link simbolico.

ln -s /usr/local/Cellar/mysql@5.7/5.7.22/bin/mysql /usr/local/bin/mysql (assuming you have 5.7.22 installed).

Come cambiare versione di php

Se usi diverse versioni di magento 2 dovrai utlizzare anche diverse versioni di PHP. Di seguito ti spiego come cambiare la versione di php con valet+.

  • Con php -v controlliamo che versione sta girando
  • brew unlink valet-php@7.1 (Inserire il numero della versione da scollegare)
  • brew link valet-php@7.2 –force (inseriamo il numero della versione che vogliamo)
  • Lanciare i comandi per inserire le versioni di php nel ~/.bash_profile
  • Fare nano ~/.bash_profile e rimuovere le vecchie versioni
  • Apri una nuova tab nel terminale
  • Lancia valet install

Altri strumenti interessanti di valet+

Per sviluppare in modo produttivo è fondamentale avere un debugger. Php mette a disposizione xdebug. Con valet+ è semplice attivarlo basta eseguire il comando:

valet xdebug on

Un’altro strumento moto interessante è mailhog. Se digiti nel browser http://mailhog.test vedrai la coda della mail inviate, il testo le intestazioni e tutto quello che ti serve per debuggare l’invio della mail dalla tua applicazione.

Conclusione

Valet+ è un ottimo strumento di sviluppo se si utilizza Mac OS come sistema operativo. A mio avviso è l’unico strumento che permette di lavorare in modo produttivo con Magento 2. In questo articolo abbiamo visto quali sono le alternative per lo sviluppo locale di Magento 2 nei vari sistemi operativi. Oggi siamo andati nel dettaglio su come installare Valet+. Per ogni dubbio o suggerimento puoi scrivermi utilizzando il form dei contatti qui.

Un ringraziamento speciale va ad Andrea Rivadossi che ha ispirato e testato questa guida.