PHP内核探索:类的定义
PHP内核    2019-04-25 16:25:18    30    0    0
admin   PHP内核

在这一节中,我们正式的定义一个类。首先我给出PHP语言的实现:

01<?php
02class myclass
03{
04    public $public_var;
05    private $private_var;
06    protected $protected_var;
07     
08    public static $static_var;
09     
10    public function __construct()
11    {
12        echo "我是__construct方法\n";
13    }
14     
15    public function public_method()
16    {
17        echo "我是public类型的方法\n";
18    }
19     
20    public function private_method()
21    {
22        echo "我是private类型的方法\n";
23    }
24     
25    public function protected_method()
26    {
27        echo "我是protected类型的方法\n";
28    }
29     
30    public static function static_var()
31    {
32        echo "我是static类型的方法\n";
33    }
34}
35?>

定义类对应的zend_class_entry

定义类的第一步,便是先定义好这个类的zend_class_entry,这一步操作是在MINIT阶段完成的。

01static zend_function_entry myclass_method[]=
02{NULL,NULL,NULL};
03 
04PHP_MINIT_FUNCTION(test)
05{
06    zend_class_entry ce;
07    INIT_CLASS_ENTRY(ce,"myclass",myclass_method);
08    zend_register_internal_class(&ce TSRMLS_CC);
09    return SUCCESS;
10}
11 
12//这就是最简单的一个类,没有属性没有方法,但是可以使用了
13 
14<?php
15$obj = new myclass();
16var_dump($obj);
17 
18//得到:object(myclass)#1 (0) {}
19?>

某个类的zend_class_entry会经常用到,所以我们一般会把它保存在一个变量里,供扩展中其它地方的程序使用,所以上述的代码组合一般是这样的:

01zend_class_entry *myclass_ce;
02 
03static zend_function_entry myclass_method[]={
04    {NULL,NULL,NULL}
05};
06 
07ZEND_MINIT_FUNCTION(test)
08{
09    zend_class_entry ce;
10    INIT_CLASS_ENTRY(ce,"myclass",myclass_method);
11    myclass_ce = zend_register_internal_class(&ce TSRMLS_CC);
12    return SUCCESS;
13}

为类定义属性

我们可以用zend_declare_property*系列函数还完成这项操作,为某个类定义属性一般会需要三个信息:

  • 属性的名称
  • 属性的默认值
  • 属性的访问权限等

我们为上面的myclass类定义一个名为“public_var”的属性,默认值为null,访问权限为public。

01ZEND_MINIT_FUNCTION(test)
02{
03    zend_class_entry ce;
04    INIT_CLASS_ENTRY(ce,"myclass",myclass_method);
05     
06    myclass_ce = zend_register_internal_class(&ce TSRMLS_CC);
07     
08    //定义属性
09    zend_declare_property_null(myclass_ce, "public_var"strlen("public_var"), ZEND_ACC_PUBLIC TSRMLS_CC);
10    return SUCCESS;
11}

ZEND_ACC_PUBLIC是ZEND_ACC系列掩码中的一个,代表着public,其余的还有ZEND_ACC_PRIVATE,ZEND_ACC_PROTECTED等等,详细描述请见后面的章节。这三个掩码比较简单,就不在叙述了。

为类定义方法

为类定义方法比较繁琐一些,首先我们先回顾一下zend_function_entry结构,在以前我们用它来保存我们扩展的函数,通过它把PHP语言中的函数和我们用C语言编写的函数联系起来,在这它也发挥了这么一个桥梁的作用。下面我们实现myclass类的public_method()和构造方法。

01//首先,定义这个函数的C语言部分,不过这一次我们使用的是ZEND_METHOD
02ZEND_METHOD( myclass , public_method )
03{
04    php_printf("我是public类型的方法\n");
05}
06 
07ZEND_METHOD( myclass , __construct )
08{
09    php_printf("我是__construct方法\n");
10}
11 
12//然后,定义一个zend_function_entry
13zend_function_entry myclass_method[]=
14{
15    ZEND_ME(myclass,    public_method,  NULL,   ZEND_ACC_PUBLIC)
16    ZEND_ME(myclass,    __construct,    NULL,   ZEND_ACC_PUBLIC|ZEND_ACC_CTOR)
17    {NULL,  NULL,   NULL}
18}
19 
20//最后,在MINIT阶段register internal class的时候将它作为一个参数传递进去
21ZEND_MINIT_FUNCTION(test)
22{
23    zend_class_entry ce;
24     
25    //这里使用了myclass_method这个zend_function_entry
26    INIT_CLASS_ENTRY(ce,"myclass",myclass_method);
27     
28    myclass_ce = zend_register_internal_class(&ce TSRMLS_CC);
29    return SUCCESS;
30}

现在我们在PHP脚本中调用一下这个方法,看看输出结果:

01<?php
02$obj new myclass();
03$obj->public_method();
04 
05/*
06walu@walu-ThinkPad-Edge:/cnan/program/php-5.3.6/ext/test$ php test.php
07我是__construct方法
08我是public_method方法
09*/
10?>

这里在定义__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

1ZEND_API int zend_declare_class_constant(zend_class_entry *ce, constchar *name, size_t name_length, zval *value TSRMLS_DC);
2ZEND_API int zend_declare_class_constant_null(zend_class_entry *ce, const char *name, size_t name_length TSRMLS_DC);
3ZEND_API int zend_declare_class_constant_long(zend_class_entry *ce, const char *name, size_t name_length, long value TSRMLS_DC);
4ZEND_API int zend_declare_class_constant_bool(zend_class_entry *ce, const char *name, size_t name_length, zend_bool value TSRMLS_DC);
5ZEND_API int zend_declare_class_constant_double(zend_class_entry *ce, const char *name, size_t name_length, double value TSRMLS_DC);
6ZEND_API int zend_declare_class_constant_stringl(zend_class_entry *ce, const char *name, size_t name_length, const char *value, size_tvalue_length TSRMLS_DC);
7ZEND_API int zend_declare_class_constant_string(zend_class_entry *ce, const char *name, size_t name_length, const char *value TSRMLS_DC);

上一篇: PHP内核探索:访问控制

下一篇: PHP内核探索:类的原型zend_class_entry

30
登录 后评论.
没有帐号? 现在注册.
0 评论
Table of content