首页 » 编程语言 » PHP » PHP7扩展开发之依赖其他扩展

PHP7扩展开发之依赖其他扩展

 

前言

有的时候,我们的扩展要依赖其他扩展。比如,我们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)

源码下载

tar.gz格式下载
zip格式下载

文章推荐

更多PHP7扩展开发教程文章,请点击查看

交流社区

原文链接:PHP7扩展开发之依赖其他扩展,转载请注明来源!

7