, 它可以用於對象屬性 , |
雖然這個屬性可能在對象的標準屬性表中並不存在 __, )和__set()的動態屬性空間是有意義的,因此引入__unset()來解決這個問題因此引入__unset()來解決這個問題
还有其他的魔术方法功能, 它们可以通过某些接口来使用, 比如ArrayAccess接口以及一些SPL接口.
在一个内部对象的实现中, 每个这样的"魔术方法"都可以和其他方法一样实现, 只要在对象的方法列表中正确的定义PHP_ME()以及PUBLIC访问修饰符即可.对于 __get(), __set(), __call(), __isset()以及__unset(), 它们要求传递参数, 你必须定义恰当的arg_info结构来指出方法需要一个或两个参数. 下面的代码片段展示了这些木梳函数的arg_info和它们对应的PHP_ME()条目: static
ZEND_BEGIN_ARG_INFO_EX(php_sample3_one_arg, 0, 0, 1)
ZEND_END_ARG_INFO()
static
ZEND_BEGIN_ARG_INFO_EX(php_sample3_two_args, 0, 0, 2)
ZEND_END_ARG_INFO()
static function_entry php_sample3_sc_functions[] = {
PHP_ME(Sample3_SecondClass, __construct, NULL,
ZEND_ACC_PUBLIC|ZEND_ACC_CTOR)
PHP_ME(Sample3_SecondClass, __destruct, NULL,
ZEND_ACC_PUBLIC|ZEND_ACC_DTOR)
PHP_ME(Sample3_SecondClass, __clone, NULL,
ZEND_ACC_PUBLIC|ZEND_ACC_CLONE)
PHP_ME(Sample3_SecondClass, __toString, NULL,
ZEND_ACC_PUBLIC)
PHP_ME(Sample3_SecondClass, __get, php_sample3_one_arg,
ZEND_ACC_PUBLIC)
PHP_ME(Sample3_SecondClass, __set, php_sample3_two_args,
ZEND_ACC_PUBLIC)
PHP_ME(Sample3_SecondClass, __call, php_sample3_two_args,
ZEND_ACC_PUBLIC)
PHP_ME(Sample3_SecondClass, __isset, php_sample3_one_arg,
ZEND_ACC_PUBLIC)
PHP_ME(Sample3_SecondClass, __unset, php_sample3_one_arg,
ZEND_ACC_PUBLIC)
{ NULL, NULL, NULL }
}; 要注意__construct, __destruct, __clone使用位域运算符增加了额外的常量. 这三个访问修饰符对于方法而言是特殊的, 它们不能被用于其他地方.
属性
php5中对象属性的访问控制与方法的可见性有所不同. 在标准属性表中定义一个公开属性时, 就像你通常期望的, 你可以使用zend_hash_add()或add_property_*()族函数.
对于受保护的和私有的属性, 则需要使用新的ZEND_API函数: void zend_mangle_property_name(char **dest, int *dest_length,
char *class, int class_length,
char *prop, int prop_length,
int persistent) 这个函数会分配一块新的内存, 构造一个"\0classname\0propname"格式的字符串. 如果类名是特定的类名, 比如Sample3_SecondClass, 则属性的可见性为private, 只能在Sample3_SecondClass对象实例内部可见.
如果类名指定为*, 则属性的可见性是protected, 它可以被对象实例所属类的所有祖先和后辈访问. 实际上, 属性可以以下面方式增加到对象上:
void php_sample3_addprops(zval *objvar)
{
char *propname;
int propname_len;
/* public */
add_property_long(objvar, "Chapter", 11);
/* protected */
zend_mangle_property_name(&propname, &propname_len,
"*", 1, "Title", sizeof("Title")-1, 0);
add_property_string_ex(objvar, propname, propname_len,
"PHP5 Objects", 1 TSRMLS_CC);
efree(propname);
/* Private */
zend_mangle_property_name(&propname, &propname_len,
"Sample3_SecondClass",sizeof("Sample3_SecondClass")-1,
"Section", sizeof("Section")-1, 0);
add_property_string_ex(objvar, propname, propname_len,
"Properties", 1 TSRMLS_CC);
efree(propname);
}
通过_ex()版的add_property_*()族函数, 可以明确标记属性名的长度. 这是需要的, 因为在protected和private属性名中会包含NULL字节, 而strlen()认为NULL字节是字符串终止标记, 这样将导致属性名被认为是空. 要注意的是_ex()版本的add_property_*()函数还要求显式的传递TSRMLS_CC. 而通常它是通过宏扩展隐式的传递的.
定义类常量和定义类属性非常相似. 两者的关键不同点在于它们的持久性, 因为属性的生命周期是伴随的实例的, 它发生在请求中, 而常量是和类定义在一起的, 只能在MINIT阶段定义.
由于标准的zval *维护宏的函数假定了非持久性, 所以你需要手动写不少代码. 考虑下面的函数: void php_sample3_register_constants(zend_class_entry *ce)
{
zval *constval;
/* 基本的标量值可以使用Z_*()去设置它们的值 */
constval = pemalloc(sizeof(zval), 1);
INIT_PZVAL(constval);
ZVAL_DOUBLE(constval, 2.7182818284);
zend_hash_add(&ce->constants_table, "E", sizeof("E"),
(void*)&constval, sizeof(zval*), NULL);
/* 字符串需要额外的空间分配 */
constval = pemalloc(sizeof(zval), 1);
INIT_PZVAL(constval);
Z_TYPE_P(constval) = IS_STRING;
Z_STRLEN_P(constval) = sizeof("Hello World") - 1;
Z_STRVAL_P(constval) = pemalloc(Z_STRLEN_P(constval)+1, 1);
memcpy(Z_STRVAL_P(constval), "Hello World",
Z_STRLEN_P(constval) + 1);
zend_hash_add(&ce->constants_table,
"GREETING", sizeof("GREETING"),
(void*)&constval, sizeof(zval*), NULL);
/* Objects, Arrays, and Resources can't be constants */
}
PHP_MINIT_FUNCTION(sample3)
{
zend_class_entry ce;
INIT_CLASS_ENTRY(ce, PHP_SAMPLE3_SC_NAME,
php_sample3_sc_functions);
php_sample3_sc_entry =
zend_register_internal_class(&ce TSRMLS_CC);
php_sample3_register_constants(php_sample3_sc_entry);
return SUCCESS;
} 在这之下, 这些类常量就可以访问了, 分别是: Sample3_SecondClass::E和Sample3_SecondClass::GREETING.
接口
接口的定义和类的定义除了几个差异外基本一致. 首先是所有的方法都定义为抽象的, 这可以通过PHP_ABSTRACT_ME()宏来完成. static function_entry php_sample3_iface_methods[] = {
PHP_ABSTRACT_ME(Sample3_Interface, workerOne, NULL)
PHP_ABSTRACT_ME(Sample3_Interface, workerTwo, NULL)
PHP_ABSTRACT_ME(Sample3_Interface, workerThree, NULL)
{ NULL, NULL, NULL }
}; 由于这些方法是抽象的, 所以不需要实现. 接下来的第二个差异就是注册. 和一个实际的类注册类似, 首先调用INIT_CLASS_ENTRY和zend_register_internal_class.
当类(zend_class_entry)可用时, 最后一部就是标记这个类是接口, 实现方法如下: zend_class_entry *php_sample3_iface_entry;
PHP_MINIT_FUNCTION(sample3)
{
zend_class_entry ce;
INIT_CLASS_ENTRY(ce, "Sample3_Interface",
php_sample3_iface_methods);
php_sample3_iface_entry =
zend_register_internal_class(&ce TSRMLS_CC);
php_sample3_iface_entry->ce_flags|= ZEND_ACC_INTERFACE; 实现接口
假设你想让Sample3_SecondClass这个类实现Sample3_Interface这个接口, 就需要实现这个接口定义的所有抽象方法:
PHP_METHOD(Sample3_SecondClass,workerOne)
{
php_printf("Working Hard.\n");
}
PHP_METHOD(Sample3_SecondClass,workerTwo)
{
php_printf("Hardly Working.\n");
}
PHP_METHOD(Sample3_SecondClass,workerThree)
{
php_printf("Going wee-wee-wee all the way home.\n");
}
接着在php_sample3_sc_functions列表中定义它们:
PHP_ME(Sample3_SecondClass,workerOne,NULL,ZEND_ACC_PUBLIC)
PHP_ME(Sample3_SecondClass,workerTwo,NULL,ZEND_ACC_PUBLIC)
PHP_ME(Sample3_SecondClass,workerThree,NULL,ZEND_ACC_PUBLIC)
最后, 定义你新注册的类实现php_sample3_iface_entry接口:
PHP_MINIT_FUNCTION(sample3)
{
zend_class_entry ce;
/* 注册接口 */
INIT_CLASS_ENTRY(ce, "Sample3_Interface",
php_sample3_iface_methods);
php_sample3_iface_entry =
zend_register_internal_class(&ce TSRMLS_CC);
php_sample3_iface_entry->ce_flags|= ZEND_ACC_INTERFACE;
/* 注册实现接口的类 */
INIT_CLASS_ENTRY(ce, PHP_SAMPLE3_SC_NAME,
php_sample3_sc_functions);
php_sample3_sc_entry =
zend_register_internal_class(&ce TSRMLS_CC);
php_sample3_register_constants(php_sample3_sc_entry);
/* 声明实现关系 */
zend_class_implements(php_sample3_sc_entry TSRMLS_CC,
1, php_sample3_iface_entry);
return SUCCESS;
}
如果Sample3_SecondClass实现了其他接口, 比如ArrayAccess, 就需要将对应的类(zend_class_entry)作为附加参数增加到zend_class_implements()调用中, 并将现在传递为数字1的参数值相应的增大为2: zend_class_implements(php_sample3_sc_entry TSRMLS_CC,
2, php_sample3_iface_entry, php_other_interface_entry); 句柄
ZE2并没有把所有的对象实例看做是相同的, 它为每个对象实例关联了句柄表. 当在一个对象上执行特定的操作时, 引擎调用执行对象的句柄表中自定义的行为.
标准句柄
默认情况下, 每个对象都被赋予了std_object_handlers这个内建句柄表. std_object_handlers中对应的句柄方法以及它们的行为定义如下:
当对象值的refcount增加时被调用, 比如, 当一个对象变量赋值给新的变量时. add_ref和del_ref函数的默认行为都是调整内部对象存储的refcount.
和add_ref类似, 这个方法也在修改refcount时调用, 通常是在unset()对象变量时发生的.
用于利用已有的对象实例创建一个新的实例. 默认行为是创建一个新的对象实例, 将它和原来的句柄表关联, 拷贝属性表, 如果该对象的类定义了__clone()方法, 则调用它让新的对象执行一些附加的复制工作.
zval *read_property(zval *obj, zval *prop, int type TSRMLS_DC)
void write_property(zval *obj, zval *prop, zval *value TSRMLS_DC)
在用户空间尝试以$obj->prop方式访问, 去读写对象的属性时, read_property/write_property对应的被调用. 默认的处理是首先在标准属性表中查找属性. 如果属性没有定义, 则检查是否存在__get()或__set()魔术方法, 如果有则调用该方法.
get_property_ptr_ptr()是read_property()的一個變種, 它的含義是允許調用作用域直接將當前的zval *替換為新的. 預設的行為是傳回標準屬性表中該屬性的指標位址. 如果不存在, 並且沒有__get()/__set()魔術方法, 則隱式創建並返回指針. 如果存在__get()或__set()方法, 則導致這個句柄失敗, 使得引擎轉而依靠單獨的read_property和write_property呼叫.
zval *get(zval *obj TSRMLS_DC)
- zval *get(zval *objTSRMLS_DC)
- void set(zval *obj, zval *value TSRMLS_DC)
在設定或取回物件的值時, 則會在物件上呼叫方法()或set().作為第一個參數被傳遞. 對於set, 新的值作為第二個參數傳遞; 實際上, 這些方法被用於算數運算中. 這些操作沒有默認處理器.
- int has_property(zval *obj, zval *prop, int chk_type TSRMLS_DC)
當在一個物件屬性上呼叫isset()時, 這個句柄被呼叫. 預設情況下標準的處理器會檢查prop指定的屬性名, 在php 5.1.0中如果沒有找到這個屬性, 並且定義了__isset()方法, 則會調用這個方法. chk_type參數的值如果是2則僅需要屬性存在, 如果chk_type值為0, 則必須存在並且不能是IS_NULL的值, 如果chk_type值為1, 則屬性必須存在且必須是非FALSE的值. 注意: 在php 5.0.x中,
chk_type的意思和has_dimension的chk_type一致.
void unset_property(zval *obj, zval *prop TSRMLS_DC)-
市「RM」
這兩個方法在嘗試卸載物件屬性時(或將物件以數組方式應用呼叫unset()時)被呼叫.unset_property()處理器要麼從標準屬性表刪除屬性(如果存在), 要麼就嘗試呼叫實作的__unset($prop)方法(php 5.1.0中), unset_dimension()則在類別實作了ArrayAccess時, 呼叫offsetunset($idx)方法.
HashTable *get_properties(zval; TSRMLS_DC)
union _zend_function *get_method(zval **obj_ptr char *method_name, int methodname_len TSRMLS_obj_ptr char *method_name, int methodname_len TSRMLS_DC)
這個處理器在解析類別的function_table中的物件方法時被呼叫. 如果在主的function_table中不存在方法, 則預設的處理器傳回一個指向對物件的__call($name, $args)方法包裝的zend_function *指標.
_D.處理器是未定義的.
- union _zend_function *get_constructor(zval *obj TSRMLS_DC)
處理器對處理方法的對應中構造器是特殊方式儲存的, 這使得它比較特殊. 對這個方法的重寫非常少見.
int get_class_name(zval *object, char **name zend_uint *len, int parent TSRMLS_DC)
int compare_objects(zval *obj1, zval *obj2 TSRMLS_DC) ==, !=, , >=)用在兩個物件上時, 在操作數(參與比較的兩個物件)上呼叫compare_objects()就是這個工作的第一部分. 它的返回值通常是1, 0, -1, 分別代表大於, 等於, 小於.預設, 物件是基於它們的標準屬性表比較的, 使用的比較規則和第8章"在數組和HashTable上工作"中學習的陣列比較規則一樣.
這個處理器. 如果將should_free設為非0值, zval_dtor()將會在dst上調用, 首先釋放內部的資源. 總之, 處理器應該嘗試將src中的物件表示為dst給出的zval *的類型中. 這個處理器預設是未定義的, 但當有它的時候, 應該返回SUCCESS或FAILURE.
譯註: 上面的句柄表和譯者使用的php-5.4.9中已經不完全一致, 讀者在學習這一部分的時候, 可以參考Zend/zend_object_handlers.c中最下面的標準處理器句柄表.
魔術方法第二部
使用前面看到的对象句柄表的自定义版本, 可以让内部类提供与在用户空间基于对象或类的__xxx()魔术方法相比, 相同或更多的能力.将这些自定义的句柄设置到对象实例上首先要求创建一个新的句柄表. 因为你通常不会覆写所有的句柄, 因此首先将标准句柄表拷贝到你的自定义句柄表中再去覆写你想要修改的句柄就很有意义了: static zend_object_handlers php_sample3_obj_handlers;
int php_sample3_has_dimension(zval *obj, zval *idx,
int chk_type TSRMLS_DC)
{
/* 仅在php版本>=1.0时使用 */
if (chk_type == 0) {
/* 重新映射chk_type的值 */
chk_type = 2;
}
/* 当chk_type值为1时保持不变. 接着使用标准的hash_property方法执行逻辑 */
return php_sample3_obj_handlers.has_property(obj,
idx, chk_type TSRMLS_CC);
}
PHP_MINIT_FUNCTION(sample3)
{
zend_class_entry ce;
zend_object_handlers *h = &php_sample3_obj_handlers;
/* 注册接口 */
INIT_CLASS_ENTRY(ce, "Sample3_Interface",
php_sample3_iface_methods);
php_sample3_iface_entry =
zend_register_internal_class(&ce TSRMLS_CC);
php_sample3_iface_entry->ce_flags = ZEND_ACC_INTERFACE;
/* 注册SecondClass类 */
INIT_CLASS_ENTRY(ce, PHP_SAMPLE3_SC_NAME,
php_sample3_sc_functions);
php_sample3_sc_entry =
zend_register_internal_class(&ce TSRMLS_CC);
php_sample3_register_constants(php_sample3_sc_entry);
/* 实现AbstractClass接口 */
zend_class_implements(php_sample3_sc_entry TSRMLS_CC,
1, php_sample3_iface_entry);
/* 创建自定义句柄表 */
php_sample3_obj_handlers = *zend_get_std_object_handlers();
/* 这个句柄表的目的是让$obj['foo']的行为等价于$obj->foo */
h->read_dimension = h->read_property;
h->write_dimension = h->write_property;
h->unset_dimension = h->unset_property;
#if PHP_MAJOR_VERSION > 5 || \
(PHP_MAJOR_VERSION == 5 && PHP_MINOR_VERSION > 0)
/* php-5.1.0中, has_property和has_dimension的chk_type含义不同, 为使它们行为一致, 自己包装一个函数 */
h->has_dimension = php_sample3_has_dimension;
#else
/* php 5.0.x的has_property和has_dimension行为一致 */
h->has_dimension = h->has_property;
#endif
return SUCCESS;
} 要将这个句柄表应用到对象上, 你有两种选择. 最简单也是最具代表性的就是实现一个构造器方法, 并在其中重新赋值变量的句柄表. PHP_METHOD(Sample3_SecondClass,__construct)
{
zval *objptr = getThis();
if (!objptr) {
php_error_docref(NULL TSRMLS_CC, E_WARNING,
"Constructor called statically!");
RETURN_FALSE;
}
/* 执行正常的构造器任务... */
/* 覆写句柄表 */
Z_OBJ_HT_P(objptr) = &php_sample3_obj_handlers;
} 当构造器返回时, 对象就有了新的句柄表以及对应的自定义行为. 还有一种更加受欢迎的方法是覆写类的对象创建函数.
zend_object_value php_sample3_sc_create(zend_class_entry *ce
TSRMLS_DC)
{
zend_object *object;
zend_object_value retval;
/* 返回Zend创建的对象 */
retval = zend_objects_new(&object, ce TSRMLS_CC);
/* 覆写create_object时, 属性表必须手动初始化 */
ALLOC_HASHTABLE(object->properties);
zend_hash_init(object->properties, 0, NULL,
ZVAL_PTR_DTOR, 0);
/* 覆写默认句柄表 */
retval.handlers = &php_sample3_obj_handlers;
/* 这里可能会执行其他对象初始化工作 */
return retval;
}
这样就可以在MINIT阶段注册类(zend_class_entry)之后直接将自定义句柄表附加上去. INIT_CLASS_ENTRY(ce, PHP_SAMPLE3_SC_NAME,
php_sample3_sc_functions);
php_sample3_sc_entry =
zend_register_internal_class(&ce TSRMLS_CC);
php_sample3_sc_entry->create_object= php_sample3_sc_create;
php_sample3_register_constants(php_sample3_sc_entry);
zend_class_implements(php_sample3_sc_entry TSRMLS_CC,
1, php_sample3_iface_entry); 这两种方法唯一可预见的不同是它们发生的时机不同. 引擎在碰到new Sample3_SecondClass后会在处理构造器及它的参数之前调用create_object. 通常, 你计划覆盖的各个点使用的方法(create_object Vs. __construct)应该一致.
译注: php-5.4.9中, xxx_property/xxx_dimension这一组句柄的原型是不一致的, 因此, 按照原著中的示例, 直接将xxx_property/xxx_dimension进行映射已经不能工作, 要完成上面的功能, 需要对4个句柄均包装一个函数去映射. 由于译者没有详细跟踪具体在哪一个版本发生了这些改变, 因此这里不给出译者测试的示例(没有做兼容性处理检查), 如果读者碰到这个问题, 请检查自己所使用php版本中两组句柄原型的差异并进行相应修正.
小结
毋庸置疑, php5/ZE2的对象模型比它的前辈php4/ZE1中的对象模型更加复杂. 在看完本章中介绍的所有特性和实现细节后, 你可能已经被它的所包含的信息量搞得手足无措. 幸运的是, php中在OOP之上有一层可以让你选择你的任务所需的部分而不关心其他部分. 找到复杂性之上一个舒适的层级开始工作, 剩下的都会顺起来的.
现在已经看完了所有的php内部数据类型, 是时候回到之前的主题了: 请求生命周期. 接下来的两章, 将在你的扩展中使用线程安全全局变量增加内部状态, 定义自定义的ini设置, 定义常量, 以及向使用你扩展的用户空间脚本提供超级全局变量.
以上就是[翻译][php扩展开发和嵌入式]第11章-php5对象的内容,更多相关内容请关注PHP中文网(www.php.cn)!
|