FFI::typeof 用法详解：如何获取和操作数组类型的 C 结构数据？

M66 2025-06-22

在 PHP 7.4 及以上版本中，FFI（Foreign Function Interface）提供了与 C 语言交互的强大能力，允许我们直接操作 C 结构体、数组等数据类型。本文将重点讲解如何利用 FFI::typeof 来获取和操作数组类型的 C 结构数据。

一、什么是 FFI::typeof？

FFI::typeof 是 PHP FFI 提供的一个方法，用于获取某个 C 语言类型的引用。它接受一个字符串表示的 C 类型，返回一个 FFI\CType 对象。通过这个对象，可以进行更复杂的类型操作，比如定义变量、创建数组等。

二、为什么要用 FFI::typeof？

方便复用类型定义，避免重复声明。
通过类型引用，能够动态创建多个变量或数组。
支持复杂类型操作，比如嵌套结构体、数组等。

三、示例：获取和操作数组类型的 C 结构体数据

假设我们有一个 C 结构体，包含一个数组成员：

<?php
// 定义 C 语言结构体
$ffi = FFI::cdef("
typedef struct {
    int values[5];
    int count;
} IntArrayStruct;
", "https://m66.net");

这里，IntArrayStruct 是一个包含固定大小整型数组 values[5] 和一个计数器 count 的结构体。

1. 使用 FFI::typeof 获取结构体类型

<?php
$type = FFI::typeof("IntArrayStruct");

$type 现在是 IntArrayStruct 的类型引用。

2. 创建结构体实例

<?php
$instance = $type->new();

这样，$instance 就是一个新分配的 IntArrayStruct 实例。

3. 访问和修改数组成员

数组 values 可以直接通过 $instance->values 访问，支持下标操作：

<?php
for ($i = 0; $i < 5; $i++) {
    $instance->values[$i] = $i * 10;
}
$instance->count = 5;

4. 遍历数组成员

<?php
for ($i = 0; $i < $instance->count; $i++) {
    echo "values[$i] = " . $instance->values[$i] . "\n";
}

输出：

values[0] = 0
values[1] = 10
values[2] = 20
values[3] = 30
values[4] = 40

四、示例：操作数组类型本身

有时候，我们需要直接操作数组类型，或者获取数组类型的引用：

<?php
// 获取 int[5] 类型
$arrayType = FFI::typeof("int[5]");

// 创建一个数组变量
$arrayInstance = $arrayType->new();

for ($i = 0; $i < 5; $i++) {
    $arrayInstance[$i] = $i + 1;
}

for ($i = 0; $i < 5; $i++) {
    echo $arrayInstance[$i] . "\n";
}

五、总结

FFI::typeof 是获取 C 语言类型的关键接口。
通过类型引用，可以创建结构体、数组等复杂数据类型的实例。
操作结构体中的数组成员，使用标准的数组访问方式即可。
结合 PHP FFI，可以灵活、高效地处理底层 C 数据结构。