Valet

Введение

Valet — среда для разработки в Laravel для минималистов, работающих на Mac. Без Vagrant, без файла /etc/hosts. Можно даже расшаривать сайты в общий доступ через локальные туннели. Да, нам и самим это нравится.

Laravel Valet включает на вашем Mac фоновую автозагрузку Nginx (до версии Valet 2.0 — Caddy ). Затем с помощью DnsMasq Valet настраивает прокси для всех запросов к домену *.dev, для переадресации их на сайты на вашей локальной машине.

Другими словами, это молниеносное окружение для разработки в Laravel, которое использует около 7 Мб RAM. Valet не является полной заменой для Vagrant или Homestead, но предоставляет отличную альтернативу, когда вам нужна база для гибкой настройки, максимальная скорость, или вы работаете на машине с ограниченным объёмом RAM.

Из коробки Valet поддерживает (но не ограничивается только ими):

• Laravel
• Lumen
• Symfony
• Zend
• CakePHP 3
• WordPress
• Bedrock
• Craft
• Statamic
• Jigsaw
• Статический HTML

Также вы можете дополнить Valet своим собственным драйвером.

Valet или Homestead

Как вы знаете, Laravel предлагает Homestead — другую локальную среду разработки. Valet и Homestead отличаются целевой аудиторией и подходом к локальной разработке. Homestead включает в себя целую виртуальную машину с Ubuntu и автоматической настройкой Nginx. Homestead — отличный выбор, если вам нужна полностью виртуальная среда разработки на Linux или на Windows / Linux.

Valet поддерживает только Mac и требует установки PHP и сервера базы данных непосредственно на вашу локальную машину. Это легко делается при помощи Homebrew такими командами: shbrew install php71 и shbrew install mariadb. Valet обеспечивает молниеносную среду разработки с минимальным потреблением ресурсов, поэтому идеально подходит для разработчиков, использующих только PHP / MySQL и не нуждающихся в полностью виртуальной среде разработки.

И Valet, и Homestead являются отличным выбором для настройки среды разработки в Laravel. Выбор зависит от ваших личных предпочтений и потребностей вашей команды.

Установка

Valet требует MacOS и Homebrew. Перед установкой необходимо убедиться, что другие программы, такие как Apache и Nginx, не используют 80 порт вашей локальной машины.

• Установите или обновите Homebrew до последней версии с помощью shbrew update.
• Установите PHP 7.1 с помощью Homebrew командой shbrew install homebrew/php/php71.
• Установите Valet через Composer командой shcomposer global require laravel/valet. Убедитесь, что в вашей системной переменной PATH есть каталог ~/.composer/vendor/bin.
• Выполните команду shvalet install. Она установит и настроит Valet и DnsMasq, и пропишет демон Valet в автозагрузку.

После установки Valet попробуйте выполнить в терминале shping к любому домену *.dev такой командой shping foobar.dev. Если Valet установлен корректно, то вы увидите, что этот домен соответствует 127.0.0.1.

Valet автоматически запускает своего демона при запуске ОС. После начальной установки Valet больше не потребуется выполнять shvalet start или shvalet install.

Использование другого домена

По умолчанию Valet использует для ваших проектов домен верхнего уровня .dev. Если вы хотите использовать другой домен, используйте команду shvalet domain tld-name.

Например, чтобы использовать .app вместо .dev, выполните shvalet domain app, и Valet автоматически начнёт использовать новый домен.

База данных

Если вам нужна база данных, попробуйте MariaDB с помощью команды shbrew install mariadb. После установки MariaDB, вы можете запустить её командой shbrew services start mariadb. Затем вы можете подключиться к БД на 127.0.0.1, имя пользователя — root, пароль — пустая строка.

shvalet stop
valet uninstall

shcomposer global require laravel/valet

shvalet install
valet restart

Обслуживание сайтов

После установки Valet можно начать обслуживать сайты. Valet предоставляет две команды для помощи в обслуживании Laravel-сайтов: shpark и shlink.

Команда shpark

• Создайте новый каталог на своём Mac с помощью команды shmkdir ~/Sites. Затем перейдите к ней shcd ~/Sites и выполните shvalet park. Эта команда зарегистрирует текущий каталог как путь, по которому Valet будет искать сайты.
• Теперь создайте новый Laravel-сайт в этом каталоге: shlaravel new blog.
• Откройте http://blog.dev в своём браузере.

Вот и всё. Теперь все проекты, которые вы разместите в каталоге «парковки», будут обслуживаться автоматически с адресами в соответствии с названиями их папок http://folder-name.dev.

Команда shlink

Для обслуживания Laravel-сайтов также можно использовать команду shlink. Эта команда полезна, когда вы хотите обслуживать один сайт в каталоге, а не весь каталог.

