Zacznij

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.

3 MIN CZYTANIA

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 php w composer.json (8.3, jeśli wymagania nie ma).
  • Composer — composer install --no-dev --optimize-autoloader.
  • Zasoby front-endu — jeśli package.json ma skrypt build (Vite), jest uruchamiany, a public/build trafia 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

ZmiennaWartość
APP_KEYgenerowany raz przy pierwszym wdrożeniu i przechowywany razem z twoimi zmiennymi
APP_ENVproduction
APP_DEBUGfalse
APP_URLadres aplikacji
LOG_CHANNELstderr — dzięki temu karta Logi pokazuje log Laravela
SESSION_DRIVER, CACHE_STOREredis, 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ą:

CoPolecenie
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=redis

REDIS_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.

Nadal masz pytania?

Napisz do nas na czacie — AI odpowiada od razu, a inżynier dołącza, gdy trzeba, o każdej porze.

Kontakt z pomocą techniczną