PHP-Internals-Book解读：PHP扩展开发中的全局状态管理-CSDN博客

本文链接：https://blog.csdn.net/gitblog_01026/article/details/149013392

PHP-Internals-Book解读：PHP扩展开发中的全局状态管理

引言

在PHP扩展开发中，全局状态管理是一个需要特别注意的技术点。本文将深入探讨PHP扩展中全局变量的管理策略，帮助开发者理解如何在多进程/多线程环境下安全地使用全局变量。

全局变量的分类

在PHP扩展开发中，全局变量可以分为两大类：

请求绑定全局变量(Request-bound globals)：这类变量仅在当前请求处理期间有效，不同请求之间的变量相互隔离
真实全局变量(True globals)：这类变量在多个请求间保持持久性，通常是只读的

请求绑定全局变量的管理

基本示例分析

考虑一个简单的猜数字游戏扩展，我们需要在请求开始时生成一个随机数，并在整个请求处理过程中保持这个数值：

static zend_long rnd = 0;  // 传统的C全局变量

PHP_RINIT_FUNCTION(pib) {
    php_random_int(0, 100, &rnd, 0);
    return SUCCESS;
}

这种实现方式在进程模型下工作正常，但在线程模型下会出现严重问题，因为所有线程共享同一个全局变量空间。

线程安全解决方案

PHP提供了TSRM(Thread Safe Resource Manager)机制来解决这个问题。正确做法是：

首先声明一个全局变量结构体：

ZEND_BEGIN_MODULE_GLOBALS(pib)
    zend_long rnd;
ZEND_END_MODULE_GLOBALS(pib)

然后声明全局变量实例：

ZEND_DECLARE_MODULE_GLOBALS(pib)

定义访问宏：

#ifdef ZTS
#define PIB_G(v) ZEND_MODULE_GLOBALS_ACCESSOR(pib, v)
#else
#define PIB_G(v) (pib_globals.v)
#endif

全局变量初始化

可以使用GINIT钩子为全局变量设置初始值：

PHP_GINIT_FUNCTION(pib) {
    pib_globals->rnd = 0;
}

注意在模块定义中需要正确设置相关字段：

zend_module_entry pib_module_entry = {
    // ...其他字段...
    PHP_MODULE_GLOBALS(pib),
    PHP_GINIT(pib),
    PHP_GSHUTDOWN(pib),
    NULL,
    STANDARD_MODULE_PROPERTIES_EX
};

完整示例：猜数字游戏扩展

下面是一个更完整的示例，展示了如何在扩展中管理请求绑定全局变量：

ZEND_BEGIN_MODULE_GLOBALS(pib)
    zend_long rnd;
    zend_ulong cur_score;
    zval scores;
ZEND_END_MODULE_GLOBALS(pib)

PHP_RINIT_FUNCTION(pib) {
    array_init(&PIB_G(scores));
    pib_rnd_init();
    return SUCCESS;
}

PHP_RSHUTDOWN_FUNCTION(pib) {
    zval_dtor(&PIB_G(scores));
    return SUCCESS;
}

这个示例中：

在请求开始时初始化数组和随机数
在请求结束时清理资源
使用TSRM宏安全地访问全局变量

真实全局变量的使用

真实全局变量通常用于存储只读的、跨请求持久化的数据。常见用例包括：

环境变量配置
预分配的字符串常量
只读的全局配置

真实全局变量示例

static zend_string *more, *less;
static zend_ulong max = 100;

PHP_MINIT_FUNCTION(pib) {
    register_persistent_string("more", &more);
    register_persistent_string("less", &less);
    
    // 从环境变量读取配置
    if (pib_max = getenv("PIB_RAND_MAX")) {
        max = ZEND_STRTOUL(pib_max, NULL, 10);
    }
    return SUCCESS;
}

关键点：