终于有机会写c++了,虽然现在还是摸着石头过河,但是能过河说明就再实践了,之前写了,python、java对c++的调用,和c++的动态链接库的创建,终于轮到写php对c++的调用了,这里不是单纯的helloworld,而是在ace基础上封装类,本文主要说c++开发php扩展的基本方法和php扩展类的创建方法,已经如何引用第三方库。
因为php官方提供的示例是以c开发为基础,所以相对c++开发的资料还是有点难找,下面进入正题
一、c++扩展开发步骤
1、down一份php的源码,如我的php是5.3.3,我就down了一份php5.3.3的源码
2、解压进入ext目录下,执行:./ext_skel –extname=AceClient。我建的是一个名为aceclient的模块
3、按照提示应该是修改 config.m4,因为是c++所以需要这样
//1、找到以下三句类似代码去除前面的dnl(注释符)
PHP_ARG_WITH(AceClient, for AceClient support,
Make sure that the comment is aligned:
[ --with-AceClient Include AceClient support])
//2、在if test "$PHP_ACECLIENT" != "no"; then这句判断内加入如下代码
PHP_REQUIRE_CXX() #告诉它用c++来编译
PHP_ADD_LIBRARY(stdc++, "", EXTRA_LDFLAGS)
EXTRA_LDFLAGS="$EXTRA_LDFLAGS -lACE" #需要引入的第三方模块ACE
CPPFILE="AceClient.cpp ace_client.cpp" #需要编译的cpp文件集合
PHP_NEW_EXTENSION(AceClient, $CPPFILE, $ext_shared)
2、更改php_AceClient.h,找到#ifdef ZTS,#include “TSRM.h”,#endif这三句前后加代码
//兼容c代码
extern "C" {
#ifdef ZTS
#include "TSRM.h"
#endif
}
3、把AceClient.c为AceClient.cpp,同样AceClient.cpp中找到#ifdef HAVE_CONFIG_H—#include “ext/standard/info.h”前后加代码
extern "C" {
#ifdef HAVE_CONFIG_H
#include "config.h"
#endif
#include "php.h"
#include "php_ini.h"
#include "ext/standard/info.h"
}
到此,php扩展需要兼容c的代码部分就修改完了
二、c++扩展类开发示例
下面先看需要实现的结果
//$b = get_loaded_extensions(); //可以查看扩展是否加载成功
//var_dump($b);
$a = new AceClient("127.0.0.1", 50050, 200);
var_dump($a);
$ret = $a->send("铃不铃不铃");
var_dump("send:".$ret);
$ret = $a->receive();
var_dump("receive:".$ret);
目前php的官方示例代码是都是提供了函数的开发,所以函数的开发略过,直接讲解类的开发过程,http://devzone.zend.com/1435/wrapping-c-classes-in-a-php-extension/ 这是zend官方的一篇类开发说明文,有点长,抽离了一下主要的部分讲解
1、加载一些需要的文件
#include "php_AceClient.h" //这个是本来就存在的,闲杂不需要放在extern "C"中了
#include "ace_client.h" //这个是业务类代码,目的是为了个语言统一
2、加入我们的业务代码,即新建类,基本是模板,直接改就行:
/****************************extension class***************************/
zend_class_entry *ace_ce;
zend_object_handlers ace_object_handlers;
struct ace_object { //声明个结构体存储业务代码的ace instance对象
zend_object std;
Esun_Ace_Client *ace_ins;
};
//创建php的构造函数
PHP_METHOD(Esun_Ace_Client, __construct){
long port, timeout;
char *ip; int ip_len;
Esun_Ace_Client *ecli = NULL;
zval *object = getThis();
if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "sll", &ip, &ip_len, &port, &timeout) == FAILURE) {
RETURN_NULL();
}
ecli = new Esun_Ace_Client(ip, (int)port);
ace_object *obj = (ace_object *)zend_object_store_get_object(object TSRMLS_CC);
obj->ace_ins = ecli;
}
//创建ace发送方法
PHP_METHOD(Esun_Ace_Client, send){
char *data; int data_len, ret = -1;
if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "s", &data, &data_len) == FAILURE) {
RETURN_NULL();
}
Esun_Ace_Client *ecli = NULL;
ace_object *obj = (ace_object *)zend_object_store_get_object(
getThis() TSRMLS_CC);
ecli = obj->ace_ins;
if (ecli != NULL) {
ret = ecli->send_data(data);
}
RETURN_LONG(ret);
}
//创建php的接收方法
PHP_METHOD(Esun_Ace_Client, receive){
char *data;
Esun_Ace_Client *ecli = NULL;
ace_object *obj = (ace_object *)zend_object_store_get_object(
getThis() TSRMLS_CC);
ecli = obj->ace_ins;
if (ecli != NULL) {
data = ecli->receive_data();
}else{
RETURN_NULL();
}
RETURN_STRING(data, strlen(data));
}
//说明php类存在的几个方法
function_entry ace_methods[] = {
PHP_ME(Esun_Ace_Client, __construct, NULL, ZEND_ACC_PUBLIC | ZEND_ACC_CTOR)
PHP_ME(Esun_Ace_Client, send, NULL, ZEND_ACC_PUBLIC)
PHP_ME(Esun_Ace_Client, receive, NULL, ZEND_ACC_PUBLIC)
{NULL, NULL, NULL}
};
//这基本是模板函数,拷贝,替换一下相关值就行了
void ace_free_storage(void *object TSRMLS_DC){
ace_object *obj = (ace_object *)object;
delete obj->ace_ins;
zend_hash_destroy(obj->std.properties);
FREE_HASHTABLE(obj->std.properties);
efree(obj);
}
//一样的模板函数,拷贝,用于创建类对象保存
zend_object_value ace_create_handler(zend_class_entry *type TSRMLS_DC){
zval *tmp;
zend_object_value retval;
ace_object *obj = (ace_object *)emalloc(sizeof(ace_object));
memset(obj, 0, sizeof(ace_object));
obj->std.ce = type;
ALLOC_HASHTABLE(obj->std.properties);
zend_hash_init(obj->std.properties, 0, NULL, ZVAL_PTR_DTOR, 0);
zend_hash_copy(obj->std.properties, &type->default_properties,
(copy_ctor_func_t)zval_add_ref, (void *)&tmp, sizeof(zval *));
retval.handle = zend_objects_store_put(obj, NULL,
ace_free_storage, NULL TSRMLS_CC);
retval.handlers = &ace_object_handlers;
return retval;
}
/****************************************************************/
3、业务代码就完了,现在只剩下通知PHP_MINIT_FUNCTION(模块初始化需要处理的方法)
PHP_MINIT_FUNCTION(AceClient)
{
zend_class_entry ce;
INIT_CLASS_ENTRY(ce, "AceClient", ace_methods); //注册php类并注册相关方法
ace_ce = zend_register_internal_class(&ce TSRMLS_CC);
ace_ce->create_object = ace_create_handler;
memcpy(&ace_object_handlers,
zend_get_std_object_handlers(), sizeof(zend_object_handlers));
ace_object_handlers.clone_obj = NULL;
return SUCCESS;
}
一、编译php的扩展模块AceClient
如果上面就操作完了,接下来的动作就简单多了
1、初始化一下模块的环境,执行 phpize。
2、配置,./configure
3、编译,make
4、如果没有问题的情况下,modules下面应该会出现一个 AceClient.so 模块
5、在php.ini中加载,为了尽可能不改php.ini,所以就加载php.d目录下,vi AceClient.ini;添加:extension=/home/xxx/php-5.3.3/ext/AceClient/modules/AceClient.so
6、重启一下apache,注意看看错误日志,如我出现libACE.so.6.1.7: cannot open shared object file,这是因为第三方库libACE模块在/usr/local/lib下面,所以我就软连了一份到/usr/lib64下面。还有一个错误出现了Backtrace: zend_objects_store_del_ref_by_handle,原来是我在接收port值时忘了加&
7、大功告成,乐你的吧