白話 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}
}</pre> 
 
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);
}</pre> 
 
PHP調用代碼

memory);
$children->learn("love");
var_dump($children->memory);
?>
 
 
輸出內容如下：

NULL
string(4) "love"
 
 
代碼下載

 完整的擴展源代碼下載 
 </div>