Detaillierte Erläuterung von Beispielen für die Übergabe von Parametern und den Erhalt von Parametern in der Erweiterungsfunktion der PHP-Erweiterung

Vorwort

Nachdem ich im vorherigen Artikel das Erweiterungsframework der PHP-Erweiterung automatisch generiert habe, kann ich sagen, dass ich ein gewisses Verständnis für das PHP-Erweiterungsframework habe Wie man PHP-Erweiterungen schreibt und was die wichtigsten Punkte sind, aber der Schlüssel liegt darin, wie man die PHP_FUNCTION-Funktion schreibt.
In diesem Artikel wird hauptsächlich beschrieben, wie PHP beim Aufruf einer Erweiterung Parameter übergibt und wie die Erweiterungsfunktion den Aufruf empfängt. Behandeln Sie es als Ihr eigenes Memo

Text

1.zend_parse_parameters

Um die von der Funktion übergebenen Parameter zu erhalten, können Sie die Funktion zend_parse_parameters verwenden Die vom Beamten generierte Standardfunktion ist auch Verwenden Sie diese Funktion, um Parameter zu empfangen.

Wie verwende ich diese Funktion?

Zuallererst können Sie dieses Buch wie PHPs scanf lesen. (Wenn Sie mit dieser Funktion nicht vertraut sind, können Sie gerne hier nachlesen)

zend_parse_parameters(int num_args TSRMLS_DC, char *type_spec, &参数1,&参数2…);

Der erste Parameter ist die Anzahl der an die Funktion übergebenen Parameter. Der übliche Ansatz besteht darin, ZEND_NUM_ARGS() zu übergeben. (ZEND_NUM_ARGS(), um „so viele wie Parameter übergeben werden“ auszudrücken) Dies ist ein Makro, das die Gesamtzahl der an die Funktion übergebenen Parameter darstellt.

Der zweite Parameter dient der Thread-Sicherheit. Übergeben Sie immer das TSRMLS_CC-Makro.

Der dritte Parameter ist eine Zeichenfolge, die den von der Funktion erwarteten Parametertyp angibt, gefolgt von einer Liste von Variablen, die mit dem Parameterwert aktualisiert werden müssen. Da PHP eine schwach typisierte Sprache ist, verwendet es lose Variablendefinitionen und eine dynamische Typbeurteilung, während die C-Sprache stark typisiert ist und zend_parse_parameters () verschiedene Parametertypen in den erwarteten Typ konvertieren soll. (Wenn der tatsächliche Wert nicht in den erwarteten Typ umgewandelt werden kann, wird eine Warnung ausgegeben)

Der vierte, fünfte und n-te Parameter sind alle Werte der zu übergebenden Werte.

Detaillierte Erläuterung des dritten Parameters

Bezüglich des dritten Parameters finden Sie hier eine Liste von Parametern zur Auswahl:

类型指定符	对应的C类型	描述
l	long	符号整数
d	double	浮点数
s	char *, int	二进制字符串，长度
b	zend_bool	逻辑型（1或0）
r	zval *	资源（文件指针，数据库连接等）
a	zval *	联合数组
o	zval *	任何类型的对象
O	zval *	指定类型的对象。需要提供目标对象的类类型
z	zval *	无任何操作的zval

Es gibt zwei Punkte, die besondere Aufmerksamkeit erfordern hier
1. Der dem String-Typ entsprechende C-Typ hat hier zwei Parameter. Ja. Dies zeigt, dass Sie die Funktion zend_parse_parameters() wie folgt verwenden müssen:

zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "s",&name, &name_len)

Einer repräsentiert den String-Inhalt und der andere ist die String-Länge.

2. Sie müssen etwas darüber wissen, was ist Zval?
zval ist der Wertcontainer der Zend-Engine. Unabhängig davon, ob es sich bei der Variablen um einen booleschen Wert, eine Zeichenfolge oder einen anderen Typ handelt, sind ihre Informationen immer in einer zval-Union enthalten. Werfen wir einen Blick auf die Struktur von zval:

typedef union _zval {    long lval;    double dval;    struct {        char *val;        int len;

    } str;

    HashTable *ht;

    zend_object_value obj;

} zval;

ps: Ich werde typedef nicht erklären, weil ich festgestellt habe, dass es bereits jemand sehr gut geschrieben hat. Bitte klicken Sie hier für eine Zusammenfassung der Verwendung von typedef

Der Rand beinhaltet außerdem drei zusätzliche Verwendungsmöglichkeiten, um unsere Fähigkeit, Parameter zu empfangen, zu verbessern:

符号	解释
|	它之前的参数都是必须的，之后的都是非必须的，也就是有默认值的。
!	如果接收了一个PHP语言里的null变量，则直接把其转成C语言里的NULL，而不是封装成IS_NULL类型的zval。
/	如果传递过来的变量与别的变量共用一个zval，而且不是引用，则进行强制分离，新的zval的is_ref__gc==0, and refcount__gc==1.

“|”和”!”将在下文有具体例子讲解，关于”/”虽然大概懂意思，但没想到具体的例子。

走一波与php的交互

正常的样子

在PHP中

<?phpfunction my_function($msg) {
    echo "我收到参数啦： {$msg}!\n";
}
my_function(&#39;咖啡色的羊驼&#39;);

如果my_function写成PHP扩展：

ZEND_FUNCTION(my_function) {
    char *msg;
    int msg_len;

    if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "s",&msg, &msg_len) == FAILURE){
        RETURN_NULL();
    }
    php_printf("我收到参数啦：");
    PHPWRITE(msg, msg_len);
    php_printf("!\n");
}

两个参数的样子

在PHP中

