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 數據結構。