Laravel Framework Russian Community
Введение
Laravel старается сделать восхитительной не только разработку на PHP, но и поднять на уровень выше вашу локальную среду разработки.
Vagrant предоставляет простой и элегантный способ создания и управления виртуальными машинами. Laravel Homestead является официальным «образом» (box) для Vagrant’а, и предоставляет замечательную среду разработки, не требуя устанавливать PHP, веб-сервер и какое бы то ни было дополнительное серверное ПО на вашей локальной машине. Больше не стоит беспокоиться о захламлении вашей операционной системы! Боксы Vagrant’а являются полностью одноразовыми. Если что-то пойдет не так, вы сможете уничтожить и пересоздать бокс за считанные минуты!
Homestead работает под любыми версиями Windows, Mac и Linux, и включает веб-сервер Nginx, PHP 5.6, MySQL, Postgres, Redis, Memcached и другие вкусности, которые могут потребоваться вам для разработки потрясающих Laravel-приложений.
Примечание: Если вы используете Windows, то вам надо разрешить в БИОСе аппаратную виртуализацию (VT-x).
Текущая версия Homestead создана и протестирована для использования под Vagrant 1.6.
Что внутри
- Ubuntu 14.04
- PHP 5.6
- Nginx
- MySQL
- Postgres
- Node (включая Bower, Grunt и Gulp)
- Redis
- Memcached
- Beanstalkd
- Laravel Envoy
- Fabric + HipChat Extension
Установка и настройка
Установка VirtualBox и Vagrant
Перед запуском среды Homestead, вы должны установить VirtualBox и Vagrant. Оба этих программных продукта имеют легкие в использовании установщики для всех популярных операционных систем.
Добавление бокса в Vagrant
Как только VirtualBox и Vagrant будут установлены, вам следует добавить бокс laravel/homestead в Vagrant, используя следующую команду в командной строке. Процесс скачки бокса займет какое-то время, в зависимости от скорости вашего интернет-соединения:
Установка Homestead
При помощи Composer и PHP
На машине должен быть установлен PHP и Composer
После того как бокс Homestead добавлен в Vagrant, при помощи композера установите глобально инструмент Homestead CLI:
Проверьте, чтобы папка
/.composer/vendor/bin ( C:\Users\username\AppData\\Roaming\Сomposer\vendor\bin в случае Windows) находилась у вас в PATH. Для проверки выполните в терминале команду homestead .
После установки инструмента, создайте конфигурационный файл Homestead.yaml :
Файл Homestead.yaml будет создан в папке
/.homestead (или C:\Users\username\.homestead в случае Windows). Если вы используете Mac, Linux, или у вас в Windows стоит cygwin или msysgit (он ставится вместе с git), то вы можете редактировать его при помощи этой команды:
При помощи git
В этом варианте вы можете обойтись без установки PHP на локальную машину, вам понадобится только установленный Git+msysgit.
Склонируйте репозиторий с Homestead CLI в произвольную директорию:
Она создаст файл Homestead.yaml в папке
/.homestead (или C:\Users\username\.homestead в случае Windows)
SSH-ключи
Далее вам нужно отредактировать созданный Homestead.yaml . В этом файле вы можете указать путь к вашему публичному и приватному SSH-ключам, а также сконфигурировать совместно используемые локальной и виртуальной машиной папки.
Ни разу не использовали SSH ключи? Под Mac, Linux или Windows с установленным Git+msysgit вы можете создать пару ключей (приватный id_rsa и публичный id_rsa.pub), используя следующую команду:
В Windows в качестве альтернативы вы можете использовать PuTTYgen.
Укажите путь к публичному ключу в свойстве authorize файла Homestead.yaml , а путь к приватному — в свойстве keys .
Настройте общие папки
В свойстве folders в файле Homestead.yaml перечислены все локальные папки, доступ к которым вы хотите предоставить в среде Homestead. Файлы в этих папках будут синхронизироваться между локальной и виртуальной машиной. Синхронизация будет двусторонней. Настроить можно столько папок, сколько необходимо.
Настройте веб-сервер
Еще не знакомы с Nginx? Никаких проблем. Свойство sites позволяет легко связать домен и папку в среде Homestead. В файле Homestead.yaml имеется пример настройки одного сервера. Опять же, вы можете добавить столько сайтов, сколько вам нужно. Homestead может служить удобной виртуальной средой для нескольких проектов на Laravel.
Если вы хотите, чтобы ваш сайт работал под управлением HHVM, установите параметр hhvm в true :
Алиасы (aliases) Bash
Чтобы добавить произвольный алиас в Homestead, просто укажите его в файле aliases в папке
Запуск Vagrant
После того как вы отредактировали файл Homestead.yaml , выполните в терминале команду vagrant up из каталога с установленным Homestead.
Vagrant запустит виртуальную машину, настроит синхронизацию папок и сконфигурирует веб-сервер Nginx согласно вашему конфигу.
Чтобы уничтожить виртуальную машину, выполните команду vagrant destroy —force .
Не забудьте добавить домены, которые вы будете использовать в Homestead, в файл hosts . Файл hosts будет перенаправлять ваши запросы к локальным доменам в среду Homestead. Под Mac и Linux это /etc/hosts . В Windows — C:\Windows\System32\drivers\etc\hosts . Строки, добавляемые вами в этот файл, будут выглядеть примерно так:
где 192.168.10.10 — это ip-адрес, прописанный в Homestead.yaml
После того, как вы добавите домен в файл hosts , вы получите доступ к сайту, развернутому в Homestead из вашего браузера.
Повседневное использование
Соединение По SSH
Чтобы подсоединиться к виртуальной машине Homestead по SSH, нужно выполнить в терминале команду vagrant ssh из каталога с установленным Homestead.
Вероятно, вам придется часто подключаться к вашей Homestead-машине, поэтому логичным будет создать «alias» на хост-машине:
После этого вы сможете подключаться к вашей Homestead-машине с помощью команды vm из любого каталога.
Коннект к базе данных
В Homestead установлены две СУБД — MySQL и Postgres. И там и там создана база данных homestead . В Laravel, дефолтных конфигах для среды выполнения local , уже указаны параметры для работы с этой базой данных.
Для соединения с СУБД Homestead вам нужно настроить клиент (Navicat, Sequel Pro, HeidiSQL и т.п.) на соединение с ip 127.0.0.1 и портом 33060 (MySQL) или 54320 (Postgres). Логин и пароль одинаковые для этих СУБД — homestead / secret
Примечание: Эти нестандартные порты следует использовать только когда вы устанавливаете соединение из своей основной системы. В файлах конфигурации Laravel следует использовать порты по умолчанию 3306 и 5432, так как Laravel запускается внутри виртуальной машины.
Добавление сайтов
Через некоторое время вам, возможно, потребуется добавить домены новых сайтов в Homestead. Для этого есть два способа.
Во-первых, вы можете просто добавить сайты в файл Homestead.yaml , после чего выполнить vagrant provision .
Или же вы можете воспользоваться скриптом serve , доступным в среде Homestead. Для того, чтобы им воспользоваться, войдите по SSH в среду Homestead и выполните следующую команду:
Замечание: После запуска команды serve не забудьте добавить новый домен в файл hosts в вашей основной системе.
Порты
Список портов, которые перенаправляются из локальной машины в Homestead:
- SSH: 2222 → Перенаправление на порт 22
- HTTP: 8000 → Перенаправление на порт 80
- MySQL: 33060 → Перенаправление на порт 3306
- Postgres: 54320 → Перенаправление на порт 5432
Установка и настройка рабочей среды Homestead для Laravel
Установка и настройка рабочей среды Homestead для Laravel
Homestead — это специально подготовленный разработчиками Laravel образ Ubuntu Linux, включающий в себя все необходимые инструменты для создания приложений на этом замечательном фреймворке. В официальной документации Laravel процесс установки Homestead описан довольно неплохо, но всё же содержит некоторые пробелы. Их я и попытаюсь заполнить в этой статье.
Итак, приступим. Первым делом нужно установить VirtualBox и Vagrant.
Последнюю версию VirtualBox можно скачать на странице https://www.virtualbox.org/wiki/Downloads. При установке можно оставить все настройки по умолчанию.
Установщик Vagrant скачиваем на странице https://www.vagrantup.com/downloads.html. По умолчанию программа устанавливается в корень диска C:\, в папку HashiCorp\Vagrant\. Я предпочитаю изменить этот путь на C:\Program Files (x86)\HashiCorp\Vagrant\. После установки Vagrant потребуется перезагрузить компьютер.
Теперь нужно добавить бокс laravel/homestead в Vagrant. Открываем командную строку Windows от имени администратора (сочетание клавиш Win+R, затем команда cmd в окне Выполнить) и выполняем следующую команду:
В консоли Вы увидите примерно следующее:
Процесс загрузки займёт некоторое время, в зависимости от скорости вашего интернет-соединения.
Устанавливать Homestead будем при помощи Git. Скачать его последнюю версию можно на странице https://git-scm.com/downloads. При установке все настройки можно оставить по умолчанию. Чтобы команда git стала доступна в консоли Windows, также потребуется перезагрузить компьютер.
Теперь нужно клонировать репозиторий Homestead CLI в произвольную директорию, например в вашу домашнюю папку. Для этого запустите консоль Windows от имени администратора и выполните следующую команду:
На экране вы увидите следующее:
При этом в вашем домашнем каталоге будет создана папка Homestead. Перейдите в неё и запустите файл init.bat, он создаст конфигурационный файл Homestead.yaml в папке .homestead в вашей домашней директории.
Теперь создадим SSH-ключи для доступа к нашей виртуальной машине. Для этого нужно открыть терминал Git (например, щёлкнув на экране правой кнопкой мыши и выбрав из контекстного меню пункт Git Bash Here) и выполнить следующую команду:
При запросе пути к каталогу для сохранения файла ключей просто нажмите Enter, при этом будет выбрано значение по умолчанию указанное в скобках (в домашней директории будет создана папка .ssh, в которую будут помещены файлы ключей). Также необходимо будет ввести и подтвердить пароль для ключей.
Чтобы Vagrant использовал именно эти ключи, а не создавал новые файлы ключей при каждом запуске из-за настроек безопасности, нужно добавить следующую строчку в файл Vagrantfile в папке Homestead:
После этого он должен выглядеть примерно так:
Всё почти готово к запуску, осталось совсем немного.
Для начала откроем файл Homestead.yaml (помните, он находится в папке .homestead в нашей домашней директории). Вот его содержимое:
Здесь содержатся настройки виртуальной машины. В принципе, все они вполне работоспособны, нужно лишь внести небольшие изменения в нашу операционную систему. В первую очередь создадим папку Code в нашей домашней директории. Через эту папку мы сможем работать с сайтом, который будет доступен по адресу http://homestead.app. Чтобы получить возможность обращаться к этому сайту из браузера, добавим следующую строку в файл hosts, находящийся в директории C:\Windows\System32\drivers\etc\:
SSH-ключи уже созданы и находятся в нужной директории.
Всё готово к запуску системы. Перейдите в директорию с установленным Homestead, откройте терминал и выполните комнаду vagrant up .
Поздравляю! Мы запустили виртуальную машину Homestead. Проверить её статус можно с помощью команды vagrant status , для остановки виртуальной машины используйте команду vagrant halt .
Открыв страницу http://hometead.app вы увидите следующее:
Это всего лишь означает, что в рабочей директории сайта, определённой в файле Homestead.yaml, пока что нет файлов. Это легко исправить, добавив файлы сайта в папку Code\Laravel\public\ (такая конфигурация очень удобна для установки Laravel: скопировав дистрибутив в папку Laravel мы получаем доступ к папке public через браузер, сами файлы движка при этом остаются недоступными извне).
Осталось настроить доступ к виртуальной машине через SSH.
Скачиваем SSH-клиент PuTTY на странице http://www.chiark.greenend.org.uk/
sgtatham/putty/download.html. Предлагаю скачать ZIP-архив и распаковать его в папку Putty в вашей домашней директории. Запустите файл PUTTY.exe. Подключиться можно со следующими параметрами:
- Логин: vagrant
- Пароль: vagrant
- Адрес сервера: 127.0.0.1
- Порт: 2222
Введите все эти параметры (кроме пароля) в окне PuTTY Configuration и нажмите кнопку Open.
Введите пароль в окне терминала (пароль не отображается при вводе, и может сложиться впечатление, что терминал завис, однако это не так) и нажмите Enter. После этого вы сможете работать с виртуальной машиной через SSH.
Можно автоматизировать процесс подключения, исключив необходимость каждый раз вводить все данные и пароль. Данные для подключения мы сохраним в PuTTY, для подключения будем использовать ранее сгенерированный SSH-ключ.
Проблема в том, что PuTTY использует собственный формат приватных ключей для подключения. К счастью, в его составе есть утилита для конвертации стандартных файлов ключей. Запустите PUTTYGEN.EXE, нажмите кнопку Load и выберите ранее сгенерированный с помощью Git файл приватного ключа id_rsa (для возможности выбора установите режим просмотра на показ всех файлов в выпадающем меню справа от поля Имя файла).
После выбора потребуется ввести пароль, использованный вами при генерации ключа. Файл ключа будет загружен и сконвертирован в формат PuTTY. Очистите поля Key passphrase и Confirm passphrase, чтобы впоследствии подключаться без пароля.
Теперь нажмите кнопку Save private key и сохраните ключ в той же папке под именем id_rsa.ppk, предварительно согласившись на создание ключа без пароля.
Снова откройте PUTTY.EXE. В разделе Session введите настройки подключения, как делали до этого. Затем перейдите в раздел Connection→SSH→Auth, нажмите кнопку Browse и выберите ранее сгенерированный файл приватного ключа.
Вернитесь в раздел Session и сохраните конфигурацию. Для этого в поле Saved Sessions введите произвольное имя конфигурации (например Homestead ) и нажмите кнопку Save.
Для подключения дважды кликните по имени сохранённой конфигурации в списке.
На этом настройку рабочей среды Homestead можно считать завершённой.