Co robimy, gdy Valet przestaje działać prawidłowo?

Jestem fanem używania zarówno Homebrew, jak i Valet, jeśli chodzi o konfigurację i konfigurację podstawowego środowiska programistycznego WordPress. Chociaż używanie do tego celu menedżerów pakietów i prostego oprogramowania powinno ułatwić sprawę, nie zwalnia nas to od sporadycznych problemów.

Przykład: są chwile, w których być może będziemy musieli zaktualizować naszą domenę TLD, aby dobrze bawić się z Chrome i innymi przeglądarkami, a nawet uaktualnić całą instalację.

Niestety nie zawsze jest to takie proste, jak powinno być. Technicznie powinniśmy być w stanie odinstalować Valet i zaktualizować go za pomocą Composera. Ale osobiście napotkałem pewne problemy, które spowodowały, że musiałem:

• ręcznie odinstaluj Valeta,
• użyj Homebrew, aby odinstalować PHP i całkowicie wyczyścić to, co zostało,
• ponownie zainstaluj pakiety Homebrew,
• zainstaluj Valeta,
• sprawdź, czy przeglądarka używa tej samej wersji PHP, co instalacja Valet.

Brzmi to jak dużo pracy dla czegoś, co powinno mniej więcej „po prostu działać" i jest to sporo kroków, ale są one dość szybkie w konfiguracji.

Kiedy Valet przestaje działać

Więc jeśli znajdziesz się w sytuacji, w której Valet nie pracuje z WordPressem, Homebrew lub żadnym z nich, być może poniższe kroki pomogą.

1 Ręcznie usuń Valeta

Zgodnie z dokumentacją powinniśmy być w stanie uruchomić:

$ valet uninstall

Aby całkowicie usunąć oprogramowanie, ale to nie działa. Zamiast tego musimy całkowicie go usunąć, usuwając jego katalog i powiązany plik binarny.

Jeśli używasz macOS, sposobem na to jest usunięcie katalogu .vendor i pliku binarnego valet znalezionego w /usr/local/bin/valet.

Aby to zrobić, wprowadź w terminalu następujące polecenia:

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

