PHP7 使用资源包裹第三方扩展的实现及其源码解读

在阅读下面的内容之前，我们假定你已经对 PHP 7 基本的数据结构 都有大致的了解了，这是下面内容阅读的前提。

我们分为两大块：

首先实现一个自定义的文件打开、读取、写入、关闭的文件操作扩展；

然后分析各个操作背后的实现原理，其中某些部分的实现我会和 PHP 5.3 使用资源包裹第三方扩展源码解读 对比分析。

通过原型生成扩展骨架

首先进入到源码目录的ext目录中，添加一个文件操作的原型文件

[root@localhost php-src-php-7.0.3]# cd ext/
[root@localhost ext]# vim tipi_file.proto

编辑原型为

resource file_open(string filename, string mode)
string file_read(resource filehandle, int size)
bool file_write(resource filehandle, string buffer)
bool file_close(resource filehandle)

生成骨架

[root@localhost ext]# ./ext_skel --extname=tipi_file --proto=./tipi_file.proto

这样一个简单的文件操作扩展的代码骨架就生成了。

完整代码 tipi_file.c，可以先有一个大致的了解，这样后面阅读时，思路可能会清晰很多。

扩展的实现

1.1 注册资源类型

1.1.1 注册资源 API

ZEND_API int zend_register_list_destructors_ex(rsrc_dtor_func_t ld, rsrc_dtor_func_t pld, const char *type_name, int module_number)
参数 解释
ld 释放该资源时调用的函数。
pld 释放用于在不同请求中始终存在的永久资源的函数。
type_name 是一个具有描述性类型名称的字符串。
module_number 为引擎内部使用，当我们调用这个函数时，我们只需要传递一个已经定义好的module_number变量。

该 API 返回一个资源类型 id，该id应当被作为全局变量保存在扩展里，以便在必要的时候传递给其他资源API。

1.1.2 添加资源释放回调函数

static void tipi_file_dtor(zend_resource *rsrc TSRMLS_DC){
     FILE *fp = (FILE *) rsrc->ptr;
     fclose(fp);
}

我们发现该函数的参数类型是zend_resource。这是 PHP7 新增的数据结构，在 PHP 5 则是zend_rsrc_list_entry。细节的内容，我们留在后面分析。

1.1.3 在PHP_MINIT_FUNCTION中注册

我们知道在 PHP 生命周期中，当 PHP 被装载时，PHP_MINIT_FUNCTION（模块启动函数）即被引擎调用。这使得引擎做一些例如资源类型，注册INI变量等的一次初始化。

那么我们需要在这里通过zend_register_list_destructors_ex在PHP_MINIT_FUNCTION来注册资源类型。

PHP_MINIT_FUNCTION(tipi_file)
{
    /* If you have INI entries, uncomment these lines
    REGISTER_INI_ENTRIES();
    */

    le_tipi_file = zend_register_list_destructors_ex(tipi_file_dtor, NULL, TIPI_FILE_TYPE, module_number);
    return SUCCESS;
}

其中TIPI_FILE_TYPE在前面已经定义了，是该扩展的别名（具体可以对比着代码 tipi_file.c 查看）

1.2 注册资源

1.2.1 注册资源 API

在 PHP 7 中删除了原来的ZEND_REGISTER_RESOURCE宏，直接使用zend_register_resource函数

ZEND_API zend_resource* zend_register_resource(void *rsrc_pointer, int rsrc_type)
参数 解释
rsrc_pointer 资源数据指针
rsrc_type 注册资源类型时获得的资源类型 id

1.2.2 在 file_open函数中实现资源的注册

PHP_FUNCTION(file_open)
{
    char *filename = NULL;
    char *mode = NULL;
    int argc = ZEND_NUM_ARGS();
    size_t filename_len;
    size_t mode_len;

    if (zend_parse_parameters(argc TSRMLS_CC, "ss", &filename, &filename_len, &mode, &mode_len) == FAILURE)
        return;

    // 使用 VCWD 宏取代标准 C 文件操作函数
    FILE *fp = VCWD_FOPEN(filename, mode);

    if (fp == NULL) {
        RETURN_FALSE;
    }

    RETURN_RES(zend_register_resource(fp, le_tipi_file));
}

其中RETURN_RES宏的作用是将返回的zend_resource添加到zval中，然后将最后的zval作为返回值。也就是说该函数的返回值为zval指针。RETURN_RES(zend_register_resource(fp, le_tipi_file))会将返回值的value.res设为fp，u1.type_info设为IS_RESOURCE_EX。大家可以根据源码非常直观的了解到，这里不粘贴代码详细说明了。

1.3 使用资源

1.3.1 使用资源 API

ZEND_API void *zend_fetch_resource(zend_resource *res, const char *resource_type_name, int resource_type)

