Почати

Застосунки на Laravel.

Що проєкт на Laravel отримує одразу: APP_KEY і робочі налаштування, SQLite, доки ви не додасте базу даних, міграції як команду релізу, воркер черги й планувальник.

3 ХВ ЧИТАННЯ

Laravel розпізнається за laravel/framework у composer.json. Ви розгортаєте проєкт як є — без налаштування сервера й без додаткових файлів у репозиторії.

Як він збирається й запускається

  • PHP — найнижча з версій 8.2, 8.3 і 8.4, що задовольняє вимогу php у composer.json (8.3, якщо вимогу не вказано).
  • Composer — composer install --no-dev --optimize-autoloader.
  • Фронтенд-ресурси — якщо в package.json є скрипт build (Vite), він виконується, а public/build додається до збирання.
  • Під час запуску — storage:link, потім будуються кеші конфігурації, маршрутів і представлень.
  • HTTPS — ваш застосунок вважає HTTPS-запити захищеними, тож url(), asset() і переспрямування використовують https://, і вам не потрібно самостійно налаштовувати довіру до проксі.

Змінні, які задано за вас

ЗміннаЗначення
APP_KEYгенерується один раз під час першого розгортання й зберігається разом із вашими змінними
APP_ENVproduction
APP_DEBUGfalse
APP_URLадреса застосунку
LOG_CHANNELstderr — щоб вкладка Журнал показувала журнал Laravel
SESSION_DRIVER, CACHE_STOREredis, якщо в застосунку є Valkey, інакше file

Будь-яку з них можна замінити власною змінною з такою самою назвою — наприклад, SESSION_DRIVER=database. Докладніше — у статті Змінні середовища.

База даних: спершу SQLite

Новий застосунок Laravel без бази даних зберігає дані в SQLite — це типовий варіант самого Laravel — у файлі storage/app/database.sqlite на диску застосунку. Файл зберігається між розгортаннями й потрапляє в щоденні резервні копії застосунку, тож можна спершу запуститися, а про базу даних вирішити пізніше.

Коли ви додаєте до проєкту PostgreSQL або MySQL (Огляд → Сервіси → Додати сервіс), застосунок перемикається на неї з наступним розгортанням, і міграції виконуються вже там. Дані з файлу SQLite не переносяться — якщо вони вам потрібні, спершу експортуйте їх, а потім імпортуйте на вкладці бази Дані. Докладніше — у статті Бази даних.

Міграції — команда релізу

Рекомендована команда релізу — php artisan migrate --force. Вона виконується один раз під час кожного розгортання, перш ніж нова версія отримає відвідувачів; якщо міграція завершиться з помилкою, поточна версія працює далі. Змінити команду можна на вкладці Процеси. Докладніше — у статті Розгортання.

Воркер черги й планувальник

Одразу після запуску вкладка Процеси запускає:

ЩоКоманда
Фоновий воркер «queue»php artisan queue:work --sleep=3 --tries=3 --max-time=3600
Команда за розкладом, щохвилиниphp artisan schedule:run

Вони використовують ресурси застосунку й перезапускаються з кожним розгортанням. Змінюйте чи видаляйте їх на вкладці Процеси — наприклад, замініть воркер на php artisan horizon, якщо використовуєте Horizon із Valkey.

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

Valkey для кешу, сесій і черг

Додайте до проєкту Valkey: сесії й кеш переїдуть туди самі (з наступним розгортанням; відвідувачам доведеться увійти ще раз). Черги та все інше задайте на вкладці Змінні, наприклад:

CACHE_STORE=redis
SESSION_DRIVER=redis
QUEUE_CONNECTION=redis

REDIS_HOST, REDIS_PASSWORD, REDIS_PORT і REDIS_CLIENT=phpredis задано за вас.

WebSockets (Laravel Reverb)

Запустіть Reverb як вебсервіс із коду цього проєкту командою php artisan reverb:start --host=0.0.0.0 --port=$PORT. Він отримає власну адресу.

Файли й завантаження

Файли в storage/app — диски Laravel local і public — лишаються на диску застосунку між розгортаннями й щодня копіюються. Усе інше в папці проєкту з кожним розгортанням береться з репозиторію наново. Для великої кількості файлів або великих файлів використовуйте об’єктне сховище з диском Laravel s3.

Залишилися питання?

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

Написати в підтримку