Homestead

Введение

Laravel стремится преобразить процесс разработки на PHP, это относится и к локальной среде разработки. Vagrant обеспечивает простой, элегантный способ настройки и управления виртуальными машинами.

Laravel Homestead — официальная предустановленная Vagrant-"коробка", которая предоставляет вам замечательную среду разработки без необходимости установки PHP, веб-сервера и любого другого серверного программного обеспечения на ваш компьютер. Можно больше не беспокоиться о том, что ваша операционная система засоряется! Vagrant-коробки очень удобны. Если что-то пошло не так, вы можете уничтожить и пересоздать коробку в считанные минуты!

Homestead запускается на ОС Windows, Mac и Linux, и включает в себя веб-сервер Nginx, PHP 7.1, MySQL, Postgres, Redis, Memcached, Node и все другие полезные штуки, которые вам понадобятся для разработки удивительных Laravel-приложений.

Если вы используете Windows, возможно, вам необходимо включить аппаратную виртуализацию (VT-x). Она обычно включается через BIOS. Если вы используете Hyper-V на UEFI-системе, вам может понадобиться отключить Hyper-V, для доступа к VT-x.

Включённое ПО

• Ubuntu 16.04
• Git (в 5.1+)
• PHP 7.1
• HHVM (только в 5.2 и ранее)
• Nginx
• MySQL
• MariaDB (в 5.1+)
• Sqlite3 (в 5.1+)
• Postgres
• Composer (в 5.1+)
• Node (с Yarn (в 5.3+), PM2, Bower, Grunt и Gulp)
• Redis
• Memcached
• Beanstalkd
• Laravel Envoy (в 5.0)
• Профайлер Blackfire (в 5.0)

Установка и настройка

Первые шаги

Прежде чем запустить Homestead-среду, вы должны установить VirtualBox 5.1,
VMWare или Parallels (с версии Laravel 5.3), а также Vagrant. Эти программные пакеты предоставляют простые в использовании визуальные инсталляторы для всех популярных операционных систем.

Для использования VMWare вам необходимо приобрести и VMware Fusion/Workstation, и плагин VMware Vagrant. Хотя он и платный, зато VMware изначально обеспечивает большую скорость работы общих папок.

Для использования провайдера Parallels вам необходимо установить плагин Parallels Vagrant. Он бесплатный.

Установка Vagrant-коробки Homestead
После установки VirtualBox/VMware и Vagrant вы должны добавить коробку laravel/homestead в установленный пакет Vagrant, используя следующую команду в вашем терминале. Скачивание коробки может занять несколько минут:

shvagrant box add laravel/homestead

Если выполнение команды завершится неудачно, проверьте, что у вас установлена свежая версия Vagrant.

Установка Homestead

Вы можете установить Homestead, просто клонировав репозиторий. Клонируйте репозиторий в папку Homestead в тот каталог, где вы храните все свои проекты Laravel, потому что коробка Homestead станет хостом всех ваших Laravel-проектов:

shcd ~

git clone https://github.com/laravel/homestead.git Homestead

После клонирования репозитория Homestead выполните в этой папке команду shbash init.sh, чтобы создать конфигурационный файл Homestead.yaml. Этот файл будет помещён в скрытый каталог ~/.homestead:

sh// Mac / Linux...
bash init.sh

// Windows...
init.bat

Настройка Homestead

Настройка провайдера

Параметр provider в файле ~/.homestead/Homestead.yaml указывает на то, какой провайдер должен использоваться: virtualbox, vmware_fusion (Mac OS X) или vmware_workstation (Windows) или parallels. Вы можете задать тот, который предпочитаете:

confprovider: virtualbox

Настройка общих папок

В параметре folders в файле Homestead.yaml перечислены все папки, которые вы хотите расшарить для вашей среды Homestead. Поскольку файлы в этих папках будут меняться, они будут синхронизироваться с вашей локальной машиной и средой Homestead. Вы можете настроить столько папок, сколько вам необходимо:

conffolders:
  - map: ~/Code
    to: /home/vagrant/Code

Для включения NFS просто добавьте простой ключ к вашей синхронизируемой папке:

