PHP 拡張関数のパラメーター型バインディングの作成-PHPチュートリアル-php.cn

PHP 拡張関数のパラメーター型バインディングの作成

巴扎黑

リリース： 2023-03-03 12:26:01

オリジナル

1514 人が閲覧しました

それを介してタイプバインディングを実装する方法を見てみましょう。ただし、この機能は Zend Engine 2、つまり PHP5 でのみ使用できます。 ZE2 の引数情報構造をもう一度見直してみましょう。各 arg info 構造体の宣言は ZEND_BEGIN_ARG_INFO() または ZEND_BEGIN_ARG_INFO_EX() マクロ関数で始まり、数行の ZEND_ARG_*INFO() マクロ関数が続き、最後に ZEND_END_ARG_INFO() マクロ関数で終わります。 count() 関数を PHP 言語で書き換えたい場合は、次のようにすることができます:
ZEND_FUNCTION(sample_count_array)
{
zval *arr;
if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "a",&arr) == FAILURE)
{
を使用してRETURN_LONG(zend_hash_num_elements(Z_ARRVAL_P(arr)));
}
zend_parse_parameters() 自体は、渡されたパラメーターが配列であることを保証できます。しかし、zend_get_parameter() 関数を通じてパラメータを受け取った場合は、それほど幸運ではないため、自分で型チェックを実行する必要があります。カーネルに型検証を自動的に完了させたい場合は、arg_info を使用する必要があります: ZEND_BEGIN_ARG_INFO(php_sample_array_arginfo, 0) ZEND_ARG_ARRAY_INFO(0, arr, 0) ZEND_END_ARG_INFO()

....
PHP_FE(sample_count_array, php_sample_array_ arginfo)
。 ..
こうして、活字校正作業をZend Engineに引き継いだので、一安心ですね！また、API を使用しようとするスクリプト作成者にとって、生成されたエラーメッセージがより意味のあるものになるように、引数に名前を付けています。また、引数内のオブジェクトを検証して、特定のクラスまたは実装から継承しているかどうかを制限することもできます。インターフェースなど。
ZEND_BEGIN_ARG_INFO(php_sample_class_arginfo, 0)
ZEND_ARG_OBJ_INFO(1, obj, stdClass, 0)
ZEND_END_ARG_INFO()
このときの最初のパラメータの値は数値の 1 であることに注意してください。これは、参照によって渡されることを意味します。実際、ZE2 のすべてのオブジェクトは、関数パラメーターとして使用される場合、デフォルトで参照によって渡されるため、このパラメーターはオブジェクトにはほとんど役に立ちません。ただし、拡張機能に PHP4 との互換性を持たせたくない場合を除き、このパラメータを数値 1 に設定する必要があります。 PHP4 では、オブジェクトは参照ではなく完全なコピーとして渡されます。

配列およびオブジェクトのパラメーターについては、NULL を許可する最後のパラメーターを忘れないでください。詳細については、第 6 章の最後のセクションの説明を参照してください。
引数情報による型バインディングの機能は、PHP5+ である ZE2 でのみ有効です。対応する関数を PHP4 で実装したい場合は、zend_get_parameters() 関数を使用してパラメータを受け取り、Z_TYPE_P() マクロ関数を使用してパラメータの型を検出するか、convert_to_type() 関数を使用して型を実行する必要があります。変換。