【php7扩展开发二】全局变量

系统管理员 2022-11-12 09:41 177阅读 0赞

使用C语言开发程序时经常会使用全局变量进行数据存储，这就涉及前面已经介绍过的一个问题：线程安全，PHP设计了TSRM(即:线程安全资源管理器)用于解决这个问题，内核中频繁使用到的EG、CG等都是根据是否开启ZTS封装的宏，同样的，在扩展中也需要必须按照TSRM的规范定义全局变量，除非你的扩展不支持多线程的环境。

PHP为扩展的全局变量提供了一种存储方式：每个扩展将自己所有的全局变量统一定义在一个结构体中，然后将这个结构体注册到TSRM中，这样扩展就可以像使用EG、CG那样访问这个结构体。

这个结构体的定义通过ZEND\_BEGIN\_MODULE\_GLOBALS(extension\_name),ZEND\_END\_MODULE\_GLOBALS(extension\_name)两个宏完成，这两个宏必须成对出现，中间定义扩展需要的全局变量即可。

ZEND_BEGIN_MODULE_GLOBALS(hello)
        zend_long greeting;
    ZEND_END_MODULE_GLOBALS(hello)

展开后实际就是个普通的struct:

typedef struct _zend_hello_globals {
        zend_long greeting;
    } zend_hello_globals;

接着创建一个此结构体的全局变量，这时候就会涉及ZTS了，如果未开启线程安全直接创建普通的全局变量即可，如果开启线程安全了则需要向TSRM注册，得到一个唯一的资源id，这个操作也由专门的宏来完成:ZEND\_DECLARE\_MODULE\_GLOBALS(extension\_name),展开后:

//ZTS: 此时只是定义资源id，并没有向TSRM注册
    ts_rsrc_id hello_globals_id;
    
    //非ZTS
    zend_hello_globals hello_global;

最后需要定义一个像EG、CG那样的宏用于访问扩展的全局资源结构体，这一步使用ZEND\_MODULE\_GLOBALS\_ACCESSOR()宏完成:

> \#define HELLO\_G(v) ZEND\_MODULE\_GLOBALS\_ACCESSOR(hello, v)

看起来是不是跟EG、CG的定义非常像?这个宏展开后:

//ZTS
    #define  hello_G(v) ZEND_TSRMG(hello_globals_id, zend_hello_globals *, v)
    //非ZTS
    #define hello_G(v) (hello_globals.v)

接下来就可以在扩展中通过:MYTEST\_G(greeting)、对结构体成员进行读写了。下面来看一个demo:

//php_hello.h
    #define HELLO_G(v) ZEND_MODULE_GLOBALS_ACCESSOR(hello, v)
    
    ZEND_BEGIN_MODULE_GLOBALS(hello)
        zend_long greeting;
    ZEND_END_MODULE_GLOBALS(hello)
    
    //hello.c
    ZEND_DECLARE_MODULE_GLOBALS(hello)
    
    PHP_FUNCTION(hello_change_ini)
    {
        HELLO_G(greeting) ++;
    }
    
    PHP_FUNCTION(hello_ini)
    {
        RETURN_LONG(HELLO_G(greeting));
    }
    
    //index.php
    <?php
        echo hello_ini();  //0
        hello_change_ini();
        echo "<br>";
        echo hello_ini(); //1
    >