Установка

• Знакомство с Laravel
  • Почему Laravel?
• Создание проекта Laravel
• Начальная настройка
  • Настройка в зависимости от окружения
  • Базы данных и миграции
  • Настройка директорий
• Установка через Docker с использованием Sail
  • Sail на macOS
  • Sail на Windows
  • Sail на Linux
  • Выбор сервисов Sail
• Поддержка IDE
• Laravel и ИИ
  • Установка Laravel Boost
• Следующие шаги
  • Laravel как full-stack фреймворк
  • Laravel как API-бэкенд

#Знакомство с Laravel

Laravel — это фреймворк для веб-приложений с выразительным и элегантным синтаксисом. Веб-фреймворк предоставляет структуру и отправную точку для создания вашего приложения, позволяя сосредоточиться на создании чего-то удивительного, пока мы заботимся о деталях.

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

Независимо от того, новичок ли вы в PHP-фреймворках или имеете многолетний опыт, Laravel — это фреймворк, который будет расти вместе с вами. Мы поможем вам сделать первые шаги в веб-разработке или дадим импульс для повышения вашего уровня. Нам не терпится увидеть, что вы создадите.

#Почему Laravel?

Существует множество инструментов и фреймворков для создания веб-приложений. Однако мы считаем, что Laravel — лучший выбор для создания современных full-stack веб-приложений.

#Прогрессивный фреймворк

Мы называем Laravel «прогрессивным» фреймворком. Это значит, что Laravel растёт вместе с вами. Если вы только начинаете путь в веб-разработке, обширная библиотека документации, руководств и видеоуроков поможет вам освоиться без перегрузки.

Если вы опытный разработчик, Laravel предоставляет мощные инструменты для инъекции зависимостей, модульного тестирования, очередей, событий в реальном времени и многое другое. Laravel оптимизирован для создания профессиональных веб-приложений и готов к работе с нагрузками корпоративного уровня.

#Масштабируемый фреймворк

Laravel обладает высокой масштабируемостью. Благодаря масштабируемой природе PHP и встроенной поддержке быстрых распределённых кеш-систем, таких как Redis, горизонтальное масштабирование с Laravel — простая задача. На самом деле, приложения на Laravel успешно масштабировались для обработки сотен миллионов запросов в месяц.

Нужна экстремальная масштабируемость? Платформы вроде Laravel Vapor позволяют запускать ваше приложение Laravel практически без ограничений, используя новейшие безсерверные технологии AWS.

#Фреймворк с поддержкой сообщества

Laravel объединяет лучшие пакеты PHP-экосистемы, предлагая самый мощный и удобный для разработчиков фреймворк. Кроме того, тысячи талантливых разработчиков со всего мира внесли вклад в развитие фреймворка. Кто знает, возможно, вы тоже станете участником сообщества Laravel.

#Создание проекта Laravel

Перед созданием первого проекта Laravel убедитесь, что на вашем компьютере установлены PHP и Composer. Если вы разрабатываете на macOS, PHP и Composer можно установить за несколько минут с помощью Laravel Herd. Также рекомендуем установить Node и NPM.

После установки PHP и Composer вы можете создать новый проект Laravel с помощью команды Composer create-project:

composer create-project "laravel/laravel:^10.0" example-app

Или вы можете создавать новые проекты Laravel, установив глобально установщик Laravel через Composer:

composer global require laravel/installer

laravel new example-app

После создания проекта запустите локальный сервер разработки Laravel с помощью команды Artisan serve:

cd example-app

php artisan serve

После запуска сервера разработки Artisan ваше приложение будет доступно в браузере по адресу http://localhost:8000. Далее вы можете продолжить изучение экосистемы Laravel. Конечно, вы также можете настроить базу данных.

#Начальная настройка

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

Laravel практически не требует дополнительной настройки из коробки. Вы можете сразу приступать к разработке! Тем не менее, рекомендуется ознакомиться с файлом config/app.php и его документацией. В нём содержатся параметры, такие как timezone и locale, которые вы можете изменить под нужды вашего приложения.

#Настройка в зависимости от окружения

Поскольку многие параметры конфигурации Laravel могут отличаться в зависимости от того, работает ли приложение на локальной машине или на продакшн-сервере, важные значения конфигурации задаются в файле .env, который находится в корне приложения.

Файл .env не должен попадать в систему контроля версий, так как у каждого разработчика или сервера могут быть свои настройки окружения. Кроме того, это создаёт риск безопасности, если злоумышленник получит доступ к репозиторию, так как в файле могут содержаться конфиденциальные данные.

#Базы данных и миграции

Теперь, когда вы создали приложение Laravel, скорее всего, захотите хранить данные в базе. По умолчанию в файле .env указано, что Laravel будет работать с базой MySQL, доступной по адресу 127.0.0.1.