conffolders:
  - map: ~/Code
    to: /home/vagrant/Code
    type: "nfs"

Также вы можете передавать параметры, поддерживаемые синхронизируемыми папками Vagrant, указывая их под ключом options:

conffolders:
  - map: ~/Code
    to: /home/vagrant/Code
    type: "rsync"
    options:
      rsync__args: ["--verbose", "--archive", "--delete", "-zz"]
      rsync__exclude: ["node_modules"]

Настройка сайтов Nginx

Не знакомы с Nginx? Не проблема. Параметр sites позволяет легко связать «домен» с папкой в среде Homestead. Типовая конфигурация сайта включена в файл Homestead.yaml. И снова вы можете добавить столько сайтов к своей среде Homestead, сколько необходимо. Homestead может служить удобной виртуальной средой для каждого проекта Laravel, над которым вы работаете:

confsites:
  - map: homestead.app
    to: /home/vagrant/Code/Laravel/public

confsites:
  - map: homestead.app
    to: /home/vagrant/Code/Laravel/public
    hhvm: true

Если вы измените параметр sites после подключения Homestead-коробки, вам будет необходимо перезапустить shvagrant reload --provision, чтобы обновить конфигурацию Nginx на виртуальной машине.

Файл Hosts

Вы должны добавить «домены» для своих Nginx-сайтов в файл hosts на вашей машине. Файл hosts перенаправит запросы к вашим сайтам в вашу машину Homestead. На Mac и Linux этот файл расположен в /etc/hosts. На Windows он расположен в C:\Windows\System32\drivers\etc\hosts. Строки, которые вы добавляете в этот файл, будут выглядеть примерно так:

conf192.168.10.10  homestead.app

Удостоверьтесь, что IP-адрес тот же, что вы установили в своём файле ~/.homestead/Homestead.yaml. Когда вы добавите домен в свой файл hosts и запустите Vagrant-коробку, вы можете получить доступ к сайту через свой веб-браузер:

http://homestead.app

Запуск Vagrant Box

Когда вы отредактировали Homestead.yaml, выполните команду shvagrant up в папке Homestead. Vagrant загрузит виртуальную машину и настроит ваши общие папки и сайты Nginx автоматически.

Чтобы уничтожить машину, вы можете использовать команду shvagrant destroy --force.

Чтобы узнать, как подключиться к своей базе данных, читайте дальше!

Установка для проекта

Вместо глобальной установки Homestead и использования одной Homestead-коробки для всех ваших проектов, вы можете настроить отдельный экземпляр Homestead для каждого проекта. Установка Homestead для проекта может быть выгоднее, когда вы хотите поставлять файл Vagrantfile вместе с вашим проектом, позволяя тем, кто работает над проектом, просто выполнять shvagrant up.

Чтобы установить Homestead непосредственно в ваш проект, затребуйте его с помощью Composer:

shcomposer require laravel/homestead --dev

Когда Homestead установлен, используйте команду shmake для создания Vagrantfile и файла Homestead.yaml в корне вашего проекта. Команда shmake автоматически настроит директивы sites и folders в файле Homestead.yaml.

Mac/Linux:

shphp vendor/bin/homestead make

Windows:

shvendor\\bin\\homestead make

Затем выполните команду shvagrant up в терминале и зайдите в свой проект http://homestead.app через браузер. Не забывайте, что вам по-прежнему необходимо добавить строку для homestead.app (или выбранного вами домена) в файл /etc/hosts.

Установка MariaDB

Если вы решили использовать MariaDB вместо MySQL, вы можете добавить параметр mariadb в ваш файл Homestead.yaml. Этот параметр удалит MySQL и установит MariaDB. MariaDB является полноценной заменой для MySQL, поэтому вы должны использовать тот же драйвер БД mysql в настройках базы данных приложения:

confbox: laravel/homestead
ip: "192.168.20.20"
memory: 2048
cpus: 4
provider: virtualbox
mariadb: true

Повседневное использование

Глобальный доступ к Homestead

Иногда вам может понадобиться выполнить shvagrant up вашей Homestead-машины из любого места вашей файловой системы.

