2. 定義一個類 · PHP擴展開發及內核應用

# 10.2 PHP中的面向對象（一）在這一節中，我們正式的定義一個類。首先我給出PHP語言的實現： ````php <?php class myclass { public $public_var; private $private_var; protected $protected_var; public static $static_var; public function __construct() { echo "我是__construct方法\n"; } public function public_method() { echo "我是public類型的方法\n"; } private function private_method() { echo "我是private類型的方法\n"; } protected function protected_method() { echo "我是protected類型的方法\n"; } public static function static_var() { echo "我是static類型的方法\n"; } } ```` ### 定義類對應的zend_class_entry 定義類的第一步，便是先定義好這個類的zend_class_entry，這一步操作是在MINIT階段完成的。 ````c static zend_function_entry myclass_method[]= {NULL,NULL,NULL}; PHP_MINIT_FUNCTION(test) { zend_class_entry ce; INIT_CLASS_ENTRY(ce,"myclass",myclass_method); zend_register_internal_class(&ce TSRMLS_CC); return SUCCESS; } //這就是最簡單的一個類，沒有屬性沒有方法，但是可以使用了 /* <?php $obj = new myclass(); var_dump($obj); //得到：object(myclass)#1 (0) {} */ ```` 某個類的zend_class_entry會經常用到，所以我們一般會把它保存在一個變量里，供擴展中其它地方的程序使用，所以上述的代碼組合一般是這樣的： ````c zend_class_entry *myclass_ce; static zend_function_entry myclass_method[]={ {NULL,NULL,NULL} }; ZEND_MINIT_FUNCTION(test) { zend_class_entry ce; INIT_CLASS_ENTRY(ce,"myclass",myclass_method); myclass_ce = zend_register_internal_class(&ce TSRMLS_CC); return SUCCESS; } ```` ### 為類定義屬性我們可以用zend_declare_property*系列函數來完成這項操作，為某個類定義屬性一般會需要三個信息： <ul> <li>屬性的名稱</li> <li>屬性的默認值</li> <li>屬性的訪問權限等</li> </ul> 我們為上面的myclass類定義一個名為“public_var”的屬性，默認值為null，訪問權限為public。 ````c ZEND_MINIT_FUNCTION(test) { zend_class_entry ce; INIT_CLASS_ENTRY(ce,"myclass",myclass_method); myclass_ce = zend_register_internal_class(&ce TSRMLS_CC); //定義屬性 zend_declare_property_null(myclass_ce, "public_var", strlen("public_var"), ZEND_ACC_PUBLIC TSRMLS_CC); return SUCCESS; } ```` ZEND_ACC_PUBLIC是ZEND_ACC系列掩碼中的一個，代表著public，其余的還有ZEND_ACC_PRIVATE,ZEND_ACC_PROTECTED等等，詳細描述請見后面的章節。這三個掩碼比較簡單，就不再敘述了。 ### 為類定義方法為類定義方法比較繁瑣一些，首先我們先回顧一下zend_function_entry結構，在以前我們用它來保存我們擴展的函數，通過它把PHP語言中的函數和我們用C語言編寫的函數聯系起來，在這它也發揮了這么一個橋梁的作用。下面我們實現myclass類的public_method()和構造方法。 ````c //首先，定義這個函數的C語言部分，不過這一次我們使用的是ZEND_METHOD ZEND_METHOD( myclass , public_method ) { php_printf("我是public類型的方法\n"); } ZEND_METHOD( myclass , __construct ) { php_printf("我是__construct方法\n"); } //然后，用PHP_METHOD聲明public_method和__construct。 PHP_METHOD(myclass, public_method); PHP_METHOD(myclass, __construct); //再定義一個zend_function_entry zend_function_entry myclass_method[]= { ZEND_ME(myclass, public_method, NULL, ZEND_ACC_PUBLIC) ZEND_ME(myclass, __construct, NULL, ZEND_ACC_PUBLIC|ZEND_ACC_CTOR) {NULL, NULL, NULL} }; //最后，在MINIT階段register internal class的時候將它作為一個參數傳遞進去 ZEND_MINIT_FUNCTION(test) { zend_class_entry ce; //這里使用了myclass_method這個zend_function_entry INIT_CLASS_ENTRY(ce,"myclass",myclass_method); myclass_ce = zend_register_internal_class(&ce TSRMLS_CC); return SUCCESS; } ```` 現在我們在PHP腳本中調用一下這個方法，看看輸出結果： ````php <?php $obj = new myclass(); $obj->public_method(); /* walu@walu-ThinkPad-Edge:/cnan/program/php-5.3.6/ext/test$ php test.php 我是__construct方法我是public_method方法 */ ```` 這里在定義__construct方法的時候，使用到了ZEND_ACC_CTOR，它的作用便是聲明這個方法是此類的構造函數，而ZEND_ACC_PUBLIC|ZEND_ACC_CTOR是我們常見的掩碼或運算，代表它是一個public類型構造函數，:-)。如果我們去掉ZEND_ACC_CTOR標志，那么此構造函數還會起作用嗎？在這里的例子中它仍然起作用，但是在別的環境下我就不敢保證了。說到現在，protected和private類型的屬性與方法的定義和public的一樣。而定義static的屬性與方法只是在掩碼標志中加入ZEND_ACC_STATIC即可。下面詳細的羅列出了所有掩碼，fn_flags代表可以在定義方法時使用，zend_property_info.flags代表可以在定義屬性時使用，ce_flags代表在定義zend_class_entry時候可用。 ````c #define ZEND_ACC_STATIC 0x01 /* fn_flags, zend_property_info.flags */ #define ZEND_ACC_ABSTRACT 0x02 /* fn_flags */ #define ZEND_ACC_FINAL 0x04 /* fn_flags */ #define ZEND_ACC_IMPLEMENTED_ABSTRACT 0x08 /* fn_flags */ #define ZEND_ACC_IMPLICIT_ABSTRACT_CLASS 0x10 /* ce_flags */ #define ZEND_ACC_EXPLICIT_ABSTRACT_CLASS 0x20 /* ce_flags */ #define ZEND_ACC_FINAL_CLASS 0x40 /* ce_flags */ #define ZEND_ACC_INTERFACE 0x80 /* ce_flags */ #define ZEND_ACC_INTERACTIVE 0x10 /* fn_flags */ #define ZEND_ACC_PUBLIC 0x100 /* fn_flags, zend_property_info.flags */ #define ZEND_ACC_PROTECTED 0x200 /* fn_flags, zend_property_info.flags */ #define ZEND_ACC_PRIVATE 0x400 /* fn_flags, zend_property_info.flags */ #define ZEND_ACC_PPP_MASK (ZEND_ACC_PUBLIC | ZEND_ACC_PROTECTED | ZEND_ACC_PRIVATE) #define ZEND_ACC_CHANGED 0x800 /* fn_flags, zend_property_info.flags */ #define ZEND_ACC_IMPLICIT_PUBLIC 0x1000 /* zend_property_info.flags; unused (1) */ #define ZEND_ACC_CTOR 0x2000 /* fn_flags */ #define ZEND_ACC_DTOR 0x4000 /* fn_flags */ #define ZEND_ACC_CLONE 0x8000 /* fn_flags */ #define ZEND_ACC_ALLOW_STATIC 0x10000 /* fn_flags */ #define ZEND_ACC_SHADOW 0x20000 /* fn_flags */ #define ZEND_ACC_DEPRECATED 0x40000 /* fn_flags */ #define ZEND_ACC_CLOSURE 0x100000 /* fn_flags */ #define ZEND_ACC_CALL_VIA_HANDLER 0x200000 /* fn_flags */ ```` ZEND_ACC_CTOR與ZEND_ACC_DTOR是比較特殊的掩碼標志，分別代表著構造函數與析構函數，不要將這兩個標志位用在其它的方法上面。其它的一些魔術方法，如__get,__call等大都需要arginfo，有關它們的內容將在下一章中描述。 ### 為類定義常量這個內容比較簡單，只涉及到一組函數，可以查看Zend/zend_API.h ````c ZEND_API int zend_declare_class_constant(zend_class_entry *ce, const char *name, size_t name_length, zval *value TSRMLS_DC); ZEND_API int zend_declare_class_constant_null(zend_class_entry *ce, const char *name, size_t name_length TSRMLS_DC); ZEND_API int zend_declare_class_constant_long(zend_class_entry *ce, const char *name, size_t name_length, long value TSRMLS_DC); ZEND_API int zend_declare_class_constant_bool(zend_class_entry *ce, const char *name, size_t name_length, zend_bool value TSRMLS_DC); ZEND_API int zend_declare_class_constant_double(zend_class_entry *ce, const char *name, size_t name_length, double value TSRMLS_DC); ZEND_API int zend_declare_class_constant_stringl(zend_class_entry *ce, const char *name, size_t name_length, const char *value, size_t value_length TSRMLS_DC); ZEND_API int zend_declare_class_constant_string(zend_class_entry *ce, const char *name, size_t name_length, const char *value TSRMLS_DC); ```` ## links * 10.1 [zend_class_entry](<10.1.md>) * 10.3 [定義一個接口](<10.3.md>)