php扩展与嵌入－－资源数据类型2-php手册-PHP中文網

首頁

php教程

php手册

php扩展与嵌入－－资源数据类型2

WBOYWBOYWBOYWBOYWBOYWBOYWBOYWBOYWBOYWBOYWBOYWBOYWB

Jun 21, 2016 am 08:48 AM

zend

在资源变量中存储的复杂的数据类型通常在初始化时需要一些内存分配，CPU时间或网络通信。但是在请求之间保留类似于数据库连接这种资源，必须要做到持久。资源是否持久是一个必须要考虑到的因素。
首先看内存分配的问题： 在使用php的时候，偏向使用emalloc因为它是malloc的带回收的版本。但是持久化的资源必须在请求间都存在。对于一个文件句柄类的资源来说，如果要加入一个存储文件名的需求，那么必须在头文件中加入如下的代码：

typedef struct _php_sample_descriptor_data {
    char *filename;
    FILE *fp;
} php_sample_descriptor_data;

登入後複製

利用这个结构可以存储文件名和文件句柄资源，从而能够在不同的请求之间进行共享。
对应的，要在源文件中进行相应的更改：

static void php_sample_descriptor_dtor( //这个是进行资源回收的回调函数，定义在资源的初始化处。
                    zend_rsrc_list_entry *rsrc TSRMLS_DC)
{
    php_sample_descriptor_data *fdata =
                (php_sample_descriptor_data*)rsrc->ptr;
    fclose(fdata->fp);
    efree(fdata->filename);
    efree(fdata);
}

登入後複製

这个静态函数用来进行资源的回收，需要在初始化资源的时候进行指定回调。
进行修改后的文件打开函数，需要增加给资源分配空间的操作：

PHP_FUNCTION(sample_fopen) //修改后的fopen
{
    php_sample_descriptor_data *fdata;
    FILE *fp;
    char *filename, *mode;
    int filename_len, mode_len;
    if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "ss",
                        &filename, &filename_len,
                        &mode, &mode_len) == FAILURE) {// 获取文件名和文件长度 
        RETURN_NULL();
    }
    if (!filename_len  !mode_len) {
        php_error_docref(NULL TSRMLS_CC, E_WARNING,
                "Invalid filename or mode length");
        RETURN_FALSE;
    }
    fp = fopen(filename, mode);
    if (!fp) {
        php_error_docref(NULL TSRMLS_CC, E_WARNING,
                "Unable to open %s using mode %s",
                filename, mode);
        RETURN_FALSE;
    }
    <strong>fdata = emalloc(sizeof(php_sample_descriptor_data)); //给包含了文件资源和文件名的结构分配空间
    fdata->fp = fp;
    fdata->filename = estrndup(filename, filename_len);</strong>
    ZEND_REGISTER_RESOURCE(return_value, fdata,
                                le_sample_descriptor); // 注册资源
}

登入後複製

对于文件写入函数fwrite同样需要修改：

PHP_FUNCTION(sample_fwrite)
{
    php_sample_descriptor_data *fdata;
    zval *file_resource;
    char *data;
    int data_len;
    if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "rs",
            &file_resource, &data, &data_len) == FAILURE ) {
        RETURN_NULL();
    }
    <strong>ZEND_FETCH_RESOURCE(fdata, php_sample_descriptor_data*,
        &file_resource, -1,
        PHP_SAMPLE_DESCRIPTOR_RES_NAME, le_sample_descriptor);</strong>
    RETURN_LONG(fwrite(data, 1, data_len, fdata->fp));
}

登入後複製

对于sample_fclose函数并不需要改变什么，因为它没有操作实际的资源。下面这个函数可以从资源中拿到原本的文件名：

PHP_FUNCTION(sample_fname)
{
    php_sample_descriptor_data *fdata;
    zval *file_resource;
    if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "r",
            &file_resource) == FAILURE ) {
        RETURN_NULL();
    }
    <strong>ZEND_FETCH_RESOURCE(fdata, php_sample_descriptor_data*,
        &file_resource, -1,
        PHP_SAMPLE_DESCRIPTOR_RES_NAME, le_sample_descriptor);</strong>
    RETURN_STRING(fdata->filename, 1);
}

登入後複製

