立即开始

Laravel 应用。

Laravel 项目开箱即用的内容:APP_KEY 和生产环境设置、添加数据库前使用 SQLite、以迁移作为发布命令、队列 Worker 和调度器。

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。它在每次部署时执行一次,在新版本接收访问之前运行;如果迁移失败,当前版本会继续运行。您可以在 进程 标签页中修改。请参阅部署。

队列 Worker 和调度器

默认情况下,进程 标签页会运行:

内容命令
后台 Worker “queue”php artisan queue:work --sleep=3 --tries=3 --max-time=3600
定时命令,每分钟一次php artisan schedule:run

它们共享应用的资源,并在每次部署时重启。您可以在 进程 标签页中修改或删除它们——例如使用 Horizon 和 Valkey 时,将 Worker 替换为 php artisan horizon。

如果队列负载较重,请将 Worker 作为独立的 后台 Worker 服务运行,并为其分配独立资源,同时从 进程 中删除。请参阅项目服务。

使用 Valkey 处理缓存、会话和队列

向项目添加 Valkey:会话和缓存会自动迁移到其中(在下一次部署时生效;访客需要重新登录一次)。队列及其他设置请在 变量 标签页中配置,例如:

CACHE_STORE=redis
SESSION_DRIVER=redis
QUEUE_CONNECTION=redis

REDIS_HOST、REDIS_PASSWORD、REDIS_PORT 和 REDIS_CLIENT=phpredis 会自动设置。

WebSocket(Laravel Reverb)

使用本项目的代码,以命令 php artisan reverb:start --host=0.0.0.0 --port=$PORT 将 Reverb 作为 Web 服务 运行。它会获得独立的地址。

文件与上传

storage/app 中的文件(即 Laravel 的 local 和 public 磁盘)在部署之间保留在应用磁盘上,并每日备份。项目文件夹中的其他内容在每次部署时都会从仓库重新获取。如果文件较多或较大,请使用对象存储配合 Laravel 的 s3 磁盘。

还有疑问?

和我们聊聊——AI 即时回答,需要时工程师加入,全天候在线。

联系技术支持