Download the PHP package kode/context without Composer

On this page you can find all versions of the php package kode/context. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
Some PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

  • Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
  • To use Composer is sometimes complicated. Especially for beginners.
  • Composer needs much resources. Sometimes they are not available on a simple webspace.
  • If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
  • Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Please rate this library. Is it a good library?

Example code of kode/context

Informations about the package context

kode/context - PHP 协程/纤程上下文管理包

PHP Version Latest Version

为多线程、多进程、协程（Swoole/Swow/Fiber）环境提供安全的请求上下文传递机制，支持分布式多机器部署

📌 概述

在现代 PHP 高并发编程中，尤其是在使用 协程（Coroutine） 或 纤程（Fiber） 的场景下，传统的全局变量、静态属性或单例模式极易导致上下文污染和数据错乱。例如，在一个 HTTP 请求中存储用户信息、Trace ID、请求对象等，若直接使用 static 变量或全局容器，多个并发协程会共享同一份内存，造成严重安全隐患。

kode/context 是一个轻量级、高性能、跨运行时的上下文管理库，旨在解决：

🎯 为什么需要 kode/context？

场景 问题 解决方案
原生 PHP + 多进程 进程隔离，无需担心共享状态 ✅ 安全
原生 PHP + 多线程（ZTS） 线程共享内存，static 被所有线程共享 ❌ 存在风险
Swoole 协程 协程共享线程内存，static 被复用 ❌ 极易污染
Swow 协程 同上，绿色线程模型 ❌ 存在上下文混淆
PHP 8.3+ Fiber Fiber 共享调用栈中的 static 变量 ❌ 数据交叉污染
分布式多机器 跨节点调用时上下文丢失 ✅ 序列化传递

👉 结论：只要存在"并发执行单元共享主线程内存"的情况，就必须使用上下文隔离机制！

🔥 特别提醒：这是解决 Facade 模式、Service Locator、静态容器等"全局状态"污染的关键！

🧩 核心功能

⚙️ 实现原理（按运行时自动适配）

运行时环境 上下文存储机制 说明
PHP Fiber (8.3+) \Fiber::getLocal() 使用 Fiber 内建本地存储，完美隔离
Swoole Co::getCid() + Coroutine::getContext() 基于协程 ID 绑定上下文对象
Swow Swow\Coroutine::getLocal() 使用 Swow 提供的本地存储 API
多线程 (ZTS) 线程 ID + 独立存储 支持 pthreads/parallel 扩展
多进程 进程 ID + fork 继承 支持 pcntl_fork
普通同步环境 $GLOBALS 模拟 单线程安全，兼容 CLI/HTTP

✅ 所有实现均保证：每个并发执行单元拥有独立的上下文视图

🧪 快速开始

1. 安装

2. 基本用法

3. 使用 Context::run() 创建隔离作用域

4. 使用 Context::fork() 继承上下文

5. 结合中间件使用（如 Swoole HTTP Server）

🔀 多进程支持

kode/context 提供完整的多进程上下文管理支持，适用于使用 pcntl_fork() 的场景。

Fork 上下文继承

进程池并行执行

进程间通信

进程间通过 socket 传递序列化数据：

🧵 多线程支持

kode/context 支持多线程环境（需要 ZTS + pthreads 或 parallel 扩展）。

检测线程环境

线程中运行任务

线程池并行执行

🌐 分布式支持

kode/context 提供完整的分布式上下文传递支持，适用于微服务、多机器部署场景。

分布式追踪

序列化与反序列化

HTTP Headers 传递

完整分布式调用示例

与 kode/fibers 集成

kode/context 可以与 kode/fibers 无缝集成，在分布式任务调度中自动传递上下文：

🔄 API 文档

基础操作

方法 说明
Context::set(string $key, mixed $value): void 设置上下文值
Context::get(string $key, mixed $default = null): mixed 获取上下文值
Context::has(string $key): bool 判断键是否存在
Context::delete(string $key): void 删除指定键
Context::clear(): void 清空当前上下文

批量操作

方法 说明
Context::copy(): array 复制当前上下文为数组快照
Context::restore(array $snapshot): void 从快照恢复上下文
Context::merge(array $data, bool $overwrite = true): void 合并数据到上下文
Context::keys(): array 获取所有键名
Context::count(): int 获取键值对数量
Context::all(): array 获取所有数据

作用域操作

方法 说明
Context::run(callable $callable): mixed 在隔离作用域中执行
Context::fork(callable $callable): mixed 在继承作用域中执行

类型安全

方法 说明
Context::getOfType(string $key, string $type): mixed 获取并断言类型

监听器

方法 说明
Context::listen(string $key, Closure $listener): void 注册变更监听器
Context::unlisten(string $key): void 移除监听器

