Laravel қолданбалары.
Laravel жобасы бірден не алады: APP_KEY және production баптаулары, дерекқор қосқанша SQLite, release командасы ретінде миграциялар, кезек өңдеуші және жоспарлағыш.
Laravel composer.json ішіндегі laravel/framework арқылы анықталады. Оны сол күйінде деплой жасайсыз — серверді баптаудың да, репозиторийге қосымша файлдардың да қажеті жоқ.
Қалай құрастырылады және іске қосылады
- PHP —
composer.jsonішіндегіphpталабына сай келетін 8.2, 8.3 және 8.4 нұсқаларының ең төменгісі (талап көрсетілмесе, 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 | қолданбада Valkey болса redis, әйтпесе file |
Олардың кез келгенін дәл сондай атаумен өз айнымалыңызбен ауыстыруға болады — мысалы, SESSION_DRIVER=database. Толығырақ: Орта айнымалылары.
Дерекқор: алдымен SQLite
Дерекқоры жоқ жаңа Laravel қолданбасы деректерін SQLite-та — Laravel-дің өз әдепкі нұсқасында — қолданба дискіндегі storage/app/database.sqlite файлында сақтайды. Файл деплойлардан кейін де сақталады және қолданбаның күнделікті сақтық көшірмелеріне кіреді, сондықтан алдымен іске қосып, дерекқор туралы кейін шешуге болады.
Жобаға PostgreSQL немесе MySQL қосқанда (Шолу → Сервистер → Сервис қосу), қолданба келесі деплоймен соған ауысады және миграциялар сол жерде орындалады. SQLite файлындағы деректер көшірілмейді — қажет болса, алдымен экспорттап, дерекқордың Деректер қойындысында импорттаңыз. Толығырақ: Дерекқорлар.
Миграциялар — release командасы
Ұсынылатын release командасы — php artisan migrate --force. Ол әр деплойда, жаңа нұсқа келушілерді қабылдамас бұрын бір рет орындалады; миграция сәтсіз болса, ағымдағы нұсқа жұмыс істей береді. Оны Процестер қойындысында өзгертуге болады. Толығырақ: Деплойлар.
Кезек өңдеуші және жоспарлағыш
Процестер қойындысы бірден мыналарды іске қосады:
| Не | Команда |
|---|---|
| «queue» фондық процесі | php artisan queue:work --sleep=3 --tries=3 --max-time=3600 |
| Жоспарланған команда, әр минут сайын | php artisan schedule:run |
Олар қолданбаның ресурстарын бөліседі және әр деплой сайын қайта іске қосылады. Оларды Процестер қойындысында өзгертіңіз немесе алып тастаңыз — мысалы, Horizon-ды Valkey-мен қолдансаңыз, өңдеушіні php artisan horizon командасымен ауыстырыңыз.
Кезек ауыр болса, өңдеушіні өз ресурстары бар бөлек фондық процесс сервисі ретінде іске қосып, оны Процестер қойындысынан алып тастаңыз. Толығырақ: Жоба сервистері.
Кэш, сессиялар және кезектер үшін 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 дискімен объектілік қойманы пайдаланыңыз.