Застосунки на Laravel.
Що проєкт на Laravel отримує одразу: APP_KEY і робочі налаштування, SQLite, доки ви не додасте базу даних, міграції як команду релізу, воркер черги й планувальник.
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_ENV | production |
APP_DEBUG | false |
APP_URL | адреса застосунку |
LOG_CHANNEL | stderr — щоб вкладка Журнал показувала журнал Laravel |
SESSION_DRIVER, CACHE_STORE | redis, якщо в застосунку є 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=redisREDIS_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.