在 PHP 7 中删除了原有的ZEND_FETCH_RESOURCE宏，直接使用函数zend_fetch_resource，而且解析方式也变得简单了很多，想比 PHP 5 要高效很多，后面我们再通过图片分析对比。

参数 含义
res 资源指针
resource_type_name 该类资源的字符串别名
resource_type 该类资源的类型 id

1.3.2 解析资源的实现

当我们要实现文件的读取时，最终还是需要使用原生的fread函数，所以这里需要通过zend_fetch_resource将zend_resource解析成为该资源包裹的原始的FILE *的指针。

PHP_FUNCTION(file_read)
{
    int argc = ZEND_NUM_ARGS();
    int filehandle_id = -1;
    zend_long size;
    zval *filehandle = NULL;
    FILE *fp = NULL;
    char *result;
    size_t bytes_read;

    if (zend_parse_parameters(argc TSRMLS_CC, "rl", &filehandle, &size) == FAILURE)
        return;

    if ((fp = (FILE *)zend_fetch_resource(Z_RES_P(filehandle), TIPI_FILE_TYPE, le_tipi_file)) == NULL) {
        RETURN_FALSE;
    }

    result = (char *) emalloc(size+1);
    bytes_read = fread(result, 1, size, fp);
    result[bytes_read] = '\0';

    RETURN_STRING(result, 0);

}

这里需要说明，脚本自动生成的扩展代码中还是使用ZEND_FETCH_RESOURCE， 是个 BUG，因为自动生成的脚本（ext/skeleton/create_stubs）还没更新。

与之类似的文件的写入操作，也很类似，这里就复制代码了，请查看完整的代码 tipi_file.c

1.4 资源的删除

1.4.1 资源删除 API

ZEND_API int zend_list_close(zend_resource *res)

传入需要被删除的资源即可。该 API 看似非常简单，实际做了很多工作，后面原理分析细说。

1.4.2 资源删除的实现

我们在函数file_close中需要调用资源删除 API

PHP_FUNCTION(file_close)
{
    int argc = ZEND_NUM_ARGS();
    int filehandle_id = -1;
    zval *filehandle = NULL;

    if (zend_parse_parameters(argc TSRMLS_CC, "r", &filehandle) == FAILURE)
        return;

    zend_list_close(Z_RES_P(filehandle));
    RETURN_TRUE;
}

1.5 编译安装以及测试

1.5.1 编译安装

通过上面的编码，一个简单的第三方的扩展就实现了。查看完整版

下面的一些命令配置请根据自己的环境而定（安装的过程可以参考最基础的扩展开发教程）

root@localhost tipi_file]# php7ize
Configuring for:
PHP Api Version:         20151012
Zend Module Api No:      20151012
Zend Extension Api No:   320151012
[root@localhost tipi_file]# ./configure --with-php-config=/usr/local/php7/bin/php-config
...
[root@localhost tipi_file]# make
...
[root@localhost tipi_file]# make install
...

1.5.2 测试

直接用 php 脚本测试，就不一个功能一个功能写测试样例了，修改tipi_file.php文件。

$fp = file_open("./CREDITS","r+");
var_dump($fp);
var_dump(file_read($fp,6));
var_dump(file_write($fp,"zhoumengakng"));
var_dump(file_close($fp));

然后通过命令行执行

php7 -d"extension=tipi_file.so" tipi_file.php

源码分析

2.1 注册资源类型源码

ZEND_API int zend_register_list_destructors_ex(rsrc_dtor_func_t ld, rsrc_dtor_func_t pld, const char *type_name, int module_number)
{
   zend_rsrc_list_dtors_entry *lde;
   zval zv;

   lde = malloc(sizeof(zend_rsrc_list_dtors_entry));
   lde->list_dtor_ex = ld;
   lde->plist_dtor_ex = pld;
   lde->module_number = module_number;
   lde->resource_id = list_destructors.nNextFreeElement;
   lde->type_name = type_name;
   ZVAL_PTR(&zv, lde);

   if (zend_hash_next_index_insert(&list_destructors, &zv) == NULL) {
      return FAILURE;
   }
   return list_destructors.nNextFreeElement-1;
}

其中

ZVAL_PTR(&zv, lde);

展开后，等价于

zv.value.ptr = (lde);
zv.u1.type_info = IS_PTR;

list_destructors是一个全局静态HashTable，资源类型注册时，将一个zval结构体变量zv存放入list_destructors的arData中，而zv的value.ptr却指向了zend_rsrc_list_dtors_entry *lde，lde中包含的该种资源释放函数指针、持久资源的释放函数指针，资源类型名称，该资源在 hashtable 中的索引依据 （resource_id）等。

而这里的resource_id则是该函数的返回值，所以后面我们在解析该类型变量时，都需要将resource_id带上。

整个的注册步骤可以总结为下图：

2.2 资源的注册

