jeeflow-php:基于 PHP 的轻量工作流引擎项目

jeeflow工作流引擎-php版

分支1Tags28
文件最后提交记录最后更新时间
13 天前
12 天前
6 天前
8 天前
4 天前
4 天前
1 个月前
4 天前
1 个月前
1 个月前
1 个月前
1 个月前
1 个月前
1 个月前
1 个月前
1 个月前

jeeflow-php

jeeflow 工作流引擎 · PHP 实现

jeeflow 是一个零框架依赖的轻量工作流引擎,PHP 版与 Java / Go / Python / Node / Rust 保持行为同构。

模块结构

packages/
├── core/              引擎聚合根、状态机、流程执行、SPI
├── repository-pdo/    MySQL/PDO 持久化
├── persist/           ARCHIVE/SYNC 写侧(PersistPostInterceptor)
├── web-contract/      统一门面 Facade、DTO、错误码与契约测试
└── web-psr/           可选 PSR HTTP adapter
demo-slim/             PHP 引擎参考 demo(Slim 4)
tests/                 测试套件
docs/                  文档

环境要求

  • PHP 8.1+
  • Composer 2.x
  • MySQL 5.7+(PDO 模块)

快速开始

composer install
composer test

对齐事实源

  • 引擎语义:jeeflow-java(Java 是参考实现)
  • HTTP 契约:jeeflow-doc/docs/spec/06-facade.md
  • 共享流程定义:本仓 flows/(唯一编辑源 jeeflow-java/jeeflow-core/src/test/resources/flows/,jeeflow-flows-dir.php 在维护者机器上执行时把 Java 源精确镜像进本仓,单语言用户下载即用)

已实现能力

  • 引擎核心:ProcessInstance 聚合根 + 状态机 + SPI + Handler
  • 流程类型:simple / multi-task / decision / fork-join / countersign / reject / withdraw
  • 持久化:PdoProcessRepository(MySQL)+ InMemoryProcessRepository(测试)
  • 统一门面:JeeflowFacade(与 Java 对齐,含 bizData / candidatePage)
  • 查询解析:JeeflowQueryParser(m_ 前缀过滤)
  • 扩展仓储:IProcessExtRepository
  • PSR adapter:JeeflowRequestHandler(PSR-15)
  • persist 写侧:ARCHIVE/SYNC(PersistPostInterceptor)
  • 参考 demo:demo-slim(Slim 4)

文档

统一规范:jeeflow-doc

License

Copyright © 2025-2026 mldong

Licensed under the Apache License, Version 2.0. See LICENSE and NOTICE.

项目介绍

jeeflow工作流引擎-php版

定制我的领域