PHP7 매개변수, 배열 및 Zval

시작하기

이제 간단한 함수를 선언하고 정적 또는 동적 값을 반환할 수 있습니다. INI 옵션을 정의하고 내부 또는 전역 값을 선언합니다. 이 장에서는 호출 스크립트(php 파일)에서 전달된 매개변수의 값을 받는 방법과 PHP 커널 및 Zend 엔진이 내부 변수를 작동하는 방법을 소개합니다.

매개변수 수신

사용자 제어 코드와 달리 내부 함수의 매개변수는 실제로 함수 헤더에 선언되지 않습니다. 함수 선언은 PHP_FUNCTION(func_name), 매개변수 명령문은 다음과 같습니다. 그들 중에는 없습니다. 매개변수는 매개변수 목록의 주소를 통해 전달되며, 매개변수 유무와 관계없이 모든 함수에 전달됩니다.

매개변수를 받아 인사말 텍스트와 함께 출력하는 hello_str() 함수를 정의하여 살펴보겠습니다.

PHP_FUNCTION(hello_greetme)
{    char *name = NULL;
    size_t name_len;
    zend_string *strg;    if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "s", &name, &name_len) == FAILURE) {
        RETURN_NULL();
    }

    strg = strpprintf(0, "你好: %s", name);
    RETURN_STR(strg);
}

대부분의 zend_parse_parameters() 블록은 비슷해 보입니다. ZEND_NUM_ARGS()는 Zend 엔진에 가져올 매개변수에 대한 정보를 알려줍니다. TSRMLS_CC는 스레드 안전성을 보장하는 데 사용되며 반환 값은 SUCCESS인지 FAILURE인지 감지합니다. 일반적으로 반환은 SUCCESS입니다. 너무 적거나 너무 많은 매개변수가 전달되거나 매개변수가 적절한 유형으로 변환될 수 없는 경우를 제외하고 Zend는 자동으로 오류 메시지를 출력하고 호출 스크립트에 제어를 반환합니다.

"s"를 지정하면 이 함수는 하나의 매개변수만 전달될 것으로 예상하고 매개변수는 문자열 데이터 유형으로 변환되며 주소는 char * 변수에 전달됩니다.

추가로 zend_parse_parameters()에 주소로 전달되는 int 변수가 있습니다. 이를 통해 Zend 엔진은 문자열의 바이트 길이를 제공할 수 있으므로 바이너리 안전 함수는 더 이상 문자열 길이를 결정하기 위해 strlen(name)에 의존하지 않습니다. 실제로 strlen(name)을 사용하면 name이 문자열 끝 앞에 NULL 문자를 포함할 수 있기 때문에 올바른 결과도 얻지 못하기 때문입니다.

php7에서는 매개변수 파싱 성능을 향상시키기 위해 매개변수를 얻는 또 다른 방법인 FAST_ZPP를 제공합니다.

#ifdef FAST_ZPPZEND_PARSE_PARAMETERS_START(1, 2)
    Z_PARAM_STR(type)    Z_PARAM_OPTIONAL    Z_PARAM_ZVAL_EX(value, 0, 1)
    ZEND_PARSE_PARAMETERS_END();#endif

매개변수 유형표

마지막 4가지 유형은 모두 zvals *이기 때문이다. 모든 사용자 공간 변수를 저장합니다. 세 가지 "복잡한" 데이터 유형: 리소스, 배열 및 개체. zend_parse_parameters()에서 해당 데이터 유형 코드를 사용하면 Zend 엔진이 유형 검사를 수행하지만 C에는 해당 데이터 유형이 없으므로 유형 변환이 수행되지 않습니다.

Zval

일반적으로 zval과 php 사용자 공간 변수는 매우 번거롭고 개념도 이해하기 어렵습니다. PHP7에서는 해당 구조가 Zend/zend_types.h에 정의되어 있습니다:

struct _zval_struct {
    zend_value        value;            /* value */
    union {
        struct {
            ZEND_ENDIAN_LOHI_4(
                zend_uchar    type,         /* active type */
                zend_uchar    type_flags,
                zend_uchar    const_flags,
                zend_uchar    reserved)     /* call info for EX(This) */
        } v;
        uint32_t type_info;
    } u1;
    union {
        uint32_t     next;                 /* hash collision chain */
        uint32_t     cache_slot;           /* literal cache slot */
        uint32_t     lineno;               /* line number (for ast nodes) */
        uint32_t     num_args;             /* arguments number for EX(This) */
        uint32_t     fe_pos;               /* foreach position */
        uint32_t     fe_iter_idx;          /* foreach iterator index */
        uint32_t     access_flags;         /* class constant access flags */
        uint32_t     property_guard;       /* single property guard */
    } u2;
};

보시다시피 변수는 _zval_struct 구조를 통해 저장되며 변수 값은 zend_value 유형입니다.

typedef union _zend_value {
    zend_long         lval;             /* long value */
    double            dval;             /* double value */
    zend_refcounted  *counted;
    zend_string      *str;
    zend_array       *arr;
    zend_object      *obj;
    zend_resource    *res;
    zend_reference   *ref;
    zend_ast_ref     *ast;
    zval             *zv;
    void             *ptr;
    zend_class_entry *ce;
    zend_function    *func;
    struct {
        uint32_t w1;
        uint32_t w2;
    } ww;
} zend_value;

구조가 커 보이지만 자세히 보면 합집합, 값의 확장입니다. u1은 type_info, u2는 기타 다양한 보조 필드입니다.

