博客
关于我
强烈建议你试试无所不能的chatGPT,快点击我
Just for fun——PHP7扩展编写中的宏
阅读量:6158 次
发布时间:2019-06-21

本文共 6895 字,大约阅读时间需要 22 分钟。

PHP内核架构

  • SAPI是PHP的最上层,它是PHP的应用接口层,对于源码目录为sapi
  • main是PHP的主要代码,主要是输入/输出,Web通信,以及PHP框架的初始化操作,对于源码目录为main
  • ZendVM是PHP解释器的主要实现,即ZendVM,对于源码目录为Zend 截一张的图,目录都有对应

PHP的生命周期

PHP根据不同SAPI的实现,各阶段的执行情况有些差异。譬如cli模式的话,完整地经历了这些阶段,而Fastcgi模式下则在启动时执行一次模块初始化,然后各个请求只经历请求初始化,执行请求脚本,请求关闭这几个阶段。

PHP扩展

开发者可以通过C/C++实现自定义的功能,通过扩展嵌入到PHP中。 编写扩展的步骤:

  1. 通过ext目录下ext_skel脚本生成扩展的基本框架./ext_skel --extname=module (module is the name of your extension)
  2. 修改config.m4配置:设置编译配置参数、设置扩展源文件
  3. 编写扩展源代码
  4. 生成configure:写完后先phpize(在php的bin目录下)运行一下
  5. 编译&安装: ./configure、 make、make install,然后改一下php.ini文件,添加一下.so文件

举例

操作系统:CentOS Linux release 7.3.1611 PHP版本:PHP 7.1.11

生成骨架

./ext_skel --extname=my_test --no-help复制代码

--no-help是略去注释代码(干净点) 生成目录my_test:

查看C文件

my_test.c
/* $Salamander$ */#ifdef HAVE_CONFIG_H#include "config.h"#endif#include "php.h"#include "php_ini.h"#include "ext/standard/info.h"#include "php_my_test.h"static int le_my_test;PHP_MINIT_FUNCTION(my_test){	return SUCCESS;}PHP_MSHUTDOWN_FUNCTION(my_test){	return SUCCESS;}PHP_RINIT_FUNCTION(my_test){#if defined(COMPILE_DL_MY_TEST) && defined(ZTS)	ZEND_TSRMLS_CACHE_UPDATE();#endif	return SUCCESS;}PHP_RSHUTDOWN_FUNCTION(my_test){	return SUCCESS;}PHP_MINFO_FUNCTION(my_test){	php_info_print_table_start();	php_info_print_table_header(2, "my_test support", "enabled");	php_info_print_table_end();}const zend_function_entry my_test_functions[] = {	PHP_FE_END};zend_module_entry my_test_module_entry = {	STANDARD_MODULE_HEADER,	"my_test",	my_test_functions,	PHP_MINIT(my_test),	PHP_MSHUTDOWN(my_test),	PHP_RINIT(my_test),		PHP_RSHUTDOWN(my_test),	PHP_MINFO(my_test),	PHP_MY_TEST_VERSION,	STANDARD_MODULE_PROPERTIES};#ifdef COMPILE_DL_MY_TEST#ifdef ZTSZEND_TSRMLS_CACHE_DEFINE()#endifZEND_GET_MODULE(my_test)#endif复制代码

可以注意到这里有一些

  • PHP_MINIT_FUNCTION
  • PHP_MSHUTDOWN_FUNCTION
  • PHP_RINIT_FUNCTION
  • PHP_RSHUTDOWN_FUNCTION
  • PHP_MINFO_FUNCTION 这些是PHP提供的钩子函数,PHP执行到不同的阶段时回调各个扩展定义的钩子函数,定义完成后,最后设置一下zend_module_entry对应的函数指针即可。 回顾之前的PHP的生命周期,也就是说(=>指对应某个阶段): PHP_MINIT_FUNCTION => 模块初始化阶段(M就是module的含义,init就是initial) PHP_MSHUTDOWN_FUNCTION => 模块关闭阶段(M就是module的含义,后面就是shutdown) PHP_RINIT_FUNCTION => 请求初始化(R就是request的含义,init就是initial) PHP_RSHUTDOWN_FUNCTION => 请求关闭阶段(R就是request的含义,后面就是shutdown) PHP_MINFO_FUNCTION 指获取模块信息 最后,设置zend_module_entry这个结构体