• Для использования команды перейдите к одному из своих проектов и выполните shvalet link app-name в терминале. Valet создаст в ~/.valet/Sites символьную ссылку на ваш текущий каталог.
• После запуска команды shlink вы можете перейти на сайт http://app-name.dev в своём браузере.

Для просмотра списка всех привязанных каталогов выполните команду shvalet links. Для удаления символьной ссылки используйте shvalet unlink app-name.

Защита сайтов с помощью TLS

По умолчанию Valet обслуживает сайты через чистый HTTP. Но при желании вы можете включить шифрование TLS, используя HTTP/2, с помощью команды shsecure. Например, если Valet обслуживает ваш сайт на домене laravel.dev, то для его защиты вам надо выполнить команду:

shvalet secure laravel

Чтобы отключить защиту и перевести трафик обратно на чистый HTTP, используйте команду shunsecure. Как и команда secure эта команда принимает имя хоста, для которого необходимо отключить защиту:

shvalet unsecure laravel

Открытие общего доступа к сайтам

Valet имеет команду для открытия доступа к вашим локальным сайтам для всех. Кроме Valet не нужно никакое ПО.

Для открытия доступа к сайту перейдите в терминале в его каталог и выполните команду shvalet share. URL для общего доступа будет помещён в буфер обмена, и его можно вставить в браузер. Это всё.

Для закрытия общего доступа нажмите Control + C для отмены процесса.

Пользовательские драйверы Valet

Вы можете написать свой собственный «драйвер» Valet для обслуживания PHP-приложений, работающих на другом фреймворке или CMS, изначально не поддерживаемых Valet. При установке Valet создаётся папка ~/.valet/Drivers, содержащая файл SampleValetDriver.php. В этом файле находится пример реализации драйвера для демонстрации. Для написания драйвера необходимо реализовать всего три метода: PHPserves(), PHPisStaticFile() и PHPfrontControllerPath().

Все три метода принимают в качестве аргументов PHP$sitePath, PHP$siteName и PHP$uri. Параметр PHP$sitePath — полный путь к сайту на вашей машине, например, /Users/Lisa/Sites/my-project. Параметр PHP$siteName — часть домена «хост» / «имя сайта» (my-project). Параметр PHP$uri — URI входящих запросов (/foo/bar).

Когда вы завершили написание своего драйвера Valet, поместите его в каталог ~/.valet/Drivers используя принцип именования FrameworkValetDriver.php. Например, если вы написали драйвер для WordPress, то имя файла должно быть WordPressValetDriver.php.

Давайте рассмотрим примеры реализации каждого из этих методов.

Метод PHPserves()

Метод PHPserves() должен возвращать PHPtrue, если ваш драйвер должен обрабатывать входящие запросы. Иначе метод должен возвращать PHPfalse. В этом методе вы должны попытаться определить, содержит ли данный PHP$sitePath проект того типа, который вы хотите обслуживать.

Например, давайте предположим, что мы пишем WordPressValetDriver. Наш метод PHPserves() должен выглядеть примерно так:

/**
 * Определение, обслуживает ли драйвер запрос.
 *
 * @param  string  $sitePath
 * @param  string  $siteName
 * @param  string  $uri
 * @return bool
 */
public function serves($sitePath, $siteName, $uri)
{
  return is_dir($sitePath.'/wp-admin');
}

Метод PHPisStaticFile()

Метод PHPisStaticFile() должен определять, является ли входящий запрос запросом к «статическому» файлу, такому как изображение или таблица стилей. Если файл статический, метод должен вернуть полный путь к этому файлу на диске. Если входящий запрос не к статическому файлу, метод должен вернуть PHPfalse:

/**
 * Определение, является ли входящий запрос запросом к статическому файлу.
 *
 * @param  string  $sitePath
 * @param  string  $siteName
 * @param  string  $uri
 * @return string|false
 */
public function isStaticFile($sitePath, $siteName, $uri)
{
  if (file_exists($staticFilePath = $sitePath.'/public/'.$uri)) {
    return $staticFilePath;
  }

  return false;
}

Метод PHPisStaticFile() будет вызван, только если метод PHPserves() возвращает PHPtrue для входящего запроса, и значение URI запроса не равно /.

Метод PHPfrontControllerPath()

Метод PHPfrontControllerPath() должен вернуть полный путь к «первичному контроллеру» вашего приложения, которым обычно является ваш файл index.php или его эквивалент:

/**
 * Получение полного пути к первичному контроллеру приложения.
 *
 * @param  string  $sitePath
 * @param  string  $siteName
 * @param  string  $uri
 * @return string
 */
public function frontControllerPath($sitePath, $siteName, $uri)
{
  return $sitePath.'/public/index.php';
}

Другие команды Valet