Установка Laravel 8.x на Win10

Введение

Laravel - самый популярный PHP MVC-фреймворк с открытым исходным кодом, созданный Тейлором Отвеллом. Текущая версия Laravel - 8.x. Возможно, вы являетесь поклонником XAMPP для своей Windows-машины. Однако в процессе разработки вы иногда можете услышать отговорку «работает на моей машине».

Homestead - это официальный пакет Laravel, который поможет вам разрешить этот ужасный момент, используя возможности виртуальной машины и скрипта автоматизации Vagrant. Итак, все ваши товарищи по команде всегда будут в одной среде!

Убедитесь, что в вашей Windows установлено следующее программное обеспечение:

• Git (скачать Link)
• VirtualBox (скачать Platform & Extension Pack)
• Vagrant (скачать Link)
• PuTTY (скачать Link)
• HeidiSQL (скачать Link)
• VS Code (скачать Link)

1. Git

Как правило, просто следуйте указаниям мастера установки (примите параметры по умолчанию) и завершите установку.

Для новичков рекомендуется редактор Nano. Вы можете заметить, что Git не упоминается на диаграмме выше, но это важное программное обеспечение, лежащее в основе ваших ежедневных процедур разработки.

1.1 Создайте свой SSH-ключ

Примечание. Пропустите этот шаг, если вы создали пару ключей SSH ранее. Используйте алгоритм RSA для лучшей совместимости между различными системами, выполните эту команду:

ssh-keygen -t rsa -b 4096 -C “your_email@example.com” 

Настоятельно рекомендуется использовать кодовую фразу, но не забывайте ее.

.ssh папка создается с публичными и приватными ключами, расположенными внутри

1.2 IDE и утилиты

Установите VS Code, PuTTY, HeidiSQL, SourceTree и все ваши любимые инструменты разработки.

2. VirtualBox

Установите основную платформу с параметрами по умолчанию, а затем добавьте расширение.

Установить через меню File Menu > Preferences > Extensions

3. Vagrant

Установите и следуйте указаниям мастера установки, а затем перезапустите после завершения установки.

введите vagrant в командной строке, после чего вы должны увидеть результат.

3.1 Vagrant NFS plugin

Установите подключаемый модуль NFS для повышения производительности сопоставленной папки.

vagrant plugin install vagrant-winnfsd 

Без NFS вы можете столкнуться с проблемой сопоставленной папки при установке пакетов композера.

https://www.virtualbox.org/ticket/18776 

В качестве альтернативы вы можете перейти на VirtualBox 6.0.4, как это предлагается в stackoverflow.

4. Установка Homestead

Всегда обращайтесь к последней официальной документации. Запустите Git Bash из начального меню, затем выполните команду

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

Затем проверьте ветку release

cd ~/Homestead git checkout release 

4.1 Скачать Homestead vagrant box

Выполните команду в командной строке Windows.

vagrant box add laravel/homestead 

• Выберите 2 для VirtualBox.
• Извлеките содержимое в C:\Users\<username>\.vagrant.d\boxes
• Затем проверьте с помощью команды: vagrant box list

Убедитесь, что поле Homestead загружено.

4.2 Настройка Homestead

Дважды щелкните и запустите init.bat в папке Homestead.

Отредактируйте Homestead.yaml в своем любимом редакторе

Вы должны создать свою общую папку, которая будет сопоставлена с виртуальной машиной.

e.g. C:\Users\john\code 

Примечание: заключите строку в кавычки, если она содержит пробелы или специальные символы.

Примечание: строчные буквы всегда рекомендуются для лучшей совместимости в среде Linux и Windows.

Часть IV: Nginx, MySQL и настройки функций

Убедитесь, что для функции mysql установлено значение true, и сохраните файл Homestead.yaml. Отредактируйте файл hosts, чтобы он соответствовал вашему локальному домену.

Запустите блокнот с правами администратора и откройте файл.

C: \ Windows \ System32 \ drivers \ etc \ hosts. 

Убедитесь, что IP-адрес и локальный домен соответствуют вашему файлу Homestead.yaml.

5. Загрузите свой Homestead

Измените каталог cd на каталог Homestead, например

cd C:\Users\<username>\Homestead 

Выполнить vagrant up в командной строке.

Примечание: вы должны выполнить команду vagrant up в каталоге Vagrantfile.

первая загрузка занимает некоторое время, пожалуйста, подождите ...

Примечание: если вы столкнулись с ошибкой VERR_INTNET_FLT_IF_NOT_FOUND, перейдите к отключению диспетчера устройств, а затем включите адаптеры VirtualBox.

6. Подключите Homestead через SSH

Подключитесь к своей усадьбе с вашим IP-адресом или локальным доменным именем. Вы можете подключиться через имя пользователя (vagrant) и пароль (vagrant). Как вариант, вы можете подключиться через SSH-ключ.

Вам необходимо преобразовать свой SSH-ключ в формат PuTTY с помощью PuTTYgen.

1. Откройте PuTTYgen из меню Пуск.
2. Из меню программы, Conversions > Import key.
3. Выберите закрытый ключ (он должен находиться в C: \ Users \ <username> \ .ssh \ id_rsa)
4. Нажмите «Save private key».
5. Сохраните его с помощью id_rsa.ppk (НЕ ПЕРЕЗАПИСЫВАЙТЕ существующий закрытый ключ!)

7. Подключите MySQL через SSH Tunnel

1. Откройте HeidiSQL> Нажмите New, чтобы создать новую сессию.
2. Нажмите вкладку SSH tunnel
3. Подключитесь, используя имя пользователя (vagrant) и пароль (vagrant) или ваш закрытый ключ.

4. Щелкните вкладку «Настройки» для учетных данных MySQL (или MariaDB). Подключиться, используя имя пользователя (homestead) и пароль (homestead)
5. Переименуйте сеанс, щелкнув правой кнопкой мыши session > Rename.
6. Наконец, нажмите «Save».

Нажмите Open, и вы сможете подключить MySQL к виртуальной машине Homestead.

Ваша база данных, настроенная в Homestead.yaml, создана.

8. Установка Laravel 8.x

Войдите в систему через PuTTY и перейдите в папку своего проекта с помощью cd code

Вариант 1. Установка через Composer

composer create-project laravel/laravel sample 

Вариант 2: установка с помощью установщика Laravel (рекомендуется)

composer global update laravel/installer laravel new sample 

Совет: если вы редактируете свой Homestead.yaml, вы можете запустить vagrant Provision для применения ваших новых конфигураций.

*Совет: если вы столкнулись с какой-либо проблемой производительности, вы можете попробовать перезапустить виртуальную машину Homestead, запустив vagrant reload. После завершения установки, cd sample а затем запустить php artisan --version

8.1 Обновите свой .env перед разработкой

Обновите конфигурацию базы данных в файле .env в корне вашего проекта.

9. Удачного кодинга

Git зафиксирует вашу новую установку, откройте папку проекта с помощью VSCode / PhpStorm и начните свое путешествие в Artisan!

Введите свой локальный домен, после чего вы должны увидеть страницу приветствия Laravel.

Совет: перед выключением Windows не забудьте запустить vagrant halt.

Ссылки

Install Laravel 8.x on Win10 with Homestead