Homestead + PHP Storm

Статистика: Символов — 3 055/2 593 без пробелов (2 784/2 363 без кода):, слов — 422
Разметка: Markdown
Как заставить работать PHP Storm + homestead на Mac OS? Так как я достаточно долго провозился с этой проблемой, попробую расписать все шаги подробно.

Для того, что бы PHP Storm мог работать в консоле вашей виртуальной машины, достаточно нажать Tools->Vagrant->Up, но при установке homestead, такой вариант не срабатывает, т.к. по умолчанию Vagrant не знает где лежит конфигурационный файл homestead.

Решение данной проблемы: 
```
cp ~/composer/vendor/laravel/homestead/scripts ~/.homestead
cp ~/composer/vendor/laravel/homestead/Vagrantfile ~/.homestead
```
Затем идем Preferences->Tools->Vagrant:
Vagrant executable: vagrant
Instance folder: /Users/{username}/.homestead

Теперь нам будет доступно Tools->Vagrant->Up
Теперь можно и подключиться к консоле по ssh  Tools->Start->ssh session (конфигурацию он фозбмет из папки .homestead)
Если вдруг настройки не подцепились, можно попробовать ввести данные вручную 
host: localhost
login: vagrant 
passwotd: vagrant

Еще из полезного можно рассмотреть вариант когда вам нужно развернуть на одной виртуальной машине несколько  проектов:
Заходим в файл .homestead/Homestead.yaml
и добавляем следующий код к sites:
```
sites:
//То что стояло по умолчанию
    - map: homestead.app
      to: /home/vagrant/Code/Laravel/public  
//Ваш новый домен
    - map: homestead2.app
      to: /home/vagrant/Code/Laravel2/public
```
Дале если homestead уже был установлен выполняем команды: 
   *homestead destroy*
   *homestead up*

далее не забываем в прописать в файле /private/etc/hosts
*192.168.10.10 homestead.app*
*192.168.10.10 homestead2.app*

Теперь можем перейти к настройке xDebug
Сперва нужно настроить Рабочее окружение 

1. Preferences->Languages & Frameworks ->PHP: 
    PHP language lavel: выбираем тот что у вас в homestead у меня это PHP 5.6
    Interpreter: ... Добавляем Remote ->  выбираем vagrant, устанавливаем директорию /User/{username}/.homestead 

2. Устанавливаем  [Xdebug helper](href="https://chrome.google.com/webstore/detail/xdebug-helper/eadndfjplgieldjbigjakmdgkmoaaaoc")
Переводим его в режим disabled

3. Запускаем Run>Start Listening for PHP Debug Connections. И ставим breakpoint на роуте главной страницы

4. Обновляем страницу homestead.app

5. Вас перенесет в окно PHP Storm для установки удаленного сервера, установите корневую категорию Laravel

6. Передите в Preferences->Languages & Frameworks ->PHP->Servers у вас появится homestead.app

7. Нажимаем на Validate remote environment -> Затем добавляем Deployment server:
  Тут в 2 действия 1 вкладка Connection:
   * *sftp host: 127.0.0.1*
   * *port: 2222*
   * *Root path: /home/vagrant/Code/Laravel*
   * *username: vagrant*
   * *password: vagrant*

  Mappings:
   * *Local path: /Users/{username}/Code/Laravel*
   * *Deployment path on server: public*
   * *Web path: /*

8. Уже можно попробовать перейти по навигации Debugbar, но вы можете увидеть предупреждение:
**Remote file path is not mapped**

Нажмите на Click to set up path mappings:

- В открывшемся окне Resolve Path Mapping Problem, убедитесь что стоит галочка Use path mapping
- Далее осталось выставить  соответствие между File/Directory (Папка вашего проекта на локальной машине) и Absolute path on the server ( Папка на виртуальной машине vagrant) это у нас /home/vagrant/Code/Laravel

Все, теперь окружение настроено и готово к работе.