白话PHP7扩展开发之创建对象

本篇文章主要将如何在扩展中创建一个对象。创建的对象的过程，其实和一个小孩出生，成长的过程有些类似。

第一步，办准生证

生孩子第一步，先办准生证。声明我要生孩子了。对象创建的时候，如何办准生证呢？只要定义一个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);
}

PHP调用代码

<?php
$children = new children();
var_dump($children->memory);
$children->learn("love");
var_dump($children->memory);
?>

输出内容如下：

NULL
string(4) "love"