php 8.0 ffi 调用失败主因有三：ffi 扩展未启用（需 php.ini 设 ffi.enable=true）、c 符号不可见（须用 nm/dumpbin 验证导出）、类型声明错位（结构体对齐、char* 内存管理、回调签名等须严格匹配 c abi）。
PHP 8.0 的 FFI 扩展不是“装完就能调”，它卡在三个硬性环节：扩展未启用、C 符号不可见、类型声明错位——任一失败都会静默崩溃或段错误，而不是报出明确提示。
确认 FFI 扩展已启用且生效
FFI 在 PHP 8.0+ 默认编译进内核，但ffi.enable默认值是"preload"，仅允许 CLI 模式下预加载，Web SAPI（如 Apache/FPM）直接禁用。不改配置就写FFI::cdef()，会抛FFI\Exception或直接 Fatal error。
- 运行
php -i | grep ffi.enable，输出必须是ffi.enable => true；若为preload或空，需在php.ini中显式设为ffi.enable = true并重启 PHP 进程 - CLI 下验证：
php -r "var_dump(extension_loaded('ffi'));"返回true才算真正加载成功 - Web 环境务必检查 SAPI 类型：
php_sapi_name()是fpm-fcgi还是apache2handler，不能只信 CLI 结果
确保 C 函数符号在动态库中真实可导出
FFI::load() 成功不代表函数能调——它只做 dlopen，不校验符号。常见现象是Call to undefined method或Segmentation fault，根源往往是符号被编译器优化掉、C++ mangling 或 ABI 不匹配。
- Linux/macOS：用
nm -D /path/to/lib.so | grep your_func确认符号存在且为大写T（全局文本段）；若无输出，检查是否加了static或忘了extern "C" - Windows：用
dumpbin /exports your.dll，确保函数名在导出列表里；DLL 必须用__declspec(dllexport)或.def文件导出 - 结构体/函数若来自 C++ 代码，必须用
extern "C"包裹声明，否则nm看到的是_Z9add_intsii这类乱码，FFI 解析失败 - 编译共享库时加
-fPIC -shared（Linux/macOS）或/DLL /EXPORT:（Windows），避免地址重定位失败
FFI::cdef() 中类型声明必须与 C ABI 严格对齐
FFI 不做类型推导，int*写成int、char*当成 PHP string 传，轻则读到垃圾值，重则踩内存越界。尤其结构体字段偏移错一位，整个对象就废。
-
char*用于输入字符串：先$buf = FFI::new('char[256]');，再FFI::memcpy($buf, $php_string, strlen($php_string));，最后传$buf->getAddress() -
char*用于输出缓冲区：C 函数必须已分配好内存（如char out[128]），PHP 侧用FFI::string($ptr, $len)安全读取，别直接(string)$ptr - 结构体必须显式声明对齐：
struct __attribute__((packed)) my_struct { int a; char b[3]; };，否则 PHP 默认按 8 字节对齐，和 C 端sizeof不一致 - 回调函数必须用
FFI::callback()包装，签名含const、指针层级、返回类型，缺一不可；例如int (*cb)(const char*, int*)，PHP 回调就必须声明function(string $s, FFI\CData $i_ptr): int
调用后 errno 和错误处理不能依赖自动同步
C 函数失败时设errno，但 PHP FFI 层不会自动捕获或保留它。你看到open()返回-1却查不到原因，大概率是errno已被中间某次系统调用覆盖。
- 每次调用可能出错的 C 函数后，**立刻**读取：
$errno = FFI::cdef('int errno;', 'libc.so.6')->errno;（Linux）或'libc.dylib'（macOS） - 不要复用同一个
FFI::cdef()对象读errno——它每次创建新实例，应封装成工具函数复用 -
errno只在函数返回错误值（如-1、NULL）时有效；成功调用后它的值是上一次残留，不能直接判断 - 涉及内存分配的函数（如
malloc、自定义create_*），务必检查返回指针是否为NULL，再决定是否继续访问字段
最易被忽略的是结构体内存对齐和errno读取时机——它们不报错，但会让结果随机错乱，调试时极难定位。宁可多花两分钟用readelf -Ws核对符号，也不要凭头文件直觉写cdef字符串。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
