FFI::load()函式—用法及示例

函式名稱：FFI::load()

適用版本：PHP 7.4及以上版本

功能描述：FFI::load()函式用於載入並解析C語言的標頭檔案，以便在PHP中使用C函式和變數。

用法：

1. 簡單載入：

   $ffi = FFI::load('header.h');
   

   這將載入名為"header.h"的C標頭檔案，並返回一個FFI物件，該物件包含了C函式和變數的定義。

2. 指定編譯選項：

   $ffi = FFI::load('header.h', '-I/usr/include -L/usr/lib -lmylib');
   

   在載入標頭檔案的同時，可以透過第二個引數指定編譯選項。上述示例中，"-I/usr/include"指定了包含檔案的搜尋路徑，"-L/usr/lib"指定了庫檔案的搜尋路徑，"-lmylib"指定了要連結的庫檔案。

3. 自定義型別對映：

   $ffi = FFI::load('header.h');
   $ffi->type('int32_t'); // 自定義型別對映
   

   透過呼叫FFI物件的type()方法，可以自定義C型別到PHP型別的對映。上述示例中，將int32_t型別對映為PHP的整數型別。

示例：

假設有一個名為"header.h"的C標頭檔案，其中包含了一個add()函式的宣告：

int add(int a, int b);

在PHP中使用FFI::load()函式載入並呼叫這個函式的示例：

$ffi = FFI::load('header.h');
$result = $ffi->add(2, 3);
echo $result; // 輸出：5

上述示例中，首先使用FFI::load()函式載入了"header.h"標頭檔案，然後透過$ffi物件呼叫了add()函式，並將結果輸出。

注意事項：

1. FFI擴充套件在PHP 7.4中作為實驗性功能引入，需要在編譯PHP時啟用。在較早的版本中可能不可用。
2. FFI::load()函式依賴於libffi庫，因此需要確保系統中已安裝了該庫。
3. 在載入標頭檔案時，可以使用相對或絕對路徑。如果使用相對路徑，將相對於當前指令碼的工作目錄進行解析。