Встановлення — Laravel

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

Laravel прагне забезпечити чудовий досвід розробника, водночас надаючи потужні можливості: ретельне впровадження залежностей (dependency injection), виразний рівень абстракції бази даних, черги й заплановані завдання (jobs), модульне та інтеграційне тестування тощо.

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

Чому Laravel?

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

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

Нам подобається називати Laravel «прогресивним» фреймворком. Під цим ми маємо на увазі, що Laravel росте разом із вами. Якщо ви робите лише перші кроки у веброзробці, велика бібліотека документації, посібників і відеоуроків Laravel допоможе вам опанувати основи, не перевантажуючи вас.

Якщо ви senior-розробник, Laravel дає вам надійні інструменти для впровадження залежностей, модульного тестування, черг, подій у реальному часі тощо. Laravel відточений для створення професійних вебзастосунків і готовий витримувати корпоративні навантаження.

Масштабований фреймворк

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

Потрібне екстремальне масштабування? Платформи на кшталт Laravel Cloud дозволяють запускати ваш застосунок на Laravel практично з необмеженим масштабом.

Фреймворк, готовий до агентів

Продумані домовленості Laravel і чітко визначена структура роблять його ідеальним фреймворком для розробки з допомогою ШІ за допомогою інструментів на кшталт Cursor і Claude Code. Коли ви просите ШІ-агента додати контролер, він точно знає, куди його покласти. Коли вам потрібна нова міграція, домовленості про іменування та розташування файлів передбачувані. Ця узгодженість усуває здогадки, на яких часто спотикаються ШІ-інструменти у більш гнучких фреймворках.

Окрім організації файлів, виразний синтаксис Laravel і вичерпна документація дають ШІ-агентам контекст, потрібний для генерації точного, ідіоматичного коду. Такі можливості, як звʼязки Eloquent, form request і middleware, дотримуються шаблонів, які агенти можуть надійно розуміти й відтворювати. Результат — згенерований ШІ код, який виглядає так, наче його написав досвідчений Laravel-розробник, а не зшитий із загальних PHP-фрагментів.

Щоб дізнатися більше про те, чому Laravel — ідеальний вибір для розробки з допомогою ШІ, перегляньте нашу документацію про агентну розробку.

Фреймворк спільноти

Laravel поєднує найкращі пакети екосистеми PHP, щоб запропонувати найнадійніший і найдружніший до розробника фреймворк із доступних. Крім того, тисячі талановитих розробників з усього світу зробили внесок у фреймворк. Хтозна, можливо, ви теж станете контрибутором Laravel.

Створення застосунку на Laravel

Початок роботи з допомогою ШІ

Якщо ви користуєтеся ШІ-агентом для кодування, як-от Claude Code чи OpenCode, ви можете почати з промпту, який дає агенту специфічний для Laravel план дій ще до того, як він торкнеться вашого проєкту.

Наведений нижче промпт повідомляє агенту, де знайти настанови зі встановлення Laravel, на що звертати увагу в першу чергу та як обирати розумні значення за замовчуванням, коли ви ще не зробили вибір. Вставте це у свого агента, щоб почати:

I'm building a new Laravel application.

Fetch and follow the instructions from https://laravel.com/for/agents. Treat the returned Markdown as the source of truth for how to install and set up Laravel in this session.

Після того як агент прочитає інструкції, він має вести вас крок за кроком і тримати налаштування узгодженим зі значеннями за замовчуванням Laravel.

Встановлення PHP і інсталятора Laravel

Перш ніж створювати свій перший застосунок на Laravel, переконайтеся, що на вашій локальній машині встановлено PHP, Composer і інсталятор Laravel. Крім того, вам слід встановити Node і NPM або Bun, щоб мати змогу компілювати фронтенд-ресурси вашого застосунку.

Якщо PHP і Composer не встановлені на вашій локальній машині, наведені нижче команди встановлять PHP, Composer та інсталятор Laravel на macOS, Windows або Linux:

/bin/bash -c "$(curl -fsSL https://php.new/install/mac/8.5)"

# Запускати від імені адміністратора...
Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; iex ((New-Object System.Net.WebClient).DownloadString('https://php.new/install/windows/8.5'))

/bin/bash -c "$(curl -fsSL https://php.new/install/linux/8.5)"

Після виконання однієї з наведених вище команд вам слід перезапустити сеанс термінала. Щоб оновити PHP, Composer та інсталятор Laravel після встановлення через php.new, ви можете повторно виконати команду у своєму терміналі.

Якщо PHP і Composer у вас уже встановлені, ви можете встановити інсталятор Laravel через Composer:

composer global require laravel/installer

Примітка Щоб отримати повнофункціональний графічний досвід встановлення PHP і керування ним, перегляньте Laravel Herd.

Створення застосунку

Після встановлення PHP, Composer та інсталятора Laravel ви готові створити новий застосунок на Laravel:

laravel new example-app

