基于PHP7的PHP扩展开发之十二(依赖其他扩展)

other / 2017年07月29日 22时41分 / 10933人浏览
目的:在扩展中依赖其他扩展。 有的时候,我们的扩展要依赖其他扩展。比如,我们PHP的mysqli扩展就依赖mysqlnd扩展。 我们新建立一个扩展,名字叫 demo_dep , 依赖之前的myecho扩展。 在demo_dep扩展中,我们实现demo_say方法。这个方法调用myecho扩展的myecho方法。 基础代码 确保myecho扩展的头文件正确安装到了php的include文件夹。使用以下命令查看:
$ ls /usr/local/php7/include/php/ext/myecho/
php_myecho.h
如果输出内容是php_myecho.h,那么就是已经正常安装了。 如果没有正常安装,请进行如下操作进行安装。修改myecho扩展的config.m4文件。增加以下代码:
 PHP_INSTALL_HEADERS(ext/myecho, [php_myecho.h])
然后,编译安装扩展。make install后,你会看到输出中有:
Installing header files:  /usr/local/php7/include/php/
上面的/usr/local/php7/是我本机的php安装路径。 另外,必须确认,我们要调用的方法,是否在头文件中有声明。 代码实现 第一步:修改config.m4文件。增加依赖声明。增加代码如下:
 PHP_ADD_EXTENSION_DEP(demo_dep, myecho)
第二步:在demo_dep.c文件指定依赖myecho扩展。 在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
};
第三步:实现myecho方法 先增加头文件。代码如下:
#include "ext/say/php_myecho.h"
然后调用myecho方法,实现demo_say方法。代码如下:
PHP_FUNCTION(demo_say)
{
    zif_myecho(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 你可以把myecho扩展在ini文件的配置注释掉,就可以看到报错信息了。 第三步实现代码中我们调用的是zif_myecho。这个zif_myecho就是 PHP_FUNCTION(myecho) 展开后的方法名。 INTERNAL_FUNCTION_PARAM_PASSTHRU宏的使用,就是把传递给PHP_FUNCTION(demo_say)的参数,原样传递给PHP_FUNCTION(myecho)