[转载]用c写PHP的扩展接口(php5,c++)

原文[http://bugs.tutorbuddy.com/php5cpp/php5cpp/]

第1节. 开始之前

开始前,我要说明:这篇文章所描述的主要是在UNIX的PHP环境上的。

另外一点我要说明的是:文中所介绍的方法在PHP 4.3.x和PHP 5下都是可行的。尽管我们在开始的时候会基于PHP5来介绍,但是你会发现这些方法在PHP 4.3.x中也是可行的。

我在本文中有一些约定...

$PHP_HOME 是指你的PHP源代码的位置,如:你解开的PHP源代码包所放的位置。在我的系统中指的是:/home/jay/setup/php/php-x.x.x.

我们用来做例子的模块叫做php5cpp.

第2节.安装

在你用C++编写PHP扩展前,你先要搭建一个基本的扩展模块的架构。在UNIX下,你可以运行一个在 $PHP_HOME/ext 下叫做ext_skel 的shell脚本。先切换到 $PHP_HOME/ext 目录和执行那个shell脚本,并用 --extname 参数为你的扩展模块命名。

[email protected] ~ $ cd setup/php/php-5.x.x/ext

[email protected] ext $ ./ext_skel --extname php5cpp

在Windows系统,目前PHP CVS代码中,可以使用位于 $PHP_HOME/ext 的 ext_skel_win32.php 的PHP脚本是。也许它会成为PHP5的一部分及被PHP 4.x的分支包含。但这只是我大胆的猜想,我并不知道会不会实现...

这样,在$PHP_HOME/ext/php5cpp下,我们已经有了一个基本的PHP扩展模块架构。唯一的问题是,它是为C搭建的,而不是为C++。

第3节.修改config.m4

现在我们要修改那个扩展模块的config.m4 文件以支持C++。

你不需要做太多的改动,要做的只是告诉编译PHP的系统,你的模块是使用C++的,而且需要连接C++标准库。下边是一个删去自动生成的注释后,php5cpp 扩展模块的config.m4文件的例子:

PHP_ARG_ENABLE(php5cpp, for php5cpp support,

[ --enable-php5cpp Enable php5cpp support])

if test "$PHP_php5cpp" != "no" ; then

PHP_REQUIRE_CXX()

PHP_NEW_EXTENSION(php5cpp, php5cpp.cpp, $ext_shared)

fi

注意其中的PHP_REQUIRE_CXX(),和php5cpp.c 已经变成了 php5cpp.cpp 了。
第4节.编写代码

修改完config.m4 后,你可以编写代码了。记住把php5cpp.c 修改成C++文件的名字。根据前边 config.m4的修改,在这里我们把它改成 php5cpp.cpp.

现在你可以开始编写你的代码了。但是你如果现在编译这个扩展代码的话,可能会生一个so,并且不会产生任何编译错误,但是并不能在PHP中使用。如果你把它静态编译进PHP,则会产生连接错误。这是因为C和C++的变量空间的不一致引起的 (PHP是使用C来编写,你的扩展使用C++来编写) 。

修改的方法就是,你要告诉你的扩展模块,将把一些PHP API函数当成C函数来对待(他们是用C来写的),而不是当成C++。

你需要把一些代码用 BEGIN/END_EXTERN_C()包起来。你的php5cpp.cpp 可能要写成像下边的样子:

extern "C" {

#include "php.h"

#include "php_ini.h"

#include "ext/standard/info.h"

}

#ifdef COMPILE_DL_PHP5CPP

BEGIN_EXTERN_C()

ZEND_GET_MODULE(php5cpp)

END_EXTERN_C()

#endif

一般地,我们是用 BEGIN/END_EXTERN_C() 来包起头文件的那些内容,如对 ZEND_GET_MODULE(php5cpp)那样。但是在引用声明 BEGIN/END_EXTERN_C() 的 zend.h文件前,可以通过使用extern "C" 来达到相同的作用。

在Windows系统,可以使用Visual C++编译你的扩展模块。这也需要在的扩展模块的头部加上类似的声明:

#ifdef PHP_WIN32

#include

#include

#endif

这样你可以使得你的代码保持跨平台的特性。

第5节.编译扩展模块

现在可以去编译扩展模块了。如果你想把它编译成静态模块(把它做为PHP的一个部分编译进PHP中去),去到PHP的根目录$PHP_HOME,删去 configure 文件和运行buildconf (译:需要libtool的支持)。

然后用你平常用的参数运行 configure 并加上--enable-php5cpp 项。运行 make clean, make, make install ,并完成其它的一些必要操作,如:重新编译Apache。

如果你想用动态链接库的方式编译扩展模块,到你的模块的目录下,运行phpize 命令(假设你已经安装了PEAR),它会为你的模块创建一个 configure 脚本。然后运行configure, make 和 make install。如果你想让你的模块自动加载,你要修改php.ini 以加载正确的文件。如:加上类似的一行:extension=php5cpp.so 。

现在你的PHP扩展模块已经编译好了。试着运行一下在模块目录下自动生成的php5cpp.php ,看看是不是一切正常?:)

