php扩展开发--快速入手

最新推荐文章于 2022-02-21 19:21:17 发布
最新推荐文章于 2022-02-21 19:21:17 发布
阅读量307 收藏
点赞数
分类专栏： php 
我们首先找到快速上手文章里面关于函数定义的代码，以此说明然后开发PHP的函数
复制代码 
//php_myext.h
PHP_FUNCTION(myext_hello);//函数申明，所有在myext.c文件定义的函数，都会在这个文件里有一个申明

//myext.c
static zend_function_entry myext_functions[] = {
     PHP_FE(myext_hello, NULL)//每个函数一行，第一个参数与PHP_FUNCTION(name)的name一样
     {NULL, NULL, NULL}//固定语法
};


PHP_FUNCTION(myext_hello)
{
     php_printf("hello you are success");
}
复制代码

从上面的代码可以看出，开发一个php的函数需要3个步骤：

1，申明函数的原型

2，定义函数，书写函数的代码

3，把函数注册到本扩展模块里

我们先来看2点。

复制代码 
 1 PHP_FUNCTION(myext_hello)
 2 {
 3      php_printf("hello you are success");
 4 }
 5 
 6 #define PHP_FUNCTION ZEND_FUNCTION
 7 #define ZEND_FUNCTION(name)             ZEND_NAMED_FUNCTION(ZEND_FN(name))
 8 #define ZEND_FN(name) zif_##name
 9 #define ZEND_NAMED_FUNCTION(name)       void name(INTERNAL_FUNCTION_PARAMETERS)
10 #define INTERNAL_FUNCTION_PARAMETERS int ht, zval *return_value, zval **return_value_ptr, zval *this_ptr, int return_value_used TSRMLS_DC
11 
12 //根据Zend/zend.h 和 Zend/zend_API.h中的宏定义，逐步展开
13 
14 PHP_FUNCTION(myext_hello)
15 ZEND_FUNCTION(myext_hello)
16 ZEND_NAMED_FUNCTION(ZEND_FN(myext_hello))
17 ZEND_NAMED_FUNCTION(zif_myext_hello_name)
18 void zif_myext_hello_name(INTERNAL_FUNCTION_PARAMETERS)
19 void zif_myext_hello_name( int ht, zval *return_value, zval **return_value_ptr, zval *this_ptr, int return_value_used TSRMLS_DC)
复制代码

 INTERNAL_FUNCTION_PARAMETERS 代替的参数说明

名称和类型说明使用方法
int ht传递的参数数量ZEND_NUM_ARGS()
zval *return_value函数的返回值，默认是IS_NULL.RETVAL_*,RETURN_*
zval **return_value_ptr当你需要返回引用的时候，把它赋值你要返回的变量，但是官方文档不建议返回引用.
zval *this_ptr如果当期函数是一个类方法，该指针指向对应的class，相当于PHP代码中的$this.getThis()
int return_value_used函数的调用者是否使用了返回值.

 

 

 

 

 

通过编写myext_example_args函数，了解了int ht ， zval *return_value ， int return_value_used三个参数的使用方法。

复制代码 
PHP_FUNCTION(myext_example_args);//php_myext.h

PHP_FE(myext_example_args, NULL)//static zend_function_entry myext_functions[] 在里面增加一个注册函数

//函数定义myext.c
PHP_FUNCTION(myext_example_args){

 　　　php_printf("zend_num_args() => %d,ht=>%d\n",ZEND_NUM_ARGS(),ht);//zend_num_args() => 3,ht=>3

    if(return_value_used){
        php_printf("返回值已经使用到了\n"); //$result = myext_example_args()
    }else{
        php_printf("返回值没有被使用\n"); //myext_example_args()
    }   

    RETURN_LONG(33);//返回值

}
复制代码

 我们来看函数注册的代码，

复制代码 
PHP_FE(myext_hello, NULL)//第二个参数是用来对函数的传参进行控制的，比如参数总数控制，是否传递引用，是否允许NULL，是否指定对象类，是否指定数组类型等，传递NULL表示不做控制

