Laravel 應用程式。
Laravel 專案開箱即有的設定:APP_KEY 與正式環境設定、新增資料庫前使用 SQLite、以遷移作為發布指令、佇列工作程序與排程器。
系統會依 composer.json 中的 laravel/framework 辨識 Laravel。您可以直接部署——不需要設定伺服器,也不需要在儲存庫中加入額外檔案。
建置與執行方式
- PHP——在 8.2、8.3 與 8.4 中,選擇符合
composer.json中php需求的最低版本(未指定時為 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 檔案中的資料不會自動轉移——如有需要,請先匯出,再於資料庫的資料分頁匯入。請參閱資料庫。
遷移——發布指令
建議的發布指令是 php artisan migrate --force。它在每次部署時、新版本接收訪客之前執行一次;若遷移失敗,目前的版本會繼續執行。您可以在程序分頁變更。請參閱部署。
佇列工作程序與排程器
程序分頁預設會執行:
| 項目 | 指令 |
|---|---|
| 背景工作程序「queue」 | php artisan queue:work --sleep=3 --tries=3 --max-time=3600 |
| 排程指令,每分鐘 | php artisan schedule:run |
它們共用應用程式的資源,並在每次部署時重新啟動。可在程序分頁變更或移除——例如搭配 Valkey 使用 Horizon 時,將工作程序換成 php artisan horizon。
佇列負載較重時,請將工作程序作為獨立的背景工作程序服務執行,擁有自己的資源,並從程序中移除。請參閱專案的服務。
以 Valkey 處理快取、工作階段與佇列
在專案中新增 Valkey:工作階段與快取會自動移到 Valkey(在下次部署時生效;訪客需要重新登入一次)。佇列與其他設定請在變數分頁設定,例如:
CACHE_STORE=redis
SESSION_DRIVER=redis
QUEUE_CONNECTION=redisREDIS_HOST、REDIS_PASSWORD、REDIS_PORT 與 REDIS_CLIENT=phpredis 會自動設定。
WebSocket(Laravel Reverb)
以此專案的程式碼將 Reverb 作為網頁服務執行,指令為 php artisan reverb:start --host=0.0.0.0 --port=$PORT。它會有自己的網址。
檔案與上傳
storage/app 中的檔案——Laravel 的 local 與 public 磁碟——在部署之間會保留在應用程式的磁碟上,並每日備份。專案資料夾中的其他內容在每次部署時都會從儲存庫重新取得。檔案多或檔案大時,請搭配 Laravel 的 s3 磁碟使用物件儲存。