<?phpfunction my_function($email, $msg) {
    echo "我收到参数啦： {$email}、 {$msg}!\n";
}
my_function(&#39;123456@qq.com&#39;, &#39;咖啡色的羊驼&#39;);

如果my_function写成PHP扩展：

ZEND_FUNCTION(my_function) {
    char *email;
    int email_len;
    char *msg;
    int msg_len;

    if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "ss",&msg, &msg_len,&email, &email_len) == FAILURE){
        RETURN_NULL();
    }
    php_printf("我收到参数啦：");
    PHPWRITE(email, email_len);
    PHPWRITE(msg, msg_len);
    php_printf("!\n");
}

两个参数,其中一个可选且有默认值

<?phpfunction my_function($email, $msg = &#39;咖啡色的羊驼&#39;) {
    echo "我收到参数啦： {$email}、 {$msg}!\n";
}
my_function(&#39;123456@qq.com&#39;);

如果my_function写成PHP扩展：

ZEND_FUNCTION(my_function) {
    char *email;
    int email_len;
    char *msg = "咖啡色的羊驼";
    int msg_len = sizeof("咖啡色的羊驼") - 1;

    if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "s|s",&msg, &msg_len,&email, &email_len) == FAILURE){
        RETURN_NULL();
    }
    php_printf("我收到参数啦：");
    PHPWRITE(email, email_len);
    PHPWRITE(msg, msg_len);
    php_printf("!\n");
}

这里说明了”｜”的使用

参数为null时，省内存的写法

先来不省的写法

ZEND_FUNCTION(my_function) {
    zval *val;
    if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "z",&val) == FAILURE) {
        RETURN_NULL();
    }
}

省内存

ZEND_FUNCTION(my_function) {
    zval *val;
    if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "z!",&val) == FAILURE) {
        RETURN_NULL();
    }
}

这里例子用上了”!”，每个zval，包括IS_NULL型的zval，都需要占用一定的内存空间，需要cpu的计算资源来为它申请内存、初始化，并在它们完成工作后释放掉。但是很多代码都都没有意识到这一点。有很多代码都会把一个null型的值包裹成zval的IS_NULL类型，在扩展开发里这种操作是可以优化的，我们可以把参数接收成C语言里的NULL。
所以就差了一个！，第二个例子就更省了内存。

2.zend_get_arguments()

用法

例子是最好的用法讲解，上例子：

ZEND_FUNCTION(my_function) {
    zval *email;    if (zend_get_parameters(ZEND_NUM_ARGS(), 1, &email)== FAILURE) {
        php_error_docref(NULL TSRMLS_CC, E_WARNING,"至少需要一个参数");
        RETURN_NULL();
    }
    // ... }

区别与特点

1.能够兼容老版本的PHP，并且只以zval为载体来接收参数。
2.直接获取，而不做解析，不会进行类型转换，所有的参数在扩展实现中的载体都需要是zval类型的。
3.接受失败的时候，不会自己抛出错误，也不能方便的处理有默认值的参数。
4.会自动的把所有符合copy-on-write的zval进行强制分离，生成一个崭新的copy送到函数内部。

综合评价：还是用zend_parse_parameters吧，这个函数了解下即可，不给力。

3.zend_get_parameters_ex()

用法

ZEND_FUNCTION(my_function) {
    zval **msg;    if (zend_get_parameters_ex(1, &msg) == FAILURE) {
        php_error_docref(NULL TSRMLS_CC, E_WARNING,"至少需要一个参数");
        RETURN_NULL();
    }
    // ...}

不需要ZEND_NUM_ARGS()作为参数，因为它是在是在后期加入的，那个参数已经不再需要了。

区别与特点

1.此函数基本同zend_get_parameters()。
2.唯一不同的是它不会自动的把所有符合copy-on-write的zval进行强制分离，会用到老的zval的特性

综合评价：极端情况下可能会用到，这个函数了解下即可。

zend_get_parameter_**

这个包括：zend_get_parameters_array_ex()和zend_get_parameters_array()

用法

ZEND_FUNCTION(var_dump) {
    int i, argc = ZEND_NUM_ARGS();
    zval ***args;

    args = (zval ***)safe_emalloc(argc, sizeof(zval **), 0);
    if (ZEND_NUM_ARGS() == 0 || zend_get_parameters_array_ex(argc, args) == FAILURE) {
        efree(args);
        WRONG_PARAM_COUNT;
    }
    for (i=0; i<argc; i++) {
        php_var_dump(args[i], 1 TSRMLS_CC);
    }
    efree(args);
}

这个有点复杂，需要解释一下：
程序首先获取参数数量，然后通过safe_emalloc函数申请了相应大小的内存来存放这些zval**类型的参数。这里使用了zend_get_parameters_array_ex()函数来把传递给函数的参数填充到args中。
是的
这个参数专门用于解决像php里面的var_dump的一样，可以无限传参数进去的函数的实现

区别与特点

1.用于应对无限参数的扩展函数的实现。
2.zend_get_parameters_array与zend_get_parameters_array_ex唯一不同的是它将zval*类型的参数填充到args中，并且需要ZEND_NUM_ARGS()作为参数。

综合评价:当遇到确实需要处理无限参数的时候，真的要用这个函数了。zend_parse_parameters真的做不到啊～

总结

抛开一切，最少也要学会zend_parse_parameters()的用法。好的。扩展函数传参数的技能get了。

Das obige ist der detaillierte Inhalt vonDetaillierte Erläuterung von Beispielen für die Übergabe von Parametern und den Erhalt von Parametern in der Erweiterungsfunktion der PHP-Erweiterung. Für weitere Informationen folgen Sie bitte anderen verwandten Artikeln auf der PHP chinesischen Website!