Partage d'exemples de types de ressources PHP

En PHP, nous utilisons souvent des variables de type ressource. Par exemple : connexion mysql, descripteur de fichier, etc. Ces variables ne peuvent pas être représentées par des scalaires, alors comment connecter des variables de ressources en PHP aux ressources en langage C dans le noyau Zend ?

1. L'utilisation des variables de ressources en PHP

1. $fp = fopen("test.txt", "rw");
   
   var_dump($fp);
   
   fclose($fp);

Imprimer les résultats : ressource(5) de type (stream )

Numéro 5 : indique que l'ID de la ressource est 5. La signification spécifique sera introduite plus tard.

stream : nom du type de ressource.

2. ID de ressource

Le noyau stocke les variables de ressource enregistrées dans une HashTable et utilise la clé dans la HashTable où se trouve la ressource comme ID de ressource.

Ainsi, en fait, la variable de ressource en PHP stocke en fait un entier, et la ressource correspondante dans la HashTable est trouvée via cet ID.

1. #define Z_RESVAL(zval)          (zval).value.lval
   #define Z_RESVAL_P(zval)        Z_RESVAL(*zval)
   #define Z_RESVAL_PP(zval)       Z_RESVAL(**zval)

La macro ci-dessus est l'API utilisée par ZE dans le noyau pour attribuer des valeurs aux variables de ressources. On peut voir que c'est bien le cas. une affectation à une variable entière.

3. Nom du type de ressource

Afin de distinguer les types de ressources, nous devons définir des noms de type pour les ressources que nous définissons.

#define MY_RES_NAME "my_resource" //资源类型名称，PHP通过var_dump打印资源变量时会看到这个名称
static int my_resource_descriptor;

ZEND_MINIT_FUNCTION(jinyong)
{
    my_resource_descriptor = zend_register_list_destructors_ex(NULL, NULL, MY_RES_NAME, module_number);//向内核中注册新的资源类型
}

• 
  

ZEND_MINIT_FUNCTION(jinyong) sera disponible en PHP en tant que SAPI (par exemple, Apache mod_php5) Une fois chargés en mémoire, tous les ZEND_MINIT_FUNCTION étendus sont exécutés.

Où jinyong est le nom de l'extension actuelle. Par exemple, le nom de l'extension à l'heure actuelle est jinyong

Pour faciliter la compréhension, nous la considérons comme l'extension enregistrant un nouveau type de ressource auprès du noyau lors de l'initialisation.

4. Créer des variables de ressource

Le type de ressource a été enregistré avec succès et un nom de type différencié a été défini pour la ressource. Les variables de cette ressource peuvent désormais être utilisées.

Implémentez la fonction fopen en PHP :

1. PHP_FUNCTION(my_fopen)
   {
       zval *res;
   
       char *filename, *mode;
   
       int filename_strlen, mode_strlen;
   
       FILE *fp;
   
       if(zend_parse_parameters(ZEND_NUM_ARGS TSRMLS_CC, "s|s",  &filename, &filename_strlen, &mode, &mode_strlen) == FAILURE){
           RETURN_FALSE;
       }
   
       //此处省略了对参数的有效性验证
       fp = fopen(filename, mode);
   
       ZEND_REGISTER_RESOURCE(res, fp, my_resource_descriptor);//向全局变量&EG(regular_list)中注册资源变量，并将对应HashTable的ID赋值给res
   
       RETURN_RESOURCE(res);//向PHP返回资源变量
   }

Ici, la fonction nommée my_fopen en PHP est définie. my_fopen(string $file_name, string $mode)

Implémente la fonction fclose en PHP :

1. PHP_FUNCTION(my_fclose)
   {
       zval *res;
   
       FILE *fp;
   
       if(zend_parse_parameters(ZEND_NUM_ARGS TSRMS_CC, "r", &res) == FAILURE){
           RETURN_FALSE;
       }
   
       if(Z_TYPE_P(res) == IS_RESOURCE){//判断变量类型是否是资源类型
           zend_hash_index_del(&EG(regular_list), Z_RESVAL_P(res));//EG就类似于PHP中的$_GLOBALS。在全局资源变量regular_list中删除对应ID的资源
       }else{
           php_error_docref(NULL TSRMLS_CC, E_WARNING, "参数必须是资源类型变量");
           RETURN_FALSE;
       }
   
       RETURN_TRUE;
   }