//相关的宏定义
#define PHP_FE ZEND_FE
#define ZEND_FE(name, arg_info)                     ZEND_FENTRY(name, ZEND_FN(name), arg_info, 0)
#define ZEND_FENTRY(zend_name, name, arg_info, flags)   { #zend_name, name, arg_info, (zend_uint) (sizeof(arg_info)/sizeof(struct _zend_arg_info)-1), flags },

//arg_info的结构体
typedef struct _zend_arg_info {
    const char *name;//参数名称
    zend_uint name_len;//名称长度
    const char *class_name;//参数类名称
    zend_uint class_name_len;//参数类名称长度
    zend_uchar type_hint;//不知道
    zend_uchar pass_by_reference;//是否传递引用
    zend_bool allow_null;//是否允许NULL值
    zend_bool is_variadic;//不知道
} zend_arg_info;//每一个参数的具体规则#define ZEND_ARG_INFO(pass_by_ref, name)                            { #name, sizeof(#name)-1, NULL, 0, 0, pass_by_ref, 0, 0 },
复制代码
复制代码 
#define ZEND_ARG_PASS_INFO(pass_by_ref)                             { NULL, 0, NULL, 0, 0, pass_by_ref, 0, 0 },
#define ZEND_ARG_OBJ_INFO(pass_by_ref, name, classname, allow_null) { #name, sizeof(#name)-1, #classname, sizeof(#classname)-1, IS_OBJECT, pass_by_ref, allow_null, 0 },
#define ZEND_ARG_ARRAY_INFO(pass_by_ref, name, allow_null) { #name, sizeof(#name)-1, NULL, 0, IS_ARRAY, pass_by_ref, allow_null, 0 },
#define ZEND_ARG_TYPE_INFO(pass_by_ref, name, type_hint, allow_null) { #name, sizeof(#name)-1, NULL, 0, type_hint, pass_by_ref, allow_null, 0 },
#define ZEND_ARG_VARIADIC_INFO(pass_by_ref, name)                   { #name, sizeof(#name)-1, NULL, 0, 0, pass_by_ref, 0, 1 },

//开始和结束的固定用法
//四个参数说明（变量名称，没有用到，是否返回引用，要求的参数数量）
#define ZEND_BEGIN_ARG_INFO_EX(name, _unused, return_reference, required_num_args)  \
 static const zend_arg_info name[] = { \ { NULL, 0, NULL, required_num_args, 0, return_reference, 0, 0 }, #define ZEND_BEGIN_ARG_INFO(name, _unused) \ ZEND_BEGIN_ARG_INFO_EX(name, 0, ZEND_RETURN_VALUE, -1)
#define ZEND_END_ARG_INFO() };
//我们来看一个demo，str_replace函数的参数定义
ZEND_BEGIN_ARG_INFO_EX(arginfo_str_replace, 0, 0, 3)
ZEND_ARG_INFO(0, search)
ZEND_ARG_INFO(0, replace)
ZEND_ARG_INFO(0, subject) ZEND_ARG_INFO(1, replace_count) ZEND_END_ARG_INFO()
复制代码

我们编写myext_example_arginfo函数，来演示一下arginfo变量的使用

复制代码 
PHP_FUNCTION(myext_example_arginfo);// php_myext.h

ZEND_BEGIN_ARG_INFO_EX(arginfo_arginfo, 0,0,1)//定义arginfo_arginfo
        ZEND_ARG_INFO(1, str) //使用引用传参
ZEND_END_ARG_INFO()


PHP_FE(myext_example_arginfo, arginfo_arginfo)//每个函数一行，第一个参数与PHP_FUNCTION(name)的name一样


PHP_FUNCTION(myext_example_arginfo){   
 zval *z;   
 if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "z", &z) == FAILURE) {        
return;
    }   
 convert_to_string(z);    
ZVAL_STRING(z,"引用参数的值已经改变",1);    
return ;
}

/*php 代码*/

$ref = "我是初始值";
myext_example_arginfo($ref);
var_dump($ref);//string(30) "引用参数的值已经改变"

复制代码

在刚才的例子里，我们接受了一个php参数，我们来认真了解一个参数的接受

