⛵ Laravel Sail — установка на Windows 10

Laravel Sail — это легкий интерфейс командной строки для взаимодействия со стандартной средой разработки Laravel — Docker. Sail — это отличная отправная точка для создания приложения Laravel с использованием PHP, MySQL и Redis, не требующая предварительного опыта работы с Docker.

В основе Sail лежит файл docker-compose.yml и скрипт sail, который хранится в корне вашего проекта. Сценарий sail предоставляет CLI с удобными методами для взаимодействия с контейнерами Docker, определенными в файле docker-compose.yml.

Laravel Sail поддерживается на macOS, Linux и Windows (через WSL2).

Установите Docker Desktop

https://docs.docker.com/desktop/install/windows-install/

После завершения установки перейдите в каталог пользователя windows (C:UsersYOURUSER) и создайте файл .wslconfig со следующим содержимым:

[wsl2]
memory=2GB # Limits VM memory in WSL 2 
processors=4 # Makes the WSL 2 VM use 4 virtual processors
localhostForwarding=true # Boolean specifying if ports bound to wildcard or localhost in the WSL 2 VM should be connectable from the host via localhost:port.
swap=8GB
Вход в полноэкранный режим Выйти из полноэкранного режима

После этого шага вам нужно будет перезагрузить компьютер.

Конфигурация WSL2

Установите дистрибутив Ubuntu и установите его по умолчанию с помощью Windows PowerShell.

# Check list of available distributions
wsl --list --verbose

wsl --set-default-version 2

# Install Ubuntu-20.04 distribution
# Don't forget to add a user with password on this step
wsl --install -d "Ubuntu-20.04"

# Set distribution as default
wsl -s Ubuntu-20.04

# Start distribution
wsl -d Ubuntu-20.04
Войти в полноэкранный режим Выйдите из полноэкранного режима

Затем выполните команду wsl --list --verbose в конце, и дистрибутив Ubuntu должен выглядеть следующим образом:

Теперь убедитесь, что настройки Docker Desktop выглядят следующим образом:

Установите PHP в дистрибутив Ubuntu 20.04.

В Windows Power Shell выполните команду wsl, чтобы начать новую сессию Ubuntu. После этого запустите терминал Ubuntu:

sudo apt update
sudo add-apt-repository -y ppa:ondrej/php
sudo apt install -y php8.1-common php8.1-cli
sudo apt install -y php8.1-curl php8.1-gd php8.1-mbstring php8.1-xml php8.1-zip
php --version
Войти в полноэкранный режим Выйти из полноэкранного режима

Composer 2 также должен быть установлен. Проверьте версию, выполнив команду composer -V . Если он не установлен, следуйте этому руководству по установке: https://www.digitalocean.com/community/tutorials/how-to-install-composer-on-ubuntu-20-04-quickstart.

Заключение

Теперь вы должны быть в состоянии запустить проект laravel с помощью sail.

Добавление Sail в проект

Перейдите в корневой каталог проекта и запустите его:

composer require laravel/sail --dev
php artisan sail:install

# Start docker container
./vendor/bin/sail up
Войти в полноэкранный режим Выйти из полноэкранного режима

Запуск контейнера в проекте с уже инициализированным Sail (Existing docker-compose.yml):

# Start docker container
./vendor/bin/sail up
Войти в полноэкранный режим Выйти из полноэкранного режима

Иногда запуск контейнера может завершиться неудачно, и это связано с проблемами с правами доступа, поэтому будьте внимательны к тому, где размещать файлы проекта, и дайте им соответствующие права. (или запустите его с префиксом sudo)

📋 Похожие статьи

Руководство по установке Laravel Sail

https://laravel.com/docs/9.x/installation#getting-started-on-windows

Руководство по использованию Laravel Sail

https://laravel.com/docs/9.x/sail#introduction

Оцените статью
devanswers.ru
Добавить комментарий