在完成了内存分配之后，由于必须保持持久化，所以必须延迟析构：
对于非持久的资源来说，一旦存放着资源id的变量被unset或fallen out of scope了，那么它们就被从EG(regular_list)中去除掉了。而EG(persistent_list)中使用的索引是键值类的，元素在请求的最后不会不会被自动的去除掉。只有在zend_hash_del()调用或线程/进程完全关闭的情况下才会消除。 EG(persistent_list)也有dtor方法，但是是zend_register_list_descructors_ex()的第二个参数。一般来说，非持久和持久的资源会被注册成两种类型，有的时候也可以合二为一。现在在sample.c中添加一个持久的资源类型。

    static int le_sample_descriptor_persist;
    static void php_sample_descriptor_dtor_persistent(
                    zend_rsrc_list_entry *rsrc TSRMLS_DC)
{<strong>//这是一个持久化的资源析构函数</strong>
    php_sample_descriptor_data *fdata =
                (php_sample_descriptor_data*)rsrc->ptr;
    <strong>fclose(fdata->fp);
    pefree(fdata->filename, 1);
    pefree(fdata, 1);</strong>
}
PHP_MINIT_FUNCTION(sample)
{
    le_sample_descriptor =     zend_register_list_destructors_ex(
            php_sample_descriptor_dtor, NULL,
            PHP_SAMPLE_DESCRIPTOR_RES_NAME, module_number);
    <strong>le_sample_descriptor_persist =
                        zend_register_list_destructors_ex(
            NULL, php_sample_descriptor_dtor_persistent,
            PHP_SAMPLE_DESCRIPTOR_RES_NAME, module_number);//注册一个持久化的资源</strong>
    return SUCCESS;
}

登入後複製

下面的这个fopen函数就兼容了持久与非持久的两个资源类型：

PHP_FUNCTION(sample_fopen)
{
    php_sample_descriptor_data *fdata;
    FILE *fp;
    char *filename, *mode;
    int filename_len, mode_len;
    zend_bool persist = 0;
    if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC,"ssb",
                &filename, &filename_len, &mode, &mode_len,
                &persist) == FAILURE) {
        RETURN_NULL();
    }
    if (!filename_len  !mode_len) {
        php_error_docref(NULL TSRMLS_CC, E_WARNING,
                "Invalid filename or mode length");
        RETURN_FALSE;
    }
    fp = fopen(filename, mode);
    if (!fp) {
        php_error_docref(NULL TSRMLS_CC, E_WARNING,
                "Unable to open %s using mode %s",
                filename, mode);
        RETURN_FALSE;
    }
    if (!persist) {//非持久化的资源
        fdata = emalloc(sizeof(php_sample_descriptor_data));
        fdata->filename = estrndup(filename, filename_len);//这个做了申请内存和赋值两步操作 
        fdata->fp = fp;
        ZEND_REGISTER_RESOURCE(return_value, fdata,
                                le_sample_descriptor);
    } else {//持久化的资源
        list_entry le;
        char *hash_key;          
        int hash_key_len;
        fdata =pemalloc(sizeof(php_sample_descriptor_data),1);
        fdata->filename = pemalloc(filename_len + 1, 1);
        memcpy(fdata->filename, filename, filename_len + 1);
        fdata->fp = fp;
        ZEND_REGISTER_RESOURCE(return_value, fdata,
                        le_sample_descriptor_persist);

        /* Store a copy in the persistent_list 在persistent_list存储一份副本 */
        le.type = le_sample_descriptor_persist;
        le.ptr = fdata;
        hash_key_len = spprintf(&hash_key, 0,
                "sample_descriptor:%s:%s", filename, mode);
        zend_hash_update(&EG(persistent_list),
            hash_key, hash_key_len + 1,
            (void*)&le, sizeof(list_entry), NULL);
        efree(hash_key);
    }
}

登入後複製

对于非持久化的资源，给定了一个数字的索引，并存放在了跟请求依存的list中。对于持久化的资源，给定了一个键值类型，这个hashkey可以在接下来的请求中被重新得到。然后把资源放进了persistentlist中。当一个持久的资源out of scope的时候，EG(regular_list)的析构函数会为le_sample_descriptro_persist检查registerlist析构。发现是NULL的话不会有任何的操作。从而也就保证了持久的资源不会被释放掉。当资源被从EG(persistent_list)中去除的时候，要么是线程进程结束了，要么是故意删除掉了。这时候就会去找持久化的析构函数。

资源被申请为持久化的原因就是为了在其他的请求中可以复用：
如果想要复用持久化的资源，那就一定要用到hash_key,当sample_fopen被调用的时候，函数会利用请求的文件名和模式重新创建hash_key，然后尝试在persistent_list中找到它。

