Quando Valet smette di funzionare correttamente, cosa facciamo?

Sono un fan dell’utilizzo sia di Homebrew che di Valet quando si tratta di impostare e configurare un ambiente di sviluppo WordPress di base. Anche se l’utilizzo di gestori di pacchetti e software semplici per questo tipo dovrebbe semplificare le cose, non ci esime dai problemi occasionali.

Caso in questione: ci sono momenti in cui potremmo dover aggiornare il nostro TLD per giocare bene con Chrome e altri browser, o addirittura aggiornare l’intera installazione.

Sfortunatamente, non è sempre così facile come dovrebbe essere. Tecnicamente, dovremmo essere in grado di disinstallare Valet e aggiornarlo tramite Composer. Ma personalmente ho riscontrato alcuni problemi che hanno dovuto retrocedere a:

• disinstallare manualmente Valet,
• usa Homebrew per disinstallare PHP e ripulire completamente ciò che è stato lasciato,
• reinstallare i pacchetti Homebrew,
• installa Valet,
• verificare che il browser utilizzi la stessa versione di PHP dell’installazione di Valet.

Sembra un sacco di lavoro per qualcosa che dovrebbe più o meno "funzionare" e sono pochi passaggi, ma sono abbastanza veloci da configurare.

Quando il parcheggiatore smette di funzionare

Quindi, se ti trovi in ​​una situazione in cui Valet non sta lavorando con WordPress o Homebrew o nessuno dei due, allora forse i seguenti passaggi ti aiuteranno.

1 Rimuovere manualmente Valet

Secondo la documentazione, dovremmo essere in grado di eseguire:

$ valet uninstall

Per completare rimuovere il software, ma non funziona. Invece, dobbiamo rimuoverlo completamente rimuovendo la sua directory e il binario associato.

Se stai utilizzando macOS, il modo per farlo è rimuovere la directory .vendor e il binario valet trovato in /usr/local/bin/valet.

Per fare ciò, inserisci i seguenti comandi nel terminale:

$ rm -rf ~/.valet
$ rm ~/usr/local/bin/valet

Sebbene non dovresti ricevere alcun messaggio di errore, potrebbe essere necessario eseguire sudo per rimuovere il file binario (ma in questo caso, è probabile che sia stato rimosso installato in modo errato la prima volta.

2 Usa Homebrew per rimuovere PHP

Una delle cose belle di Homebrew è che ci consente di eseguire più versioni di PHP e passare da una all’altra. Ciò è particolarmente utile se stai lavorando con vari progetti per un uso diffuso o ambienti specializzati.

Per vedere quali versioni di PHP sono presenti sul tuo sistema, puoi eseguire quanto segue:

$ brew list

E dovresti vedere qualcosa del genere:

Quindi, rimuovere i seguenti pacchetti:

• dnsmasq
• nginx
• php

E se hai più versioni di PHP, vorrai rimuovere tutte le versioni del software. Per fare ciò, inserisci i seguenti comandi:

$ brew uninstall dnsmasq && brew uninstall nginx && brew uninstall php
$ brew cleanup

Potrebbe anche essere necessario eseguire brew uninstall per ogni versione di PHP se sono presenti più versioni in esecuzione sul sistema.

Nota che se hai diverse versioni di PHP in esecuzione, potresti anche incontrare problemi durante la rimozione di ciascuna di esse.

In tal caso, sarà necessario forzare la rimozione (utilizzando il comando –force) oppure potrebbe essere necessario rimuovere ricorsivamente una determinata directory che genera report. Questo dovrà essere fatto per ciascuna delle installazioni di PHP.

Una volta terminato, ricorda di eseguire cleanup.

Successivamente, potresti voler andare avanti e rivolgerti al medico per vedere se ci sono problemi e risolverli se ce ne sono. In molti casi, troverai collegamenti simbolici interrotti che possono quindi essere rimossi digitando brew prune.

Se lo fai ed esegui di nuovo brew doctor, allora tutto dovrebbe apparire a posto:

E sarai pronto per iniziare ad andare avanti riparando l’installazione.

3 Reinstallare i pacchetti Homebrew

Quindi, installiamo la versione più recente di PHP. Puoi, ovviamente, scegliere di installare qualsiasi versione di PHP che, ma questo è il contenuto di un altro post (oppure puoi vedere cosa è disponibile in questa pagina ).

Innanzitutto, potrebbe essere necessario toccare il repository homebrew/php se non è già nell’elenco dei repository disponibili; tuttavia, puoi verificare cosa hai semplicemente inserendo

$ brew tap

Se vedi homebrew/php allora sei a posto.

Quindi, da lì, aggiorniamo brew:

$ brew update

Quindi installa l’ultima versione di PHP inserendo:

$ brew install homebrew/core/php

Al momento in cui scrivo, questo è PHP 7.2.5.

Per verificare che sia stato installato correttamente, puoi inserire quale php nel tuo terminale e /usr/local/bin/php dovrebbe essere restituito. Quindi, se esegui php -v dovresti vedere 7.2.5 restituito come versione.

4 Reinstallare Valet

Ora è il momento di reinstallare Valet. Per fare ciò, inserisci il seguente comando nel tuo terminale:

$ composer global require laravel/valet

Quindi, assicurati di eseguire il seguente comando:

export PATH="$PATH:$HOME/.composer/vendor/bin"

Ciò garantisce che i binari globali di Composer si trovino nelle variabili ambientali del sistema e siano disponibili in qualsiasi punto del sistema.

Quindi, esegui valet install. Questo installerà dnsmasq e nginx che sono componenti necessari per eseguire Valet.

5 Verificare che il browser funzioni come previsto

Prima di testare il browser, vogliamo eseguire il ping dell’ambiente locale per assicurarci che il server Web funzioni come previsto. Per fare ciò, inserisci quanto segue nel terminale:

$ ping foo.test

Supponendo che tutto sia impostato correttamente, dovresti ricevere una risposta:

Ora è il momento di assicurarsi che il browser utilizzi la stessa versione PHP che abbiamo installato nel passaggio precedente. Per fare ciò, crea una directory in qualsiasi punto del tuo sistema, chiama index.php e quindi inserisci quanto segue nel file:

<?php
phpinfo();

Quindi, vai alla directory nel tuo terminale – ho chiamato il mio beta – e quindi inserisci il seguente comando nel tuo terminale:

$ valet link && valet secure

Quindi, carica https://beta.test nel tuo browser. Supponendo che tutto vada bene, questo è ciò che dovresti vedere:

Si noti che la versione di PHP utilizzata è la stessa che abbiamo installato in precedenza.

Perché farlo manualmente?

A questo punto, hai un’installazione Valet completamente funzionante con l’ultima versione di tutti i pacchetti necessari. Sfortunatamente, il comando di disinstallazione non fa quello che ti aspetteresti e lascia dietro di sé alcuni artefatti.

Pertanto, questo è il motivo per cui sono un fan della rimozione di tutto manualmente, dell’aggiornamento e della reinstallazione di Valet.

Se riscontri problemi con l’installazione, specialmente se stai utilizzando BrowserSync, Yarn o simili, questo dovrebbe risolvere quei problemi (insieme a qualsiasi altro che potresti riscontrare).