เริ่มต้นใช้งาน

แอปพลิเคชัน Laravel

สิ่งที่โปรเจกต์ Laravel ได้รับทันที: APP_KEY และการตั้งค่าสำหรับ production, SQLite จนกว่าคุณจะเพิ่มฐานข้อมูล, migration เป็นคำสั่ง release, queue worker และ scheduler

2 นาทีในการอ่าน

ระบบรู้จัก 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_ENVproduction
APP_DEBUGfalse
APP_URLที่อยู่ของแอปพลิเคชัน
LOG_CHANNELstderr — เพื่อให้แท็บ ล็อก แสดงล็อกของ Laravel
SESSION_DRIVER, CACHE_STOREredis เมื่อแอปพลิเคชันมี 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=redis

REDIS_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

ยังติดปัญหาอยู่ใช่ไหม

แชทกับเรา AI ตอบทันที และวิศวกรจะเข้ามาช่วยเมื่อจำเป็น ได้ทุกเวลา

ติดต่อฝ่ายซัพพอร์ต