复制代码 
//有两个主要的函数用于在扩展函数中结果传递过来的参数，两者的区别就是ex结尾的多了一个flag参数
ZEND_API int zend_parse_parameters_ex(int flags, int num_args TSRMLS_DC, const char *type_spec, ...)
//flags 是一个标识位，当参数接收出错的时候，是否抑制警告，目前只有一个常亮可以起作用，ZEND_PARSE_PARAMS_QUIET 
//num_args 参数数量
//变量类型
ZEND_API int zend_parse_parameters(int num_args TSRMLS_DC, const char *type_spec, ...)
//num_args 参数数量
//变量类型
复制代码

type_spec参数有点类似于printf的格式化字符参数

参数　　类型　　变量类型
a数组zval*
A数组或对象zval*
b布尔值zend_bool
C类zend_class_entry*
d浮点型double
f函数zend_fcall_info*, zend_fcall_info_cache*
h数组HashTable*
H数组或对象HashTable*
l长整型long
L超出范围的长整型long
o对象zval*
O对象或指定类的对象zval*, zend_class_entry*
p字符串（一个有效的路径）char*, int
r资源类型zval*
s字符串char*, int
zzval*变量zval*
Zzval**变量zval**

 

 

 

 

 

 

 

 

 

 

 

 

 

在这些参数列表里，大部分的参数都是对应着一个变量，也就是你前面写了一个参数，后面对应的位置用一个变量去接受，有几个特殊的(f,O,p,s)，每一个参数对应两个变量。

除了参数类型，还有几个特殊用途的字符可以实现参数接收的特殊功能。

* 一共>=0个参数

+ 一共>=1个参数

| 在|之前的参数为必填参数，在|之后的参数为可选参数

/ 用来修饰前面一个参数，如果不是引用，则重新拷贝一个新的变量传递进来

! 用来修饰前面一个参数，如果传递过来的参数值为NULL，则直接转化成C语言的NULL，而不是zval的IS_NULL变量，区别在于后者增加了计算和赋值，浪费了更多的资源

看到这里，你很可能一头雾水，完全不明白这些到底怎么使用，没有关系，接着来我们来看几个例子，都是php标准扩展里面用到的，结合你在php中使用的经验，你应该一下子就会有所领悟。

复制代码 
//mixed str_replace ( mixed $search , mixed $replace , mixed $subject [, int &$count ] ) 
if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "ZZZ|Z", &search, &replace, &subject, &zcount) == FAILURE)
//在str_replace中，内核用了前3个ZZZ来接受必要的三个参数，接收到的变量是zval**类型，然后有一个|，表示后面的参数是可选的，如果传递了，还是用一个Z(zval**)变量接受它


//int array_push ( array &$array , mixed $var [, mixed $... ] )
if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "a+", &stack, &args, &argc) == FAILURE)
//在array_push中，内核用了a（zval*）来接受第一个参数，然后用了一个+表示后面至少得有一个参数传递，或者更多。


//array range ( mixed $start , mixed $limit [, number $step = 1 ] )
if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "z/z/|z/", &zlow, &zhigh, &zstep) == FAILURE)
//在range中，一共出现了3个z/，每个z/表示一个参数，说明是用z(zval*)来接受变量，同时对非引用的变量做强制拷贝后再传参


//mixed sscanf ( string $str , string $format [, mixed &$... ] )
if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "ss*", &str, &str_len, &format, &format_len,&args, &num_args) == FAILURE)
//在sscanf中，每个s表示一个字符串，得用两个变量来接受，一个char*类型，指向字符串，另一个是int型，等于字符串的长度。&str, &str_len接受第一个s,&format, &format_len接受第二个s，最后一个*表示后面还可以有0到多个参数
复制代码

 看了以上这些，你应该能了解zend_parse_parameters函数的使用了，我们继续通过几个函数例子，让你完整的理解参数的接受和使用的完整过程，由于*和+涉及到多参数的使用，会有一点点复杂，在这里我们先跳过，日后再来进一步理解。

复制代码 
//一个类似strlen的函数，接受一个字符串，返回字符串的长度

PHP_FUNCTION(myext_example_strlen){
    char *str;
    int len;
    if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "s", &str,&len) == FAILURE) {
        return;
    }
    RETURN_LONG(len);
}

/*
$str = "1234567";
var_dump(myext_example_strlen($str));
int(7)
*/
复制代码

 

