本文介绍在 C 程序中嵌入 PHP（启用 --enable-embed）时，如何准确捕获 php_execute_script() 的标准输出（如 echo、print 内容），而非仅依赖 stdout 重定向——后者在 PHP SAPI 嵌入模式下无效。核心方案是替换 php_embed_module.ub_write 回调函数或使用管道（pipe）机制。
本文介绍在 c 程序中嵌入 php（启用 `--enable-embed`）时，如何准确捕获 `php_execute_script()` 的标准输出（如 `echo`、`print` 内容），而非仅依赖 `stdout` 重定向——后者在 php sapi 嵌入模式下无效。核心方案是替换 `php_embed_module.ub_write` 回调函数或使用管道（pipe）机制。
在 PHP 嵌入式（SAPI embed）环境中，php_execute_script() 并不直接写入 stdout，而是通过 PHP 内部的“用户缓冲写入器”（ub_write）将输出传递给 SAPI 层。因此，简单调用 setbuf(stdout, ...) 或 freopen(...) 无法捕获其输出——这是初学者常遇的关键误区。
✅ 推荐方案：自定义 ub_write 回调（轻量、可控）
PHP 提供了 php_embed_module.ub_write 函数指针，允许你注册一个自定义回调，在每次 PHP 输出（如 echo "hello";）时被调用。这是最直接、跨平台且无需系统级 I/O 操作的方案：
#include <sapi>
#include <stdio.h>
#include <stdlib.h>
#include <string.h>
// 全局缓冲区：存储每段输出字符串的副本（注意内存管理）
#define MAX_OUTPUT_CHUNKS 1024
static char *output_chunks[MAX_OUTPUT_CHUNKS];
static size_t output_lengths[MAX_OUTPUT_CHUNKS];
static int chunk_count = 0;
// ub_write 回调：接收 PHP 输出的原始字节流
static size_t capture_ub_write(const char *str, size_t str_length) {
if (chunk_count >= MAX_OUTPUT_CHUNKS || str == NULL || str_length == 0) {
return 0;
}
// 深拷贝字符串（避免生命周期问题：str 可能为栈/临时内存）
char *copy = malloc(str_length + 1);
if (!copy) return 0;
memcpy(copy, str, str_length);
copy[str_length] = '\0';
output_chunks[chunk_count] = copy;
output_lengths[chunk_count] = str_length;
chunk_count++;
return str_length; // 必须返回实际写入字节数
}
int main(int argc, char **argv) {
// 关键：在启动 PHP 前设置自定义 ub_write
php_embed_module.ub_write = capture_ub_write;
PHP_EMBED_START_BLOCK(argc, argv)
zend_file_handle file_handle;
zend_stream_init_filename(&file_handle, "say.php");
if (php_execute_script(&file_handle) == FAILURE) {
php_printf("Failed to execute PHP script.\n");
}
// 合并所有输出片段为完整字符串（可选）
size_t total_len = 0;
for (int i = 0; i <blockquote>
<p>⚠️ 注意事项：</p>
<ul>
<li>
<code>ub_write</code> 的 <code>str</code> 参数<strong>不是以 <code>\0</code> 结尾的 C 字符串</strong>，其长度由 <code>str_length</code> 明确给出，务必按此拷贝，不可直接 <code>strlen()</code> 或 <code>strcpy()</code>。</li>
<li>回调中必须深拷贝数据（<code>malloc + memcpy</code>），因为 <code>str</code> 的生命周期仅限于本次回调；后续访问原指针将导致未定义行为。</li>
<li>
<code>ub_write</code> 是线程安全的（单线程嵌入场景下无需额外同步），但需确保全局缓冲区（如 <code>output_chunks</code>）容量充足。</li>
</ul>
</blockquote>
<h3>? 替代方案：使用 <code>pipe()</code> 重定向（更通用，适合复杂场景）</h3>
<p>若需兼容性更强或需捕获 <code>var_dump()</code>、错误信息等更完整的 SAPI 输出，可结合 <code>pipe()</code> + <code>dup2()</code> 将 PHP 的 <code>stdout</code>/<code>stderr</code> 重定向至内存管道：</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>
<pre class="brush:php;toolbar:false;">#include <unistd.h>
#include <sys>
// （在 PHP_EMBED_START_BLOCK 前）创建管道
int pipefd[2];
if (pipe(pipefd) == -1) {
perror("pipe");
return 1;
}
dup2(pipefd[1], STDOUT_FILENO); // 重定向 stdout 到写端
close(pipefd[1]);
// 执行 php_execute_script(...) 后...
close(pipefd[0]); // 关闭读端（否则 read 阻塞）
// 此处需另起线程或 fork 子进程读取 pipefd[0] —— 实际嵌入中较繁琐，略去细节</sys></unistd.h>
该方式更底层，但增加了 POSIX 依赖与资源管理复杂度，推荐仅在 ub_write 不满足需求时采用。
✅ 总结
- ❌
setbuf(stdout, ...)对php_execute_script()无效：PHP SAPI 嵌入模式绕过 libc stdio。 - ✅ 正确入口是
php_embed_module.ub_write：它是 PHP 输出的唯一可控钩子。 - ✅ 务必深拷贝
ub_write的输入数据，并妥善管理内存。 - ✅ 编译时需链接
-lphp7（或对应版本）并确保 PHP 以--enable-embed=shared构建。
掌握 ub_write 机制，即可在 C 中实现对嵌入式 PHP 脚本输出的精确捕获与双向通信。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
