使用 FFI::cdef 时 C 类型声明不一致导致的崩溃问题

PHP 的 FFI（Foreign Function Interface）功能让我们能够直接调用 C 语言的函数，极大地拓展了 PHP 的应用场景。通过 FFI::cdef()，我们可以将 C 语言的函数声明映射到 PHP 代码中，从而实现底层高效的操作。

然而，使用 FFI::cdef() 时一个常见的问题是：如果 C 类型声明与实际库中的类型不一致，程序很可能会崩溃，甚至直接导致 PHP 进程挂掉。这种崩溃通常难以调试，也不容易察觉具体原因。

本文将结合示例，说明当你遇到这类崩溃时如何排查和处理。

1. FFI::cdef 简单回顾

FFI::cdef() 用来定义 C 语言的类型和函数签名，比如：

<?php
$ffi = FFI::cdef("
    int printf(const char *format, ...);
");
$ffi->printf("Hello, %s!\n", "world");
?>

这段代码将 C 的 printf 函数声明给 PHP，进而可以调用它。

2. 崩溃示例及根因

假设你有这样一个 C 库，函数签名如下：

// C 语言函数声明
void process_data(const char *data, size_t len);

你在 PHP 中用 FFI 定义时写成了：

<?php
$ffi = FFI::cdef("
    void process_data(const char *data, int len);
");
$ffi->process_data("example", 7);
?>

注意这里，C 语言的第二个参数是 size_t，它是无符号长整型（通常是 64 位或 32 位，取决于平台），而 PHP 里写成了 int。这种类型不匹配可能导致传递参数时数据被截断或错误解释，最终导致程序崩溃。

3. 如何避免和修复

（1）确认 C 头文件类型

在使用 FFI::cdef() 时，务必参考官方或第三方库的头文件，保持类型声明完全一致。尤其要注意以下常见数据类型：

• size_t 对应 PHP FFI 中的 size_t，不要误写成 int 或 unsigned int。

• 指针类型必须写对，比如 const char *。

• 结构体声明必须完全匹配。

（2）使用 size_t 类型

PHP FFI 支持 size_t，应直接使用：

<?php
$ffi = FFI::cdef("
    void process_data(const char *data, size_t len);
");
?>

这可以避免 32/64 位平台上的类型不匹配。

（3）使用 FFI 自带的头文件映射

如果可能，直接加载 C 头文件内容，而不是手写声明，可以减少错误：

<?php
$ffi = FFI::cdef(file_get_contents("your_lib.h"), "your_lib.so");
?>

4. 调试建议

• 使用 strace 或 gdb 跟踪 PHP 进程，定位崩溃点。

• 简化 C 头文件声明，逐步测试调用。

• 注意不同平台（Linux/Windows/macOS）上 size_t 和其他类型大小的差异。

5. 示例修正后的代码

<?php
$ffi = FFI::cdef("
    void process_data(const char *data, size_t len);
");

$data = "example";
$ffi->process_data($data, strlen($data));
?>

这样即可避免类型不一致引发的崩溃。

总结：PHP FFI 功能强大，但需确保 C 类型声明完全一致，尤其是整型和指针类型的对应关系。遇到崩溃，优先检查 FFI::cdef() 中的类型定义，避免因类型不匹配导致的运行时错误。