PHP_FUNCTION(sample_fopen)
{
    php_sample_descriptor_data *fdata;
    FILE *fp;
    char *filename, *mode, *hash_key;
    int filename_len, mode_len, hash_key_len;
    zend_bool persist = 0; //判断是否持久
    list_entry *existing_file;
    if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC,"ssb",
                &filename, &filename_len, &mode, &mode_len,
                &persist) == FAILURE) {
        RETURN_NULL();
    }
    if (!filename_len  !mode_len) {
        php_error_docref(NULL TSRMLS_CC, E_WARNING,
                "Invalid filename or mode length");
        RETURN_FALSE;
    }
    <strong>/* 通过获得一个hash_key尝试寻找一个已经打开的文件 */
    hash_key_len = spprintf(&hash_key, 0,
            "sample_descriptor:%s:%s", filename, mode);
                                                                                                              
    if (zend_hash_find(&EG(persistent_list), hash_key,
            hash_key_len + 1, (void **)&existing_file) == SUCCESS) {
        /* 成功的找到了这个已经打开的文件句柄资源 */
        ZEND_REGISTER_RESOURCE(return_value,
            existing_file->ptr, le_sample_descriptor_persist);
        efree(hash_key);
        return;
    }</strong>
    fp = fopen(filename, mode);
    if (!fp) {
        php_error_docref(NULL TSRMLS_CC, E_WARNING,
                "Unable to open %s using mode %s",
                filename, mode);
        RETURN_FALSE;
    }
    if (!persist) {
        fdata = emalloc(sizeof(php_sample_descriptor_data));
        fdata->filename = estrndup(filename, filename_len);
        fdata->fp = fp;
        ZEND_REGISTER_RESOURCE(return_value, fdata,
                                le_sample_descriptor);
    } else {
        list_entry le;
        fdata =pemalloc(sizeof(php_sample_descriptor_data),1);
        fdata->filename = pemalloc(filename_len + 1, 1);
        memcpy(data->filename, filename, filename_len + 1);
        fdata->fp = fp;
        ZEND_REGISTER_RESOURCE(return_value, fdata,
                        le_sample_descriptor_persist);
        /* Store a copy in the persistent_list */
        le.type = le_sample_descriptor_persist;
        le.ptr = fdata;
        /* hash_key has already been created by now */
        zend_hash_update(&EG(persistent_list),
            hash_key, hash_key_len + 1,
            (void*)&le, sizeof(list_entry), NULL);
    }
    efree(hash_key);
}

登入後複製

注意由于所有的扩展都使用相同的哈希表单去存储资源，所以命名很重要。一般都是用扩展和资源类型名作为前缀。

检查资源可用性：
尽管像文件这种资源可以长期打开，但是类似远程网络资源这种如果在请求之间长期不用的话就有问题。所以在使用一个persistent资源之前，要先确定可用性。

if (zend_hash_find(&EG(persistent_list), hash_key,
        hash_key_len + 1, (void**)&socket) == SUCCESS) {
    if (php_sample_socket_is_alive(socket->ptr)) {
        ZEND_REGISTER_RESOURCE(return_value,
                    socket->ptr, le_sample_socket);
        return;
    }
    zend_hash_del(&EG(persistent_list),
                            hash_key, hash_key_len + 1); //这里会去调用之前注册好的析构函数
}

登入後複製

本網站聲明

本文內容由網友自願投稿，版權歸原作者所有。本站不承擔相應的法律責任。如發現涉嫌抄襲或侵權的內容，請聯絡admin@php.cn

熱AI工具

Undresser.AI Undress

人工智慧驅動的應用程序，用於創建逼真的裸體照片

AI Clothes Remover

用於從照片中去除衣服的線上人工智慧工具。

Undress AI Tool

免費脫衣圖片

Clothoff.io

AI脫衣器

Video Face Swap

使用我們完全免費的人工智慧換臉工具，輕鬆在任何影片中換臉！

熱工具

記事本++7.3.1

好用且免費的程式碼編輯器

SublimeText3漢化版

中文版，非常好用

禪工作室 13.0.1

強大的PHP整合開發環境

Dreamweaver CS6

視覺化網頁開發工具

SublimeText3 Mac版

神級程式碼編輯軟體(SublimeText3)

熱門話題

Java教學

1664

CakePHP 教程

1423

Laravel 教程

1321

PHP教程

1269

C# 教程

1249

Related knowledge

PHP實作框架：Zend Framework入門教程 Jun 19, 2023 am 08:09 AM

PHP實作框架：ZendFramework入門教學ZendFramework是PHP開發的開源網站框架，目前由ZendTechnologies維護，ZendFramework採用了MVC設計模式，提供了一系列可重複使用的程式碼庫，服務於實作Web2.0應用程式和Web服務。 ZendFramework深受PHP開發者的歡迎與推崇，擁有廣泛

