Aplikacje Laravel.
Co projekt Laravel dostaje od razu: APP_KEY i ustawienia produkcyjne, SQLite, dopóki nie dodasz bazy danych, migracje jako polecenie wydania, worker kolejki i harmonogram.
Laravel rozpoznajemy po laravel/framework w composer.json. Wdrażasz go takim, jaki jest — bez konfiguracji serwera i bez dodatkowych plików w repozytorium.
Jak jest budowany i uruchamiany
- PHP — najniższa z wersji 8.2, 8.3 i 8.4, która spełnia wymaganie
phpwcomposer.json(8.3, jeśli wymagania nie ma). - Composer —
composer install --no-dev --optimize-autoloader. - Zasoby front-endu — jeśli
package.jsonma skryptbuild(Vite), jest uruchamiany, apublic/buildtrafia do wdrożenia. - Przy starcie —
storage:link, a potem budowany jest cache konfiguracji, tras i widoków. - HTTPS — aplikacja traktuje żądania HTTPS jako bezpieczne, więc
url(),asset()i przekierowania używająhttps://bez samodzielnego konfigurowania zaufanych proxy.
Zmienne ustawiane za ciebie
| Zmienna | Wartość |
|---|---|
APP_KEY | generowany raz przy pierwszym wdrożeniu i przechowywany razem z twoimi zmiennymi |
APP_ENV | production |
APP_DEBUG | false |
APP_URL | adres aplikacji |
LOG_CHANNEL | stderr — dzięki temu karta Logi pokazuje log Laravela |
SESSION_DRIVER, CACHE_STORE | redis, gdy aplikacja ma Valkey, w przeciwnym razie file |
Każdą z nich możesz zastąpić własną zmienną o tej samej nazwie — na przykład SESSION_DRIVER=database. Zobacz Zmienne środowiskowe.
Baza danych: na początek SQLite
Nowa aplikacja Laravel bez bazy danych trzyma dane w SQLite — domyślnym rozwiązaniu samego Laravela — w pliku storage/app/database.sqlite na dysku aplikacji. Plik przetrwa wdrożenia i trafia do codziennych kopii zapasowych aplikacji, więc możesz najpierw wystartować, a o bazie danych zdecydować później.
Gdy dodasz do projektu PostgreSQL lub MySQL (Przegląd → Usługi → Dodaj usługę), aplikacja przełączy się na nią przy najbliższym wdrożeniu i tam uruchomi migracje. Dane z pliku SQLite nie są przenoszone — jeśli ich potrzebujesz, najpierw je wyeksportuj, a potem zaimportuj na karcie Dane bazy. Zobacz Bazy danych.
Migracje — polecenie wydania
Zalecane polecenie wydania to php artisan migrate --force. Uruchamia się raz przy każdym wdrożeniu, zanim nowa wersja dostanie ruch; jeśli migracja się nie powiedzie, bieżąca wersja działa dalej. Możesz je zmienić na karcie Procesy. Zobacz Wdrożenia.
Worker kolejki i harmonogram
Od razu na karcie Procesy działają:
| Co | Polecenie |
|---|---|
| Worker w tle „queue” | php artisan queue:work --sleep=3 --tries=3 --max-time=3600 |
| Zaplanowane polecenie, co minutę | php artisan schedule:run |
Korzystają z zasobów aplikacji i restartują się przy każdym wdrożeniu. Zmienisz lub usuniesz je na karcie Procesy — na przykład zastąpisz workera poleceniem php artisan horizon, jeśli używasz Horizona z Valkey.
Przy dużej kolejce uruchom workera jako osobną usługę typu worker w tle z własnymi zasobami i usuń go z Procesów. Zobacz Usługi projektu.
Valkey do cache, sesji i kolejek
Dodaj do projektu Valkey: sesje i cache same się na niego przeniosą (przy najbliższym wdrożeniu; odwiedzający zalogują się jeszcze raz). Kolejki i wszystko inne ustawiasz na karcie Zmienne, np.:
CACHE_STORE=redis
SESSION_DRIVER=redis
QUEUE_CONNECTION=redisREDIS_HOST, REDIS_PASSWORD, REDIS_PORT i REDIS_CLIENT=phpredis są ustawiane za ciebie.
WebSockets (Laravel Reverb)
Uruchom Reverb jako usługę webową z kodu tego projektu poleceniem php artisan reverb:start --host=0.0.0.0 --port=$PORT. Dostanie własny adres.
Pliki i przesyłane pliki
Pliki w storage/app — dyski local i public Laravela — zostają na dysku aplikacji między wdrożeniami i codziennie trafiają do kopii zapasowej. Cała reszta folderu projektu przy każdym wdrożeniu pochodzi na nowo z repozytorium. Przy wielu lub dużych plikach używaj magazynu obiektów z dyskiem s3 Laravela.