zval 유형

变量存储的数据是有数据类型的，php7中总体有以下类型,Zend/zend_types.h中有定义：

/* regular data types */
#define IS_UNDEF                    0
#define IS_NULL                     1
#define IS_FALSE                    2
#define IS_TRUE                     3
#define IS_LONG                     4
#define IS_DOUBLE                   5
#define IS_STRING                   6
#define IS_ARRAY                    7
#define IS_OBJECT                   8
#define IS_RESOURCE                 9
#define IS_REFERENCE                10

/* constant expressions */
#define IS_CONSTANT                 11
#define IS_CONSTANT_AST             12

/* fake types */
#define _IS_BOOL                    13
#define IS_CALLABLE                 14
#define IS_ITERABLE                 19
#define IS_VOID                     18

/* internal types */
#define IS_INDIRECT                 15
#define IS_PTR                      17
#define _IS_ERROR                   20

测试

书写一个类似gettype()来取得变量的类型的hello_typeof():

PHP_FUNCTION(hello_typeof)
{
    zval *userval = NULL;
    if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "z", &userval) == FAILURE) {
        RETURN_NULL();
    }
    switch (Z_TYPE_P(userval)) {
        case IS_NULL:
            RETVAL_STRING("NULL");
            break;

        case IS_TRUE:
            RETVAL_STRING("true");
            break;

        case IS_FALSE:
            RETVAL_STRING("false");
            break;

        case IS_LONG:
            RETVAL_STRING("integer");
            break;

        case IS_DOUBLE:
            RETVAL_STRING("double");
            break;

        case IS_STRING:
            RETVAL_STRING("string");
            break;

        case IS_ARRAY:
            RETVAL_STRING("array");
            break;

        case IS_OBJECT:
            RETVAL_STRING("object");
            break;

        case IS_RESOURCE:
            RETVAL_STRING("resource");
            break;

        default:
            RETVAL_STRING("unknown type");
    }
}

这里使用RETVAL_STRING()与之前的RETURN_STRING()差别并不大,它们都是宏。只不过RETURN_STRING中包含了RETVAL_STRING的宏代替，详细在 Zend/zend_API.h 中有定义:

#define RETVAL_STRING(s)                ZVAL_STRING(return_value, s)
#define RETVAL_STRINGL(s, l)            ZVAL_STRINGL(return_value, s, l)

#define RETURN_STRING(s)                { RETVAL_STRING(s); return; }
#define RETURN_STRINGL(s, l)            { RETVAL_STRINGL(s, l); return; }

创建zval

前面用到的zval是由Zend引擎分配空间，也通过同样的途径释放。然而有时候需要创建自己的zval，可以参考如下代码：

{
    zval temp;
    ZVAL_LONG(&temp, 1234);
}

数组

数组作为运载其他变量的变量。内部实现上使用了众所周知的 HashTable .要创建将被返回PPHP的数组，最简单的方法：

做一个测试：

PHP_FUNCTION(hello_get_arr)
{
    array_init(return_value);
    add_next_index_null(return_value);
    add_next_index_long(return_value, 42);
    add_next_index_bool(return_value, 1);
    add_next_index_double(return_value, 3.14);
    add_next_index_string(return_value, "foo");
    add_assoc_string(return_value, "mno", "baz");
    add_assoc_bool(return_value, "ghi", 1);
}

add_*_string()函数参数从四个改为了三个。

数组遍历

假设我们需要一个取代以下功能的拓展：

<?php
function hello_array_strings($arr) {
    if (!is_array($arr)) {
        return NULL;
    }

    printf("The array passed contains %d elements\n", count($arr));

    foreach ($arr as $data) {
        if (is_string($data))
            echo $data.&#39;\n&#39;;
    }
}

php7的遍历数组和php5差很多，7提供了一些专门的宏来遍历元素（或keys）。宏的第一个参数是HashTable，其他的变量被分配到每一步迭代：

ZEND_HASH_FOREACH_VAL(ht, val)
ZEND_HASH_FOREACH_KEY(ht, h, key)
ZEND_HASH_FOREACH_PTR(ht, ptr)
ZEND_HASH_FOREACH_NUM_KEY(ht, h)
ZEND_HASH_FOREACH_STR_KEY(ht, key)
ZEND_HASH_FOREACH_STR_KEY_VAL(ht, key, val)
ZEND_HASH_FOREACH_KEY_VAL(ht, h, key, val)

因此它的对应函数实现如下：

PHP_FUNCTION(hello_array_strings)
{
    ulong num_key;
    zend_string *key;
    zval *val, *arr;
    HashTable *arr_hash;
    int array_count;

    if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "a", &arr) == FAILURE) {
        RETURN_NULL();
    }

    arr_hash = Z_ARRVAL_P(arr);
    array_count = zend_hash_num_elements(arr_hash);
    php_printf("The array passed contains %d elements\n", array_count);
    ZEND_HASH_FOREACH_KEY_VAL(arr_hash, num_key, key, val) {
        //if (key) { //HASH_KEY_IS_STRING
        //}
        PHPWRITE(Z_STRVAL_P(val), Z_STRLEN_P(val));
        php_printf("\n");
    }ZEND_HASH_FOREACH_END();
}

因为这是新的遍历方法，而我看的还是php5的处理方式，调试出上面的代码花了不少功夫，总的来说，用宏的方式遍历大大减少了编码体积。哈希表是php中很重要的一个内容，有时间再好好研究一下。