xihanfun / xihan-framework
XiHan Framework SDK for PHP: primitives, manifest, invocation context, pipeline and plugin runtime (placeholder release; implementation planned).
Requires
- php: >=8.3
Requires (Dev)
None
Suggests
None
Provides
None
Conflicts
None
Replaces
None
This package is auto-updated.
Last update: 2026-10-23 03:11:18 UTC
README
占位仓库，尚未开始实现。 规范在 framework-spec，参考实现是 .NET（XiHan.Framework 的
next/），第二语言 Go 的实现在 framework-sdk-go，可以作为本 SDK 的形状参照。
面向 PHP 应用与插件，PHP 8.3+。
计划内容
按规范逐包实现，每个包都要通过 framework-spec 的一致性向量（conformance/vectors/）：
| 包 | 内容 | 规范 |
|---|---|---|
| primitives | Error / 错误码、Result、Maybe、类型化标识、生命周期状态、管道阶段、稳定性、Baggage 键、消息键与模板 |
RFC-0001、RFC-0010、conventions/ |
| manifest | xihan.manifest.json 的模型、读取与校验，能力声明与依赖文本 |
RFC-0002、manifest/manifest.schema.json |
| invocation | 调用上下文：取消与截止时间、W3C 追踪、已登记的 Baggage | RFC-0003 |
| pipeline | 十一阶段管道：登记、顺序约束、稳定拓扑排序、打印 | RFC-0004 |
| operation | 操作契约、登记表、经完整管道执行的调用器（XGI JSON） | RFC-0011 |
| plugin | 进程外插件运行时（xihan.plugin.v1，grpc 扩展） |
RFC-0017、plugin/ |
| caching 等远程 Provider | 子系统能力的操作集（首个是 caching.distributed@1） |
RFC-0019、provider/ |
插件实现用规范仓库的黑盒运行器验证：xihan-conformance plugin --dir <产物目录>。
包名
xihanfun/xihan-framework（Packagist）。领域词与规范术语表（conventions/vocabulary.md）一致，只换本语言的大小写风格。
成熟度
Reference（.NET）、Stable（通过全部向量）、Experimental（部分向量）、Community（社区维护）。本仓库当前：规划中。
参与
- 先读 framework-spec 的 README 与各 RFC，再看 framework-sdk-go 的包划分。
- 在本仓库开 Issue 认领要实现的包，一个包一个 PR，附向量测试。
- 公开契约的变更不在 SDK 仓库里做：走 framework-spec 的 RFC 流程，再同步到各 SDK。
发布占位版本
已提交：Packagist 上的 xihanfun/xihan-framework（2026-10-23，GitHub hook 自动更新，当前 dev-main），vendor xihanfun 已归本组织。Packagist 的 vendor 名 xihanfun 归第一个提交 xihanfun/... 包的人；本仓库已含最小包（composer.json + src/Framework.php，只导出 VERSION 与 SPEC_VERSION）。用 GitHub 登录 packagist.org，在 Submit 页面提交仓库地址 https://github.com/XiHanFun/framework-sdk-php，然后在包页面开启 GitHub hook 自动更新；没有标签时显示 dev-main，不影响占名。