PHP扩展开发教程(总结)

发布时间：2020-12-12 21:09:03 所属栏目：PHP教程来源：网络整理

导读：PHP是一种解释型的语言，对于用户而言，我们精心的控制内存意味着easier prototyping和更少的崩溃！当我们深入到内核之后，所有的安全防线都已经被越过，最终还是要依赖于真正有责任心的软件工程师来保证系统的稳定运行。在TSRM/TSRM.h文件中有如下定义 #de

PHP是一种解释型的语言，对于用户而言，我们精心的控制内存意味着easier prototyping和更少的崩溃！当我们深入到内核之后，所有的安全防线都已经被越过，最终还是要依赖于真正有责任心的软件工程师来保证系统的稳定运行。

在TSRM/TSRM.h文件中有如下定义

#define TSRMLS_FETCH() void tsrm_ls = (void ) ts_resource_ex(0,NULL) #define TSRMLS_FETCH_FROM_CTX(ctx) void tsrm_ls = (void ) ctx #define TSRMLS_SET_CTX(ctx) ctx = (void ***) tsrm_ls #define TSRMG(id,type,element) (((type) (((void ) tsrm_ls))[TSRM_UNSHUFFLE_RSRC_ID(id)])->element) #define TSRMLS_D void tsrm_ls #define TSRMLS_DC,TSRMLS_D #define TSRMLS_C tsrm_ls #define TSRMLS_CC,TSRMLS_C

在ext/xsl/php_xsl.h有这么一段话

/ In every utility function you add that needs to use variables. in php_xsl_globals,call TSRM_FETCH(); after declaring other. variables used by that function,or better yet,pass in TSRMLS_CC after the last function argument and declare your utility function with TSRMLS_DC after the last declared argument. Always refer to the globals in your function as XSL_G(variable). You are. encouraged to rename these macros something shorter,see examples in any other php module directory. /

1.在方法定义时加上TSRMLS_D（如果方法没有参数用这个）或者TSRMLS_DC（有1个以上的参数）

2.在方法调用时用TSRMLS_C（如果方法没有参数用这个）或者TSRMLS_CC（有1个以上的参数）

应该可以这样理解

第一个后缀字母D表示定义，即D=Define，第一个后缀字母C表示调用，即C=Call，而第二个后缀字母C是不是表示逗号呢？ C=Comma (逗号)

TSRMLS_D就是定义了，所以是 void tsrm_ls

TSRMLS_DC是带逗号的定义，所以是,void tsrm_ls

TSRMLS_C是调用，即tsrm_ls

TSRMLS_CC是调用并带逗号，即,tsrm_ls

所以一个是形参、一个是实参

可以这样使用

int php_myext_action(int action_id,char message TSRMLS_DC); php_myext_action(42,"The meaning of life" TSRMLS_CC);

一般推荐使用tsrm_ls指针定义的方式来保证线程安全

TSRMLS_FETCH调用需要一定的处理时间。这在单次迭代中并不明显，但是随着你的线程数增多，随着你调用TSRMLS_FETCH()的点的增多，你的扩展就会显现出这个瓶颈。因此，请谨慎的使用它。注意：为了和c++编译器兼容，请确保将TSRMLS_FETCH()和所有变量定义放在给定块作用域的顶部（任何其他语句之前）。因为TSRMLS_FETCH()宏自身有多种不同的解析方式，因此最好将它作为变量定义的最后一行

2、PHP的生命周期

PHP的最多的两种运行模式是WEB模式、CLI模式，无论哪种模式，PHP工作原理都是一样的，作为一种SAPI运行。

1、当我们在终端敲入php这个命令的时候，它使用的是CLI。

它就像一个web服务器一样来支持php完成这个请求，请求完成后再重新把控制权交给终端。

2、当使用Apache作为宿主时，当一个请求到来时，PHP会来支持完成这个请求

PHP_MINIT_FUNCTION 初始化module时运行 PHP_MSHUTDOWN_FUNCTION 当module被卸载时运行 PHP_RINIT_FUNCTION 当一个REQUEST请求初始化时运行 PHP_RSHUTDOWN_FUNCTION 当一个REQUEST请求结束时运行 PHP_MINFO_FUNCTION 这个是设置phpinfo中这个模块的信息 PHP_GINIT_FUNCTION 初始化全局变量时 PHP_GSHUTDOWN_FUNCTION 释放全局变量时

比如PHP_GINIT_FUNCTION

这里有一段代码，可以测试一下

3、段错误调试

Linux下的C程序常常会因为内存访问错误等原因造成segment fault（段错误）此时如果系统core dump功能是打开的，那么将会有内存映像转储到硬盘上来，之后可以用gdb对core文件进行分析，还原系统发生段错误时刻的堆栈情况。这对于我们发现程序bug很有帮助。使用ulimit -a可以查看系统core文件的大小限制；使用ulimit -c [kbytes]可以设置系统允许生成的core文件大小。

