PHP FFI 是真实可用的性能优化手段，需正确配置启用、验证系统库调用、严格遵循C内存规则、预加载头文件以避免运行时开销。
直接用 PHP 调 C 函数不是噱头，而是真实可用的性能破局手段——前提是别把 FFI 当成“胶水”，得按 C 的规则来写、按内存的逻辑来管。
FFI 不是开关，是配置项+编译支持双到位
PHP 7.4+ 自带 FFI，但默认只在 CLI 下 preload 启用，Web 环境（如 Nginx + PHP-FPM）必须显式放开：
- 确认 php.ini 中有 extension=ffi（取消注释）
- 设 ffi.enable = true（不能留默认的 "preload"）
- Docker 或 Alpine 镜像需额外安装 libffi-dev，并编译时加 --enable-ffi
- 验证：运行
php -r "var_dump(FFI::cdef('int getpid();')->getpid());"，返回正整数才算通
调系统库先跑通，再碰自定义 so/dll
别一上来就编译自己的 C 库。先用 libc 或 msvcrt 验证基础链路：
- Linux 下声明
"int strlen(const char *s);"，加载"libc.so.6" - Windows 下声明
"int MessageBoxA(void*, char*, char*, int);"，加载"user32.dll" - 注意 const、指针符号、调用约定（如 __stdcall）必须与实际 ABI 一致
- 报错优先查：库文件路径是否正确、架构是否匹配（x86_64 PHP 不能 load x86 DLL）、权限是否可读
结构体和内存操作，最容易踩坑
FFI 操作的是裸内存，PHP 变量赋值不等于内存拷贝：
立即学习“PHP免费学习笔记（深入）”；
-
$c = FFI::new("int[8]"); $copy = $c;—— 这只是复制 PHP 对象引用，不是 memcpy - 真正复制要用
$ffi->memcpy($dest, $src, FFI::sizeof($src)) - 传结构体进函数时，必须用
FFI::addr($struct)传地址，而非直接传结构体变量 - 动态分配内存（如
malloc）后，记得用FFI::free()释放，否则泄漏
生产环境别每次请求都 cdef，预加载才是关键
FFI 解析头文件、加载 so 是重操作，不能放进 HTTP 请求循环里：
- 把 C 函数声明写进 .h 文件，顶部加
#define FFI_SCOPE "math" - 在 opcache.preload.php 中调用
FFI::load("math.h") - 请求中用
FFI::scope("math")获取已预加载的绑定，毫秒级复用 - 配合 OPcache + preloading，能避免 90% 以上的初始化开销
