Когда Valet перестает работать должным образом, что мы делаем?

Мне нравится использовать как Homebrew, так и Valet, когда дело доходит до установки и настройки базовой среды разработки WordPress. Хотя использование менеджеров пакетов и простого программного обеспечения для подобных целей должно упростить задачу, это не избавляет нас от случайных проблем.

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

К сожалению, это не всегда так просто, как хотелось бы. Технически мы должны иметь возможность удалить Valet и обновить его через Composer. Но лично я столкнулся с некоторыми проблемами, из-за которых пришлось:

• вручную удалить Valet,
• используйте Homebrew, чтобы удалить PHP и полностью очистить то, что осталось,
• переустановить пакеты Homebrew,
• установить Валет,
• убедитесь, что в браузере используется та же версия PHP, что и при установке 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
• нгинкс
• php

И если у вас есть несколько версий PHP, вы захотите удалить все версии программного обеспечения. Для этого введите следующие команды:

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

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

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

Если это так, вам потребуется принудительное удаление (с помощью команды –force) или вам может потребоваться рекурсивное удаление данного каталога, о котором сообщает brew. Это нужно будет сделать для каждой из установок PHP.

После этого не забудьте запустить cleanup.

Затем вы можете пойти дальше и вызвать врача, чтобы узнать, есть ли какие-либо проблемы, и решить их, если они есть. Во многих случаях вы найдете неработающие символические ссылки, которые затем можно удалить, набрав brew prune.

Если вы сделаете это и снова запустите brew doctor, то все должно выглядеть хорошо:

И вы будете готовы приступить к ремонту установки.

3 Переустановите пакеты Homebrew

Далее давайте установим самую последнюю версию 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. Для этого введите в терминале следующую команду:

$ 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 и т.п., это должно решить эти проблемы (наряду с любыми другими, с которыми вы можете столкнуться).