將面向過程的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 <stdio.h>
//包含標頭檔,即引入所需要的宏、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);
}
************************************************************
<?php
//test.php
dl( "extern_test.so" );
echo extern_test_func(12345);
?>
************************************************************
上述php程式執行後,會輸出“12345”