finite/finite 因依赖过时的 symfony/event-dispatcher:~2.1 且 PHP 版本上限为 ^5.4||^7.0，在 PHP 8+ 和现代 Symfony 环境下无法安装；官方已归档，推荐改用官方维护的 symfony/workflow。
Finite 库已停止维护，finite/finite 在 Composer 中无法安装（PHP 8+ 环境下会因依赖冲突直接失败），官方 GitHub 仓库自 2017 年起归档，不建议新项目引入。
为什么 composer require finite/finite 会失败
主要卡在两个地方：
-
finite/finite最后一个稳定版v2.1.1依赖symfony/event-dispatcher: ~2.1，与现代 Symfony 组件（v5/v6/v7）完全不兼容 - 其
composer.json声明的 PHP 版本上限为^5.4 || ^7.0，Composer 2.2+ 默认拒绝安装不兼容 PHP 8 的包（即使加--ignore-platform-reqs，也会因事件分发器接口变更而运行时报错） - 部分用户强行降级 Symfony 或锁死旧版本，结果在
FiniteStateMachineStateMachine构造时触发ArgumentCountError: Too few arguments—— 因SymfonyComponentEventDispatcherEventDispatcherInterface构造签名已变
替代方案：用 symfony/workflow 替代 finite/finite
这是 Symfony 官方维护、活跃更新的状态机实现，轻量且 API 清晰，支持状态图定义、回调钩子、权限校验等核心能力。它不强制依赖整个 Symfony 框架，可单独使用：
Workflow Decomposer
下载
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
- 安装命令：
composer require symfony/workflow（兼容 PHP 7.4–8.3） - 最小化配置示例（YAML）：
workflow: article: type: 'state_machine' marking_store: type: 'single_state' arguments: ['currentState'] supports: ['AppEntityArticle'] places: ['draft', 'review', 'published', 'archived'] transitions: publish: {from: 'draft', to: 'published'} request_review: {from: 'draft', to: 'review'} approve: {from: 'review', to: 'published'} archive: {from: ['published', 'review'], to: 'archived'} - PHP 加载方式：
$workflow = $container->get('workflow.article');（若用 Symfony DI）或手动构建：new Workflow(...)
如果必须用 Finite（遗留系统迁移场景）
仅限 PHP 7.4 以下 + Symfony 3.x 环境，且需人工干预依赖：
立即学习“PHP免费学习笔记（深入）”；
- 先执行：
composer require symfony/event-dispatcher:^3.4 --no-update，再composer require finite/finite:^2.1.1，最后composer update --lock - 禁用自动加载冲突：在
composer.json中添加"autoload": {"psr-4": {"Finite\": "vendor/finite/finite/src/Finite/"}}，避免与新 Symfony 类名冲突 - 运行时需替换事件分发器实例：
$dispatcher = new SymfonyComponentEventDispatcherEventDispatcher();（不能用EventDispatcherInterface::class的新契约） - 所有
FiniteTransitionTransition实例需显式调用apply()，不再支持链式调用can($transition)→apply()
Finite 的 DSL 和简单性确实吸引人，但它的生命周期早已结束；真正要落地状态机逻辑，symfony/workflow 的 YAML 定义 + PHP 钩子组合，比硬扛一个废弃库更省时间——尤其当你要处理并发状态变更或审计日志时。
