# jeeflow-php

**Repository Path**: mldong/jeeflow-php

## Basic Information

- **Project Name**: jeeflow-php
- **Description**: jeeflow工作流引擎-php版
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-11
- **Last Updated**: 2026-09-04

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 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 模块）

## 快速开始

```bash
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](https://jeeflow-doc.mldong.com)

## License

Copyright © 2025-2026 mldong

Licensed under the Apache License, Version 2.0.
See [LICENSE](./LICENSE) and [NOTICE](./NOTICE).