Quando o manobrista para de funcionar corretamente, o que fazemos?

Sou fã de usar tanto o Homebrew quanto o Valet quando se trata de configurar e configurar um ambiente de desenvolvimento básico do WordPress. Embora o uso de gerenciadores de pacotes e softwares simples para tal devam facilitar as coisas, isso não nos absolve de problemas ocasionais.

Caso em questão: há momentos em que podemos ter que atualizar nosso TLD para funcionar bem com o Chrome e outros navegadores, ou até mesmo atualizar toda a instalação.

Infelizmente, nem sempre é tão fácil como deveria ser. Tecnicamente, devemos poder desinstalar o Valet e atualizá-lo via Composer. Mas eu pessoalmente me deparei com alguns problemas que relegaram ter que:

• desinstalar manualmente Valet,
• use o Homebrew para desinstalar o PHP e limpar o que restou completamente,
• reinstale os pacotes Homebrew,
• instalar manobrista,
• verifique se o navegador usa a mesma versão do PHP que a instalação do Valet.

Parece muito trabalho para algo que deveria mais ou menos “simplesmente funcionar" e são alguns passos, mas eles são bem rápidos de configurar.

Quando o manobrista para de trabalhar

Portanto, se você se encontrar em uma situação em que o Valet não está trabalhando com WordPress ou Homebrew ou qualquer um deles, talvez as etapas a seguir ajudem.

1 Remova manualmente o manobrista

De acordo com a documentação, devemos ser capazes de executar:

$ valet uninstall

Para concluir, remova o software, mas isso não funciona. Em vez disso, precisamos removê-lo completamente removendo seu diretório e o binário associado.

Se você estiver executando o macOS, a maneira de fazer isso é remover o diretório .vendor e o binário de manobrista encontrado em /usr/local/bin/valet.

Para fazer isso, digite os seguintes comandos no terminal:

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

Embora você não deva receber nenhuma mensagem de erro, talvez seja necessário executar  o sudo para remover o binário (mas se esse for o caso, provavelmente ele foi removido instalado incorretamente na primeira vez.

2 Use Homebrew para remover PHP

Uma das coisas boas do Homebrew é que ele nos permite executar várias versões do PHP e alternar entre elas. Isso é especialmente útil se você estiver trabalhando com vários projetos para uso generalizado ou ambientes especializados.

Para ver quais versões do PHP estão em seu sistema, você pode executar o seguinte:

$ brew list

E você deve ver algo assim:

Em seguida, remova os seguintes pacotes:

• dnsmasq
• nginx
• php

E se você tem várias versões do PHP, então você vai querer remover todas as versões do software. Para fazer isso, digite os seguintes comandos:

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

Você também pode precisar executar brew uninstall para cada versão do PHP se tiver várias versões em execução em seu sistema.

Observe que, se você tiver várias versões do PHP em execução, também poderá ter problemas ao remover cada uma delas.

Se for esse o caso, você precisará forçar a remoção (usando o comando –force ), ou pode ser necessário remover recursivamente um determinado diretório que produz relatórios. Isso precisará ser feito para cada uma das instalações do PHP.

Uma vez feito, lembre-se de executar cleanup.

Em seguida, você pode ir em frente e executar o médico para ver se há algum problema e resolvê-lo, se houver. Em muitos casos, você encontrará links simbólicos quebrados que podem ser removidos digitando brew prune.

Se você fizer isso e executar o brew doctor novamente, tudo ficará bem:

E você estará pronto para começar a reparar a instalação.

3 Reinstale os pacotes Homebrew

Em seguida, vamos instalar a versão mais recente do PHP. Você pode, é claro, optar por instalar qualquer versão do PHP, mas esse é o conteúdo para outro post (ou você pode ver o que está disponível nesta página ).

Primeiro, você pode precisar tocar no repositório homebrew/php se ainda não estiver na sua lista de repositórios disponíveis; no entanto, você pode verificar o que você tem simplesmente digitando

$ brew tap

Se você ver homebrew/php, então você está pronto para ir.

Então, a partir daí, vamos atualizar o brew:

$ brew update

Em seguida, instale a versão mais recente do PHP digitando:

$ brew install homebrew/core/php

No momento da redação deste artigo, este é o PHP 7.2.5.

Para verificar se foi instalado corretamente, você pode inserir qual php em seu terminal e /usr/local/bin/php deve ser retornado. Em seguida, se você executar php -v, deverá ver 7.2.5 retornado como a versão.

4 Reinstale o manobrista

Agora é hora de reinstalar o Valet. Faça isso, digite o seguinte comando no seu terminal:

$ composer global require laravel/valet

Em seguida, certifique-se de executar o seguinte comando:

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

Isso garante que os binários globais do Composer estejam localizados nas variáveis ​​ambientais do seu sistema e estejam disponíveis em qualquer lugar do seu sistema.

Em seguida, execute a instalação com manobrista. Isso instalará o dnsmasq e o nginx, que são componentes necessários para executar o Valet.

5 Verifique se o navegador funciona conforme o esperado

Antes de testar o navegador, queremos fazer ping no ambiente local para garantir que o servidor web esteja funcionando conforme o esperado. Para fazer isso, digite o seguinte no terminal:

$ ping foo.test

Supondo que tudo esteja configurado corretamente, você deve obter uma resposta:

Agora é hora de verificar se o navegador está usando a mesma versão do PHP que instalamos na etapa anterior. Para fazer isso, crie um diretório em qualquer lugar do seu sistema, chame index.php e digite o seguinte no arquivo:

<?php
phpinfo();

Em seguida, navegue até o diretório em seu terminal – eu chamei meu beta – e digite o seguinte comando em seu terminal:

$ valet link && valet secure

Em seguida, carregue https://beta.test no seu navegador. Supondo que tudo corra bem, isto é o que você deve ver:

Observe que a versão do PHP que está sendo usada é a mesma que instalamos anteriormente.

Por que fazer isso manualmente?

Neste ponto, você tem uma instalação de Valet totalmente funcional com a versão mais recente de todos os pacotes necessários. Infelizmente, o comando de desinstalação não faz o que você espera e deixa alguns artefatos para trás.

Assim, é por isso que sou fã de remover tudo manualmente, fazer uma atualização e reinstalar o Valet.

Se você tiver problemas com sua instalação – especialmente se estiver usando BrowserSync, Yarn ou algo semelhante – isso deve resolver esses problemas (junto com qualquer outro que você possa estar enfrentando).