复制代码 
//输入两个参数，返回最大值

PHP_FUNCTION(myext_example_max_num){
    long i1; 
    long i2; 
    if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "ll", &i1 ,&i2) == FAILURE) {
        return;
    }   
    if(i1 > i2){
        RETURN_LONG(i1);
    }else{
        RETURN_LONG(i2);
    }   
}

/*
var_dump(myext_example_max_num(5,4));
var_dump(myext_example_max_num(4,5));
var_dump(myext_example_max_num("3","2"));//当输入参数不是long型时，zend_parse_parameters会做自动转换
var_dump(myext_example_max_num(1,false));
int(5)
int(5)
int(3)
int(1)
*/
复制代码
红豆110
关注
专栏目录
php扩展开发
afterlife_union的博客
03-24 576
php 扩展开发相关知识
php扩展开发文档
01-24
PHP 扩展开发教程
PHP Extension的开发基础
weixin_33786077的博客
12-09 376
摘要&引言 PHP是当前应用非常广泛的一门语言，从国外的Facebook、Twitter到国内的淘宝、腾讯、百度再到互联网上林林总总的各种大中小型网站都能见到它的身影。PHP的成功，应该说很大程度上依赖于其开放的扩展API机制和丰富的扩展组件（PHP Extension），正是这些扩展组件使得PHP从各种数据库操作到XML、JSON、加密、文件处理、图形处理、Socket等领域无所不能。...
PHP扩展开发
wwz_henu的博客
12-28 537
PHP扩展开发
PHP实例开发源码-YodPHP(php开发框架).zip
11-21
YodPHP框架的命名可能来源于“YOu Do PHP”的缩写，旨在强调开发者可以根据自己的需求自由定制和扩展。该框架以MVC（Model-View-Controller）架构为基础，提供了一套完整的开发工具集，包括路由管理、数据库操作、...
PHP实例开发源码-ATutor php学习管理系统.zip
11-21
如果你是初学者，可以从简单的功能入手，逐步深入到更复杂的部分，这样既能巩固基础，也能逐步掌握实际项目开发的能力。对于有一定经验的开发者，这个源码可以作为优化和改进现有系统的参考，或者激发新的开发思路。
PHP实例开发源码-搜一次CMS PHP 电影程序.zip
11-22
【PHP实例开发源码-搜一次CMS PHP 电影程序.zip】是一个包含PHP源代码的压缩文件，主要用于构建一个电影信息管理系统。这个系统可能是基于搜一次CMS（Content Management System）平台，用于展示、搜索和管理电影...
PHP实例开发源码-软文CMS程序.zip
最新发布
11-23
【PHP实例开发源码-软文CMS程序.zip】是一个包含PHP源代码的压缩包，主要用于软文内容管理系统（CMS）的开发。这个压缩包可能是为了帮助开发者理解和学习PHP编程语言，以及如何构建一个用于发布、管理和编辑软文的...
PHP实例开发源码-Flarum 论坛类网站源码.zip
11-21
2. **高性能**：Flarum 采用了 Laravel 框架，这是一款非常高效的 PHP 开发框架，能够处理高并发场景，确保论坛的快速响应。 3. **可扩展性**：Flarum 支持丰富的插件和主题系统，允许开发者通过编写扩展来增加新...
PHP扩展开发（2）：实现类扩展(转载)
zsjay758的专栏
05-20 1404
转载自：http://terrylee.me/blog/post/2011/02/12/php-extension-part1.aspx在第一篇文章中，我们所开发的扩展是单个函数，本篇文章看一下如何开发一个类扩展。假设我们要用PHP扩展实 现一个类Person，它有一个private的成员变量$_name和两个public的实例方法getName()和setName()，可以用 PHP代码表示如下：_name; } public function setName($nam
PHP 扩展开发
xchenhao 的博客
02-21 545
PHP 扩展开始
掌握PHP扩展开发：内核应用与深入教程
本资源深入探讨了PHP扩展开发与内核应用的相关知识，从PHP的基本概念和生命周期入手，逐步指导读者理解其核心原理。以下是主要内容概览： 1. **PHP的生命周期**： - PHP通过SAPI接口与服务器交互，阐述了PHP从启动...
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值