用途:在 Laravel Cloud 上部署和管理 Laravel 应用,通过 cloud CLI 完成操作,而非猜测控制台或 API 流程。
主要能力:应用从 GitHub、GitLab 或 Bitbucket 部署,需 PHP 8.2+、Laravel 9+、已连接 Git 提供方和部署区域;Cloud 为应用创建环境(生产、预发、预览各自独立计算与设置)。构建 Docker 镜像并运行构建与部署命令,零停机切换流量,默认推送即部署,也支持手动部署和部署钩子。可管理数据库、缓存、对象存储、域名、WebSocket、后台进程、密钥、命令和部署等资源。
使用方式:项目内安装 composer require --dev laravel/cloud-cli,默认以 ./vendor/bin/cloud 调用,全局安装仅作后备。认证用 ./vendor/bin/cloud auth -n,无浏览器时设置 LARAVEL_CLOUD_TOKEN。命令遵循 CRUD 模式,如 resource:list/get/create/update/delete;所有命令加 -n,读取用 --json -n,更新加 --force,删除用 -n --force。部署后必须运行 cloud deploy:monitor -n,失败时用 cloud deployment:logs {deploymentId} --json -n 查看。
适用场景:首次部署、已有应用部署、环境变量与密钥管理、基础设施创建、Monorepo 子目录、自定义域名、边缘缓存、用量与账单查询、远程 Tinker 和命令执行。
限制:构建和部署命令有 15 分钟超时;部署命令的文件系统更改不持久;环境文件系统临时且副本间不共享;对象存储按桶设置可见性,不支持逐对象 ACL;密钥创建后不可读取,需 sodium 扩展;Resend 连接与域名验证只能在控制台完成;破坏性命令需先确认。具体功能行为以 Laravel Cloud 官方文档为准。