将面向过程的C或C++接口封装给PHP使用,即这里指的面向过程的封装。
封装PHP扩展的意义在于:由于PHP不能直接使用C函数,他需要使用自己的内存管理方式和参数管理方式,因此要在C代码和PHP代码间,将要使用的函数和变量做一个“一一映射”。
封装大致分为6步:
1.包含头文件
2.声明导出函数
3.声明zend函数块
4.声明zend模块
5.实现get_module()函数
6.实现导出函数
可以看一个最简单的例子,源分别是文件test.h和test.cpp,他们生成extern_test.so。然后由test.php动态加载这个动态链接库。
*********************************************************
//test.h
#ifndef _EXTERN_TEST_H_
#define _EXTERN_TEST_H_
#include
//包含头文件,即引入所需要的宏、API定义等
#ifdef __cplusplus
extern "C" {
#endif
# include "php.h"
# include "php_ini.h"
# include "ext/standard/info.h"
#ifdef __cplusplus
}
#endif
#define EXTERN_TEST_VERSTR "0.1.0"
ZEND_MINFO_FUNCTION( extern_test );
ZEND_FUNCTION( extern_test_func ); //声明导出函数
#endif
************************************************************
//test.cpp
#include "test.h"
//声明zend函数块
zend_function_entry extern_test_functions[] =
{
ZEND_FE( extern_test_func,NULL )
{ NULL,NULL,NULL }
};
//声明zend模块
zend_module_entry extern_test_module_entry =
{
STANDARD_MODULE_HEADER,
"extern_test",
extern_test_functions,
NULL,
NULL,
NULL,
NULL,
ZEND_MINFO(extern_test),
EXTERN_TEST_VERSTR ,
STANDARD_MODULE_PROPERTIES
};
//实现get_module()函数
#ifdef __cplusplus
BEGIN_EXTERN_C()
#endif
ZEND_GET_MODULE(extern_test)
#ifdef __cplusplus
END_EXTERN_C()
#endif
ZEND_MINFO_FUNCTION(extern_test)
{
}
//实现导出函数
ZEND_FUNCTION( extern_test_func )
{
int iInt=0;
if ( ZEND_NUM_ARGS() == 1 ){
if ( zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "l",&iInt) == FAILURE){
RETURN_LONG( ERR_PARAM_NUM );
}
}else{
RETURN_LONG( ERR_PARAM_NUM );
}
RETURN_LONG(iInt);
}
************************************************************
//test.php
dl( "extern_test.so" );
echo extern_test_func(12345);
?>
************************************************************
上述php程序执行后,会输出“12345”