Работаем на MacOS с Valet Plus

Привет, друзья!

Многие знают, что я всегда был против локальной разработки, и предпочитал использовать виртуальную машину с настоящим GNU/Linux, где всё работает точно так же, как и на хостинге. Никаких XAMPP, WAMP и прочих Denwer.

Но недавно меня познакомили с Valet Plus, и как-то очень уж он мне понравился. Внимание, Valet работает только на MacOS, поэтому дальше стоит читать исключительно обладателям этой ОС.

Итак, Valet Plus, это улучшенная версия обычного Laravel Valet, которым я ни разу не пользовался. Смысл в том, что вам на компьютер устанавливаются PHP, Nginx, DnsMasq и MySQL, а потом постоянно работают в фоне. И когда вы добавляете новый сайт, он просто сразу начинает работать по адресу типа new-project.test. Не нужно править /etc/hosts и колдовать с настройками Nginx, всё работает само.

И самое важное, что работает точно так же, как и на хостинге, потому что MacOS — это Unix-совместимая система, очень похожая на GNU/Linux и FreeBSD, которые крутят 99% всех shared-хостингов. И вы устанавливаете нормальные версии сервисов для неё, а не какие-то специально приготовленные.

Чем же отличается Valet Plus от обычного? Смотрим официальную документацию:

• Возможность переключать версию PHP
• Возможность использовать Xdebug
• Дополнительные модули PHP (mcrypt, intl, opcache)
• Работа с MySQL
• Поддержка Redis, Elasticsearch, GeoIP, Mailhog

Очень круто, жаль только что взять это всё и установить без проблем у меня ни разу не вышло, всегда какие-то заморочки. Именно поэтому я и пишу этот гайд.

Установка Brew

Итак, я всё проделываю на чистой свежей MacOS Catalina, установленной в Parallels Desktop.

Первым делом ставим Homebrew, там всё просто:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install.sh)"

Открыли терминал, скопировали, вставили, нажали Enter, подождали. Если спросят пароль — укажите, он понадобится для установки Xcode Command Line Tools, если их еще нет.



Через несколько минут у вас появляется настоящий пакетный менеджер, как в Debian и других GNU/Linux-based системах.

Дальше всё ставится так же в консоли через команду brew. Я советую потренироваться на полезных утилитах для начала:

brew install htop wget mc

Как вы догадались, теперь у вас есть htop (монитор процессов), wget (закачка файлов) и mc (двухпанельный менеджер).



Кстати, в качестве самого терминала я искренне советую вам бесплатный iTerm2.

Установка Valet Plus

Homebrew — менеджер пакетов, но скачивает он не уже собранные приложения, а их исходники и скрипты сборки, как это в BSD принято (там это называется «собрать из портов», то есть ports). Понятное дело, что источники этих скриптов можно добавлять командой brew tap.

Воспользуемся этим и установим PHP 7.4 из специального репозитория Valet:

brew tap henkrehorst/php
brew install valet-php@7.4

Если PHP не ставится с руганью на icu4c, то нужно установить его вот так:

brew install --build-from-source valet-php@7.4

php -v показывает нам версию 7.3, а это значит, что импользуется родной PHP из дистрибутива MacOS. Нужно это исправить:

brew link valet-php@7.4 --force

После этого перезапускам терминал и проверяем версию PHP. У меня она стала PHP 7.4.5.



Теперь устанавливаем composer

brew install composer

Ну и дальше уже можно поставить сам Valet Plus в пользовательскую директорию:

composer global require weprovide/valet-plus

И добавляем путь к нему в переменные окружения ZSH:

echo 'export PATH="$PATH:$HOME/.composer/vendor/bin"' >> ~/.zshrc

или Bash, если вы еще не перешли на новый коммандный интерпритатор:

echo 'export PATH="$PATH:$HOME/.composer/vendor/bin"' >> ~/.bash_profile

После чего обновляем переменные в терминале

source ~/.zshrc

Дальше набираем

valet install

Обратите внимание, что официальная документация рекомендует перед этим запустить valet fix — не делайте этого. Лично у меня этот fix приносит одни проблемы, потому что зачем-то меняет версию PHP на 7.2 и не может установить для него php-apcu.

Так что запускаем сразу install и всё должно пройти как по маслу. Если кто предпочитает MariaDB вместо MySQL, то нужно указать это так:

valet install --with-mariadb

Лично я использую обычную MySQL.



После этого, по идее, всё должно работать — и вы можете это проверить путём отправки ping на локальный адрес:

ping -c4 mysite.test

Но в реальности, как правило, веб-сервер не работает — это видно потому, что не открывается встроенный сайт mailhog.test, который ловит отправляемую локальную почту. Будем исправлять.

Исправление ошибок и запуск

Первым делом смотрим ситуацию по запущенным сервисам:

brew services list

У меня такой ответ:

Name          Status  User Plist
dnsmasq       started root     /Library/LaunchDaemons/homebrew.mxcl.dnsmasq.plist
mailhog       started bezumkin /Users/bezumkin/Library/LaunchAgents/homebrew.mxcl.mailhog.plist
mysql@5.7     started bezumkin /Users/bezumkin/Library/LaunchAgents/homebrew.mxcl.mysql@5.7.plist
nginx         started root     /Library/LaunchDaemons/homebrew.mxcl.nginx.plist
redis         started bezumkin /Users/bezumkin/Library/LaunchAgents/homebrew.mxcl.redis.plist
valet-php@7.4 started root     /Library/LaunchDaemons/homebrew.mxcl.valet-php@7.4.plist