ulimit -c 0 不产生core文件 ulimit -c 100 设置core文件最大为100k ulimit -c unlimited 不限制core文件大小

步骤：

1、当发生段错误时，我们查看ulimit -a （core file size (blocks,-c) 0）并没有文件， 2、设置：ulimit -c unlimited 不限制core文件大小 3、运行程序，发生段错误时会自动记录在core中（php -f WorkWithArray.php） 4、ls -al core.* 在那个文件下（-rw------- 1 leconte leconte 139264 01-06 22:3 1 core.2065） 5、使用gdb 运行程序和段错误记录的文件。（gdb ./test core.2065） 6、会提哪行有错。

很多系统默认的core文件大小都是0，我们可以通过在shell的启动脚本/etc/bashrc或者~/.bashrc等地方来加入 ulimit -c 命令来指定core文件大小，从而确保core文件能够生成。除此之外，还可以在/proc/sys/kernel/core_pattern里设置core文件的文件名模板，详情请看core的官方man手册。

4、常见的变量操作宏

CG -> Complier Global 编译时信息，包括函数表等(zend_globals_macros.h:32) EG -> Executor Global 执行时信息(zend_globals_macros.h:43) PG -> PHP Core Global 主要存储php.ini中的信息 SG -> SAPI Global SAPI信息

1、SG 针对SAPI信息在main/SAPI.h文件中

看一下SG的定义

BEGIN_EXTERN_C() #ifdef ZTS # define SG(v) TSRMG(sapi_globals_id,sapi_globals_struct *,v) SAPI_API extern int sapi_globals_id; #else # define SG(v) (sapi_globals.v) extern SAPI_API sapi_globals_struct sapi_globals; #endif SAPI_API void sapi_startup(sapi_module_struct *sf); SAPI_API void sapi_shutdown(void); SAPI_API void sapi_activate(TSRMLS_D); SAPI_API void sapi_deactivate(TSRMLS_D); SAPI_API void sapi_initialize_empty_request(TSRMLS_D); END_EXTERN_C()

成员都在sapi_globals_struct这里了

那么我么可以这样调用

SG(default_mimetype) SG(request_info).request_uri

可以感受一下这么一段代码

headers,&pos); while (h) { PHPWRITE_H(h->header,h->header_len); PHPWRITE_H("rn",2); h = zend_llist_get_next_ex(&sapi_headers->headers,&pos); } PHPWRITE_H("rn",2); return SAPI_HEADER_SENT_SUCCESSFULLY; }

2、EG Executor Globals

EG获取的是struct _zend_execution_globals结构体中的数据

通常，使用EG(symbol_table)获取的是全局作用域中的符号表，使用EG(active_symbol_table)获取的是当前作用域下的符号表

例如来定义$foo = 'bar'

zval *fooval;

MAKE_STD_ZVAL(fooval);
ZVAL_STRING(fooval,"bar",1);
ZEND_SET_SYMBOL(EG(active_symbol_table),"foo",fooval);

或者从符号表中查找$foo

zval **fooval; if(zend_hash_find(&EG(symbol_table),sizeof("foo"),(void **)&fooval) == SUCCESS) { RETURN_STRINGL(Z_STRVAL_PP(fooval),Z_STRLEN_PP(fooval)); } else { RETURN_FALSE; }

上面的代码中，EG(active_symbol_table) == &EG(symbol_table)

3、CG() 用来访问核心全局变量。(zend/zend_globals_macros.h)

4、PG() PHP全局变量。我们知道php.ini会映射一个或者多个PHP全局结构。(main/php_globals.h)

5、FG() 文件全局变量。大多数文件I/O或相关的全局变量的数据流都塞进标准扩展出口结构。(ext/standard/file.h)

5、获取变量的类型和值

#define Z_TYPE(zval) (zval).type #define Z_TYPE_P(zval_p) Z_TYPE(*zval_p) #define Z_TYPE_PP(zval_pp) Z_TYPE(**zval_pp)

比如获取一个变量的类型

有这么几种类型

#define IS_NULL 0 #define IS_LONG 1 #define IS_DOUBLE 2 #define IS_BOOL 3 #define IS_ARRAY 4 #define IS_OBJECT 5 #define IS_STRING 6 #define IS_RESOURCE 7 #define IS_CONSTANT 8 #define IS_CONSTANT_ARRAY 9 #define IS_CALLABLE 10

php_printf()函数是内核对printf()函数的一层封装，我们可以像使用printf()函数那样使用它，以一个P结尾的宏的参数大多是*zval型变量。此外获取变量类型的宏还有两个，分别是Z_TYPE和Z_TYPE_PP，前者的参数是zval型，而后者的参数则是**zval

