类型映射必须严格按C ABI对齐，FFI不做类型推导或运行时校验；PHP int↔C int、string↔const char*、float/double↔对应C类型、bool↔_Bool，结构体需显式声明字段与对齐，内存分配方负责释放，动态库路径须适配系统libc命名及架构。
类型映射必须严格按 C ABI 对齐
FFI 不做类型推导或运行时校验，声明与实际函数签名不一致会导致静默错误、崩溃或数据截断。常见映射关系如下：
-
PHP int ↔ C
int（注意：不是long或int32_t，除非显式指定） -
PHP string ↔ C
const char *（传入需为 null-terminated 字节数组；输出若为指针，需手动转为 PHP 字符串） -
PHP float/double ↔ C
float/double（混用会丢失精度或触发未定义行为） -
PHP bool ↔ C
_Bool或bool（int不能直接当 bool 用，0/1 外值可能被误判） -
结构体：需完整声明字段顺序、类型及对齐（如
__attribute__((packed))影响必须体现）
动态库路径与系统兼容性要明确
不同系统默认 libc 名称不同，硬编码会失败：
- Linux：常用
libc.so.6、libm.so.6 - macOS：对应
libc.dylib、libm.dylib（注意 SIP 限制可能阻止加载非系统路径 dylib） - Windows：
msvcrt.dll或自编译的.dll，且需确保依赖项（如 VC++ 运行时）已就位
自定义库建议用绝对路径，并确认权限（chmod +x）和架构匹配（x86_64 vs aarch64）。
内存分配方决定释放责任
谁分配、谁释放——这是 FFI 内存安全的核心铁律：
立即学习“PHP免费学习笔记（深入）”；
- C 分配（如
malloc、Rust 的Box::into_raw）→ 必须由 C/Rust 提供释放函数，PHP 调用后显式释放 - PHP 分配（如
$ffi->new('int[10]')）→ 默认由 PHP 自动管理；若设$owned = false，则需自行调用FFI::free() - 返回裸指针的函数（如 Rust 示例中
process_data），PHP 端必须配套调用释放函数，否则必然泄漏
示例释放流程：
$ptr = $ffi->process_data($input_ptr, $len); $result = FFI::string($ptr); // 复制内容 $ffi->free_result($ptr); // 调用 C/Rust 提供的释放函数
Web 环境下 ffi.enable 配置极易踩坑
PHP-FPM 或 Apache 模式下，ffi.enable = preload（默认值）完全无效，且不报错：
- 必须在
php.ini中显式设置ffi.enable = true - 改完后重启 PHP 进程（
systemctl restart php-fpm），不是重启 Nginx/Apache - 验证方式：
var_dump(FFI::cdef('int getpid();', 'libc.so.6')->getpid() > 0);返回bool(true)才算成功