第6节.将C++类影射到PHP中

目录

类MyClass

宏、函数及其它

封装代码

PHP 5的类支持很多新的特性。如:权限(protected, public, private),异常,interfaces,等等。在这个简单的介绍中,我们只做最基本的事情:使PHP可以影射到C++的类。这样你可以用PHP中使用你的类,之后的事情将会变得很简单的。在看下面的介绍之前,你可以参考一下Sqlite, SimpleXML 及 cryptopp-php 模块的代码。

这里介绍一下。我们要用一个C++类做为例子,就叫做 MyClass吧。在PHP术语中,把它叫做一个resource(资源)。PHP常使用这类的东西,如数据库的连接就是resource,它也可能是一个指向实际resource的struct(结构)。在C++中,class 实际上是struct的一个近义词(struct默认为public,classe默认为private --仅这个区别而已)。

在结构化的接口中,我们会用类似以下的PHP代码来使用resources:

$m = myclass_new();

myclass_set_string($m, ‘hello world!‘);

var_dump(myclass_get_string($m));

?>

在面向对象式的接口中,一样可以使用PHP resources,不过已经被封装在一个PHP对象中了,如:

$m = new MyClass;

$m->setString(‘hello world!‘);

var_dump($m->getString());

?>

我们不需要关心被封装的实际的代码做了些什么。当我们有一个叫MyClass的C++类。我们可以把这个C++类当成resources并把C++类里的方法封装成PHP的函数。然后我们也可以把它封装成一个PHP的对象,使得可以像一般的C++那样使用。

在看本文时,记住我们的目的就是:把C++类封装成PHP可以使用的结构化的函数或对象化的类。也许在一开始有些东西会令你迷惑,但读下去后就会慢慢明白的了。中间会有很多的宏定义,但当你看明白后,会觉得所有东西都很清淅很容易了。
1 类MyClass

首先我们需要一个类。下边是一个只有一个私有属性和几个公有方法的简单的类。

以下是这个类的声明头文件 myclass.h:

#ifndef __MYCLASS_H__

#define __MYCLASS_H__

#include

using namespace std;

class MyClass {

private:

string itsString;

public:

MyClass(string s = "default");

~MyClass();

string getString() const;

bool setString(const string s);

};

#endif

下边是定义代码myclass.cpp:

#include "myclass.h"

MyClass::MyClass(string s)

{

itsString = s;

}

MyClass::~MyClass()

{

}

string MyClass::getString() const

{

return itsString;

}

bool MyClass::setString(const string s)

{

itsString = s;

return true;

}

这只是一个做为例子的类。

然后我们要让构建系统知道和可以编译这些文件。把config.m4文件做以下修改:

PHP_NEW_EXTENSION(php5cpp, php5cpp.cpp, $ext_shared)

becomes...

PHP_NEW_EXTENSION(php5cpp, php5cpp.cpp myclass.cpp, $ext_shared)