比如gettype函数的实现

获取变量的值，有这么多宏来获取

rot13函数的实现

if (ZEND_NUM_ARGS( ) != 1 || zend_get_parameters_ex(1,&arg) == FAILURE) {
WRONG_PARAM_COUNT;
}
*return_value = **arg;
zval_copy_ctor(return_value);
convert_to_string(return_value);

for(i=0,ch=return_value->value.str.val;
ivalue.str.len; i++,ch++) {
cap = ch & 32;
ch &= ~cap;
ch = ((ch>='A') && (ch<='Z') ? ((ch-'A'+13) % 26 + 'A') : *ch) | cap;
}
}

要获取变量的值，也应该使用Zend定义的宏进行访问。对于简单的标量数据类型、Boolean，long，double，使用Z_BVAL,Z_LVAL,Z_DVAL

对于字符串类型，因为它含有两个字段char * (Z_STRVAL) 和 int (Z_STRLEN)，因此需要用两个宏来进行取值，因为需要二进制安全的输出这个字符串

因为数组在zval中是以HashTable形式存在的，因此使用Z_ARRVAL()进行访问

case IS_BOOL:
  /* 如果是bool类型，并且true，则输出1，否则什么也不干 */
  if (Z_BVAL_P(value)) {
    php_printf("1");
  }
  break;
case IS_LONG:
  /* 如果是long整型，则输出数字形式 */
  php_printf("%ld",Z_LVAL_P(value));
  break;
case IS_DOUBLE:
  /* 如果是double型，则输出浮点数 */
  php_printf("%f",Z_DVAL_P(value));
  break;
case IS_STRING:
  /* 如果是string型，则二进制安全的输出这个字符串 */
  PHPWRITE(Z_STRVAL_P(value),Z_STRLEN_P(value));
  break;
case IS_RESOURCE:
  /* 如果是资源，则输出Resource #10 格式的东东 */
  php_printf("Resource #%ld",Z_RESVAL_P(value));
  break;
case IS_ARRAY:
  /* 如果是Array，则输出Array5个字母！ */
  php_printf("Array");
  break;
case IS_OBJECT:
  php_printf("Object");
  break;
default:
  /* Should never happen in practice,* but it's dangerous to make assumptions
   */
   php_printf("Unknown");
   break;

}
}

一些类型转换函数

ZEND_API void convert_to_long(zval *op); ZEND_API void convert_to_double(zval *op); ZEND_API void convert_to_null(zval *op); ZEND_API void convert_to_boolean(zval *op); ZEND_API void convert_to_array(zval *op); ZEND_API void convert_to_object(zval *op); ZEND_API void _convert_to_string(zval *op ZEND_FILE_LINE_DC);

6、常量的实例化

我们可以这样实例化

常见的宏

/*注册LONG类型常量*/ #define REGISTER_LONG_CONSTANT(name,lval,flags) zend_register_long_constant((name),sizeof(name),(lval),(flags),module_number TSRMLS_CC)

/*注册double类型常量*/ #define REGISTER_DOUBLE_CONSTANT(name,dval,flags) zend_register_double_constant((name),(dval),module_number TSRMLS_CC)

/*注册STRING类型常量*/ #define REGISTER_STRING_CONSTANT(name,str,flags) zend_register_string_constant((name),(str),module_number TSRMLS_CC)

/*注册STRING类型常量*/ #define REGISTER_STRINGL_CONSTANT(name,len,flags) zend_register_stringl_constant((name),(len),module_number TSRMLS_CC)

7、全局变量

