Yii2 Workflow通过SimpleWorkflowBehavior挂载到ActiveRecord模型实现状态机管理，需配置真实status字段、正确声明workflow类并严格匹配状态转换规则。
Yii 框架本身不内置工作流引擎，但通过 yii2-workflow 扩展可快速落地审批类 OA 场景——它不依赖数据库存储流程定义，而是用 PHP 类声明状态与转换规则，轻量、可控、易调试。
怎么把 SimpleWorkflowBehavior 接到 ActiveRecord 模型上
这是最常卡住的第一步：行为（Behavior）必须正确挂载，且模型需实现状态字段的读写能力。
-
status字段必须是模型中真实存在的数据库字段（类型建议为VARCHAR或ENUM），不能仅靠 getter/setter 模拟 - 在模型类中调用
behaviors()方法返回配置，注意键名不能重复，且defaultWorkflowSource必须指向一个实现了IWorkflowDefinitionProvider的类 - 若使用命名空间，请确认
use语句完整，例如：use raoul2000\workflow\base\SimpleWorkflowBehavior;
示例片段：
public function behaviors()
{
return [
'workflow' => [
'class' => SimpleWorkflowBehavior::className(),
'defaultWorkflowSource' => MyArticleWorkflow::className(),
],
];
}
如何定义一个带“草稿→审核中→已发布→已撤回”的审批流程
流程定义不是 XML 或 JSON，而是一个纯 PHP 类，返回二维数组。关键在于 initialStatusId 和 statusTransitions 的结构是否匹配实际业务跳转逻辑。
- 每个状态 ID（如
'draft'）必须在statusTransitions中作为 key 出现，否则调用$model->can('publish')会返回 false - 转换动作名（如
'publish'）不能含空格或特殊符号，且需在模型方法中显式调用$model->applyTransition('publish')才真正触发 - 若需动态判断能否流转（比如“只有作者才能撤回”），应在 workflow 类的
canTransitionTo()方法里加逻辑，而不是只靠数组配置
简化的 MyArticleWorkflow 片段：
class MyArticleWorkflow implements IWorkflowDefinitionProvider
{
public function getDefinition()
{
return [
'initialStatusId' => 'draft',
'statusIds' => ['draft', 'reviewing', 'published', 'withdrawn'],
'statusTransitions' => [
'draft' => ['reviewing'],
'reviewing' => ['published', 'draft'],
'published' => ['withdrawn'],
'withdrawn' => ['draft'],
],
];
}
}
为什么 $model->applyTransition('review') 报错 “Invalid transition”
这不是代码写错了，而是当前模型的 status 值不在允许发起该转换的源状态列表中。yii2-workflow 严格校验状态机合法性，不会自动忽略非法调用。
- 先检查
$model->status实际值，用var_dump($model->status)确认——常见坑是数据库存了空格、大小写不一致（如'Draft'vs'draft'） - 再核对 workflow 定义中，
statusTransitions是否包含从当前status到目标动作的映射 - 如果流程中存在“跨级跳转”（如从
draft直接到published），必须显式在数组中声明，不能依赖中间状态自动穿透 - 调试时可临时启用日志：
'enableLogging' => YII_DEBUG，错误信息会输出具体不匹配的源/目标状态对
审批人逻辑怎么跟 workflow 行为解耦
yii2-workflow 只管状态流转，不管“谁来审”。OA 系统里真正的审批人控制，得靠你在控制器或服务层做额外判断。
- 不要试图把审批人规则硬塞进 workflow 类；应在调用
applyTransition()前，用业务逻辑校验当前用户是否有权执行该动作 - 例如：提交“审核中”前，查
Yii::$app->user->identity->role === 'editor'；批准“已发布”前，查是否属于AdminRole - 若需记录审批人、意见、时间等上下文，建议在模型的
afterApplyTransition()回调里写入关联表，而不是覆盖 workflow 自身逻辑
容易被忽略的一点：workflow 不处理并发审批（如多人并行审同一节点）。这类需求必须自己加数据库行锁或乐观锁，yii2-workflow 不提供内置支持。
