本篇文章主要将如何在扩展中创建一个对象。创建的对象的过程,其实和一个小孩出生,成长的过程有些类似。
### 第一步,办准生证
生孩子第一步,先办准生证。声明我要生孩子了。对象创建的时候,如何办准生证呢?只要定义一个zend_class_entry变量即可。代码如下:
```c
zend_class_entry ce;
```
`zend_class_entry` 是啥?可以认为它使一个原型,定义了一些对象应该有哪些东西组成。具体代码可以查看[./Zend/zend.h](https://github.com/php/php-src/blob/master/Zend/zend.h)文件。
## 第二步,取名字
孩子怎么得有个名字,对象也一样。如何给对象取名字呢?代码如下:
```c
INIT_CLASS_ENTRY(ce, "children", children_methods);
```
其中,`children`就是我们给对象取的名字。那`children_methods`是啥?它是这个小孩应该具备的能力(对象所拥有的方法)。
## 第三步,上户口
孩子出生了,名字有了,下面就得上户口了。上户口的过程就是登记入册的过程。代码如下:
```c
children_ce = zend_register_internal_class(&ce);
```
`zend_register_internal_class`方法会返回一个zend_class_entry指针。以后我们对这个对象的操作,可以使用这个指针。
## 第四步,培养(定义属性和方法)
孩子已经上户口了。接下来,我们就是认真的培养他。培养成对社会有用的人。那么如何培养呢?主要从两方面入手。第一方面是教授知识(定义属性),另一方面是培养其行为能力(定义方法)。
定义属性,我们使用`zend_declare_property*`系列方法。代码示例如下:
```c
zend_declare_property_null(children_ce, "memory", sizeof("memory") - 1, ZEND_ACC_PUBLIC);
```
上面的代码我们就声明了一个名称为memory的属性,并且设置访问类型为 public。
定义方法的过程更简单。还记得我们在上户口的时候,登记了`children_methods`。这个就是孩子行为的一个集合。这个行为集合如何产生的呢?代码如下:
```c
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_methods[] = {
PHP_ME(children, learn, arginfo_children_learn, ZEND_ACC_PUBLIC)
{NULL, NULL, NULL}
}
ZEND_BEGIN_ARG_INFO_EX的最后一个参数1,是传递的参数的个数。
ZEND_ARG_INFO的第一个参数0,表示是否传引用方式传递。一般默认为0即可。
```
## 完整代码
至此,我们已经定义了一个对象,拥有属性memory和方法learn。完整的代码如下:
**头文件定义如下:**
```c
//这里要声明一个模块初始化方法
PHP_MINIT_FUNCTION(minho);
PHP_MSHUTDOWN_FUNCTION(minho);
//声明类的方法
PHP_METHOD(children,__construct);
PHP_METHOD(children,__destruct);
PHP_METHOD(children, learn);
PHP_METHOD(children, toString);
```
**源文件定义:**
```c
//定义全局类对象
zend_class_entry *children_ce;
//定义learn方法接受的参数
ZEND_BEGIN_ARG_INFO_EX(arginfo_children_learn, 0, 0, 1)
ZEND_ARG_INFO(0, love)
ZEND_END_ARG_INFO()
//定义无参数的信息
ZEND_BEGIN_ARG_INFO(arginfo_return__void, 0)
ZEND_END_ARG_INFO()
//定义learn方法
PHP_METHOD(children, learn)
{
char *love;
size_t love_len;
#ifndef FAST_ZPP
if (zend_parse_method_parameters(ZEND_NUM_ARGS(), getThis(), "s",&love, &love_len) == FAILURE) {
return;
}
#else
ZEND_PARSE_PARAMETERS_START(1,1)
Z_PARAM_STRING(love,love_len)
ZEND_PARSE_PARAMETERS_END();
#endif
zend_update_property_string(children_ce, getThis(), "memory", sizeof("memory") - 1, love);
}
//定义toString方法,无参,只打印字符串
PHP_METHOD(children,toString)
{
php_printf("can not support");
}
//定义构造方法
PHP_METHOD(children,__construct){
php_printf("construct is running<br>");
}
//定义children对象的方法列表,可声明方法为静态方法或公开方法
const zend_function_entry children_methods[] = {
ZEND_ME(children, learn, arginfo_children_learn, ZEND_ACC_PUBLIC )
ZEND_ME(children,toString,arginfo_return__void,ZEND_ACC_PUBLIC | ZEND_ACC_STATIC )
ZEND_ME(children,__construct,arginfo_return__void, ZEND_ACC_PUBLIC)
{NULL, NULL, NULL}
};
//当模块启动时执行的方法
PHP_MINIT_FUNCTION(minho)
{
zend_class_entry ce;
//初始化一个类对象,并将方法绑定到对象上
INIT_CLASS_ENTRY(ce, "children", children_methods);
//将对象赋值给全局对象
children_ce = zend_register_internal_class_ex(&ce, NULL);
//初始化类的熟悉
zend_declare_property_null(children_ce, "memory", sizeof("memory") - 1, ZEND_ACC_PUBLIC);
return SUCCESS;
}
```
PHP调用代码
```
<?php
$children = new children();
var_dump($children->memory);
$children->learn("love");
var_dump($children->memory);
?>
```
输出内容如下:
```
NULL
string(4) "love"
```