如何在Zend框架中使用ACL（Access Control List）進行權限控制 Jul 29, 2023 am 09:24 AM

如何在Zend框架中使用ACL（AccessControlList）進行權限控制導言：在一個Web應用程式中，權限控制是至關重要的功能。它可以確保使用者只能存取其有權存取的頁面和功能，並防止未經授權的存取。 Zend框架提供了一種方便的方法來實現權限控制，即使用ACL（AccessControlList）元件。本文將介紹如何在Zend框架中使用ACL

PHP無法辨識ZendOptimizer，如何解決？ Mar 19, 2024 pm 01:09 PM

PHP無法辨識ZendOptimizer，如何解決？在PHP開發中，有時可能會遇到PHP無法辨識ZendOptimizer的情況，這會導致部分PHP程式碼無法正常運作。在這種情況下，我們需要採取一些措施來解決這個問題。以下將介紹一些可能的解決方法，並附上具體的程式碼範例。 1.確認ZendOptimizer是否正確安裝：首先，我們需要確認ZendOptimize

Window2003 IIS+MySQL+PHP+Zend環境如何配置 Jun 02, 2023 pm 09:56 PM

　　Windows2003安裝包包含了Zend，PHP5.2.17，PHPWind8.7和PHPMyadmin3.5.2，您可以直接下載安裝包，節約搜尋資源的時間。　　但是，由於MySQL超出了上傳限制，您需要另行前往MySQL官網下載。然後解壓縮拷貝到D碟，如下圖：　　MySQLinDdisk　　安裝與設定WindowsIIS+FTP　　點選開始>控制台>新增或移除程式。　　AddingordeletingaPG　　點選新增/移除Windows元件（A）。　　Addingorde

使用PHP框架Zend開發一個高效能的搜尋引擎 Jun 27, 2023 am 08:36 AM

隨著網路資訊的爆炸性成長，搜尋引擎已經成為人們獲取資訊的首選方式之一。而現在，隨著網站數量的不斷增加，搜尋引擎的快速反應和準確性變得越來越重要，而這就要求搜尋引擎必須具備高效能。在這篇文章中，我將介紹如何使用PHP框架Zend來開發一個高效能的搜尋引擎。一、為什麼使用Zend框架Zend框架是一個高效能的PHP框架，它在性能和可擴展性方面都有非常出色的表現

如何使用PHP框架Zend開發一個高效率的ERP管理平台 Jun 26, 2023 pm 11:00 PM

隨著資訊科技的快速發展，越來越多的企業開始意識到資訊化管理的必要性。 ERP（企業資源規劃）管理平台是現代企業管理的重要工具，可以幫助企業實現資源的規劃、協同、控制、最佳化和管理。其中，PHP框架Zend作為一款優秀的開發工具，可以幫助開發者快速且有效率地實現ERP系統的開發。本文將介紹如何使用Zend開發一個高效率的ERP管理平台。一、確定需求分析在開始開發流程前

Laravel vs Zend：哪個框架比較適合開發大型應用？ Jun 19, 2023 am 08:52 AM

隨著網路應用的不斷發展，大型應用的開發需求也不斷增加。在這樣的背景下，選擇適合自己的開發框架顯得格外重要。 Laravel和Zend是兩個廣泛使用的PHP框架，他們各有優勢，但哪一個比較適合開發大型應用？ Laravel是一個廣受歡迎的開發框架，已成為PHP開發人員的首選框架之一。它採用了現代化的設計理念，內建多種強大的功能和工具，例如EloquentOR

Symfony 3 vs Zend Framework 3：哪個PHP框架比較容易上手？ Jun 19, 2023 am 09:46 AM

PHP是一種廣泛使用的動態Web程式語言。開發者可以利用不同的框架來簡化其Web開發工作。 Symfony和ZendFramework是PHP中最受歡迎的兩個框架之一。在Symfony3和ZendFramework3之間進行選擇時，初學者經常會感到困惑。這裡我們將比較這兩個框架，看看哪一個比較容易上手。 Symfony3Symfony是一個以MVC模式為基礎的PH

See all articles

php扩展与嵌入－－资源数据类型2

熱AI工具

Undresser.AI Undress

AI Clothes Remover

Undress AI Tool

Clothoff.io

Video Face Swap

熱門文章

熱工具

記事本++7.3.1

SublimeText3漢化版

禪工作室 13.0.1

Dreamweaver CS6

SublimeText3 Mac版

熱門話題