définit le nom en PHP comme La fonction de my_fclose. my_fclose($resource)

5. Compilez et installez les extensions, redémarrez php-fpm ou mod_php5, etc.

6. Méthodes d'utilisation des extensions personnalisées en PHP

1. my_fwrite($fp, "aaTest");
   
   var_dump($fp);
   
   my_fclose($fp);
   
   var_dump($fp);

Peut ouvrir et fermer les ressources normalement.

7. Nous utilisons souvent des ressources de connexion à une base de données et des ressources de gestion de fichiers en PHP, mais elles ne nous obligent généralement pas à les libérer manuellement, et il n'y aura pas de problèmes de fuite de mémoire.

1. my_resource_descriptor = zend_register_list_destructors_ex(NULL, NULL, MY_RES_NAME, module_number);//向内核中注册新的资源类型

Retournez au type de ressource enregistré d'origine et voyez le premier paramètre de zend_register_list_destructors_ex, qui est le pointeur vers le destructeur.

Ensuite, si vous devez implémenter la fonction de libération automatique, il vous suffit de définir le destructeur et de passer le pointeur de fonction.

Regardez une autre question :

1. $fp = fopen("test.txt", "rw");
   
   var_dump($fp);
   
   //fclose($fp); 此处不使用fclose释放资源
   
   unset($fp); //而是使用unset释放
   //unset没有问题，会正常释放$fp变量。但$fp对应真正的打开文件资源句柄资源将永远释放不了，直至mod_php5或php-fpm重启
   //可以看出，在注册资源类型时定义析构函数的必要性了

Définissez le destructeur :

static void php_myres_dtor(zend_rsrc_list_entry *rsrc TSRMLS_DC){//析构函数被调用时，会接受一个当前资源变量的参数
    FILE *fp = (FILE*)rsrc->ptr;
    fclose(fp);
}

ZEND_MINIT_FUNCTION(jinyong)
{
    my_resource_descriptor = zend_register_list_destructors_ex(php_myres_dtor, NULL, MY_RES_NAME, module_number);
}

• En PHP, les variables dites de ressources stockent en fait des valeurs entières, recherchent les pointeurs correspondants dans la liste des variables de ressources globales du noyau EG (regular_list) et effectuent les opérations correspondantes.

Le type de ressource est une variable spéciale qui contient une référence à une ressource externe. Les ressources sont créées et utilisées via des fonctions spécialisées.

Tels que la connexion à une base de données, l'ouverture de fichiers, la zone de canevas graphique, etc.

Le type de ressource n'est en fait qu'un entier, et le noyau peut utiliser cette valeur entière pour trouver les données finales requises dans un endroit similaire à un pool de ressources.

Exemple 1, exemple d'opération sur fichier :

Exemple de code :

<?php
$file=fopen(&#39;a.txt&#39;,&#39;r&#39;);//使用fopen函数打开一个文件获取句柄。
fread($file,1024);//之后把该句柄传递给fread函数，即可对此文件进行后续操作。

Exemple 2, exemple d'opération sur base de données :

Exemple de code :

<?php
$result=mysql_query(&#39;select
 * from tbale&#39;);//mysql_query函数执行一条sql，若失败，返回false;成功，查询结果被缓存，并返回资源标识(类似：Resource
 id#42)即指向该资源的句柄。
mysql_num_row($result);//使用该句柄可以操作缓存中的资源，从而返回查询出来的条数
mysql_fetch_row($result);//使用该句柄可以操作缓存中的资源，从而返回查询结构

Description :
Liste des fonctions d'utilisation et de destruction des ressources.
Vous pouvez utiliser la fonction is_resource() pour déterminer si une variable est une ressource, et la fonction get_resource_type() renvoie le type de la ressource.

En ce qui concerne les variables de ressources PHP, vous n'avez pas à vous soucier de problèmes tels que la non-libération de la connexion MYSQL, car la méthode destructeur est définie dans l'extension pour aider à la libérer automatiquement.

Recommandations associées :

Liste des ressources PHP, tutoriel php resource_PHP

Ressources PHP

Un résumé des ressources PHP, notamment : bibliothèques, frameworks, modèles, etc.

Ce qui précède est le contenu détaillé de. pour plus d'informations, suivez d'autres articles connexes sur le site Web de PHP en chinois!