Щойно застосунок створено, ви можете запустити локальний сервер розробки Laravel, обробник черги й сервер розробки Vite за допомогою Composer-скрипта dev:

cd example-app
npm install && npm run build
composer run dev

Після запуску сервера розробки ви можете відкрити свій застосунок у вебпереглядачі за адресою http://localhost:8000. Далі ви готові зробити наступні кроки в екосистемі Laravel. Звісно, ви також можете захотіти налаштувати базу даних і виконати необхідні міграції.

Примітка Якщо ви хочете отримати фору під час розробки свого застосунку на Laravel, розгляньте використання одного з наших стартових наборів. Стартові набори Laravel надають бекенд- і фронтенд-каркас автентифікації для вашого нового застосунку на Laravel.

Початкове налаштування

Усі конфігураційні файли фреймворку Laravel зберігаються в теці config. Кожна опція задокументована, тож не соромтеся переглянути файли й ознайомитися з доступними вам опціями.

Laravel «з коробки» майже не потребує додаткового налаштування. Ви можете вільно починати розробку! Однак ви можете переглянути файл config/app.php і його документацію. Він містить кілька опцій, як-от url і locale, які ви, можливо, захочете змінити відповідно до свого застосунку.

Налаштування на основі оточення

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

Ваш файл .env не слід комітити в систему контролю версій застосунку, оскільки кожному розробнику / серверу, що використовує ваш застосунок, може знадобитися інша конфігурація оточення. Ба більше, це було б ризиком для безпеки в разі, якщо зловмисник отримає доступ до вашого репозиторію системи контролю версій, оскільки будь-які чутливі облікові дані були б розкриті.

Примітка Докладніше про файл .env і налаштування на основі оточення читайте в повній документації з конфігурації.

Бази даних і міграції

Тепер, коли ви створили свій застосунок на Laravel, ви, ймовірно, захочете зберігати якісь дані в базі даних. За замовчуванням конфігураційний файл .env вашого застосунку вказує, що Laravel взаємодітиме з базою даних SQLite.

Під час створення застосунку Laravel створив для вас файл database/database.sqlite і виконав необхідні міграції для створення таблиць бази даних застосунку.

Якщо ви віддаєте перевагу іншому драйверу бази даних, як-от MySQL або PostgreSQL, ви можете оновити свій конфігураційний файл .env, щоб використовувати відповідну базу даних. Наприклад, якщо ви хочете використовувати MySQL, оновіть змінні DB_* у своєму файлі .env так:

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

Якщо ви обираєте базу даних, відмінну від SQLite, вам потрібно буде створити базу даних і виконати міграції бази даних вашого застосунку:

php artisan migrate

Примітка Якщо ви розробляєте на macOS або Windows і вам потрібно встановити MySQL, PostgreSQL або Redis локально, розгляньте використання Herd Pro або DBngin.

Налаштування теки

Laravel завжди слід віддавати з кореня «вебтеки», налаштованої для вашого вебсервера. Не варто намагатися віддавати застосунок на Laravel із підтеки «вебтеки». Спроба зробити це може розкрити чутливі файли, наявні у вашому застосунку.

Встановлення за допомогою Herd

Laravel Herd — це блискавично швидке нативне середовище розробки для Laravel і PHP для macOS та Windows. Herd містить усе, що потрібно для початку розробки на Laravel, зокрема PHP і Nginx.

Щойно ви встановите Herd, ви готові починати розробку з Laravel. Herd містить інструменти командного рядка для php, composer, laravel, expose, node, npm і nvm.

Примітка Herd Pro доповнює Herd додатковими потужними можливостями, як-от здатність створювати локальні бази даних MySQL, Postgres і Redis та керувати ними, а також локальний перегляд пошти й моніторинг логів.

Herd на macOS

Якщо ви розробляєте на macOS, ви можете завантажити інсталятор Herd із сайту Herd. Інсталятор автоматично завантажує найновішу версію PHP і налаштовує ваш Mac так, щоб Nginx завжди працював у фоні.

Herd для macOS використовує dnsmasq для підтримки «припаркованих» (parked) тек. Будь-який застосунок на Laravel у припаркованій теці автоматично віддаватиметься Herd. За замовчуванням Herd створює припарковану теку в ~/Herd, і ви можете звертатися до будь-якого застосунку на Laravel у цій теці на домені .test, використовуючи назву його теки.

Після встановлення Herd найшвидший спосіб створити новий застосунок на Laravel — використати Laravel CLI, який постачається разом із Herd:

cd ~/Herd
laravel new my-app
cd my-app
herd open

Звісно, ви завжди можете керувати своїми припаркованими теками та іншими налаштуваннями PHP через інтерфейс Herd, який можна відкрити з меню Herd у системному треї.

Дізнатися більше про Herd можна з документації Herd.

Herd на Windows

Ви можете завантажити інсталятор Herd для Windows на сайті Herd. Після завершення встановлення ви можете запустити Herd, щоб завершити процес онбордингу й уперше відкрити інтерфейс Herd.

