立即開始

Laravel 應用程式。

Laravel 專案開箱即有的設定:APP_KEY 與正式環境設定、新增資料庫前使用 SQLite、以遷移作為發布指令、佇列工作程序與排程器。

1 分鐘閱讀

系統會依 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_ENVproduction
APP_DEBUGfalse
APP_URL應用程式的網址
LOG_CHANNELstderr——讓日誌分頁顯示 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=redis

REDIS_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 磁碟使用物件儲存。

還有問題嗎?

和我們對談——AI 會立即回覆,需要時由工程師加入,全天候服務。

聯絡客服