conffunction homestead() {
  ( cd ~/Homestead && vagrant $* )
}

confalias homestead='function __homestead() { (cd ~/Homestead && vagrant $*); unset -f __homestead; }; __homestead'

shalias vm="ssh vagrant@127.0.0.1 -p 2222"

shssh-keygen -t rsa -C "you@homestead"

Подключение через SSH

Для подключения к своей виртуальной машине по SSH вы можете использовать команду shvagrant ssh из вашего каталога Homestead.

Но поскольку вам, скорее всего, потребуется часто подключаться к вашей Homestead-машине по SSH, будет удобно создать «функцию» (для версии 5.1 и ранее «псевдоним») на вашей хост-машине для быстрого подключения, как описано выше.

Подключение к базам данных

База homestead изначально настроена на использование и MySQL, и Postgres. Для ещё большего удобства файл Laravel .env настроен на использование этой БД по умолчанию.

Чтобы подключиться к вашей базе данных MySQL или Postgres через клиент БД с вашей хост-машины, вы должны подключиться к 127.0.0.1 через порт 33060 (MySQL) или 54320 (Postgres). Имя пользователя и пароль для обеих баз данных — homestead / secret.

Вы должны использовать эти нестандартные порты, только подключаясь к базам данных с вашей главной машины. Вы будете использовать порты 3306 и 5432 в вашем конфигурационном файле базы данных Laravel, так как Laravel запущен на виртуальной машине.

Добавление дополнительных сайтов

После настройки и запуска вашей среды Homestead вы можете захотеть добавить дополнительные Nginx-сайты для своих Laravel-приложений. Вы можете запустить в одной среде Homestead столько установок Laravel, сколько захотите. Вы можете просто добавить сайты в свой файл ~/.homestead/Homestead.yaml и затем выполнить shvagrant reload --provision (для версии 5.2 и ранее shvagrant provision)) из папки Homestead.

shserve domain.app /home/vagrant/Code/path/to/public/directory 80

Настройка расписания Cron

Laravel предоставляет удобный способ для планирования Cron-задач путём планирования единственной Artisan-команды shschedule:run на ежеминутное выполнение. Команда shschedule:run проверит запланированные задачи, определённые в классе App\Console\Kernel, и определит, какие задачи необходимо выполнить.

Если вы хотите выполнить команду shschedule:run для сайта Homestead, вы можете задать значение true для параметра schedule при определении сайта:

confsites:
  - map: homestead.app
    to: /home/vagrant/Code/Laravel/public
    schedule: true

Cron-задача для сайта будет определена в папке /etc/cron.d на виртуальной машине.

Порты

По умолчанию следующие порты переадресованы в вашу среду Homestead:

• SSH: 2222 → переадресован в 22
• HTTP: 8000 → переадресован в 80
• HTTPS: 44300 → переадресован в 443
• MySQL: 33060 → переадресован в 3306
• Postgres: 54320 → переадресован в 5432

Добавление дополнительных портов

Если хотите, вы можете переадресовать дополнительные порты в Vagrant-коробку, а также указать их протокол:

confports:
  - send: 93000
    to: 9300
  - send: 7777
    to: 777
    protocol: udp

Сетевые интерфейсы

Свойство networks в файле Homestead.yaml настраивает сетевые интерфейсы для вашей среды Homestead. Вы можете настроить сколько угодно интерфейсов:

confnetworks:
  - type: "private_network"
    ip: "192.168.10.20"

Для включения сетевого моста задайте параметр bridge и измените тип сети на public_network:

confnetworks:
  - type: "public_network"
    ip: "192.168.10.20"
    bridge: "en1: Wi-Fi (AirPort)"

Для включения DHCP просто удалите параметр ip из конфигурации:

confnetworks:
  - type: "public_network"
    bridge: "en1: Wi-Fi (AirPort)"

shvagrant box update

shcomposer update

confversion: 0.6.0

confbox: laravel/homestead
version: 0.6.0
ip: "192.168.20.20"
memory: 2048
cpus: 4
provider: virtualbox

confblackfire:
  - id: your-server-id
    token: your-server-token
    client-id: your-client-id
    client-token: your-client-token