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. - Front-end ресурси — ако
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 — дисковете local и public на Laravel — остават на диска на приложението между деплоите и се архивират ежедневно. Всичко останало в папката на проекта идва наново от хранилището при всеки деплой. За много или големи файлове използвайте обектното хранилище с диска s3 на Laravel.