แอปพลิเคชัน Laravel
สิ่งที่โปรเจกต์ Laravel ได้รับทันที: APP_KEY และการตั้งค่าสำหรับ production, SQLite จนกว่าคุณจะเพิ่มฐานข้อมูล, migration เป็นคำสั่ง release, queue worker และ scheduler
ระบบรู้จัก Laravel จาก laravel/framework ใน composer.json คุณ deploy ได้ทันทีตามที่เป็นอยู่ ไม่ต้องตั้งค่าเซิร์ฟเวอร์และไม่ต้องเพิ่มไฟล์ใดในรีโพสิทอรี
การ build และการรัน
- 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จากนั้นสร้างแคชของ config, route และ view - HTTPS — แอปพลิเคชันของคุณมองเห็นคำขอ HTTPS ว่าปลอดภัย ดังนั้น
url(),asset()และการ redirect จะใช้https://โดยที่คุณไม่ต้องตั้งค่า trusted proxy เอง
ตัวแปรที่ตั้งไว้ให้
| ตัวแปร | ค่า |
|---|---|
APP_KEY | สร้างครั้งเดียวตอน deploy ครั้งแรก และเก็บไว้กับตัวแปรของคุณ |
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 บนดิสก์ของแอปพลิเคชัน ไฟล์นี้คงอยู่ข้ามการ deploy และรวมอยู่ในการสำรองข้อมูลรายวันของแอปพลิเคชัน คุณจึงเปิดใช้งานก่อนแล้วค่อยตัดสินใจเรื่องฐานข้อมูลภายหลังได้
เมื่อคุณเพิ่ม PostgreSQL หรือ MySQL ให้โปรเจกต์ (ภาพรวม → เซอร์วิส → เพิ่มเซอร์วิส) แอปพลิเคชันจะเปลี่ยนไปใช้ฐานข้อมูลนั้นเมื่อ deploy ครั้งถัดไป และ migration จะรันที่นั่น ข้อมูลในไฟล์ SQLite จะไม่ถูกย้ายไปด้วย หากต้องการใช้ ให้ export ออกมาก่อน แล้ว import ที่แท็บ ข้อมูล ของฐานข้อมูล ดูเพิ่มเติมที่ ฐานข้อมูล
Migration — คำสั่ง release
คำสั่ง release ที่แนะนำคือ php artisan migrate --force ซึ่งรันหนึ่งครั้งในทุกการ deploy ก่อนที่เวอร์ชันใหม่จะเริ่มรับผู้เข้าชม หาก migration ล้มเหลว เวอร์ชันปัจจุบันจะยังทำงานต่อไป คุณเปลี่ยนคำสั่งนี้ได้ที่แท็บ โปรเซส ดูเพิ่มเติมที่ การ deploy
Queue worker และ scheduler
แท็บ โปรเซส รันสิ่งต่อไปนี้ให้ตั้งแต่แรก:
| อะไร | คำสั่ง |
|---|---|
| Background worker “queue” | php artisan queue:work --sleep=3 --tries=3 --max-time=3600 |
| คำสั่งตามกำหนดเวลา ทุกนาที | php artisan schedule:run |
ทั้งสองใช้ทรัพยากรร่วมกับแอปพลิเคชันและรีสตาร์ทในทุกการ deploy คุณเปลี่ยนหรือลบได้ที่แท็บ โปรเซส เช่น เปลี่ยน worker เป็น php artisan horizon เมื่อใช้ Horizon กับ Valkey
สำหรับคิวที่มีงานหนัก ให้รัน worker เป็นเซอร์วิส background worker แยกที่มีทรัพยากรของตัวเอง แล้วลบออกจาก โปรเซส ดูเพิ่มเติมที่ เซอร์วิสของโปรเจกต์
Valkey สำหรับแคช เซสชัน และคิว
เพิ่ม Valkey ให้โปรเจกต์ แล้วเซสชันและแคชจะย้ายไปใช้ Valkey เอง (เมื่อ deploy ครั้งถัดไป ผู้เข้าชมต้องเข้าสู่ระบบใหม่อีกครั้ง) ส่วนคิวและอื่น ๆ ให้ตั้งค่าที่แท็บ ตัวแปร เช่น:
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 จะคงอยู่บนดิสก์ของแอปพลิเคชันข้ามการ deploy และสำรองข้อมูลทุกวัน ส่วนไฟล์อื่นทั้งหมดในโฟลเดอร์โปรเจกต์จะมาใหม่จากรีโพสิทอรีในทุกการ deploy หากมีไฟล์จำนวนมากหรือไฟล์ขนาดใหญ่ ให้ใช้ object storage กับดิสก์ s3 ของ Laravel