lostphp

just do it

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

目的:在扩展中依赖其他扩展。
有的时候,我们的扩展要依赖其他扩展。比如,我们PHP的mysqli扩展就依赖mysqlnd扩展。
我们新建立一个扩展,名字叫 demo_dep , 依赖之前的myecho扩展。 在demo_dep扩展中,我们实现demo_say方法。这个方法调用myecho扩展的myecho方法。

基础代码
确保myecho扩展的头文件正确安装到了php的include文件夹。使用以下命令查看:

1
2
$ ls /usr/local/php7/include/php/ext/myecho/
php_myecho.h

如果输出内容是php_myecho.h,那么就是已经正常安装了。 如果没有正常安装,请进行如下操作进行安装。修改myecho扩展的config.m4文件。增加以下代码:

1
 PHP_INSTALL_HEADERS(ext/myecho, [php_myecho.h])

然后,编译安装扩展。make install后,你会看到输出中有:

1
Installing header files:  /usr/local/php7/include/php/

上面的/usr/local/php7/是我本机的php安装路径。

另外,必须确认,我们要调用的方法,是否在头文件中有声明。

代码实现

第一步:修改config.m4文件。增加依赖声明。增加代码如下:

1
 PHP_ADD_EXTENSION_DEP(demo_dep, myecho)

第二步:在demo_dep.c文件指定依赖myecho扩展。 在zend_module_entry demo_dep_module_entry之上增加代码:

1
2
3
4
static const  zend_module_dep demo_dep_deps[] = {
    ZEND_MOD_REQUIRED("mysqlnd")
    ZEND_MOD_END
};

然后,把demo_dep_module_entry中的STANDARD_MODULE_HEADER修改为:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
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,<code></code>
    STANDARD_MODULE_PROPERTIES
};

第三步:实现myecho方法 先增加头文件。代码如下:

1
#include "ext/say/php_myecho.h"

然后调用myecho方法,实现demo_say方法。代码如下:

1
2
3
4
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)

点赞

发表评论

电子邮件地址不会被公开。 必填项已用*标注