Несмотря на то, что Nginx указан как started, цвет у статуса жёлтый, значит brew в этом вовсе не уверен.



И правда, Nginx у нас не работает, и причину можно увидеть, если проверить его конфигурацию командой sudo nginx -t:

nginx: [emerg] open() "/usr/local/etc/nginx/valet/elasticsearch.conf" failed (2: No such file or directory) in /usr/local/etc/nginx/nginx.conf:44
nginx: configuration file /usr/local/etc/nginx/nginx.conf test failed

То есть, в Nginx указано, что должен быть конфиг ElasticSearch, а его нет. Видимо потому, что никто его не устанавливал.

Комментируем этот конфиг в конце файла настроек:

nano /usr/local/etc/nginx/nginx.conf

и перезапускаем Nginx

valet restart nginx

Урраааа, Mailhog открывается!

На этом исправление работы в моём случае окончено. На других компьютерах видел подобные проблемы с конфигом GeoIP из-за того, что он как-то криво установился. Было такое, что не запускался DnsMasq из-за неверных прав на директорию логов.

У меня система чистая, так что ошибка всего одна. Ну а вы вручную проверяйте запуск всех сервисов и читайте их логи.

Установка MODX

Пробуем установить первый сайт. Создаём директорию для проектов и качаем MODX:

mkdir ~/Sites && cd ~/Sites
wget https://modx.com/download/latest -O modx.zip
unzip modx.zip
mv modx-2.7.3-pl modx
cd modx

Вот и wget пригодился. Скачали, распаковали, переименовали, зашли внутрь.



Дальше превращаем эту директорию modx в сайт:

valet link modx

Ответ: Current working directory linked to modx.test.

Пытаемся зайти по этому адресу, и о чудо!, он открывается! Добавляем к адресу /setup/ и устанавливаем движок.



Логин и пароль MySQL — root. На локальной машине мы можем не заморачиваться с отдельными юзерами под каждый сайт, и вообще с безопасностью.



MODX установлен и работает. Осталось настроить всякие вкусняшки, ради чего, собственно, вся эта локальная разработка и затевалась.

Установка дополнений

Первым делом устанавливаем Xdebug:

pecl install xdebug

Еще я советую установить ImageMagick для работы с картинками:

brew install imagemagick
brew insatll pkg-config
pecl install imagick

Сначала ставим саму библиотеку, затем нужную либу для сборки PHP обёртки, а потом и её саму через Pecl.



После установки обновок, как обычно, перезапускаем PHP:

valet restart php

Вообще, принцип установки дополнений следующий:
1. Ищем что нужно в Homebrew brew search имя
2. Если чего-то нет, а это запросто, ищем в pecl search имя
3. Если нет и там — ищем уже в поисковике

Я пока что всё, что мне нужно, нахожу и устанавливаю без проблем. Обычно через Pecl.

Работа с PhpStorm

Ну вот и финал нашего путешествия — открываем наш MODX сайт в PhpStorm.



Первым делом идём в настройки, там Languages & Frameworks -> PHP. Добавляем наш PHP интерпретатор по адресу /usr/local/bin/php:



Затем идём чуть ниже в Debug и отключаем там оба пункта Break at first line when ...


Иначе нас будут дёргать каждый раз на запуск файла server.php в директории Valet, а нам это совсем не интересно.

Теперь нужно установить браузерное расширение для запуска отладки, и мой Safari тут уже не поддерживается. Да и вообще для разработки не под iOS его использовать бесполезно.
Так что я ставлю Firefox и добавляю Xdebug Helper. Ему в настройках нужно включить PhpStorm и теперь можно использовать жука в панели адреса.



Дальше выставляем в index.php точку остановки, включаем телефонную трубку в правом верхем углу PhpStorm (слушать входящие подключения), перезагружаем страничку в браузере, видим запрос на подключение — соглашаемся…



И происходит невероятное! Выполнение нашего скрипта остановлено именно в указанной точке, мы можем посмотреть все объявленные переменные, их содержимое, походить по соседним методам, понаставить еще точек — и продолжить или остановить отладку. Браузер при этом нас ждет и скрипт не выполняется дальше.



Ну и кто тут теперь главный, а, PHP? С этого момента никаких print_r и var_dump — мы видим всё в коде сайта через Xdebug.

Заключение

Наигравшись с Xdebug посмотрим теперь, что еще можно сделать с Valet Plus. Для этого набираем просто

valet

И видим, что можно работать с базами данных из консоли: создавать, удалять, открывать (если скачаете бесплатный SequelPro), читать логи, менять версии PHP и еще много-много всякого.

valet db create test
valet db drop test

ну и всё в таком духе — очень удобно.

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

wget https://files.phpmyadmin.net/phpMyAdmin/4.9.5/phpMyAdmin-4.9.5-english.zip -O ~/Sites/pma.zip
cd ~/Sites && unzip pma.zip
mv phpMyAdmin-4.9.5-english pma && cd pma
mv config.sample.inc.php config.inc.php
valet link pma
valet open pma

Открываем pma.test, там логин и пароль — root

Дальше, конечно, можно поднастроить его конфиг, но принцип вы поняли — создание сойтов становится очень простым делом.

Так что желаю вам всем отличного настроения с локальной разработкой через Valet Plus.