类型映射必须严格按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 内存安全的核心铁律：

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) 才算成功。

Tags: PHP调用C动态库 PHP类型映射

分享到：