运行时信息

方法 说明
Context::getRuntime(): string 获取运行时类型
Context::isCoroutine(): bool 是否在协程环境
Context::isThread(): bool 是否在线程环境
Context::isProcess(): bool 是否在进程环境
Context::getExecutionId(): int\|string\|null 获取执行单元 ID
Context::getCoroutineId(): int\|string\|null 获取协程 ID
Context::getProcessId(): int 获取进程 ID
Context::getThreadId(): ?int 获取线程 ID

多进程操作

方法 说明
Context::prepareFork(): void 准备 fork 前的上下文快照
Context::afterFork(bool $inherit = true): void fork 后初始化子进程上下文
Context::runInProcess(callable $task, bool $inherit = true): mixed 在子进程中运行任务
Context::parallelProcesses(array $tasks, int $max = 4, bool $inherit = true): array 进程池并行执行

多线程操作

方法 说明
Context::runInThread(callable $task, bool $inherit = true): mixed 在线程中运行任务
Context::parallelThreads(array $tasks, int $max = 4, bool $inherit = true): array 线程池并行执行

分布式操作

方法 说明
Context::toJson(array $onlyKeys = []): string 序列化为 JSON
Context::fromJson(string $json, bool $merge = false): array 从 JSON 反序列化
Context::export(array $onlyKeys = []): array 导出可序列化数据
Context::import(array $data, bool $merge = false): array 导入数据
Context::startTrace(?string $traceId = null, ?string $nodeId = null): string 启动追踪
Context::startSpan(): string 创建子 Span
Context::getTraceInfo(): array 获取追踪信息
Context::toHeaders(string $prefix = 'X-Context-'): array 导出为 Headers
Context::fromHeaders(array $headers, string $prefix = 'X-Context-'): void 从 Headers 导入
Context::getDistributedKeys(): array 获取分布式键
Context::exportForDistributed(): array 导出分布式上下文

测试辅助

方法 说明
Context::reset(): void 重置上下文状态

常量

🧱 设计思想参考

✅ 适用场景

🚫 注意事项

📦 与其他组件集成建议

组件 集成方式
Hyperf 替代 Hyperf\Context\Context，作为底层依赖
Laravel Octane 在 onRequest 回调中初始化 Context
EasySwoole 在主服务启动时注册 Context 初始化
Monolog 添加 ProcessContextProcessor 注入 trace_id
kode/fibers 作为底层依赖，支持分布式任务调度

🧪 性能基准测试

kode/context 在多种环境下进行了性能测试，迭代次数 100,000 次。

macOS (Apple Silicon)

方法 执行时间 每秒操作数
Context::set() 8.53ms 11,723,570
Context::get() 6.87ms 14,556,030
Context::has() 6.53ms 15,322,044
Context::delete() 12.44ms 8,038,464
Context::clear() 18.80ms 5,320,011
Context::copy() 6.64ms 15,064,102
Context::run() 36.10ms 2,770,016
Context::fork() 42.50ms 2,352,941
Context::toJson() ~25ms ~4,000,000
Context::fromJson() ~30ms ~3,300,000

测试环境： macOS 14.4 (Darwin 24.3.0), Apple M3 Pro (11核), 18GB RAM, PHP 8.3.30, OPcache 启用

Linux (x86_64)

方法 执行时间 每秒操作数
Context::set() ~7ms ~14,000,000
Context::get() ~5ms ~20,000,000
Context::has() ~5ms ~20,000,000
Context::run() ~30ms ~3,300,000
Context::fork() ~35ms ~2,800,000

测试环境： Ubuntu 22.04 LTS, AMD EPYC/Ryzen, PHP 8.2+, OPcache 启用

Windows (x86_64)

方法 执行时间 每秒操作数
Context::set() ~9ms ~11,000,000
Context::get() ~8ms ~12,500,000
Context::has() ~8ms ~12,500,000

测试环境： Windows 11, AMD Ryzen 7 5800H, 32GB RAM, PHP 8.2+

这些结果表明 kode/context 在各种操作上都具有出色的性能表现，适合在高并发环境中使用。

💡 提示： 实际性能会因硬件配置、PHP 版本、OPcache/JIT 状态等因素而有所不同。建议在正式环境中使用 OPcache 和 JIT 以获得最佳性能。

运行基准测试

🤝 贡献与反馈

欢迎提交 Issue 或 Pull Request！

GitHub: https://github.com/kodephp/context

📜 许可证

Apache License 2.0

🌟 kode/context —— 让每一次协程调用都清晰可控，告别上下文污染！

All versions of context with dependencies

PHP Build Version
Package Version
Requires php Version ^8.3
Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package kode/context contains the following files

Loading the files please wait ...