前言
有的时候,我们的扩展要依赖其他扩展。比如,我们PHP的mysqli扩展就依赖mysqlnd扩展。这中情况下,我们怎么使用其他扩展呢?这个就是本文讲述的内容。
我们新建立一个扩展,名字叫 demo_dep
, 依赖之前的say
扩展。
在demo_dep
扩展中,我们实现demo_say
方法。这个方法调用say
扩展的say
方法。
代码
基础代码
确保say
扩展的头文件正确安装到了php的include文件夹。使用以下命令查看:
$ ls /usr/local/php7/include/php/ext/say/ php_say.h
如果输出内容是php_say.h
,那么就是已经正常安装了。
如果没有正常安装,请进行如下操作进行安装。修改say
扩展的config.m4文件。增加以下代码:
PHP_INSTALL_HEADERS(ext/say, [php_say.h])
然后,编译安装扩展。make install后,你会看到输出中有:
Installing header files: /usr/local/php7/include/php/
上面的/usr/local/php7/
是我本机的php安装路径。
另外,必须确认,我们要调用的方法,是否在头文件中有声明。
代码实现
第一步:修改config.m4文件。增加依赖声明。增加代码如下:
PHP_ADD_EXTENSION_DEP(demo_dep, say)
第二步:在demo_dep.c
文件指定依赖say
扩展。
在zend_module_entry demo_dep_module_entry
之上增加代码:
static const zend_module_dep demo_dep_deps[] = { ZEND_MOD_REQUIRED("mysqlnd") ZEND_MOD_END };
然后,把demo_dep_module_entry
中的STANDARD_MODULE_HEADER
修改为:
zend_module_entry demo_dep_module_entry = { // 以下两行是新加的 STANDARD_MODULE_HEADER_EX, NULL, demo_dep_deps, "demo_dep", demo_dep_functions, PHP_MINIT(demo_dep), PHP_MSHUTDOWN(demo_dep), PHP_RINIT(demo_dep), /* Replace with NULL if there's nothing to do at request start */ PHP_RSHUTDOWN(demo_dep), /* Replace with NULL if there's nothing to do at request end */ PHP_MINFO(demo_dep), PHP_DEMO_DEP_VERSION, STANDARD_MODULE_PROPERTIES };
第三步:实现say
方法
先增加头文件。代码如下:
#include "ext/say/php_say.h"
然后调用say
方法,实现demo_say
方法。代码如下:
PHP_FUNCTION(demo_say) { zif_say(INTERNAL_FUNCTION_PARAM_PASSTHRU); }
代码解读
config.m4中的PHP_INSTALL_HEADERS是用于指定把头文件安装到php的头文件目录。
* 第一个参数:安装目录
* 第二个参数:要安装的头文件名。多个头文件名用空格分割
config.m4中的PHP_ADD_EXTENSION_DEP是用于指定此扩展依赖的扩展。把此扩展静态编译进PHP时,会做检测。检测自己依赖的扩展是否被安装。
在第二步增加的依赖,主要作用是在PHP启动时,做扩展依赖检测。如果,自己依赖的扩展不能正常被加载,则报错。报错信息如下:
PHP Warning: Cannot load module 'demo_dep' because required module 'say' is not loaded in Unknown on line 0
你可以把say扩展在ini文件的配置注释掉,就可以看到报错信息了。
第三步实现代码中我们调用的是zif_say。这个zif_say就是 PHP_FUNCTION(say) 展开后的方法名。
INTERNAL_FUNCTION_PARAM_PASSTHRU宏的使用,就是把传递给PHP_FUNCTION(demo_say)的参数,原样传递给PHP_FUNCTION(say)
源码下载
文章推荐
交流社区
技术交流
原文链接:PHP7扩展开发之依赖其他扩展,转载请注明来源!