本文详解如何在 C 程序中通过 PHP 嵌入式 SAPI 捕获 php_execute_script() 的标准输出，而非仅打印到控制台；核心方法是重写 ub_write 回调函数或使用管道（pipe）重定向 stdout。
本文详解如何在 c 程序中通过 php 嵌入式 sapi 捕获 `php_execute_script()` 的标准输出，而非仅打印到控制台；核心方法是重写 `ub_write` 回调函数或使用管道（pipe）重定向 stdout。
在 PHP 嵌入式开发（--enable-embed 编译）中，php_execute_script() 默认将脚本输出（如 echo、print）直接发送至 SAPI 层的输出缓冲器（output buffer），而非标准 C 的 stdout 流。因此，简单调用 setbuf(stdout, ...) 无效——因为 PHP 并未经过 libc 的 stdout 接口，而是绕过它，直接调用其内部 ub_write 函数指针写入。
✅ 正确方案一：自定义 ub_write 回调（推荐、轻量、可控）
PHP SAPI 提供了可替换的输出写入钩子：php_embed_module.ub_write。你需要在调用 PHP_EMBED_START_BLOCK 前，将其指向一个自定义函数，该函数接收原始字节流并存入你管理的缓冲区：
#include <sapi>
#include <stdio.h>
#include <stdlib.h>
#include <string.h>
// 全局动态缓冲区（示例用固定大小，生产环境建议 malloc + realloc）
#define BUFFER_SIZE 65536
static char output_buffer[BUFFER_SIZE];
static size_t output_len = 0;
// ub_write 回调：每次 PHP 输出时被调用
static size_t capture_ub_write(const char *str, size_t str_length) {
if (!str || str_length == 0) return 0;
size_t remaining = BUFFER_SIZE - output_len;
size_t to_copy = (str_length <blockquote>
<p>⚠️ 注意事项：</p><div class="aritcle_card flexRow artxards">
<div class="artcardd flexRow">
<a class="aritcle_card_img" rel="nofollow" href="/xiazai/skill5233" title="btpanel phpsite 宝塔面板PHP网站"><img
src="https://img.php.cn/upload/skill/000/000/081/179040786932301.jpg" alt="btpanel phpsite 宝塔面板PHP网站" onerror="this.onerror='';this.src='/static/lhimages/moren/morentu.png'" ></a>
<div class="aritcle_card_info flexColumn">
<a rel="nofollow" href="/xiazai/skill5233" title="btpanel phpsite 宝塔面板PHP网站" class="overflowclass">btpanel phpsite 宝塔面板PHP网站</a>
<p class="overflowclass">宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理</p>
</div>
<a rel="nofollow" href="/xiazai/skill5233" title="btpanel phpsite 宝塔面板PHP网站" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span>
</a>
</div>
</div>
<ul>
<li>
<code>ub_write</code> 是<strong>逐段回调</strong>（可能多次调用），不可假设单次传入完整输出；</li>
<li>必须在 <code>PHP_EMBED_START_BLOCK</code> 之前赋值 <code>php_embed_module.ub_write</code>，否则无效；</li>
<li>
<code>ub_write</code> 返回值必须为实际处理的字节数，否则可能导致 SAPI 行为异常；</li>
<li>若需线程安全或多脚本隔离，请将缓冲区改为 per-request 局部变量（配合 <code>php_request_startup()</code>/<code>shutdown</code> 生命周期管理）。</li>
</ul>
</blockquote>
<h3>✅ 方案二：使用 Unix pipe 重定向 stdout（兼容性强，但平台受限）</h3>
<p>若你更倾向标准 I/O 重定向（例如在 Linux/macOS 上），可通过 <code>pipe()</code> + <code>dup2()</code> 将 <code>stdout</code> 替换为管道写端，并在另一线程或 <code>fork()</code> 后读取：</p>
<pre class="brush:php;toolbar:false;">#include <unistd.h>
#include <sys>
// …（其他头文件同上）
int main(int argc, char **argv) {
int pipefd[2];
if (pipe(pipefd) == -1) {
perror("pipe");
return 1;
}
// 将 stdout 重定向到 pipe 写端
dup2(pipefd[1], STDOUT_FILENO);
close(pipefd[1]);
PHP_EMBED_START_BLOCK(argc, argv)
// ... 执行脚本
PHP_EMBED_END_BLOCK()
close(STDOUT_FILENO); // 关闭写端，触发 EOF
// 读取管道内容
char buf[4096];
ssize_t n;
output_len = 0;
while ((n = read(pipefd[0], buf, sizeof(buf)-1)) > 0) {
if (output_len + n <blockquote><p>✅ 优势：无需修改 PHP 内部逻辑，完全复用标准流语义；<br>
❌ 局限：Windows 不支持 <code>pipe</code>/<code>dup2</code>（需 <code>_pipe</code>/<code>_dup2</code>），且多线程下 stdout 重定向易引发竞态。</p></blockquote>
<h3>总结</h3>
<ul>
<li>
<code>php_execute_script()</code> 不走 <code>stdout</code>，因此 <code>setbuf</code>、<code>freopen</code> 等 libc 方法均无效；</li>
<li>
<strong>首选 <code>ub_write</code> 回调机制</strong>：精准、高效、跨平台，是 PHP SAPI 设计的官方扩展点；</li>
<li>
<code>pipe</code> 方案适合快速原型或已有 stdout 依赖逻辑，但需注意平台与并发安全性；</li>
<li>实际项目中，建议封装为 <code>php_capture_script(const char* path, char** out, size_t* len)</code> 工具函数，统一管理内存与错误。</li>
</ul>
<p>通过上述任一方式，你即可可靠地将 PHP 脚本输出捕获为 C 字符串，实现 C 与嵌入式 PHP 的双向数据通信。</p></sys></unistd.h>php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