Інтерфейс Herd доступний по кліку лівою кнопкою миші на іконці Herd у системному треї. Клік правою кнопкою відкриває швидке меню з доступом до всіх інструментів, потрібних вам щодня.

Під час встановлення Herd створює «припарковану» теку у вашій домашній теці за шляхом %USERPROFILE%\Herd. Будь-який застосунок на Laravel у припаркованій теці автоматично віддаватиметься Herd, і ви можете звертатися до будь-якого застосунку на Laravel у цій теці на домені .test, використовуючи назву його теки.

Після встановлення Herd найшвидший спосіб створити новий застосунок на Laravel — використати Laravel CLI, який постачається разом із Herd. Щоб почати, відкрийте Powershell і виконайте такі команди:

cd ~\Herd
laravel new my-app
cd my-app
herd open

Дізнатися більше про Herd можна з документації Herd для Windows.

Підтримка IDE

Ви вільні використовувати будь-який редактор коду під час розробки застосунків на Laravel. Laravel LSP забезпечує підтримку редактора з розумінням фреймворку, зокрема автодоповнення коду, інформацію при наведенні, діагностику, посилання в документі, перехід до визначення та швидкі виправлення для коду Laravel і Blade.

Щоб встановити Laravel LSP, встановіть його глобально через Composer. Переконайтеся, що глобальна тека vendor bin Composer є у вашому PATH:

composer global require laravel/lsp

Якщо ви шукаєте легкі та розширювані редактори, VS Code або Cursor у поєднанні з офіційним розширенням Laravel для VS Code забезпечують підсвічування синтаксису, сніпети, інтеграцію з командами Artisan і автоматичну підтримку Laravel LSP. Офіційні розширення Laravel також доступні для Sublime Text і Zed. Інструкції з налаштування для інших редакторів, сумісних із мовними серверами, зокрема Neovim і OpenCode, дивіться в репозиторії Laravel LSP.

Щоб отримати широку й надійну підтримку Laravel, погляньте на PhpStorm, IDE від JetBrains. Вбудована підтримка фреймворку Laravel у PhpStorm охоплює шаблони Blade, розумне автодоповнення для моделей Eloquent, маршрутів, представлень (views), перекладів і компонентів, а також потужну генерацію коду й навігацію по проєктах на Laravel.

Для тих, хто шукає хмарний досвід розробки, Firebase Studio надає миттєвий доступ до розробки з Laravel просто у вашому браузері. Не потребуючи жодного налаштування, Firebase Studio дозволяє легко почати створювати застосунки на Laravel з будь-якого пристрою.

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 і 13, що працюють на PHP 8.1 або вище. Щоб почати, встановіть Boost як залежність для розробки:

composer require laravel/boost --dev

Після встановлення запустіть інтерактивний інсталятор:

php artisan boost:install

Інсталятор автоматично визначить вашу IDE та ШІ-агентів, дозволивши вам увімкнути ті можливості, які мають сенс для вашого проєкту. Boost поважає наявні домовленості проєкту й не нав'язує упереджених правил стилю за замовчуванням.

Примітка Щоб дізнатися більше про Boost, перегляньте репозиторій Laravel Boost на GitHub.

Додавання власних настанов для ШІ

Щоб доповнити Laravel Boost власними настановами для ШІ, додайте файли .blade.php або .md до теки .ai/guidelines/* вашого застосунку. Ці файли автоматично включатимуться разом із настановами Laravel Boost, коли ви запускаєте boost:install.

Наступні кроки

Тепер, коли ви створили свій застосунок на Laravel, ви, можливо, замислюєтеся, що вивчати далі. По-перше, ми наполегливо рекомендуємо ознайомитися з тим, як працює Laravel, прочитавши таку документацію:

• Життєвий цикл запиту
• Конфігурація
• Структура тек
• Фронтенд
• Контейнер сервісів
• Фасади

Те, як саме ви хочете використовувати Laravel, також визначатиме наступні кроки на вашому шляху. Є різні способи використання Laravel, і нижче ми розглянемо два основні сценарії використання фреймворку.

Laravel як full stack фреймворк

Laravel може слугувати full stack фреймворком. Під «full stack» фреймворком ми маємо на увазі, що ви збираєтеся використовувати Laravel для маршрутизації запитів до вашого застосунку й рендерингу вашого фронтенду через шаблони Blade або гібридну технологію односторінкових застосунків на кшталт Inertia. Це найпоширеніший спосіб використання фреймворку Laravel і, на нашу думку, найпродуктивніший спосіб використання Laravel.

Якщо ви плануєте використовувати Laravel саме так, вам, можливо, варто переглянути нашу документацію про фронтенд-розробку, маршрутизацію, представлення (views) або 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 саме так, вам, можливо, варто переглянути нашу документацію про маршрутизацію, Laravel Sanctum та Eloquent ORM.