PHP怎么实现Symfony Workflow工作流_Symfony状态机管理【指南】-php教程-PHP中文网

symfony workflow组件仅校验状态迁移合法性，不托管状态存储或权限；需显式定义places、transitions及initial_place，并设type: state_machine；触发transition必须用apply()而非直改属性，监听事件需匹配固定命名格式。

php怎么实现symfony workflow工作流_symfony状态机管理【指南】

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() 或事件监听都会失效。

典型错误写法：$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（任意迁移发生）。监听器必须注册到对应事件名，且注意命名空间层级。

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

常用事件类型：

workflow.[name].enter.[place]：进入某状态时触发（如 workflow.article_publishing.enter.review）
workflow.[name].leave.[place]：离开某状态时触发
workflow.[name].transition：每次 apply() 成功后触发，事件对象含 $event->getTransition()->getName()

监听器内不要做耗时操作（如发邮件），建议 dispatch 异步消息；若需修改实体状态，只能在 leave 或 transition 事件里做，enter 事件时新状态尚未写入实体属性。