安装

本指南说明如何在 Laravel 应用中安装 Durable Workflow PHP 包。

如果还在内嵌包与独立 Server 之间选择，请先阅读部署模式。本页只介绍 Laravel 内嵌路径。

想从可运行的应用开始？ Sample App是使用 Durable Workflow 2.0 的 Laravel 13 项目，为各类模式提供工作流示例，并支持 Codespaces 和 docker compose。克隆后运行 php artisan app:init 即可完成安装。需要将 Durable Workflow 加入自己的 Laravel 应用时，再回到本指南。

环境要求

• PHP 8.1 或更高版本
• Laravel 9 或更高版本

Durable Workflow 支持 Laravel 的各类队列驱动，不支持 sync，例如：

• Amazon SQS
• Beanstalkd
• Database
• Redis

各队列驱动有自己的前提条件。

还需要使用支持锁的缓存驱动。

安装 Durable Workflow

通过 Composer 安装：

composer require durable-workflow/workflow:2.5.4

如果希望 Composer 自动接受兼容的 2.x 更新，可以使用 durable-workflow/workflow:^2.0。版本兼容性说明运行时和包的兼容规则。

包会自动加载数据库迁移，安装后运行常规迁移命令即可：

php artisan migrate

运行 Worker

Durable Workflow 使用队列在后台执行工作流和活动。运行 queue:work 命令，或通过 Horizon管理队列 Worker。没有队列 Worker，工作流和活动就不会被处理。并行执行工作流和活动需要多个队列 Worker。