ZEND_API zend_resource* zend_register_resource(void *rsrc_pointer, int rsrc_type)
{
   zval *zv;

   zv = zend_list_insert(rsrc_pointer, rsrc_type);

   return Z_RES_P(zv);
}

该函数的功能则是将zend_list_insert返回的zval中的资源指针返回。Z_RES_P宏在Zend/zend_types.h中定义。

重点分析zend_list_insert

ZEND_API zval *zend_list_insert(void *ptr, int type)
{
   int index;
   zval zv;

   index = zend_hash_next_free_element(&EG(regular_list));
   if (index == 0) {
      index = 1;
   }
   ZVAL_NEW_RES(&zv, index, ptr, type);
   return zend_hash_index_add_new(&EG(regular_list), index, &zv);
}

其中zend_hash_next_free_element宏，返回&EG(regular_list)表的nNextFreeElement，后面用来作为索引查询的依据。

而ZVAL_NEW_RES宏是 PHP 7 新增的一套东西，把一个资源装载到zval里去，因为PHP 7 中Bucket只能存zval了。

#define ZVAL_NEW_RES(z, h, p, t) do {                         \
        zend_resource *_res =                                 \
        (zend_resource *) emalloc(sizeof(zend_resource));     \
        zval *__z;                                         \
        GC_REFCOUNT(_res) = 1;                                    \
        GC_TYPE_INFO(_res) = IS_RESOURCE;                     \
        _res->handle = (h);                                        \
        _res->type = (t);                                      \
        _res->ptr = (p);                                       \
        __z = (z);                                            \
        Z_RES_P(__z) = _res;                                  \
        Z_TYPE_INFO_P(__z) = IS_RESOURCE_EX;                  \
    } while (0)

代码比较清晰，首先根据h,p,t新建了一个资源，然后一起存入了z这个zval的结构体。（最后两个宏前面刚刚讨论过了）

最后就是zend_hash_index_add_new宏了，追踪代码发现其最后等价于调用的是

_zend_hash_index_add_or_update_i(&EG(regular_list), index, &zv, HASH_ADD | HASH_ADD_NEW ZEND_FILE_LINE_RELAY_CC)

关于HashTable的具体操作，这里暂不做细致的分析，后面单独再单独说。

2.3 解析资源源码分析

ZEND_API void *zend_fetch_resource(zend_resource *res, const char *resource_type_name, int resource_type)
{
   if (resource_type == res->type) {
      return res->ptr;
   }

   if (resource_type_name) {
      const char *space;
      const char *class_name = get_active_class_name(&space);
      zend_error(E_WARNING, "%s%s%s(): supplied resource is not a valid %s resource", class_name, space, get_active_function_name(), resource_type_name);
   }

   return NULL;
}

在上面的例子中我们是这样解析的

(FILE *)zend_fetch_resource(Z_RES_P(filehandle), TIPI_FILE_TYPE, le_tipi_file)

首先通过Z_RES_P宏，获取filehandle这个zval变量中的zend_resource。然后zend_fetch_resource中只是对比了zend_resource的type与我们预想的资源类型是否一致，然后返回了zend_resource的*ptr，最后转换成FILE *指针。

PHP7 中资源的解析比 PHP5中解析简单快捷很多，得益于其 zval 结构的改变。

原来PHP5中则需要通过EG(regular_list)查找，如下图所示。

而现在 PHP7的解析则直接从zval里解析出zend_resource，如下图所示：

2.4 删除资源源码分析

ZEND_API int zend_list_close(zend_resource *res)
{
   if (GC_REFCOUNT(res) <= 0) {
      return zend_list_free(res);
   } else if (res->type >= 0) {
      zend_resource_dtor(res);
   }
   return SUCCESS;
}

与PHP5 不同的地方，这里不是每次都进来将其引用计数减一操作，而是直接调用zend_resource_dtor函数。

static void zend_resource_dtor(zend_resource *res)
{
   zend_rsrc_list_dtors_entry *ld;
   zend_resource r = *res;

   res->type = -1;
   res->ptr = NULL;

   ld = zend_hash_index_find_ptr(&list_destructors, r.type);
   if (ld) {
      if (ld->list_dtor_ex) {
         ld->list_dtor_ex(&r);
      }
   } else {
      zend_error(E_WARNING, "Unknown list entry type (%d)", r.type);
   }
}

如果引用计数已经等于0或者小于0了，那么才从EG(regular_list)中删除

ZEND_API int zend_list_free(zend_resource *res)
{
   if (GC_REFCOUNT(res) <= 0) {
      return zend_hash_index_del(&EG(regular_list), res->handle);
   } else {
      return SUCCESS;
   }
}

原理图还是引用上面的注册资源类型、并注册资源的图：

先从zend_resource逆向通过其type在list_destructors中索引层层关联，找到该类资源的释放回调函数，然后对该资源执行释放回调函数。

