在这一节中,我们正式的定义一个类。首先我给出PHP语言的实现:
06 | protected $protected_var ; |
08 | public static $static_var ; |
10 | public function __construct() |
12 | echo "我是__construct方法\n" ; |
15 | public function public_method() |
17 | echo "我是public类型的方法\n" ; |
20 | public function private_method() |
22 | echo "我是private类型的方法\n" ; |
25 | public function protected_method() |
27 | echo "我是protected类型的方法\n" ; |
30 | public static function static_var() |
32 | echo "我是static类型的方法\n" ; |
定义类对应的zend_class_entry
定义类的第一步,便是先定义好这个类的zend_class_entry,这一步操作是在MINIT阶段完成的。
01 | static zend_function_entry myclass_method[]= |
04 | PHP_MINIT_FUNCTION(test) |
07 | INIT_CLASS_ENTRY(ce, "myclass" ,myclass_method); |
08 | zend_register_internal_class(&ce TSRMLS_CC); |
某个类的zend_class_entry会经常用到,所以我们一般会把它保存在一个变量里,供扩展中其它地方的程序使用,所以上述的代码组合一般是这样的:
01 | zend_class_entry *myclass_ce; |
03 | static zend_function_entry myclass_method[]={ |
07 | ZEND_MINIT_FUNCTION(test) |
10 | INIT_CLASS_ENTRY(ce, "myclass" ,myclass_method); |
11 | myclass_ce = zend_register_internal_class(&ce TSRMLS_CC); |
为类定义属性
我们可以用zend_declare_property*系列函数还完成这项操作,为某个类定义属性一般会需要三个信息:
我们为上面的myclass类定义一个名为“public_var”的属性,默认值为null,访问权限为public。
01 | ZEND_MINIT_FUNCTION(test) |
04 | INIT_CLASS_ENTRY(ce, "myclass" ,myclass_method); |
06 | myclass_ce = zend_register_internal_class(&ce TSRMLS_CC); |
09 | zend_declare_property_null(myclass_ce, "public_var" , strlen ( "public_var" ), ZEND_ACC_PUBLIC TSRMLS_CC); |
ZEND_ACC_PUBLIC是ZEND_ACC系列掩码中的一个,代表着public,其余的还有ZEND_ACC_PRIVATE,ZEND_ACC_PROTECTED等等,详细描述请见后面的章节。这三个掩码比较简单,就不在叙述了。
为类定义方法
为类定义方法比较繁琐一些,首先我们先回顾一下zend_function_entry结构,在以前我们用它来保存我们扩展的函数,通过它把PHP语言中的函数和我们用C语言编写的函数联系起来,在这它也发挥了这么一个桥梁的作用。下面我们实现myclass类的public_method()和构造方法。
02 | ZEND_METHOD( myclass , public_method ) |
04 | php_printf( "我是public类型的方法\n" ); |
07 | ZEND_METHOD( myclass , __construct ) |
09 | php_printf( "我是__construct方法\n" ); |
13 | zend_function_entry myclass_method[]= |
15 | ZEND_ME(myclass, public_method, NULL, ZEND_ACC_PUBLIC) |
16 | ZEND_ME(myclass, __construct, NULL, ZEND_ACC_PUBLIC|ZEND_ACC_CTOR) |
21 | ZEND_MINIT_FUNCTION(test) |
26 | INIT_CLASS_ENTRY(ce, "myclass" ,myclass_method); |
28 | myclass_ce = zend_register_internal_class(&ce TSRMLS_CC); |
现在我们在PHP脚本中调用一下这个方法,看看输出结果:
这里在定义__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时候可用。
01 | #define ZEND_ACC_STATIC 0x01 /* fn_flags, zend_property_info.flags */ |
02 | #define ZEND_ACC_ABSTRACT 0x02 /* fn_flags */ |
03 | #define ZEND_ACC_FINAL 0x04 /* fn_flags */ |
04 | #define ZEND_ACC_IMPLEMENTED_ABSTRACT 0x08 /* fn_flags */ |
05 | #define ZEND_ACC_IMPLICIT_ABSTRACT_CLASS 0x10 /* ce_flags */ |
06 | #define ZEND_ACC_EXPLICIT_ABSTRACT_CLASS 0x20 /* ce_flags */ |
07 | #define ZEND_ACC_FINAL_CLASS 0x40 /* ce_flags */ |
08 | #define ZEND_ACC_INTERFACE 0x80 /* ce_flags */ |
09 | #define ZEND_ACC_INTERACTIVE 0x10 /* fn_flags */ |
10 | #define ZEND_ACC_PUBLIC 0x100 /* fn_flags, zend_property_info.flags */ |
11 | #define ZEND_ACC_PROTECTED 0x200 /* fn_flags, zend_property_info.flags */ |
12 | #define ZEND_ACC_PRIVATE 0x400 /* fn_flags, zend_property_info.flags */ |
13 | #define ZEND_ACC_PPP_MASK (ZEND_ACC_PUBLIC | ZEND_ACC_PROTECTED | ZEND_ACC_PRIVATE) |
14 | #define ZEND_ACC_CHANGED 0x800 /* fn_flags, zend_property_info.flags */ |
15 | #define ZEND_ACC_IMPLICIT_PUBLIC 0x1000 /* zend_property_info.flags; unused (1) */ |
16 | #define ZEND_ACC_CTOR 0x2000 /* fn_flags */ |
17 | #define ZEND_ACC_DTOR 0x4000 /* fn_flags */ |
18 | #define ZEND_ACC_CLONE 0x8000 /* fn_flags */ |
19 | #define ZEND_ACC_ALLOW_STATIC 0x10000 /* fn_flags */ |
20 | #define ZEND_ACC_SHADOW 0x20000 /* fn_flags */ |
21 | #define ZEND_ACC_DEPRECATED 0x40000 /* fn_flags */ |
22 | #define ZEND_ACC_CLOSURE 0x100000 /* fn_flags */ |
23 | #define ZEND_ACC_CALL_VIA_HANDLER 0x200000 /* fn_flags */ |
ZEND_ACC_CTOR与ZEND_ACC_DTOR是比较特殊的掩码标志,分别代表着构造函数与析构函数,不要将这两个标志位用在其它的方法上面。其它的一些魔术方法,如__get,__call等大都需要arginfo,有关它们的内容将在下一章中描述。
为类定义常量
这个内容比较简单,只涉及到一组函数,可以查看Zend/zend_API.h
1 | ZEND_API int zend_declare_class_constant(zend_class_entry *ce, const char *name, size_t name_length, zval *value TSRMLS_DC); |
2 | ZEND_API int zend_declare_class_constant_null(zend_class_entry *ce, const char *name, size_t name_length TSRMLS_DC); |
3 | ZEND_API int zend_declare_class_constant_long(zend_class_entry *ce, const char *name, size_t name_length, long value TSRMLS_DC); |
4 | ZEND_API int zend_declare_class_constant_bool(zend_class_entry *ce, const char *name, size_t name_length, zend_bool value TSRMLS_DC); |
5 | ZEND_API int zend_declare_class_constant_double(zend_class_entry *ce, const char *name, size_t name_length, double value TSRMLS_DC); |
6 | 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); |
7 | ZEND_API int zend_declare_class_constant_string(zend_class_entry *ce, const char *name, size_t name_length, const char *value TSRMLS_DC); |
没有帐号? 现在注册.