Chociaż nie powinieneś otrzymywać żadnych komunikatów o błędach, być może będziesz musiał uruchomić sudo, aby usunąć plik binarny (ale jeśli tak jest, prawdopodobnie został on usunięty nieprawidłowo zainstalowany za pierwszym razem.

2 Użyj Homebrew, aby usunąć PHP

Jedną z fajnych rzeczy w Homebrew jest to, że pozwala nam uruchamiać wiele wersji PHP i przełączać się między nimi. Jest to szczególnie przydatne, jeśli pracujesz z różnymi projektami o szerokim zastosowaniu lub w wyspecjalizowanych środowiskach.

Aby zobaczyć, jakie wersje PHP są w Twoim systemie, możesz uruchomić następujące polecenie:

$ brew list

Powinieneś zobaczyć coś takiego:

Następnie usuń następujące pakiety:

• dnsmasq
• nginx
• php

A jeśli masz wiele wersji PHP, będziesz chciał usunąć wszystkie wersje oprogramowania. Aby to zrobić, wprowadź następujące polecenia:

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

Może być również konieczne uruchomienie dezinstalacji programu brew dla każdej wersji PHP, jeśli w systemie działa wiele wersji.

Zauważ, że jeśli masz uruchomionych kilka wersji PHP, możesz również napotkać problemy z usunięciem każdej z nich.

Jeśli tak jest, będziesz musiał wymusić usunięcie (za pomocą polecenia –force) lub być może będziesz musiał rekurencyjnie usunąć dany katalog, który raportuje brew. Trzeba to zrobić dla każdej instalacji PHP.

Po zakończeniu pamiętaj o uruchomieniu czyszczenia.

Następnie możesz iść dalej i poprowadzić lekarza, aby sprawdzić, czy są jakieś problemy i rozwiązać je, jeśli takie istnieją. W wielu przypadkach znajdziesz uszkodzone dowiązania symboliczne, które można następnie usunąć, wpisując brew prune.

Jeśli to zrobisz i ponownie uruchomisz brew Doctor, to wszystko powinno wyglądać dobrze:

I będziesz gotowy do rozpoczęcia naprawy instalacji.

3 Zainstaluj ponownie pakiety Homebrew

Następnie zainstalujmy najnowszą wersję PHP. Możesz oczywiście zdecydować się na zainstalowanie dowolnej wersji PHP, która nie jest treścią innego posta (lub możesz zobaczyć, co jest dostępne na tej stronie ).

Po pierwsze, może być konieczne dotknięcie repozytorium homebrew/php, jeśli nie ma go jeszcze na liście dostępnych repozytoriów; jednak możesz sprawdzić, co masz, po prostu wpisując

$ brew tap

Jeśli widzisz homebrew/php, możesz zacząć.

Od tego momentu zaktualizujmy piwo:

$ brew update

Następnie zainstaluj najnowszą wersję PHP wpisując:

$ brew install homebrew/core/php

W chwili pisania tego tekstu jest to PHP 7.2.5.

Aby sprawdzić, czy został poprawnie zainstalowany, możesz wpisać , który php w twoim terminalu i /usr/local/bin/php powinien zostać zwrócony. Następnie, jeśli uruchomisz php -v, powinieneś zobaczyć zwróconą wersję 7.2.5.

4 Zainstaluj ponownie Valeta

Teraz nadszedł czas na ponowną instalację Valeta. Zrób to, wprowadź następujące polecenie w swoim terminalu:

$ composer global require laravel/valet

Następnie upewnij się, że wykonałeś następujące polecenie:

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

Dzięki temu globalne pliki binarne Composera znajdują się w zmiennych środowiskowych systemu i są dostępne w dowolnym miejscu systemu.

Następnie uruchom valet install. Spowoduje to zainstalowanie dnsmasq i nginx, które są komponentami niezbędnymi do uruchomienia Valeta.

5 Sprawdź, czy przeglądarka działa zgodnie z oczekiwaniami

Przed testowaniem przeglądarki chcemy pingować środowisko lokalne, aby upewnić się, że serwer sieciowy działa zgodnie z oczekiwaniami. Aby to zrobić, wpisz w terminalu:

$ ping foo.test

Zakładając, że wszystko jest poprawnie skonfigurowane, powinieneś otrzymać odpowiedź:

Teraz nadszedł czas, aby upewnić się, że przeglądarka używa tej samej wersji PHP, którą zainstalowaliśmy w poprzednim kroku. Aby to zrobić, utwórz katalog w dowolnym miejscu w systemie, wywołaj index.php, a następnie wpisz w pliku:

<?php
phpinfo();

Następnie przejdź do katalogu w swoim terminalu – nazwałem moją wersję beta – a następnie wprowadź następujące polecenie w swoim terminalu:

$ valet link && valet secure

Następnie załaduj https://beta.test w swojej przeglądarce. Zakładając, że wszystko pójdzie dobrze, powinieneś zobaczyć:

Zauważ, że używana wersja PHP jest taka sama, jaką zainstalowaliśmy wcześniej.

Dlaczego to robić ręcznie?

W tym momencie masz w pełni działającą instalację Valet z najnowszą wersją wszystkich niezbędnych pakietów. Niestety, polecenie odinstalowania nie robi tego, czego można by się spodziewać i pozostawia za sobą pewne artefakty.

Dlatego jestem fanem ręcznego usuwania wszystkiego, robienia aktualizacji, a następnie ponownej instalacji Valeta.

Jeśli napotkasz problemy z instalacją — zwłaszcza jeśli korzystasz z BrowserSync, Yarn, itp. — powinno to rozwiązać te problemy (wraz z innymi, które możesz napotkać).