Що ми робимо, коли Valet перестає працювати належним чином?

Я прихильник використання як Homebrew, так і Valet, коли справа доходить до налаштування та налаштування базового середовища розробки WordPress. Хоча використання менеджерів пакунків і простого програмного забезпечення для подібного має полегшити роботу, це не звільняє нас від періодичних проблем.

Приклад: бувають випадки, коли нам може знадобитися оновити наш домен верхнього рівня, щоб добре працювати з Chrome та іншими браузерами, або навіть оновити всю установку.

На жаль, це не завжди так легко, як хотілося б. Технічно ми повинні мати можливість видалити Valet і оновити його через Composer. Але я особисто зіткнувся з деякими проблемами, через які потрібно:

• вручну видалити Valet,
• використовуйте Homebrew, щоб видалити PHP і повністю очистити те, що залишилося,
• перевстановити пакети Homebrew,
• встановити Valet,
• переконайтеся, що браузер використовує ту саму версію PHP, що й інсталяція Valet.

Це звучить як багато роботи для чогось, що має більш-менш «просто працювати», і це досить багато кроків, але вони досить швидкі для налаштування.

Коли Valet перестає працювати

Отже, якщо ви опинитеся в ситуації, коли Valet не працює з WordPress або Homebrew або будь-яким із них, можливо, наступні кроки допоможуть.

1 Видаліть Valet вручну

Згідно з документацією, ми повинні мати можливість запускати:

$ valet uninstall

Щоб повністю видалити програмне забезпечення, але це не працює. Натомість нам потрібно повністю видалити його, видаливши його каталог і пов’язаний двійковий файл.

Якщо ви використовуєте macOS, це можна зробити, видаливши каталог .vendor і двійковий файл valet у /usr/local/bin/valet.

Для цього в терміналі введіть такі команди:

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

Хоча ви не повинні отримувати жодних повідомлень про помилки, можливо, вам доведеться запустити sudo, щоб видалити двійковий файл (але якщо це так, то, ймовірно, його було видалено неправильно встановлено вперше.

2 Використовуйте Homebrew для видалення PHP

Однією з приємних речей Homebrew є те, що він дозволяє нам запускати кілька версій PHP і перемикатися між ними. Це особливо корисно, якщо ви працюєте з різними проектами для широкого використання або спеціалізованих середовищ.

Щоб дізнатися, які версії PHP є у вашій системі, ви можете запустити наступне:

$ brew list

І ви повинні побачити щось на зразок цього:

Далі видаліть такі пакети:

• dnsmasq
• nginx
• php

І якщо у вас є кілька версій PHP, ви захочете видалити всі версії програмного забезпечення. Для цього введіть такі команди:

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

Вам також може знадобитися запустити brew uninstall для кожної версії PHP, якщо у вашій системі запущено декілька версій.

Зауважте, що якщо у вас запущено кілька версій PHP, у вас також можуть виникнути проблеми з видаленням кожної з них.

Якщо це так, то вам потрібно буде примусово видалити (за допомогою команди –force ), або вам може знадобитися рекурсивно видалити певний каталог, який створює звіти. Це потрібно буде зробити для кожної інсталяції PHP.

Після завершення не забудьте запустити очищення.

Далі ви можете продовжити і звернутися до лікаря, щоб перевірити, чи є якісь проблеми, і вирішити їх, якщо вони є. У багатьох випадках ви знайдете непрацюючі символічні посилання, які потім можна видалити, ввівши brew prune.

Якщо ви зробите це та знову запустите brew doctor, то все має виглядати добре:

І ви будете готові приступити до ремонту установки.

3 Перевстановіть Homebrew Packages

Далі встановимо останню версію PHP. Ви, звичайно, можете вибрати будь-яку версію PHP, але це вміст іншої публікації (або ви можете переглянути, що доступно на цій сторінці ).

По- перше, вам може знадобитися торкнутися репозиторію homebrew/php, якщо його ще немає у вашому списку доступних сховищ; однак ви можете перевірити, що у вас є, просто ввівши

$ brew tap

Якщо ви бачите homebrew/php, то все готово.

Отже, давайте оновимо brew:

$ brew update

Потім інсталюйте останню версію PHP, ввівши:

$ brew install homebrew/core/php

На момент написання цієї статті це PHP 7.2.5.

Щоб переконатися, що його встановлено правильно, ви можете ввести, який php у вашому терміналі та /usr/local/bin/php потрібно повернути. Далі, якщо ви запустите php -v, ви побачите версії 7.2.5.

4 Перевстановіть Valet

Тепер настав час перевстановити Valet. Для цього введіть наступну команду у вашому терміналі:

$ composer global require laravel/valet

Далі переконайтеся, що ви виконали таку команду:

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

Це гарантує, що глобальні двійкові файли Composer розташовані у змінних середовища вашої системи та доступні будь-де у вашій системі.

Далі запустіть програму Valet install. Це встановить dnsmasq і nginx, які є компонентами, необхідними для запуску Valet.

5 Перевірте, чи браузер працює належним чином

Перш ніж тестувати браузер, ми хочемо перевірити локальне середовище, щоб переконатися, що веб-сервер працює належним чином. Для цього в терміналі введіть наступне:

$ ping foo.test

Якщо все налаштовано правильно, ви повинні отримати відповідь:

Тепер настав час переконатися, що браузер використовує ту саму версію PHP, яку ми встановили на попередньому кроці. Для цього створіть каталог будь-де у вашій системі, викличте index.php і введіть у файл наступне:

<?php
phpinfo();

Далі перейдіть до каталогу у вашому терміналі – я назвав свій бета -версією – і введіть таку команду у вашому терміналі:

$ valet link && valet secure

Далі завантажте https://beta.test у свій браузер. Якщо все піде добре, ось що ви повинні побачити:

Зауважте, що використовується та сама версія PHP, яку ми встановили раніше.

Навіщо робити це вручну?

На даний момент у вас є повністю робоча інсталяція Valet з останньою версією всіх необхідних пакетів. На жаль, команда видалення не виконує те, що ви очікували, і залишає деякі артефакти.

Ось чому я прихильник видалення всього вручну, виконання оновлення, а потім перевстановлення Valet.

Якщо у вас виникли проблеми під час інсталяції – особливо якщо ви використовуєте BrowserSync, Yarn тощо – то це повинно вирішити ці проблеми (разом із будь-якими іншими, з якими ви можете зіткнутися).