zend_module_entry my_test_module_entry = {	STANDARD_MODULE_HEADER,	"my_test",	my_test_functions,	PHP_MINIT(my_test),	PHP_MSHUTDOWN(my_test),	PHP_RINIT(my_test),		PHP_RSHUTDOWN(my_test),	PHP_MINFO(my_test),	PHP_MY_TEST_VERSION,	STANDARD_MODULE_PROPERTIES};复制代码

获取各个钩子函数的指针,有对对应的宏PHP_MINIT,PHP_MSHUTDOWN,PHP_RINIT,PHP_RSHUTDOWN,PHP_MINFO

注册函数

分为两步:

  1. 定义函数,可以通过PHP_FUNCTION()或ZEND_FUNCTION()宏来完成函数声明
  2. 注册函数,PHP提供了zend_function_entry,扩展只需为每个内部函数生成这样一个结构,然后将所有函数的结构数组提供给zend_module_entry->functions即可 For Example:
PHP_FUNCTION(my_func){    // 具体实现}复制代码

展开后

void zif_my_func(zend_execute_data *execute_data, zval *return_value){    // ...}复制代码

zend_function_entry可以通过宏PHP_FE或ZEND_FE生成(FE即function entry)。

const zend_function_entry my_test_functions[] = {    PHP_FE(my_func, NULL)	PHP_FE_END};复制代码

my_test_functions就是这个扩展注册的函数数组。 最后,它设置在了zend_module_entry(第三个参数)

zend_module_entry my_test_module_entry = {	STANDARD_MODULE_HEADER,	"my_test",	my_test_functions,	PHP_MINIT(my_test),	PHP_MSHUTDOWN(my_test),	PHP_RINIT(my_test),		PHP_RSHUTDOWN(my_test),	PHP_MINFO(my_test),	PHP_MY_TEST_VERSION,	STANDARD_MODULE_PROPERTIES};复制代码

函数参数解析

PHP提供了一个方法将zend_execute_data上的参数解析到指定变量上。

//file: Zend/zend_API.hZEND_API int zend_parse_parameters(int num_args, const char *type_spec, ...)复制代码
  • num_args:参数数量,用ZEND_NUM_ARGS()可以获取
  • type_spec 为参数解析规则,是一个字符串
  • 最后一个是可变参数,指定要解析到的变量地址 举例:
PHP_FUNCTION(my_func){    zval *arr;    if(zend_parse_parameters(ZEND_NUM_ARGS(), "a", &a) == FAILURE) {        RETURN_FALSE;    }    ...}复制代码

如果有多个变量type_spec可以变为"la",l表示整型,a表示数组(另外还有b:布尔型,s:字符串型,o:对象) ,后面则改为&a, &b

函数返回值

可以设置return_value,但PHP提供了设置了设置返回值的宏

#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_STR(s) 					{ RETVAL_STR(s); return; }#define RETURN_INTERNED_STR(s)			{ RETVAL_INTERNED_STR(s); return; }#define RETURN_NEW_STR(s)				{ RETVAL_NEW_STR(s); return; }#define RETURN_STR_COPY(s)				{ RETVAL_STR_COPY(s); return; }#define RETURN_STRING(s) 				{ RETVAL_STRING(s); return; }#define RETURN_STRINGL(s, l) 			{ RETVAL_STRINGL(s, l); return; }#define RETURN_EMPTY_STRING() 			{ RETVAL_EMPTY_STRING(); return; }#define RETURN_RES(r) 					{ RETVAL_RES(r); return; }#define RETURN_ARR(r) 					{ RETVAL_ARR(r); return; }#define RETURN_OBJ(r) 					{ RETVAL_OBJ(r); return; }#define RETURN_ZVAL(zv, copy, dtor)		{ RETVAL_ZVAL(zv, copy, dtor); return; }#define RETURN_FALSE  					{ RETVAL_FALSE; return; }#define RETURN_TRUE   					{ RETVAL_TRUE; return; }复制代码

写个小例子

写一个两个整型变量相加的函数

/* $Salamander$ */#ifdef HAVE_CONFIG_H#include "config.h"#endif#include "php.h"#include "php_ini.h"#include "ext/standard/info.h"#include "php_my_test.h"static int le_my_test;PHP_FUNCTION(my_add){	int argc = ZEND_NUM_ARGS();	zend_long a;	zend_long b;	if (zend_parse_parameters(argc, "ll", &a, &b) == FAILURE) 		RETURN_FALSE;	RETURN_LONG(a + b);}PHP_MINIT_FUNCTION(my_test){	return SUCCESS;}PHP_MSHUTDOWN_FUNCTION(my_test){	return SUCCESS;}PHP_RINIT_FUNCTION(my_test){#if defined(COMPILE_DL_MY_TEST) && defined(ZTS)	ZEND_TSRMLS_CACHE_UPDATE();#endif	return SUCCESS;}PHP_RSHUTDOWN_FUNCTION(my_test){	return SUCCESS;}PHP_MINFO_FUNCTION(my_test){	php_info_print_table_start();	php_info_print_table_header(2, "my_test support", "enabled");	php_info_print_table_end();}const zend_function_entry my_test_functions[] = {	PHP_FE(my_add, NULL)	PHP_FE_END};zend_module_entry my_test_module_entry = {	STANDARD_MODULE_HEADER,	"my_test",	my_test_functions,	PHP_MINIT(my_test),	PHP_MSHUTDOWN(my_test),	PHP_RINIT(my_test),		PHP_RSHUTDOWN(my_test),	PHP_MINFO(my_test),	PHP_MY_TEST_VERSION,	STANDARD_MODULE_PROPERTIES};#ifdef COMPILE_DL_MY_TEST#ifdef ZTSZEND_TSRMLS_CACHE_DEFINE()#endifZEND_GET_MODULE(my_test)#endif复制代码

config.m4中取消以下注释(删除dnl即可)

dnl PHP_ARG_ENABLE(my_test, whether to enable my_test support,dnl Make sure that the comment is aligned:dnl [  --enable-my_test           Enable my_test support])复制代码

然后在my_test目录下执行

phpize./configure --with-php-config=/usr/local/php7.1/bin/php-config复制代码

php-config这个脚本是获取PHP安装信息的(PHP安装路径,PHP版本,PHP源码的头文件目录,LDFLAGS,依赖的外部库,PHP编译参数),它在php的安装路径的bin目录下,如果你不指定--with-php-config的话,将到默认的PHP的安装路径下搜索(安装了多个PHP版本时最好指定一下,可能会编译不通过) 然后

make && make install复制代码

得到

Installing shared extensions:     /usr/local/php7.1/lib/php/extensions/no-debug-zts-20160303/复制代码

修改php.ini文件,加入.so

date.timezone = "Asia/Shanghai"display_errors = Onerror_reporting = E_ALLshort_open_tag=Offupload_max_filesize = 50Mpost_max_size = 50Mmemory_limit=512Mextension=my_test.so复制代码

测试加载

php -m复制代码

测试函数

php -r 'echo my_add(1, 3);'复制代码

函数调用成功。

转载地址:http://gcsfa.baihongyu.com/

你可能感兴趣的文章
MySql操作
查看>>
python 解析 XML文件
查看>>
MySQL 文件导入出错
查看>>
java相关
查看>>
由一个异常开始思考springmvc参数解析
查看>>
向上扩展型SSD 将可满足向外扩展需求
查看>>
虚机不能启动的特例思考
查看>>
SQL Server编程系列(1):SMO介绍
查看>>
在VMware网络测试“专用VLAN”功能
查看>>
使用Formik轻松开发更高质量的React表单(三)<Formik />解析
查看>>
也问腾讯:你把用户放在什么位置?
查看>>
CSS Sprites 样式生成工具(bg2css)
查看>>
[转]如何重构代码--重构计划
查看>>
类中如何对list泛型做访问器??
查看>>
C++解析XML--使用CMarkup类解析XML
查看>>
P2P应用层组播
查看>>
Sharepoint学习笔记—修改SharePoint的Timeouts (Execution Timeout)
查看>>
CSS引入的方式有哪些? link和@import的区别?
查看>>
Redis 介绍2——常见基本类型
查看>>
asp.net开发mysql注意事项
查看>>