Laravel 应用。
Laravel 项目开箱即用的内容:APP_KEY 和生产环境设置、添加数据库前使用 SQLite、以迁移作为发布命令、队列 Worker 和调度器。
我们通过 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。它在每次部署时执行一次,在新版本接收访问之前运行;如果迁移失败,当前版本会继续运行。您可以在 进程 标签页中修改。请参阅部署。
队列 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=redisREDIS_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 磁盘。