而后面的从EG(regular_list)中删除，则是通过res->handler做为索引的依据。

时间： 2024-10-27 19:23:29

PHP7 使用资源包裹第三方扩展的实现及其源码解读的相关文章

让时间处理简单化 【第三方扩展类库org.apache.commons.lang.time】

阅读目录 1. DateFormatUtils 和 FastDateFormat  2. DateUtils 3. DurationFormatUtils 和 StopWatch      JAVA的时间日期处理一直是一个比较复杂的问题,大多数程序员都不能很轻松的来处理这些问题.首先Java中关于时间的类,从 JDK 1.1 开始,Date的作用很有限,相应的功能已由Calendar与DateFormat代替.使用Calendar类实现日期和时间字段之间转换,使用 DateFormat 类来格式

Chrome着手打造可扩展插件系统，将可支持第三方扩展插件

12月2日消息,据国外媒体报道,Google Chrome的工程师Aaron Boodman近日在其博客中披露了Chrome的扩展插件计划,并公布相关的开发人员设计文件.文件显示,Chrome正着手打造可扩展插件系统,未来将支持第三方扩展插件. 根据该份文件,使用者在不同的环境中执行不同的工作,而每个人的需求都不尽相同,但Chrome又想保持最清爽的用户介面,因此可通过扩展插件新增各种功能,可以是使用者在其他浏览器上惯用的扩展插件,也可以是合作伙伴在Chrome上新增的功能. 在该份设计文件中G

第三方网站微信扫二维码登录的功能如何实现的？

问题描述 第三方网站微信扫二维码登录的功能如何实现的? 想做一个类同蘑菇街网站的微信扫二维码登录的功能,看下面的地址发现是腾讯QQ的地址,但是查不到任何的API,特别是二维码是在QQ的服务器上生成的,我找不到相应的API说明!也不是OAuth2.0网页授权模式实现的,请高人指点:这个是否是腾讯特意为合作商开的权限?https://open.weixin.qq.com/connect/qrconnect?appid=wx4530e35e8a9fc5cd&redirect_uri=http://ww

CI框架源码解读之利用Hook.php文件完成功能扩展的方法_php实例

本文实例讲述了CI框架源码解读之利用Hook.php文件完成功能扩展的方法.分享给大家供大家参考,具体如下: 看了hook.php的源码,就知道CI使用hook来进行扩展的原理了. hook的基本知识 http://codeigniter.org.cn/user_guide/general/hooks.html CI中hook的使用经历了一个:开启hook,定义hook,调用hook,执行hook的过程. 手册中已经告知了开启.定义.调用的方法.那么hook的实现原理是啥呢. <?php if

PHP7 学习笔记（三）关于PHP7如何安装调试工具Xdebug扩展以及Zephir的问题

安装这个扩展是由于Zephir 编译不能始终通过,迫不得已啊,使用Zephir写扩展,总是出现以下错误: www@ubuntu1:~/phalcon-zephir/$ sudo zephir build Segmentation fault (core dumped) 去官方问问,由于php cli 没有安装 Disable xdebug 扩展导致的结果 开始安装吧 git clone git://github.com/xdebug/xdebug.git cd xdebug # 生成config

PHP通过反射动态加载第三方类和获得类源码的实例_php实例

使用反射动态加载第三方类 用反射加载第三方类用处在于: 使用XML或其他配文件配置要加载的类,从而和系统源代码分离. 对加载的类进行类检查,是加载的类符合自己定义的结构. <?php abstract class Module { #核心Module类库 function baseFunc() { echo "I am baseFunc"; } abstract function execute(); } class ModuleRunner { private $configD

php7.0.5相关问题，redis扩展

问题描述 php7.0.5相关问题,redis扩展 为什么php7.0.5安装redis扩展,phpinfo还是不显示redis,步骤都是对的 PHP官方库里没有PHP7的redis扩展:https://pecl.php.net/package/redis 编译安装下载github地址:https://github.com/phpredis/phpredis/tree/php7 Windows:https://github.com/neil-chen/NeilChen/tree/master/p

PHP7扩展开发之类型处理

前言 这次,我们将演示如何在PHP扩展中如何对类型进行一些操作.如,判断变量类型.要实现的PHP代码如下: <?php function get_size ($value) { if (is_string($value)) { return "string size is ". strlen($value); } else if (is_array($value)) { return "array size is ". sizeof($value); } el

PHP7扩展开发之数组处理

前言 这次,我们将演示如何在PHP扩展中如何对数组进行处理.要实现的PHP代码如下: <?php function array_concat ($arr, $prefix) { foreach($arr as $key => $val) { if (isset($prefix[$key]) && is_string($val) && is_string($prefix[$key])) { $arr[$key] = $prefix[$key].$val; } }