在php5cpp.cpp 文件中增加#include “myclass.h” :

extern "C" {

#include "php.h"

#include "php_ini.h"

#include "ext/standard/info.h"

}

#include "php_php5cpp.h"

#include "myclass.h"

不要把include php_php5cpp.h 和 myclass.h 的语句放在 extern "C" 中,否则会出现错误。
2 宏、函数及其它

为了让这个模块可以同时在PHP 4和PHP 5使用,我们需要使用一些宏去声明是依赖于PHP 4或是PHP 5的。因为PHP 4和PHP 5的执行文件是不兼容的,所以你需要为这两个PHP的版本分别编译不同的版本。

通常我会把这些宏的声明放在一个单独的文件中。在这个例子里,就放在objects.h 中吧。

objects.h 中要写一些PHP 5需要的函数,如:

#ifndef __PHP5CPP_OBJECTS_H__

#define __PHP5CPP_OBJECTS_H__

#if PHP_MAJOR_VERSION == 5

zend_class_entry *php5cpp_ce_myclass;

static zend_object_handlers php5cpp_object_handlers_myclass;

function_entry php5cpp_myclass_methods[] = {

ZEND_ME_MAPPING(MyClass, myclass_new, NULL)

ZEND_ME_MAPPING(setString, myclass_set_string, NULL)

ZEND_ME_MAPPING(getString, myclass_get_string, NULL)

{NULL, NULL, NULL}

};

typedef enum {

is_myclass

} php5cpp_obj_type;

struct php5cpp_obj {

zend_object std;

int rsrc_id;

php5cpp_obj_type type;

union {

MyClass *myclass;

} u;

};

你可以发现,为了保持一致,每个声明都加上了php5cpp_ 前缀。这是习惯上的一种约定。

另外,#if PHP_MAJOR_VERSION == 5表明在下边的那些宏、函数等都只是在PHP 5下才生效,当我们在PHP 4下编译时它们会被预处理忽略掉。

php5cpp_ce_myclass 是类 MyClass 的入口。 php5cpp_object_handlers_myclass 是类的内部处理handler(句柄)。

php5cpp_myclass_methods[] 把MyClass中的函数影射成可在PHP使用的标准函数。这样我们在PHP中就可以使用 myclass_new, myclass_get_string 等来执行这些函数。你会发现这里并没有定义myclass_destroy函数,因为在你对一个类实例使用unset() 时,系统会自动调用它的释构函数的了。

在结构php5cpp_obj中的枚举变量 php5cpp_obj_type 声明了对象的类型。如果你想在扩展中再加入一个类,如: AnotherClass,你需要再增加一项,如: is_anotherclass。

php5cpp_obj 结构中声明了在PHP中使用的一些基本信息,包括:

一个resource ID:rsrc_id ,它指向PHP内部的一个记录着C++对象的track的resource(资源)。实际上,我们的类在PHP中的操作是更像是一个PHP resource,它有自己的垃圾回收和引用计数等机制。

一个zend_object 来声明我们的PHP类,使得它可以像PHP的类那样。当使用这个PHP类时,实际上就会调用我们的C++类去处理了。(需要记住的是:使用时需要像使用其它PHP类那样动态的创建它。(译:使用new))

type 声明现在处理的对象。在这里,它只有一个:is_myclass。但正如我前边说过,你可以再增加其它的类。

联合类型变量u 保存了指向C++对象实例的指针。如果你在这个扩展中还有其它class,那还需要在这再增加其它的指针,如:AnotherClass *anotherclass。

static void php5cpp_object_free_storage(zend_object *object TSRMLS_DC)

{

php5cpp_obj *obj = (php5cpp_obj *) object;

zend_hash_destroy(obj->std.properties);

FREE_HASHTABLE(obj->std.properties);

if (obj->u.myclass) {

zend_list_delete(obj->rsrc_id);

}

efree(obj);

}