php_module_startup() -> php_startup_auto_globals() -> 保存变量到symbol_table符号表 php_cgi_startup()在 fpm/fpm/fpm_main.c中定义 php_module_startup() 在main/main.c中定义 php_startup_auto_globals() 在main/php_variables.h中定义 zend_hash_update(&EG(symbol_table),"_GET",sizeof("_GET") + 1,&vars,sizeof(zval *),NULL); /* 读取$_SERVER变量 */ static PHP_FUNCTION(print_server_vars) { zval **val; if (zend_hash_find(&EG(symbol_table),"_SERVER",sizeof("_SERVER"),(void **)&val) == SUCCESS) { RETURN_ZVAL(*val,1,0); }else{ RETURN_FALSE; } } /* 读取$_SERVER[$name] */ ZEND_BEGIN_ARG_INFO(print_server_var_arginfo,0) ZEND_ARG_INFO(0,"name") ZEND_END_ARG_INFO() static PHP_FUNCTION(print_server_var) { char *name; int name_len; zval **val; HashTable *ht_vars = NULL; HashPosition pos; zval **ret_val; if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC,"|s!",&name,&name_len) == FAILURE) { RETURN_NULL(); } if (zend_hash_find(&EG(symbol_table),(void **)&val) == SUCCESS) { ht_vars = Z_ARRVAL_PP(val); //此处需传入大于name长度+1的值，因为字符串值后面需要'' if (zend_hash_find(ht_vars,name,name_len+1,(void **)&ret_val) == SUCCESS) { RETURN_STRING(Z_STRVAL_PP(ret_val),0); }else{ RETURN_NULL(); } }else{ RETURN_NULL(); } }

8、包装第三方库

配置(config.m4)

9、用于返回的宏

//这些宏都定义在Zend/zend_API.h文件里 #define RETVAL_RESOURCE(l) ZVAL_RESOURCE(return_value,l) #define RETVAL_BOOL(b) ZVAL_BOOL(return_value,b) #define RETVAL_NULL() ZVAL_NULL(return_value) #define RETVAL_LONG(l) ZVAL_LONG(return_value,l) #define RETVAL_DOUBLE(d) ZVAL_DOUBLE(return_value,d) #define RETVAL_STRING(s,duplicate) ZVAL_STRING(return_value,s,duplicate) #define RETVAL_STRINGL(s,l,duplicate) ZVAL_STRINGL(return_value,duplicate) #define RETVAL_EMPTY_STRING() ZVAL_EMPTY_STRING(return_value) #define RETVAL_ZVAL(zv,copy,dtor) ZVAL_ZVAL(return_value,zv,dtor) #define RETVAL_FALSE ZVAL_BOOL(return_value,0) #define RETVAL_TRUE ZVAL_BOOL(return_value,1) #define RETURN_RESOURCE(l) { RETVAL_RESOURCE(l); return; } #define RETURN_BOOL(b) { RETVAL_BOOL(b); return; } #define RETURN_NULL() { RETVAL_NULL(); return;} #define RETURN_LONG(l) { RETVAL_LONG(l); return; } #define RETURN_DOUBLE(d) { RETVAL_DOUBLE(d); return; } #define RETURN_STRING(s,duplicate) { RETVAL_STRING(s,duplicate); return; } #define RETURN_STRINGL(s,duplicate) { RETVAL_STRINGL(s,duplicate); return; } #define RETURN_EMPTY_STRING() { RETVAL_EMPTY_STRING(); return; } #define RETURN_ZVAL(zv,dtor) { RETVAL_ZVAL(zv,dtor); return; } #define RETURN_FALSE { RETVAL_FALSE; return; } #define RETURN_TRUE { RETVAL_TRUE; return; }

其实，除了这些标量类型，还有很多php语言中的复合类型我们需要在函数中返回，如数组和对象，我们可以通过RETVAL_ZVAL与RETURN_ZVAL来操作它们

10、hashTable的遍历函数

//基于long key的操作函数 zval *v3; MAKE_STD_ZVAL(v3); ZVAL_STRING(v3,"value3",1); zend_hash_index_update(names,&v3,NULL);//按数字索引键更新HashTable元素的值 zval **v4; zend_hash_index_find(names,&v4); //按数字索引获取HashTable元素的值 php_printf("v4 : "); PHPWRITE(Z_STRVAL_PP(v4),Z_STRLEN_PP(v4)); php_printf("n"); ulong idx; idx = zend_hash_index_exists(names,10);//按数字索引查找HashTable，如果找到返回 1，反之则返回 0 zend_hash_index_del(names,2); //按数字索引删除HashTable元素 //hashTable的遍历函数 zend_hash_internal_pointer_reset(names); //初始化hash指针 zend_hash_internal_pointer_reset_ex(names,&pos);//初始化hash指针，并付值给pos zend_hash_get_current_data(names,(void**) &val); //获取当前hash存储值,data should be cast to void**,ie: (void**) &data zend_hash_get_current_data_ex(names,(void**) &val,&pos) == SUCCESS; //获取当前hash存储值 zend_hash_get_current_key(names,&key,&klen,&index,0) == HASH_KEY_IS_LONG zend_hash_get_current_key_ex(names,&pos) == HASH_KEY_IS_LONG; //读取hashtable当前的KEY，返回值会有两种 HASH_KEY_IS_LONG | HASH_KEY_IS_STRING ，分别对应array("value")，array("key"=>"value")两种hashtable zend_hash_move_forward(names); zend_hash_move_forward_ex(names,&pos); //hash指针移至下一位 //HashTable长度 php_printf("%*carray(%d) {n",depth * 2,' ',zend_hash_num_elements(Z_ARRVAL_P(zv))

一个简单的函数

PHP内核实现

以上所述就是本文给大家介绍的PHP扩展开发教程，希望大家喜欢。

（编辑：李大同）

【声明】本站内容均来自网络，其相关言论仅代表作者个人观点，不代表本站立场。若无意侵犯到您的权利，请及时与联系站长删除相关内容!