Ứng dụng Laravel.
Những gì dự án Laravel có sẵn: APP_KEY và cấu hình production, SQLite cho đến khi bạn thêm cơ sở dữ liệu, migration làm lệnh release, queue worker và scheduler.
Laravel được nhận diện qua laravel/framework trong composer.json. Bạn deploy dự án nguyên trạng — không cần cấu hình máy chủ, không cần thêm tệp nào vào repository.
Cách build và chạy
- PHP — phiên bản thấp nhất trong 8.2, 8.3 và 8.4 đáp ứng yêu cầu
phptrongcomposer.json(8.3 nếu không ghi). - Composer —
composer install --no-dev --optimize-autoloader. - Tài nguyên front-end — nếu
package.jsoncó scriptbuild(Vite), script đó được chạy vàpublic/buildđược đưa vào. - Khi khởi động — chạy
storage:link, sau đó tạo cache cho config, route và view. - HTTPS — ứng dụng của bạn nhận request HTTPS là bảo mật, nên
url(),asset()và các chuyển hướng dùnghttps://mà bạn không cần tự cấu hình trusted proxy.
Biến được đặt sẵn
| Biến | Giá trị |
|---|---|
APP_KEY | được tạo một lần ở lần deploy đầu tiên và lưu cùng các biến của bạn |
APP_ENV | production |
APP_DEBUG | false |
APP_URL | địa chỉ của ứng dụng |
LOG_CHANNEL | stderr — để tab Logs hiển thị log của Laravel |
SESSION_DRIVER, CACHE_STORE | redis khi ứng dụng có Valkey, nếu không thì file |
Bạn có thể thay bất kỳ biến nào bằng biến của mình cùng tên — ví dụ SESSION_DRIVER=database. Xem Biến môi trường.
Cơ sở dữ liệu: bắt đầu với SQLite
Ứng dụng Laravel mới chưa có cơ sở dữ liệu sẽ lưu dữ liệu trong SQLite — mặc định của chính Laravel — tại storage/app/database.sqlite trên ổ đĩa của ứng dụng. Tệp này được giữ lại qua các lần deploy và nằm trong bản sao lưu hằng ngày của ứng dụng, nên bạn có thể ra mắt trước và chọn cơ sở dữ liệu sau.
Khi bạn thêm PostgreSQL hoặc MySQL vào dự án (Tổng quan → Services → Add a service), ứng dụng chuyển sang cơ sở dữ liệu đó ở lần deploy tiếp theo và migration chạy trên đó. Dữ liệu trong tệp SQLite không được chuyển sang — hãy xuất ra trước nếu cần, rồi nhập vào ở tab Data của cơ sở dữ liệu. Xem Cơ sở dữ liệu.
Migration — lệnh release
Lệnh release được đề xuất là php artisan migrate --force. Lệnh chạy một lần ở mỗi lần deploy, trước khi phiên bản mới nhận lượt truy cập; nếu migration lỗi, phiên bản hiện tại vẫn tiếp tục chạy. Bạn có thể đổi lệnh này ở tab Processes. Xem Deploy.
Queue worker và scheduler
Mặc định, tab Processes chạy:
| Tiến trình | Lệnh |
|---|---|
| Background worker «queue» | php artisan queue:work --sleep=3 --tries=3 --max-time=3600 |
| Lệnh theo lịch, mỗi phút | php artisan schedule:run |
Chúng dùng chung tài nguyên của ứng dụng và khởi động lại ở mỗi lần deploy. Bạn có thể đổi hoặc xóa chúng ở tab Processes — ví dụ thay worker bằng php artisan horizon khi dùng Horizon với Valkey.
Với queue nặng, hãy chạy worker như một service background worker riêng có tài nguyên riêng và xóa nó khỏi Processes. Xem Các service của dự án.
Valkey cho cache, session và queue
Thêm Valkey vào dự án: session và cache tự chuyển sang đó (từ lần deploy tiếp theo; khách truy cập cần đăng nhập lại một lần). Queue và các thiết lập khác bạn đặt ở tab Variables, ví dụ:
CACHE_STORE=redis
SESSION_DRIVER=redis
QUEUE_CONNECTION=redisREDIS_HOST, REDIS_PASSWORD, REDIS_PORT và REDIS_CLIENT=phpredis được đặt sẵn cho bạn.
WebSocket (Laravel Reverb)
Chạy Reverb như một web service từ mã của dự án này với lệnh php artisan reverb:start --host=0.0.0.0 --port=$PORT. Service này có địa chỉ riêng.
Tệp và tệp tải lên
Tệp trong storage/app — các disk local và public của Laravel — được giữ trên ổ đĩa của ứng dụng qua các lần deploy và được sao lưu hằng ngày. Mọi thứ khác trong thư mục dự án được lấy mới từ repository ở mỗi lần deploy. Với nhiều tệp hoặc tệp lớn, hãy dùng object storage với disk s3 của Laravel.