扩展内部的全局变量

php_donie.h
1
2
3
4
ZEND_BEGIN_MODULE_GLOBALS(donie)
unsigned long global_long;
char *global_string;
ZEND_END_MODULE_GLOBALS(donie)
donie.c
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
ZEND_DECLARE_MODULE_GLOBALS(donie);

static void php_donie_init_globals(zend_donie_globals *donie_globals)
{
donie_globals->global_long = 2015;
donie_globals->global_string = "Long live Donie Leigh !";
}
static void php_donie_globals_dtor(zend_donie_globals *donie_globals)
{
php_printf("php_donie_globals_dtor triggered.");
}

PHP_MINIT_FUNCTION(donie)
{
/* init extension globals */
ZEND_INIT_MODULE_GLOBALS(donie, php_donie_init_globals, php_donie_globals_dtor);

return SUCCESS;
}

PHP_RSHUTDOWN_FUNCTION(donie)
{
#ifndef ZTS
php_donie_globals_dtor(&donie_globals);
#endif

return SUCCESS;
}

ZEND_FUNCTION(donie_test_ext_globals)
{
php_printf("%s", DONIE_G(global_string));
}

声明

ZEND_BEGIN_MODULE_GLOBALS和ZEND_END_MODULE_GLOBALS及其间的内容实际上声明了一个结构体zend_donie_globals。

根据是否开启线程安全的情况,ZEND_DECLARE_MODULE_GLOBALS做不同的事:未开启线程安全,直接声明zend_donie_globals类型的变量;已开启线程安全,声明一个整形变量donie_globals_id。

初始化

在未开启线程安全时,ZEND_INIT_MODULE_GLOBALS调用第二个参数指定的函数初始化全局变量;已开启线程安全时,调用ts_allocate_id()分配一个资源ID,并调用第二个参数代表的函数。

访问

DONIE_G在扩展的头文件里,生成扩展框架时默认就有。

销毁

开启线程安全时,ZEND_INIT_MODULE_GLOBALS的第三个参数指定的析构函数会自动被调用。未开启线程安全时,由于该宏只调用第二个参数初始化全局变量,第三个参数没有用,所以需要在MSHUTDOWN中手工调用析构函数。

用户空间的超级全局变量

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
static zend_bool php_donie_autoglobal_callback(const char *name, uint name_len TSRMLS_DC)
{
zval *donie_val;
MAKE_STD_ZVAL(donie_val);
array_init(donie_val);
add_next_index_string(donie_val, "Hello autoglobals !", 1);
ZEND_SET_SYMBOL(&EG(symbol_table), "_DONIE", donie_val);
return 0;
}

PHP_MINIT_FUNCTION(donie)
{
/* declare userspace super globals */
zend_register_auto_global("_DONIE", sizeof("_DONIE")-1, 0, php_donie_autoglobal_callback TSRMLS_CC);

return SUCCESS;
}

zend_register_auto_global()注册了$_DONIE这样一个全局变量。在代码的编译时,如果PHP内核发现代码中没有使用这个全局变量,不会进行初始化;若有使用,会调用php_donie_autoglobal_callback进行初始化。PHP4中没有php_donie_autoglobal_callback这个参数。

php_donie_autoglobal_callback做的事就是初始化一个zval并加入符号表。如果此函数返回0,则只会被调用一次,如果返回非0,在代码编译时,每发现一次该全局变量,就调用一次这个函数。