日本語
日本語
PHPのFFI（外部関数インターフェイス）関数により、C言語で関数を直接呼び出すことができ、PHPのアプリケーションシナリオを大幅に拡張できます。 ffi :: cdef（）を介して、c言語の関数宣言をPHPコードにマッピングできるため、基礎となる効率的な操作を実現できます。
ただし、 FFI :: cdef（）を使用する場合の一般的な問題は、Cタイプの宣言が実際のライブラリのタイプと一致しない場合、プログラムがクラッシュし、PHPプロセスを直接引き出すことさえあることです。この種のクラッシュは通常、デバッグするのが困難であり、特定の原因を検出するのは容易ではありません。
この記事では、例を組み合わせて、そのようなクラッシュにトラブルシューティングと対処方法を説明します。
ffi :: cdef（）は、次のようなc言語のタイプと関数の署名を定義するために使用されます。
<?php
$ffi = FFI::cdef("
int printf(const char *format, ...);
");
$ffi->printf("Hello, %s!\n", "world");
?>
このコードは、Cのprintf関数をPHPに宣言し、それを呼び出すことができます。
このようなCライブラリがあるとしますが、関数の署名は次のとおりです。
// C 言語関数宣言
void process_data(const char *data, size_t len);
PHPで定義すると、次のように書かれていました。
<?php
$ffi = FFI::cdef("
void process_data(const char *data, int len);
");
$ffi->process_data("example", 7);
?>
Cの2番目のパラメーターはSIZE_Tであり、これは署名されていない長い整数（通常はプラットフォームに応じて64ビットまたは32ビット）であり、 INTはPHPで記述されています。このタイプの不一致により、パラメーターを渡すときにデータが切り捨てられたり、誤って解釈されたりする可能性があり、最終的にはプログラムのクラッシュにつながります。
ffi :: cdef（）を使用する場合は、型宣言を完全に一貫性に保つために、公式ライブラリまたはサードパーティライブラリのヘッダーファイルを参照してください。次の一般的なデータ型に特に注意してください。
size_tは、php ffiのsize_tに対応し、誤ってintまたはunsigned intとして書くことはありません。
const char *など、ポインタータイプを正しく記述する必要があります。
構造宣言は正確に一致する必要があります。
PHP FFIはsize_tをサポートし、直接使用する必要があります。
<?php
$ffi = FFI::cdef("
void process_data(const char *data, size_t len);
");
?>
これにより、32/64ビットプラットフォームのタイプの不一致が回避されます。
可能であれば、手書きの宣言の代わりにCヘッダーの内容を直接ロードすると、エラーを減らすことができます。
<?php
$ffi = FFI::cdef(file_get_contents("your_lib.h"), "your_lib.so");
?>
StraceまたはGDBを使用して、PHPプロセスを追跡し、クラッシュポイントを見つけます。
Cヘッダーファイル宣言を簡素化し、テストコールを段階的にテストします。
さまざまなプラットフォーム（Linux/Windows/MacOS）のSIZE_Tおよびその他のタイプのサイズの違いに注意してください。
<?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（）のタイプ定義をチェックすることが優先されます。