static void php5cpp_object_new(zend_class_entry *class_type, zend_object_handlers *handlers, zend_object_value *retval TSRMLS_DC)
{

zval *tmp;

php5cpp_obj *obj = (php5cpp_obj *) emalloc(sizeof(php5cpp_obj));

memset(obj, 0, sizeof(php5cpp_obj));

obj->std.ce = class_type;
ALLOC_HASHTABLE(obj->std.properties);
zend_hash_init(obj->std.properties, 0, NULL, ZVAL_PTR_DTOR, 0);
zend_hash_copy(obj->std.properties, &class_type->default_properties, (copy_ctor_func_t) zval_add_ref, (void *) &tmp, sizeof(zval *));
retval->handle = zend_objects_store_put(obj, NULL, php5cpp_object_free_storage, NULL TSRMLS_CC);

retval->handlers = handlers;

}

php5cpp_object_free_storage() 可以看成了对象是 php5cpp_obj 的释构函数,因为它要做的就是把MyClass的对象释放掉

php5cpp_object_new() 基本上算是一个构造函数,它负责分配内存空间,分配zend_object结构,及初始化handler(句柄)等等。它负责为扩展中所有的类的构造,不管是对象MyClass 还是 AnotherClass。

php5cpp_object_new_myclass() 通过调用 php5cpp_object_new() 来创建一个PHP MyClsss的实例。如果在扩展中有几个类的话,你要为每个类写一个类似php5cpp_object_new_*()函数。

