PHP FFI性能关键在于预加载避免重复解析，需严格匹配作用域、手动管理非托管内存，并确保C声明完整准确，否则易崩溃。
PHP 使用 FFI 调用 C 库，核心不是“能不能调”，而是“怎么避免每次请求都重解析定义 + 重复加载 so/dll”。FFI 的开销主要在 FFI::cdef() 和 FFI::load() 阶段，而不是后续调用。Web 场景下若不预加载，性能会断崖式下跌。
FFI::cdef() 加载 libc.so.6 却报错 undefined symbol
常见错误是只声明函数，但没提供完整签名或类型别名。比如写 "int printf(const char *format, ...);" 看似没问题，但某些 libc 版本要求显式包含 stdarg.h 相关约定 —— FFI 不处理头文件，只认纯 C 声明。
实操建议：
- 优先从系统头文件中复制粘贴声明（如
/usr/include/stdio.h中的printf原型），删掉宏、#include、注释，保留纯函数签名 - 若用
...，必须确保目标库 ABI 支持可变参数（libc.so.6支持，但自定义 so 可能不支持） - 字符串字面量传入时，要用
FFI::string()或手动分配内存，不能直接传 PHP 字符串变量（它不是 C 字符串） - 示例修正：
$ffi = FFI::cdef(" int printf(const char *format, ...); int strlen(const char *s); ", "libc.so.6");
FFI::load() 预加载头文件后，FFI::scope() 找不到函数
这是作用域（scope）未对齐的典型表现。预加载时 header 文件里必须有 #define FFI_SCOPE "mylib"，而运行时调用 FFI::scope("mylib") 才能拿到绑定；默认 scope 是 "C"，但 FFI::load() 不会自动注册到该 scope，除非 header 显式声明。
实操建议：
- 头文件开头加
#define FFI_SCOPE "mymath"，保存为mymath.h - PHP 启动时（如 opcache.preload）调用
FFI::load("mymath.h") - 请求中用
$ffi = FFI::scope("mymath")获取实例，再调$ffi->pow(2, 3) - 多个头文件可共用同一 scope，但不得有重复符号（否则预加载失败）
传递结构体指针给 C 函数时 segfault
根本原因是 PHP 创建的 FFI\CData 实例默认是“owned”（由 PHP 管理生命周期），但 C 函数可能长期持有该指针，而 PHP 请求结束就回收内存 —— 下次访问就是野指针。
实操建议：
- 用
FFI::new('struct my_s', false, true)：第二个参数false表示不 owned（不自动 free），第三个参数true表示 persistent（跨请求存活） - 结构体字段赋值必须用
->field，不能用数组语法；数组字段才用[$i] - 不要对 struct 指针做
clone或unset()——FFI\CData不支持unset() - 示例：
$s = FFI::new('struct { int a; char b[10]; }', false, true); $s->a = 42; FFI::memcpy($s->b, FFI::string("hello"), 6);
FFI::new() 分配的内存没释放，导致 OOM
FFI 默认分配的内存由 PHP GC 管理，但仅限于 $owned = true（默认）。一旦设为 false，就必须手动调 FFI::free()，否则永不释放 —— 尤其在 CLI 长进程或 Swoole Worker 中极易堆积。
实操建议：
- 只在必要时设
$owned = false（如需跨函数传递、C 层缓存指针） - 与
FFI::free()配对使用，且确保只 free 一次（重复 free 会 crash） - 用
FFI::isNull()判断是否已空，避免误操作 - 注意：PHP 8.3+ 支持将
FFI\CData直接赋给 struct 字段，但不改变内存所有权规则
FFI 最容易被忽略的点，是它不提供任何运行时类型安全检查 —— 函数签名写错、指针越界、结构体对齐偏差，都会直接 crash，而不是抛 Exception。调试时优先用 var_dump($cdata) 看地址和类型，再结合 FFI::typeof() 和 FFI::sizeof() 核验尺寸，比靠猜快得多。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