Если вы не хотите устанавливать MySQL или Postgres на локальной машине, всегда можно использовать базу данных SQLite. SQLite — это компактный, быстрый и автономный движок базы данных. Чтобы начать, обновите файл .env, указав драйвер базы данных sqlite. Остальные параметры базы можно удалить:

DB_CONNECTION=sqlite
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=laravel
DB_USERNAME=root
DB_PASSWORD=

После настройки SQLite вы можете выполнить миграции базы данных, которые создадут таблицы для вашего приложения:

php artisan migrate

Если база SQLite ещё не существует, Laravel предложит создать её. Обычно файл базы SQLite создаётся по пути database/database.sqlite.

#Настройка директорий

Laravel всегда должен обслуживаться из корня «веб-директории», настроенной для вашего веб-сервера. Не рекомендуется запускать Laravel из поддиректории «веб-директории», так как это может привести к раскрытию конфиденциальных файлов приложения.

#Установка через Docker с использованием Sail

Мы хотим сделать начало работы с Laravel максимально простым вне зависимости от вашей операционной системы. Поэтому существует несколько вариантов разработки и запуска проекта Laravel на локальной машине. Хотя вы можете изучить их позже, Laravel предлагает Sail — встроенное решение для запуска проекта Laravel с помощью Docker.

Docker — это инструмент для запуска приложений и сервисов в лёгких «контейнерах», которые не влияют на установленное ПО и настройки вашей локальной машины. Это значит, что вам не нужно настраивать сложные инструменты разработки, такие как веб-серверы и базы данных, локально. Для начала достаточно установить Docker Desktop.

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

#Sail на macOS

Если вы разрабатываете на Mac и у вас уже установлен Docker Desktop, вы можете создать новый проект Laravel простой командой в терминале. Например, чтобы создать приложение Laravel в директории с именем "example-app", выполните в терминале следующую команду:

curl -s "https://laravel.build/example-app" | bash

Конечно, вы можете заменить "example-app" на любое другое имя — главное, чтобы оно содержало только буквы, цифры, дефисы и подчёркивания. Директория приложения Laravel будет создана в той папке, из которой вы запускаете команду.

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

После создания проекта перейдите в директорию приложения и запустите Laravel Sail. Sail предоставляет простой интерфейс командной строки для работы с дефолтной Docker-конфигурацией Laravel:

cd example-app

./vendor/bin/sail up

После запуска Docker-контейнеров приложения вы сможете открыть приложение в браузере по адресу: http://localhost.

#Sail на Windows

Перед созданием нового приложения Laravel на Windows убедитесь, что установлен Docker Desktop. Затем убедитесь, что Windows Subsystem for Linux 2 (WSL2) установлен и включён. WSL позволяет запускать Linux-бинарники нативно в Windows 10. Инструкции по установке и включению WSL2 доступны в документации Microsoft для разработчиков.

Далее вы готовы создать первый проект Laravel. Запустите Windows Terminal и откройте новую сессию терминала для вашей Linux-системы WSL2. Затем выполните простую команду для создания проекта Laravel. Например, чтобы создать приложение в директории "example-app", выполните в терминале следующую команду:

curl -s https://laravel.build/example-app | bash

Конечно, вы можете заменить "example-app" на любое другое имя — главное, чтобы оно содержало только буквы, цифры, дефисы и подчёркивания. Директория приложения Laravel будет создана в той папке, из которой вы запускаете команду.

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

После создания проекта перейдите в директорию приложения и запустите Laravel Sail. Sail предоставляет простой интерфейс командной строки для работы с дефолтной Docker-конфигурацией Laravel:

cd example-app

./vendor/bin/sail up

После запуска Docker-контейнеров приложения вы сможете открыть приложение в браузере по адресу: http://localhost.

#Разработка внутри WSL2

Конечно, вам нужно будет редактировать файлы приложения Laravel, созданные внутри WSL2. Для этого мы рекомендуем использовать редактор Microsoft Visual Studio Code и официальный плагин для удалённой разработки.

После установки этих инструментов вы можете открыть любой проект Laravel, выполнив команду code . из корня приложения в Windows Terminal.

#Sail на Linux

Если вы разрабатываете на Linux и у вас уже установлен Docker Compose, вы можете создать новый проект Laravel простой командой в терминале.

Сначала, если вы используете Docker Desktop для Linux, выполните следующую команду. Если нет — этот шаг можно пропустить:

docker context use default

Затем, чтобы создать приложение Laravel в директории "example-app", выполните в терминале следующую команду:

curl -s https://laravel.build/example-app | bash

Конечно, вы можете заменить "example-app" на любое другое имя — главное, чтобы оно содержало только буквы, цифры, дефисы и подчёркивания. Директория приложения Laravel будет создана в той папке, из которой вы запускаете команду.

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

После создания проекта перейдите в директорию приложения и запустите Laravel Sail. Sail предоставляет простой интерфейс командной строки для работы с дефолтной Docker-конфигурацией Laravel:

cd example-app

./vendor/bin/sail up

После запуска Docker-контейнеров приложения вы сможете открыть приложение в браузере по адресу: http://localhost.

#Выбор сервисов Sail

При создании нового приложения Laravel через Sail вы можете использовать параметр with в строке запроса, чтобы выбрать, какие сервисы будут настроены в файле docker-compose.yml вашего приложения. Доступные сервисы: mysql, pgsql, mariadb, redis, memcached, meilisearch, typesense, minio, selenium и mailpit:

curl -s "https://laravel.build/example-app?with=mysql,redis" | bash

Если вы не укажете, какие сервисы хотите настроить, будет использован набор по умолчанию: mysql, redis, meilisearch, mailpit и selenium.

Вы можете указать Sail установить дефолтный Devcontainer, добавив параметр devcontainer в URL:

curl -s "https://laravel.build/example-app?with=mysql,redis&devcontainer" | bash

#Поддержка IDE

Вы можете использовать любой редактор кода для разработки приложений Laravel; однако PhpStorm предлагает расширенную поддержку Laravel и его экосистемы, включая Laravel Pint.

Кроме того, поддерживаемый сообществом плагин Laravel Idea для PhpStorm предоставляет множество полезных функций, включая генерацию кода, автодополнение синтаксиса Eloquent, автодополнение правил валидации и многое другое.

#Laravel и ИИ

Laravel Boost — мощный инструмент, который соединяет ИИ-агентов с приложениями Laravel. Boost предоставляет ИИ-агентам контекст, инструменты и рекомендации, специфичные для Laravel, чтобы они могли генерировать более точный, версионно-специфичный код, соответствующий конвенциям Laravel.

При установке Boost в ваше приложение Laravel ИИ-агенты получают доступ к более чем 15 специализированным инструментам, включая возможность узнавать, какие пакеты вы используете, выполнять запросы к базе данных, искать в документации Laravel, читать логи браузера, генерировать тесты и выполнять код через Tinker.

Кроме того, Boost предоставляет ИИ-агентам доступ к более чем 17 000 векторизованных документов экосистемы Laravel, специфичных для версий установленных пакетов. Это позволяет агентам давать рекомендации, ориентированные на точные версии вашего проекта.

Boost также включает поддерживаемые Laravel рекомендации для ИИ, которые направляют агентов следовать конвенциям фреймворка, писать корректные тесты и избегать распространённых ошибок при генерации кода Laravel.

#Установка Laravel Boost

Boost можно установить в приложениях Laravel 10, 11 и 12, работающих на PHP 8.1 и выше. Для начала установите Boost как зависимость для разработки:

composer require laravel/boost --dev

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

php artisan boost:install

Установщик автоматически определит вашу IDE и ИИ-агентов, позволяя выбрать функции, которые подходят для вашего проекта. Boost уважает существующие конвенции проекта и по умолчанию не навязывает строгие правила стиля.

#Следующие шаги

Теперь, когда вы создали проект Laravel, возможно, задаётесь вопросом, что изучать дальше. Сначала мы настоятельно рекомендуем ознакомиться с тем, как работает Laravel, прочитав следующую документацию:

То, как вы планируете использовать Laravel, также определит ваши следующие шаги. Существует несколько способов применения Laravel, и ниже мы рассмотрим два основных варианта.

#Laravel как full-stack фреймворк

Laravel может использоваться как full-stack фреймворк. Под full-stack мы понимаем, что вы будете использовать Laravel для маршрутизации запросов к вашему приложению и рендеринга фронтенда через Blade шаблоны или гибридные SPA-технологии, такие как Inertia. Это самый распространённый способ использования Laravel и, на наш взгляд, самый продуктивный.

Если вы планируете использовать Laravel таким образом, рекомендуем ознакомиться с документацией по фронтенд-разработке, маршрутизации, представлениям и Eloquent ORM. Также может быть интересно изучить популярные пакеты сообщества, такие как Livewire и Inertia. Эти пакеты позволяют использовать Laravel как full-stack фреймворк, сохраняя преимущества UI, характерные для одностраничных JavaScript-приложений.

Если вы используете Laravel как full-stack фреймворк, мы также настоятельно рекомендуем изучить, как компилировать CSS и JavaScript вашего приложения с помощью Vite.

#Laravel как API-бэкенд

Laravel также может служить API-бэкендом для одностраничного JavaScript-приложения или мобильного приложения. Например, вы можете использовать Laravel как API-бэкенд для вашего приложения на Next.js. В этом случае Laravel обеспечивает аутентификацию и хранение/получение данных, а также предоставляет мощные сервисы, такие как очереди, электронная почта, уведомления и многое другое.

Если вы планируете использовать Laravel таким образом, рекомендуем ознакомиться с документацией по маршрутизации, Laravel Sanctum и Eloquent ORM.