// Register the class entry..
#define PHP5CPP_REGISTER_CLASS(name, obj_name) \
{ \

zend_class_entry ce; \

INIT_CLASS_ENTRY(ce, obj_name, php5cpp_ ## name ##_methods); \

ce.create_object = php5cpp_object_new_ ## name; \

php5cpp_ce_ ## name = zend_register_internal_class_ex(&ce, NULL, NULL TSRMLS_CC); \

memcpy(&php5cpp_object_handlers_ ## name, zend_get_std_object_handlers(), sizeof(zend_object_handlers)); \

php5cpp_object_handlers_ ## name.clone_obj = NULL; \

php5cpp_ce_ ## name->ce_flags |= ZEND_ACC_FINAL_CLASS; \

}

// Register resources. If we‘re using an object, put it into the object store.

#define PHP5CPP_REGISTER_RESOURCE(obj_type, return_value, res, le) \
{ \

int rsrc_id = ZEND_REGISTER_RESOURCE(object ? NULL : return_value, res, le); \

if (object) { \
php5cpp_obj *obj = (php5cpp_obj *) zend_object_store_get_object(object TSRMLS_CC); \

obj->u.obj_type= res; \

obj->rsrc_id = rsrc_id; \

obj->type = is_ ## obj_type; \

} \

}

#define PHP5CPP_REGISTER_MYCLASS_RESOURCE(return_value, res, le) \

PHP5CPP_REGISTER_RESOURCE(myclass, return_value, res, le)

接着我们要在php5cpp.cpp中加上以上的宏。虽然看起来很相似,但不要把它们弄乱,实际上PHP5CPP_REGISTER_CLASS() 和PHP5CPP_REGISTER_RESOURCE()的处理是不一样的。

PHP5CPP_REGISTER_CLASS() 登记一个类的实际处理的程序。在后边介绍模块初始化函数(PHP_MINIT_FUNCTION())时还会遇到它。

PHP5CPP_REGISTER_RESOURCE() 负责在登记一个resource时取得resource得ID。其实resource就是我们的C++对象的一个实例。当我们处理一个对象时,它会创建一个PHP对象,把实际的对象保存在PHP的对象贮存器中,然后把resource ID记录在PHP对象中。

PHP5CPP_REGISTER_MYCLASS_RESOURCE() 只是为了使用 PHP5CPP_REGISTER_RESOURCE()时可以方便一些。
// These are for parsing parameters and getting the actual object from the store.
#define PHP5CPP_GET_THIS() \
zval* object = getThis();
#define PHP5CPP_SET_OBJ(type) \
php5cpp_obj *obj = (php5cpp_obj *) zend_object_store_get_object(object TSRMLS_CC); \
type ## _instance = obj->u.type;
#define PHP5CPP_OBJ_PARAMS(type, params) \
PHP5CPP_GET_THIS(); \
if (object) { \
if (params == FAILURE) { \
RETURN_FALSE; \
} \
PHP5CPP_SET_OBJ(type) \
} \
else
#define PHP5CPP_OBJ_NO_PARAMS(type) \
PHP5CPP_GET_THIS(); \
if (object) { \
if (ZEND_NUM_ARGS() != 0) { \
php_error(E_WARNING, "didn‘t expect any arguments in %s()", get_active_function_name(TSRMLS_C)); \
} \

PHP5CPP_SET_OBJ(type) \

} \

else

#define PHP5CPP_MYCLASS_OBJ_PARAMS(params) PHP5CPP_OBJ_PARAMS(myclass, params)

#define PHP5CPP_MYCLASS_OBJ_NO_PARAMS() PHP5CPP_OBJ_NO_PARAMS(myclass)

PHP5CPP_GET_THIS() 会返回当前使用对象的指针。如果当前使用的是一个结构,那么getThis() 会返回NULL;如果使用的是一个对象,getThis() 返回一个指向当前PHP对象的指针。

PHP5CPP_SET_OBJ() 会从对象贮存器中取得PHP对象实际使用的C++对象实例,然后可以用来做其它处理。在使用PHP函数/方法时,对象会贮存在类似"type ## _instance" 的类型里,如:在我们的例子中是myclass_instance,即MyClass*类型。

PHP5CPP_*_OBJ_PARAMS() 和 PHP5CPP_*_NO_OBJ_PARAMS() 会在调用我们的函数/方法时被使用,它们会处理从PHP方传进来的参数。在封装函数和声明中,可以通过zend_parse_parameters() 去分析这些参数。

你可以注意到,宏PHP5CPP_*_PARAMS() 是以 else结尾的。这样的话,当所处理的不是一个对象时,它会试着用结构化方式去处理。这些宏都可以在下边找到。

为PHP 5写的类处理的部分已经写完了,下边的部分是为PHP 4写的很简单易懂的处理。如果我们用的是PHP 4,上边的那部分代码在预处理时会被乎略掉,而只处理下边的这些代码。如果我们用的是PHP 5则反之。

#else // End of PHP5-specific macros

// This stuff is for PHP 4. They‘re empty on purpose, obviously.

#define PHP5CPP_GET_THIS()

#define PHP5CPP_MYCLASS_OBJ_PARAMS(params)

#define PHP5CPP_MYCLASS_OBJ_NO_PARAMS()

#define PHP5CPP_REGISTER_CLASS(name, obj_name)

#define PHP5CPP_REGISTER_MYCLASS_RESOURCE(return_value, res, le) \

ZEND_REGISTER_RESOURCE(return_value, res, le);

#endif // End of PHP4-specific macros

非常的简单,除了PHP5CPP_REGISTER_MYCLASS_RESOURCE()外其它的宏都是空的。 PHP5CPP_REGISTER_MYCLASS_RESOURCE()仍会注册一个resource,但不会为对象做任何的检查。好了,完成这些后,就使得代码在PHP 4和PHP 5中都可以编译通过了。

下边的一些宏在PHP 4和PHP 5中都是一样的,它们是处理结构和非面向对象代码的。

// These are for both PHP 4 and 5

#define PHP5CPP_MYCLASS_RSRC_PARAMS(params) \

if (params == FAILURE) { \

RETURN_FALSE; \

} \

else { \

ZEND_FETCH_RESOURCE(myclass_instance, MyClass*, &resource, -1, "myclass", le_myclass); \

}

#define PHP5CPP_MYCLASS_RSRC_NO_PARAMS() \

if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "r", &resource) == FAILURE) { \

RETURN_FALSE; \

} \

else { \

ZEND_FETCH_RESOURCE(myclass_instance, MyClass*, &resource, -1, "myclass", le_myclass); \

}

