
Введение
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
.
- Откройте
PuTTYgen
из менюПуск
. - Из меню программы,
Conversions > Import key
. - Выберите закрытый ключ (он должен находиться в
C: \ Users \ <username> \ .ssh \ id_rsa
) - Нажмите «Save private key».
- Сохраните его с помощью
id_rsa.ppk
(НЕ ПЕРЕЗАПИСЫВАЙТЕ существующий закрытый ключ!)
7. Подключите MySQL через SSH Tunnel
- Откройте
HeidiSQL>
НажмитеNew
, чтобы создать новую сессию. - Нажмите вкладку
SSH tunnel
- Подключитесь, используя имя пользователя (
vagrant
) и пароль (vagrant
) или ваш закрытый ключ.
- Щелкните вкладку «Настройки» для учетных данных MySQL (или MariaDB).
Подключиться, используя имя пользователя (
homestead
) и пароль (homestead
) - Переименуйте сеанс, щелкнув правой кнопкой мыши
session > Rename
. - Наконец, нажмите «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
.