本篇文章主要將如何在擴展中創建一個對象。創建的對象的過程,其實和一個小孩出生,成長的過程有些類似。
### 第一步,辦準生證
生孩子第一步,先辦準生證。聲明我要生孩子了。對象創建的時候,如何辦準生證呢?只要定義一個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"
```