static ZEND_RSRC_DTOR_FUNC(destroy_myclass)
{
if (rsrc->ptr) {

delete (MyClass*) rsrc->ptr;

rsrc->ptr = NULL;

}

}

#endif

它们同样是很简单的:先试着分析PHP界面传进来的参数,和取得要处理的resource。

destroy_myclass 负责资源回收。当触发垃圾回收机制,或destroy 对象/ resource 时,它会把在创建C++对象实例时分配的内存清理/释放掉。

在php5cpp.cpp里我们会这样使用这些宏:

PHP5CPP_MYCLASS_OBJ_PARAMS(zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "s", &s, &len))

PHP5CPP_MYCLASS_RSRC_PARAMS(zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "rs", &resource, &s, &len))

在PHP 5中,经过预处理后会变成这样:

zval* object = getThis();

if (object) {

if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "s", &s, &len) == FAILURE) {

RETURN_FALSE;

}

php5cpp_obj *obj = (php5cpp_obj *) zend_object_store_get_object(object TSRMLS_CC);

myclass_instance = obj->u.myclass;

}

else if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "rs", &resource, &s, &len) == FAILURE) {

RETURN_FALSE;

}

else {

ZEND_FETCH_RESOURCE(myclass_instance, MyClass*, &resource, -1, "myclass", le_myclass); \

}

可以看到,在面向对象模式下,它会试着去取得对象,分析参数和取得实际的MyClass对象。如果在非面向对象的模式下,这段代码会试着用结构的方式去分析参数,取得resource等等。

在PHP 4中,经过预处理后会变成了下边这样:

if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "rs", &resource, &s, &len) == FAILURE) {

RETURN_FALSE;

}

else {

ZEND_FETCH_RESOURCE(myclass_instance, MyClass*, &resource, -1, "myclass", le_myclass); \

}

在这里(PHP 4中),面向对象的代码会完全给忽略掉,只留下结构化程序的代码。

为了上边我们做的有意义,现在我们要做一个最简单的部分,写我们的封装代码,和使得在PHP中可以使用我们的class。
3 封装代码

我们要在php_php5cpp.h中加入一些封装函数和方法的定义:

PHP_FUNCTION(myclass_new);

PHP_FUNCTION(myclass_destroy);

PHP_FUNCTION(myclass_set_string);

PHP_FUNCTION(myclass_get_string);

简单吧。好,那我们在php5cpp.cpp中写入封装函数的执行代码:

PHP_FUNCTION(myclass_new)

{

MyClass *myclass_instance;

char* s;

int len = 0;

PHP5CPP_GET_THIS();
if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "|s", &s, &len) == FAILURE) {
RETURN_FALSE;
}
if (len) {

myclass_instance = new MyClass(string(s, len));

}

else {

myclass_instance = new MyClass;

}

if (myclass_instance != NULL) {

PHP5CPP_REGISTER_MYCLASS_RESOURCE(return_value, myclass_instance, le_myclass);

}

}

PHP_FUNCTION(myclass_destroy)

{

zval *resource;

if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "r", &resource) == FAILURE) {

RETURN_FALSE;

}

zend_list_delete(Z_RESVAL_P(resource));

}

PHP_FUNCTION(myclass_set_string)

{

zval *resource;

MyClass *myclass_instance;

int len = -1;

char *s;

PHP5CPP_MYCLASS_OBJ_PARAMS(zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "s", &s, &len))

PHP5CPP_MYCLASS_RSRC_PARAMS(zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "rs", &resource, &s, &len))

if (myclass_instance == NULL) {

php_error(E_WARNING, "can‘t set string on null resource in %s()", get_active_function_name(TSRMLS_C));

RETURN_FALSE;

}

else {

myclass_instance->setString(string(s, len));

RETURN_TRUE;

}

}

PHP_FUNCTION(myclass_get_string)

