本篇文章的内容介绍的是关于PHP7内核剖析11之模块扩展 ,现在分享给大家,有需要的朋友可以参考一下
1. 编译工具
(a).ext_skel:这个脚本主要生成了编译需要的配置以及扩展的基本结构
(b).php-config:这个脚本主要是获取PHP的安装信息
(c).phpize:用于生成configure文件
2.编写扩展的基本步骤
a.通过ext目录下ext_skel脚本生成扩展的基本框架;
./ext_skel --extname=wu
b.修改config.m4配置:设置编译配置参数、设置扩展的源文件、依赖库/函数检查等等;
PHP_ARG_WITH(arg_name,check message,help info): 定义一个--with-feature[=arg]这样的编译参数,参数分别为 参数名、执行./configure是展示信息、执行--help时展示信息 $PHP_参数名:获取对应的参数值
PHP_ARG_ENABLE(arg_name,check message,help info): 定义一个--enable-feature[=arg]或--disable-feature参 数,--disable-feature等价于--enable-feature=no,这个宏与PHP_ARG_WITH类似,通常情况下如果配置的参数需 要额外的arg值会使用PHP_ARG_WITH,而如果不需要arg值,只用于开关配置则会使用PHP_ARG_ENABLE。
./configure时输出结果,其中error将会中断configure执行 AC_MSG_CHECKING(message) AC_MSG_RESULT(message) AC_MSG_ERROR(message)
AC_DEFINE(variable, value, [description]): 定义一个宏,比如:AC_DEFINE(IS_DEBUG, 1, []),执行autoheader 时将在头文件中(config.h)生成:#define IS_DEBUG 1。
PHP_ADD_INCLUDE(path): 添加include路径,即:gcc -Iinclude_dir
PHP_CHECK_LIBRARY(library, function [, action-found [, action-not-found ]]): 检查依赖的库中是否存在需要 的function,action-found为存在时执行的动作,action-not-found为不存在时执行的动作
PHP_ADD_LIBRARY_WITH_PATH($LIBNAME, $XXX_DIR/$PHP_LIBDIR, XXX_SHARED_LIBADD): 添加链接库
PHP_NEW_EXTENSION(extname, sources [, shared]): 注册一个扩展,添加扩展源文件,确定此扩展是动态库还是静态库,每个扩展的config.m4中都需要通过这个宏完成扩展的编译配置。
c.编写扩展要实现的功能:按照PHP扩展的格式以及PHP提供的API编写功能;
PHP_MINIT_FUNCTION(mytest){ 这个阶段可以进行内部类的注册,如果你的扩展提供 了类就可以在此函数中完成注册;除了类还可以在此 函数中注册扩展定义的常量 } PHP_RINIT_FUNCTION(mytest){ 如果你的扩展需要针对每一个请求进行处理则可以设 置这个函数,如:对请求进行filter } PHP_RSHUTDOWN_FUNCTION(mytest){ 此函数在请求结束时被调用 } PHP_MSHUTDOWN_FUNCTION(mytest){ 模块关闭阶段回调的函数,与module_startup_func对应, 此阶段主要可以进行一些资源的清理 } PHP_FUNCTION(my_func_1){ 自定义内部函数1 } PHP_FUNCTION(my_func_1){ 自定义内部函数2(带参) zval *arr; //L当数据溢出不报错,s需要第四参数, //l(L)整型,(b)布尔型,(d)浮点型,s(S)字符串型,a(A)数组型,o(O)对象型,r资源型,z任意类型 if(zend_parse_parameters(ZEND_NUM_ARGS(), "la", &lval, &arr) == FAILURE){ RETURN_FALSE; } } const zend_function_entry mytest_functions[] = { PHP_FE(my_func_1, NULL) PHP_FE(my_func_2, NULL) PHP_FE_END //末尾必须加这个 }; zend_module_entry mytest_module_entry = { STANDARD_MODULE_HEADER, //宏统一设置 "mytest", //模块名 mytest_functions, //自定义函数数组 PHP_MINIT(mytest), //扩展初始化回调函数 PHP_MSHUTDOWN(mytest), //扩展关闭时回调函数 PHP_RINIT(mytest), //请求开始前回调函数 PHP_RSHUTDOWN(mytest), //请求结束时回调函数 NULL, //PHP_MINFO(mytest),php_info展示的扩展信息处理函数 "1.0.0", STANDARD_MODULE_PROPERTIES //宏统一设置 }; ZEND_GET_MODULE(mytest) //读取mytest_module_entry结构体
d.生成configure:扩展编写完成后执行phpize脚本生成configure及其它配置文件;
phpsize
e.编译&安装:./configure、make、make install,然后将扩展的.so路径添加到php.ini中。
./configure make make install
相关推荐:
以上是PHP7内核剖析11之模块扩展 的详细内容。更多信息请关注PHP中文网其他相关文章!