PHP处理Devin进度监控机制【技巧】-php教程-PHP中文网

devin进度监控需通过http长轮询或sse消费其外部api流，php须用curl或socket逐块接收、按\n\n分割事件、提取并清洗data字段后json解析，同时处理超时、重连、事件类型及前端协同。

php处理devin进度监控机制【技巧】

Devin进度监控不是PHP原生能力，得靠HTTP长轮询或SSE模拟

PHP本身没有内置的“Devin进度监控”机制——Devin是AI编程代理（如Cognition Labs推出的工具），它执行任务时会通过HTTP接口暴露实时日志流。PHP端若想接入其进度，只能作为客户端去消费这些流，而不是在PHP里“实现”一个Devin。

常见错误是试图用 exec() 启动Devin CLI后直接读取stdout，结果卡死或漏掉早期日志，因为Devin输出是非阻塞、分块、带事件标记的JSON流（类似{"event":"step_start","data":{"step":"installing_deps"}}）。

必须用 stream_socket_client() 或 curl_init() 配合 CURLOPT_WRITEFUNCTION 逐块接收，不能依赖 file_get_contents()
Devin的进度接口通常要求 Accept: text/event-stream，PHP cURL需显式设置，否则返回406
响应头含 Cache-Control: no-cache 和 Connection: keep-alive，PHP端要禁用cURL的自动重定向和缓存（CURLOPT_FOLLOWLOCATION = false, CURLOPT_CACHE_TIMEOUT = 0）

解析Devin的SSE响应时，别直接json_decode整行

Devin返回的SSE流格式是标准的 event: log\n data: {...}\n\n，但它的 data 字段值可能跨多行（比如堆栈跟踪），也可能包含未转义换行符。直接对每行做 json_decode(trim($line)) 会失败。

正确做法是按双换行（\n\n）切分事件块，再提取 data: 后的内容，最后用 json_decode(str_replace("\n", "", $raw_data), true) 清洗后再解析。

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

示例关键片段：

$buf = '';<br>curl_setopt($ch, CURLOPT_WRITEFUNCTION, function($ch, $data) use (&$buf) {<br>    $buf .= $data;<br>    $parts = explode("\n\n", $buf);<br>    $buf = array_pop($parts); // 保留不完整块<br>    foreach ($parts as $part) {<br>        if (preg_match('/^data:\s*(.+)$/m', $part, $m)) {<br>            $json = json_decode(str_replace("\n", "", $m[1]), true);<br>            if ($json && isset($json['event'])) {<br>                echo "Step: {$json['event']}\n";<br>            }<br>        }<br>    }<br>    return strlen($data);<br>});

注意：Devin有时会在同一事件中发多个 data: 行（比如拆分大日志），需合并所有匹配到的 data: 内容再解析

超时与重连必须自己管，Devin不会等PHP

Devin任务可能持续数分钟，而PHP默认的 max_execution_time 是30秒，default_socket_timeout 通常为60秒。一旦超时，连接断开，PHP进程终止，进度就永远丢失。

用 set_time_limit(0) 解除脚本时间限制，但别忘了用户浏览器端也有超时（Nginx默认60秒，需调 proxy_read_timeout）
Devin接口不保证永久可用，需在断连后按指数退避重试（如1s → 2s → 4s），并记录最后成功接收的 id（如果SSE带id:字段）用于断点续传
不要在CLI模式下长期运行PHP监听——它无法优雅处理SIGTERM；更适合用短生命周期请求+前端轮询状态API（如 /api/task/{id}/status）替代长连接