{

zval *resource;

MyClass *myclass_instance = NULL;

string retval;

PHP5CPP_MYCLASS_OBJ_NO_PARAMS()

PHP5CPP_MYCLASS_RSRC_NO_PARAMS()

if (myclass_instance == NULL) {

php_error(E_WARNING, "can‘t get string from null resource in %s()", get_active_function_name(TSRMLS_C));

RETURN_FALSE;

}

else {

retval = myclass_instance->getString();

RETVAL_STRINGL((char*) retval.data(), retval.length(), 1);

}

}

这里没什么太难的地方,所以我不想每个函数都解释一次。现在就只简单看一下myclass_new()和myclass_set_string()做为例子。

在myclass_new()中,首先尝试取得一个对象。再次说明,只在面向对象方式下才会生效,在PHP 4下会被预处理所忽略掉。

因为C++类的构造函数有默认的参数,所以我们要看看PHP是否有传一个string类型的参数过来。分析完传进来的参数后,就为分配 myclass_instance内存空间,然后用PHP5CPP_REGISTER_MYCLASS_RESOURCE把得到的resource贮存起来。在PHP 5的OO模式下,PHP5CPP_REGISTER_MYCLASS_RESOURC会把resource当成对象贮存,在PHP 4的结构化模块下只会简单的创建一个resource。

接着说myclass_set_string()...

首先,先定义一个zval结构去处理在PHP用结构化接口传进来的参数。myclass_instance会被用来指向实际的C++对象。len和*s用来保存从PHP方传来的字串和字串的长度。

在PHP 4下,PHP5CPP_MYCLASS_OBJ_PARAMS()会被预处理忽略。在PHP 5它会尝试取得对象,如果获取对象失败,否会返回使用结构化接口的步骤。

在取得myclass_instance后,可以像平时使用类那样使用C++ MyClass类。先调用MyClass的setString()方法。然后把得到的C++标准string类对象转成类似C方式的char指针,并传回给PHP方。

最后,要让PHP知道这个新class,很简单,在PHP_MINIT_FUNCTION中加入:

PHP5CPP_REGISTER_CLASS(myclass, "MyClass");

le_myclass = zend_register_list_destructors_ex(destroy_myclass, NULL, "myclass", module_number);

好了,到这里代码已经写完了。:P

第7节.然后...

然后,你可以按自己需要的方式编译扩展模块。你也许需要增加一些另外的代码,像using namespace std 等。这个介绍的下边几页会包含一个完整的可运行例子。这些代码我已经在gentoo系统上测试过了,包括目前(2004-03-19)在CVS上是新的 PHP 5和PHP_4_3的环境。(译:本译文只提供了可查看代码的链接,没有包括这些代码)

第8节.例子源代码

译文中没有包括完整在例子源代码,你通过下边的链接去查看:

http://bugs.tutorbuddy.com/php5cpp/php5cpp/example_code.html

第9节.授权许可

本文在GNU Free Documentation License下授权传播。以下是许可License的内容链接...

http://bugs.tutorbuddy.com/php5cpp/php5cpp/license.html

时间: 2024-10-12 11:55:27

[转载]用c写PHP的扩展接口(php5,c++)的相关文章

【转载】如何写一个框架:步骤(下)

说明:写本文的时候作者完全是把脑子里的东西写了出来,没有参考任何的资料,所以对于每一项内容可能都是不完整的,不能作为一个完整的参考.有一些方法学的东西每个人都有自己的喜好,没有觉得的对和错. 单元测试 在这之前我们写的框架只能说是一个在最基本的情况下可以使用的框架,作为一个框架我们无法预测开发人员将来会怎么使用它,所以我们需要做大量的工作来确保框架不但各种功能都是正确的,而且还是健壮的.写应用系统的代码,大多数项目是不会去写单元测试的,原因很多: 项目赶时间,连做一些输入验证都没时间搞,哪里有时

[转载,感觉写的非常详细]DUBBO配置方式详解

[转载,感觉写的非常详细]DUBBO配置方式详解 原文链接:http://www.cnblogs.com/chanshuyi/p/5144288.html DUBBO 是一个分布式服务框架,致力于提供高性能和透明化的 RPC 远程服务调用方案,是阿里巴巴 SOA 服务化治理方案的核心框架,每天为 2,000+ 个服务提供 3,000,000,000+ 次访问量支持,并被广泛应用于阿里巴巴集团的各成员站点. Dubbo采用全spring配置方式,透明化接入应用,对应用没有任何API侵入,只需用Sp

