如何使用Composer引入 Symfony Workflow 库在 PHP 中管理复杂的业务状态机-composer-PHP中文网

必须用 composer require symfony/workflow 显式安装，依赖 frameworkbundle；配置文件必须为 config/packages/workflow.yaml，顶层结构为 framework: → workflows:，每个 workflow 需指定 type；状态值须与实体字段严格一致；apply() 后需手动 $em->flush() 持久化。

如何使用composer引入 symfony workflow 库在 php 中管理复杂的业务状态机

别用 `composer install` 装 Workflow，它不单独发布

Workflow 组件不是独立可安装的包，composer install 本身不会拉取它——你得明确告诉 Composer 要什么。symfony/workflow 是一个可选组件，必须通过 composer require 显式引入，且依赖 symfony/framework-bundle 提供的基础能力（如配置加载、事件分发）。

常见错误是搜“Composer 安装 Symfony Workflow”后直接运行 composer install，结果什么都没变，状态机压根没注册进容器。

正确命令是：composer require symfony/workflow
若项目尚未启用 FrameworkBundle（极少见），先确认 config/bundles.php 中有 Symfony\Bundle\FrameworkBundle\FrameworkBundle::class => ['all' => true]
旧版 Symfony（如 4.4 或更早）可能无法安装 symfony/workflow ^6.0+，此时要么升级框架，要么改用 symfony/console + 手写状态迁移逻辑

`workflow.yaml` 路径和结构错一个字符，状态机就静默失效

装完包只是第一步。Workflow 服务是否被注册，完全取决于 config/packages/workflow.yaml 是否存在、路径是否精确、格式是否合规。写错文件名或顶层键名，容器里根本不会生成 state_machine.* 或 workflow.* 服务，调用时直接报 Service "workflow" not found 或 Class "Workflow" not found。

btpanel phpsite 宝塔面板PHP网站

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

下载

文件必须放在：config/packages/workflow.yaml（不能是 workflows.yaml、state_machine.yaml 或 config/workflow.yaml）
顶层结构必须是：framework: → workflows:，不能顶格写 workflows:
每个 workflow 必须指定 type: state_machine 或 type: workflow，漏掉会报 The workflow "xxx" has no type defined
最小可用示例：

framework:
  workflows:
    order:
      type: state_machine
      marking_store:
        type: method
        property: status
      supports:
        - App\Entity\Order
      places: [draft, paid, shipped, delivered]
      transitions:
        pay:
          from: draft
          to: paid
        ship:
          from: paid
          to: shipped

实体状态字段名和 `places` 值必须字面完全一致

Workflow 内部做的是严格字符串比对，不是语义匹配。哪怕只差一个下划线、大小写不一致、多一个空格，can() 就返回 false，apply() 会静默失败或抛出 LogicException。

确保你的实体有 getStatus() 方法，且返回值（如 'paid'）和 workflow.yaml 中 places 列表里的字符串（paid）完全一致
如果实体用的是 $status 属性而非方法，需在 marking_store 中显式声明：property: status；若用 $currentStep，就得写 property: currentStep
避免混用近义词：比如 shipped 和 dispatched 同时出现在 places 里，但 transition 的 from 写了 dispatched，而实体实际存的是 shipped —— Workflow 不会自动映射
推荐做法：把所有状态值抽成类常量，在 YAML 和实体中复用，例如 Order::STATUS_PAID，再在 places 中写 !php/const App\Entity\Order::STATUS_PAID

`apply()` 不自动持久化，忘掉 `$em->flush()` 就等于没执行

Workflow 只负责状态转换逻辑校验和变更内存中的标记（marking），它不碰数据库。调用 $workflow->apply($order, 'pay') 后，$order->getStatus() 会返回新值，但如果不手动 $em->flush()，下次从 DB 查出来的还是旧状态。

务必在 apply() 后执行持久化操作，典型流程是：$workflow->apply($order, 'pay'); $em->flush();
别指望 Doctrine 监听器自动捕获——Workflow 不触发 preFlush 或 postFlush，它只发自己的事件（如 workflow.entered），需要你自己监听并写逻辑
复杂流程（如订单含支付、发货、售后多个环节）建议拆成多个独立 workflow（payment、shipping、returns），而不是塞进一个大 workflow 里——否则 places 列表膨胀、transition 爆炸，维护成本陡增