אפליקציות Laravel.
מה פרויקט Laravel מקבל מהרגע הראשון: APP_KEY והגדרות production, SQLite עד שמוסיפים מסד נתונים, מיגרציות כפקודת שחרור, worker לתורים ו-scheduler.
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, ואחר כך נבנים המטמונים של ההגדרות, הנתיבים וה-views. - HTTPS — האפליקציה מזהה בקשות HTTPS כמאובטחות, כך ש-
url(), asset()והפניות משתמשים ב-https://בלי שתצטרכו להגדיר אמון ב-proxies בעצמכם.
משתנים שמוגדרים בשבילכם
| משתנה | ערך |
|---|---|
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. היא רצה פעם אחת בכל פריסה, לפני שהגרסה החדשה מקבלת מבקרים; אם מיגרציה נכשלת, הגרסה הנוכחית ממשיכה לרוץ. אפשר לשנות אותה בלשונית תהליכים. ראו פריסות.
Worker לתורים ו-scheduler
מהרגע הראשון, הלשונית תהליכים מריצה:
| מה | פקודה |
|---|---|
| Worker ברקע «queue» | php artisan queue:work --sleep=3 --tries=3 --max-time=3600 |
| פקודה מתוזמנת, כל דקה | php artisan schedule:run |
הם חולקים את המשאבים של האפליקציה ומופעלים מחדש בכל פריסה. אפשר לשנות או להסיר אותם בלשונית תהליכים — למשל להחליף את ה-worker ב-php artisan horizon כשמשתמשים ב-Horizon עם Valkey.
לתור כבד, הריצו את ה-worker כשירות worker ברקע נפרד עם משאבים משלו, והסירו אותו מתהליכים. ראו שירותים של פרויקט.
Valkey למטמון, לסשנים ולתורים
הוסיפו Valkey לפרויקט: הסשנים והמטמון עוברים אליו מעצמם (בפריסה הבאה; המבקרים יתחברו פעם נוספת). את התורים וכל דבר אחר מגדירים בלשונית משתנים, למשל:
CACHE_STORE=redis
SESSION_DRIVER=redis
QUEUE_CONNECTION=redisREDIS_HOST, REDIS_PASSWORD, REDIS_PORT ו-REDIS_CLIENT=phpredis מוגדרים בשבילכם.
WebSockets (Laravel Reverb)
הריצו את Reverb כשירות web מהקוד של הפרויקט הזה עם הפקודה php artisan reverb:start --host=0.0.0.0 --port=$PORT. הוא מקבל כתובת משלו.
קבצים והעלאות
קבצים ב-storage/app — הדיסקים local ו-public של Laravel — נשארים על הדיסק של האפליקציה בין פריסות ומגובים מדי יום. כל השאר בתיקיית הפרויקט מגיע מחדש מהמאגר בכל פריסה. להרבה קבצים או לקבצים גדולים, השתמשו באחסון אובייקטים עם הדיסק s3 של Laravel.