php扩展开发笔记(2)多个源码文件的配置和编译
程序员文章站
2022-05-16 21:45:15
...
我们在开发过程中,为了代码得可读性和易维护性,肯定是需要多个代码文件的,而不仅仅是通过 ext_skel 生成得骨架文件。这篇文章主要介绍下,多个代码文件的时候,我们需要注意什么,以及怎么做。
我的代码文件如下(slash为我的扩展名)
// ext_skel 生成默认得模块相关的主要文件php_slash.h // 头文件slash.c // 源码文件config.m4 // 编译的时候需要修改的文件
在这个默认生成的骨架文件里面,我们只要执行下面几步,就可以完成一个新的扩展了。
删除config.m4的第10-12行开头的注释dnlphpize./configuremake && make install
通过上面的步骤,我们就完成了一个扩展,通过 dl(“slash.so”);的方式就可以进行测试了。如果编写一个类在这里写链接内容里有介绍。
下面我们介绍增加新的类和源码文件以及如何编译配置等。
增加一个新的php类(Slash_Http_Util),并且给该类增加一个 getIv 的方法,php代码测试代码如下:
$httpUtil = new Slash_Http_Util();$httpUtil->getIv(); // 会输出 HELLO
源码文件 slash_http_util.h
#ifndef SLASH_HTTP_UTIL_H#define SLASH_HTTP_UTIL_Hextern zend_class_entry *slash_http_util_ce;PHP_METHOD(slash_http_util, getIv);SLASH_MINIT_FUNCTION(http_util);#endif
源码文件 slash_http_util.c
#ifdef HAVE_CONFIG_H#include "config.h"#endif#include "php.h"#include "php_ini.h" /* for zend_alter_ini_entry */#include "php_slash.h"#include "slash_http_util.h"zend_class_entry *slash_http_util_ce;PHP_METHOD(slash_http_util, getIv) { php_printf("HELLO"); RETURN_TRUE;}zend_function_entry slash_http_util_methods[] = { ZEND_ME(slash_http_util, getIv, NULL, ZEND_ACC_PUBLIC|ZEND_ACC_STATIC) PHP_FE_END};SLASH_MINIT_FUNCTION(http_util) { zend_class_entry ce; SLASH_INIT_CLASS_ENTRY(ce, SLASH_CN_HTTP_UTIL, slash_http_util_methods); slash_http_util_ce = zend_register_internal_class(&ce TSRMLS_CC); return SUCCESS;}
以上的代码完成了新类的添加,并且给该类增加了一个叫 getIv 的方法。下面需要修改我的 config.m4 配置文件,增加 slash_http_util.c 这个文件。打开 config.m4 到最后倒数第二行,默认 ext_skel 生成的代码是
PHP_NEW_EXTENSION(slash,slash.c,$ext_shared)
修改,增加 slash_http_util.c 这个文件,需要注意的是两个 *.c 文件之间是空格,没有标点符号
PHP_NEW_EXTENSION(slash,slash.c slash_http_util.c, $ext_shared)
完成 config.m4 的修改以后,还需要去修改 slash.c 这个文件,默认情况下在这个文件中会有下面的代码
PHP_MINIT_FUNCTION(slash){ /* If you have INI entries, uncomment these lines REGISTER_INI_ENTRIES(); */ return SUCCESS;}
我们需要把我们新创建的这个类载入进来
PHP_MINIT_FUNCTION(slash){ /* If you have INI entries, uncomment these lines REGISTER_INI_ENTRIES(); */ SLASH_STARTUP(http_util); return SUCCESS;}
通过这几步,新的类就完全创建成功了,你可以通过 phpize、configure、make 来编译这个模块了。最后通过我们开始制定的目标进行测试。
几个需要注意的问题:
1. 修改 config.m4 文件,增加源码文件
2. 修改 config.m4 文件以后,需要重新执行 phpize
3. 在模块加载函数中 PHP_MINIT_FUNCTION 加入这个新的类。
上面的代码中如果你完全copy可能没办法通过编译,因为我自定义重命名了几个宏(php_slash.h),实际开发中你可以zend的宏。
#define SLASH_CN_HTTP_UTIL "Slash_Http_Util"// {{{ php life cycle redefine#define SLASH_MINIT_FUNCTION(module) PHP_MINIT_FUNCTION(slash_##module)#define SLASH_MSHUTDOWN_FUNCTION(module) PHP_MSHUTDOWN_FUNCTION(slash_##module)#define SLASH_RINIT_FUNCTION(module) PHP_RINIT_FUNCTION(slash_##module)#define SLASH_RSHUTDOWN_FUNCTION(module) PHP_RSHUTDOWN_FUNCTION(slash_##module)#define SLASH_STARTUP(module) PHP_MODULE_STARTUP_N(slash_##module)(INIT_FUNC_ARGS_PASSTHRU)// }}}// {{{ class init mac#define SLASH_INIT_CLASS_ENTRY(ce, name, methods) INIT_CLASS_ENTRY(ce, name, methods)// }}}
以上代码仅供参考,欢迎交流。