Symfony Workflow组件仅校验状态迁移合法性，不托管状态存储或权限；需显式定义places、transitions及initial_place，并设type: state_machine；触发transition必须用apply()而非直改属性，监听事件需匹配固定命名格式。
Symfony Workflow 组件不是状态机的“自动托管服务”，它不替你存状态、不帮你做权限校验、也不自动生成表单——它只负责校验「当前状态 + 当前触发事件」是否合法，并执行定义好的状态迁移逻辑。用错场景或漏掉关键步骤，很容易出现 Transition not enabled 或状态没更新却无报错。
怎么定义一个最简可用的 workflow 配置
Workflow 必须显式声明 places（状态集合）、transitions（迁移规则），且至少有一个初始 place 被标记为 initial。YAML 是主流写法，但别漏掉 type: state_machine —— 否则默认是 workflow 类型（支持多状态并存），和多数业务中“单状态流转”直觉不符。
示例（config/packages/workflow.yaml）：
framework:
workflows:
article_publishing:
type: state_machine
marking_store:
type: single_state
arguments: ['state']
supports: ['App\Entity\Article']
initial_place: draft
places: [draft, review, published, archived]
transitions:
to_review:
from: draft
to: review
publish:
from: review
to: published
archive:
from: [published, review]
to: archived
-
marking_store.type: single_state表示从实体的state属性读写当前状态，该属性必须存在且可写（public 或有 setter） -
from支持数组，但to必须是字符串（state_machine 不允许多目标） - 如果实体没有
state属性，或名字不匹配，Workflow会静默失败，不会抛异常
怎么在控制器里安全触发 transition
不能直接改实体属性再 flush，必须走 WorkflowInterface::apply()。否则跳过合法性校验，后续调用 can() 或事件监听都会失效。
立即学习“PHP免费学习笔记（深入）”；
典型错误写法：$article->setState('published'); → 正确做法是：
$workflow = $this->workflowRegistry->get($article);
if (!$workflow->can($article, 'publish')) {
throw new \LogicException('Cannot publish this article');
}
$workflow->apply($article, 'publish');
$entityManager->flush();
-
$workflowRegistry->get($article)依赖自动发现，要求实体类被supports列表覆盖；否则抛InvalidArgumentException -
apply()成功后，实体的state属性会被自动更新，但数据库未保存——flush()仍需手动调用 - 若 transition 不存在或条件不满足，
apply()会抛LogicException，不是RuntimeException
怎么监听 transition 前后事件
Symfony 发出的事件名是固定的，比如 article_publishing.entered.review（进入 review 状态）或 article_publishing.transition（任意迁移发生）。监听器必须注册到对应事件名，且注意命名空间层级。
常用事件类型：
-
workflow.[name].enter.[place]：进入某状态时触发（如workflow.article_publishing.enter.review） -
workflow.[name].leave.[place]：离开某状态时触发 -
workflow.[name].transition：每次apply()成功后触发，事件对象含$event->getTransition()->getName()
监听器内不要做耗时操作（如发邮件），建议 dispatch 异步消息；若需修改实体状态，只能在 leave 或 transition 事件里做，enter 事件时新状态尚未写入实体属性。
为什么 can() 返回 true 却 apply() 报错 Transition not enabled
最常见原因是实体的 state 属性值和配置中 places 名称不一致：大小写不符、多了空格、用了下划线但配置写的是驼峰。Workflow 内部用严格字符串匹配判断当前状态，不作 trim 或 normalize。
调试建议：
- dump 实体的
getState()输出，确认值完全等于配置里的某个place - 检查
marking_store.arguments是否指向正确属性名（如写成['status']但实体只有state） - 运行
bin/console debug:workflow确认 workflow 已加载且 transitions 显示正常
Workflow 的“状态”完全是字符串比对，没有隐式转换，也没有 fallback 机制——写错一个字符，整个链路就断在 can() 和 apply() 之间。
