PHP 8.3 接入大模型流式对话需依托JIT加速、Swoole协程异步I/O、类型化类常量配置,并选用ollama-php或dashscope-php等SDK处理SSE流,配合正确header、实时flush输出及token耗时统计。

PHP 8.3 接入大模型流式对话接口,核心在于三点:语言特性支撑、HTTP长连接能力、流式响应解析。不是简单发个请求就完事,而是要让 PHP 真正“跟得上”LLM 的实时输出节奏。
用好 PHP 8.3 的 JIT 和协程友好特性
PHP 8.3 自带的 JIT 编译器对计算密集型操作(如 token 解析、上下文拼接)有实际加速效果,但真正关键的是它对 Swoole 协程的兼容性提升。流式对话本质是异步 I/O 场景,必须避开传统 FPM 模式下的阻塞等待。
- 确保启用 Swoole ≥ 5.1.0,并验证环境:
php --ri swoole | grep "Version" - 禁用 opcache.preload(避免协程中类加载冲突),改用
opcache.enable_cli=1提升 CLI 启动性能 - 利用 PHP 8.3 新增的 类型化类常量 定义模型配置,比如:
public const DEFAULT_MODEL = 'qwen-plus';,增强 IDE 补全与运行时校验
选对客户端:ollama-php 或 DashScope SDK + 流式适配
不推荐裸写 cURL 处理 Server-Sent Events(SSE)。优先使用封装完善的库,它们已处理 chunk 边界识别、重连逻辑和错误码映射。
大模型 Token 成本节约工具。在请求到达大模型之前自动压缩 prompt 和上下文,减少 60-95% 的 token 消耗,直接降低 API 成本。支持 Claude/OpenAI/Gemini 等主流模型,提供代理模式、CLI 包装、Python SDK 和 MCP Server 四种接入方式。内置一键安...
- 对接本地 Ollama:用
ardagnsrn/ollama-php,调用$client->chat()->create(['stream' => true, 'messages' => [...]]),响应自动 yield 每个delta.content - 对接阿里云千问:用官方
dashscope-phpSDK,启用stream => true,注意其返回是Generator对象,需 foreach 迭代获取$event->output->text - 若需 WebSocket 长连接(如前端直连后端服务),用 Swoole 写一个中继服务,把 HTTP 流转换为 WebSocket 帧,避免浏览器端 SSE 兼容性问题
流式响应在 PHP 层的落地写法
流式不是“等全部返回再 echo”,而是边收边推。关键在控制输出缓冲、设置正确 header,并防止超时中断。
立即学习“PHP免费学习笔记(深入)”;
- 启动前关闭默认输出缓冲:
if (ob_get_level()) ob_end_clean(); - 发送必要 header:
header('Content-Type: text/event-stream'); header('Cache-Control: no-cache'); header('X-Accel-Buffering: no'); - 每次收到一个 chunk,立即
echo "data: " . json_encode([...]) . "\n\n"; flush(); ob_flush(); - 配合
set_time_limit(0)和ignore_user_abort(true),防止用户网络抖动导致连接意外断开
加一层轻量治理:记录 token 与延迟
流式调用容易掩盖真实成本。建议在响应流结束时,补一条完成事件,附带本次消耗的 input/output tokens 和总耗时。
- 用
AiUsageMeter::record($model, $inputTokens, $outputTokens, $elapsedMs)记录到 Redis 或数据库 - 前端可通过监听
event: done类型的 SSE 事件,拿到最终统计信息用于 UI 展示或配额提醒 - 结合 Laravel 12.1 的新事件系统,触发
AiStreamCompleted事件,解耦日志、告警、计费等后续动作


















