本篇文章主要将如何在扩展中创建一个对象。创建的对象的过程,其实和一个小孩出生,成长的过程有些类似。
生孩子第一步,先办准生证。声明我要生孩子了。对象创建的时候,如何办准生证呢?只要定义一个zend_class_entry变量即可。代码如下:
zend_class_entry ce;
zend_class_entry 是啥?可以认为它使一个原型,定义了一些对象应该有哪些东西组成。具体代码可以查看./Zend/zend.h文件。
孩子怎么得有个名字,对象也一样。如何给对象取名字呢?代码如下:
INIT_CLASS_ENTRY(ce, "children", children_methods);
其中,children就是我们给对象取的名字。那children_methods是啥?它是这个小孩应该具备的能力(对象所拥有的方法)。
孩子出生了,名字有了,下面就得上户口了。上户口的过程就是登记入册的过程。代码如下:
zend_class_entry *children_ce;children_ce = zend_register_internal_class(&ce);
zend_register_internal_class方法会返回一个zend_class_entry指针。以后我们对这个对象的操作,可以使用这个指针。
孩子已经上户口了。接下来,我们就是认真的培养他。培养成对社会有用的人。那么如何培养呢?主要从两方面入手。第一方面是教授知识(定义属性),另一方面是培养其行为能力(定义方法)。定义属性,我们使用zend_declare_property*系列方法。代码示例如下:
zend_declare_property_null(children_ce, "memory", sizeof("memory") - 1, ZEND_ACC_PUBLIC);
上面的代码我们就声明了一个名称为memory的属性,并且设置访问类型为 public。
定义方法的过程更简单。还记得我们在上户口的时候,登记了children_methods。这个就是孩子行为的一个集合。这个行为集合如何产生的呢?代码如下:
ZEND_BEGIN_ARG_INFO_EX(arginfo_children_learn, 0, 0, 1) ZEND_ARG_INFO(0, love)ZEND_END_ARG_INFO()PHP_METHOD(children, learn);const zend_function_entry children_functions[] = {PHP_FE(learn, arginfo_children_learn){NULL, NULL, NULL}}
ZEND_BEGIN_ARG_INFO_EX的最后一个参数1,是传递的参数的个数。ZEND_ARG_INFO的第一个参数0,表示是否传引用方式传递。一般默认为0即可。
至此,我们已经定义了一个对象,拥有属性memory和方法learn。完整的代码如下:
zend_class_entry *children_ce;ZEND_BEGIN_ARG_INFO_EX(arginfo_children_learn, 0, 0, 1) ZEND_ARG_INFO(0, love)ZEND_END_ARG_INFO()const zend_function_entry children_functions[] = {PHP_ME(children, learn, arginfo_children_learn, ZEND_ACC_PUBLIC){NULL, NULL, NULL}}PHP_MINIT_FUNCTION(children) {zend_class_entry ce;INIT_CLASS_ENTRY(ce, "children", children_methods);children_ce = zend_register_internal_class(&ce);zend_declare_property_null(children_ce, "memory", sizeof("memory") - 1, ZEND_ACC_PUBLIC);}PHP_METHOD(children, learn){char *love;size_t love_len;if (zend_parse_method_parameters(ZEND_NUM_ARGS(), getThis(), "s",&content, &content_len) == FAILURE) { return;}zend_update_property_string(children_ce, getThis(), "memory", sizeof("memory") - 1, love);}
memory);$children->learn("love");var_dump($children->memory);?>
输出内容如下:
NULLstring(4) "love"
完整的扩展源代码下载