Spring8:一些常用的Spring Bean扩展接口

前言 Spring是一款非常强大的框架,可以说是几乎所有的企业级Java项目使用了Spring,而Bean又是Spring框架的核心. Spring框架运用了非常多的设计模式,从整体上看,它的设计严格遵循了OCP----开闭原则,即: 1.保证对修改关闭,即外部无法修改Spring整个运作的流程 2.提供对扩展开放,即可以通过继承.实现Spring提供的众多抽象类与接口来改变类加载的行为 开卷有益,阅读Spring源码(无需每个类都看得很细,大体流程能梳理出来即可)对于个人水平的提升是帮助非常大

从头认识java-7.5 怎样通过继承扩展接口?

我们这一章节来讨论一下怎样通过继承扩展接口. 接口跟类一样,具有继承的特性,但是他只是继承接口,不继承类. package com.ray.ch07; interface WhatPersonCanDo { void run(); void sleep(); } interface WhatSingerCanDo extends WhatPersonCanDo { void sing(); } class Singer implements WhatSingerCanDo { @Override

0001 - Spring 框架和 Tomcat 容器扩展接口揭秘

前言 在 Spring 框架中,每个应用程序上下文(ApplicationContext)管理着一个 BeanFactory,BeanFactory 主要负责 Bean 定义的保存.Bean 的创建.Bean 之间依赖的自动注入等.应用程序上下文则是对 BeanFactory 和 Bean 的生命周期中的各个环节进行管理,并且提供扩展接口允许用户对 BeanFactory 和 Bean 的各个阶段进行定制,本文从以下三个点进行切入讲解. refresh()是应用上下文刷新阶段. getBean(

hibernate核心接口,和扩展接口。回顾笔记,以前没记,现在补上,纯手工敲的。

hibernate核心接口: 所有的hibernate应用都会访问hibernate的5个核心接口 1,Configuration接口 Configuration用于配置并且根启动Hibernate.Hibernate应用通过Configuration实例来获取对象-关系映射文件中的元数据,以及动态配置Hibernate的属性,然后创建SessionFactory实例. 2,SessionFactory接口 一个SessionFactory实例对应一个数据存储源,应用从SessionFactor

hive里的扩展接口

hive里的扩展接口,主要包括CLI(控制命令行接口).Beeline和JDBC等方式访问Hive. CLI和Beeline都是交互式用户接口,并且功能相似,但是语法和实现不同. JDBC是一种类似于编程访问关系型数据库的编程接口. 1.CLI 在UNIX shell环境下输入hive命令可以启用Hive CLI.在CLI下,所有的Hive语句都以分号结束. 在CLI下可以对一些属性做出设置,像是设置底层MapReduce任务中Reducer的实例数.这些信息都详细地记录在在线Hive语言手册中

为什么用C++写库 但是导出接口时 却定义了C的接口(李大哥告诉我的,我还没有理解,先记着吧。为以后查询方便,哈哈)

导出C接口 使其拥有使用范围最广的接口 和多方式支持.比如操作系统,用C++写,但是接口申明了#ifdef C plus plus,判断如果是C++代码 就导出C接口,windows 下微软的几乎所有接口都是这样导出的,linux也一样.举例说明,我们导出一个C++接口 接口函数如下:KERNEL_USER_API int UserLogin(LPCTSTR lpszUserName,LPCTSTR lpszPassword);   假设这是一个内核库 封装了所有方法   然后提供给界面程序调用

java通过继承来扩展接口

接口主要是为了向上转型,从而使基类(接口方法)更具灵活性!不想废话,看例子: /** * */ package interfaces; interface Monster{ void menace(); } interface DangerousMonster extends Monster{ void destory(); } interface Lethal{ void kill(); } class DragonZilla implements DangerousMonster{ publ