2 +--------------------------------------------------------------------+
4 +--------------------------------------------------------------------+
5 | Redistribution and use in source and binary forms, with or without |
6 | modification, are permitted provided that the conditions mentioned |
7 | in the accompanying LICENSE file are met. |
8 +--------------------------------------------------------------------+
9 | Copyright (c) 2013 Michael Wallner <mike@php.net> |
10 +--------------------------------------------------------------------+
18 extern zend_module_entry propro_module_entry
;
19 #define phpext_propro_ptr &propro_module_entry
21 #define PHP_PROPRO_VERSION "2.0.0dev"
24 # define PHP_PROPRO_API __declspec(dllexport)
25 #elif defined(__GNUC__) && __GNUC__ >= 4
26 # define PHP_PROPRO_API extern __attribute__ ((visibility("default")))
28 # define PHP_PROPRO_API extern
32 # include <TSRM/TSRM.h>
35 #define PHP_PROPRO_PTR(zo) (void*)(((char*)(zo))-(zo)->handlers->offset)
40 * The internal property proxy.
42 * Container for the object/array holding the proxied property.
44 struct php_property_proxy
{
45 /** The container holding the property */
47 /** The name of the proxied property */
50 typedef struct php_property_proxy php_property_proxy_t
;
53 * The userland object.
55 * Return an object instance of php\\PropertyProxy to make your C-struct
56 * member accessible by reference from PHP userland.
60 * static zval *my_read_prop(zval *object, zval *member, int type, void **cache_slot, zval *tmp)
63 * zend_string *member_name = zval_get_string(member);
64 * my_prophandler_t *handler = my_get_prophandler(member_name);
66 * if (!handler || type == BP_VAR_R || type == BP_VAR_IS) {
67 * return_value = zend_get_std_object_handlers()->read_property(object, member, type, cache_slot, tmp);
70 * handler->read(object, tmp);
72 * zval_ptr_dtor(return_value);
73 * ZVAL_COPY_VALUE(return_value, tmp);
76 * return_value = php_property_proxy_zval(object, member_name);
79 * zend_string_release(member_name);
81 * return return_value;
85 struct php_property_proxy_object
{
86 /** The actual property proxy */
87 php_property_proxy_t
*proxy
;
88 /** Any parent property proxy object */
90 /** The std zend_object */
93 typedef struct php_property_proxy_object php_property_proxy_object_t
;
95 PHP_PROPRO_API php_property_proxy_object_t
*php_property_proxy_object_new_ex(
96 zend_class_entry
*ce
, php_property_proxy_t
*proxy
);
98 PHP_PROPRO_API zend_object
*php_property_proxy_object_new(zend_class_entry
*ce
);
101 * Create a property proxy
103 * The property proxy will forward reads and writes to itself to the
104 * proxied property with name \a member_str of \a container.
106 * @param container the container holding the property
107 * @param member the name of the proxied property
108 * @return a new property proxy
110 PHP_PROPRO_API php_property_proxy_t
*php_property_proxy_init(zval
*container
,
111 zend_string
*member
);
114 * Destroy and free a property proxy.
116 * The destruction of the property proxy object calls this.
118 * @param proxy a pointer to the allocated property proxy
120 PHP_PROPRO_API
void php_property_proxy_free(php_property_proxy_t
**proxy
);
123 * Get the zend_class_entry of php\\PropertyProxy
124 * @return the class entry pointer
126 PHP_PROPRO_API zend_class_entry
*php_property_proxy_get_class_entry(void);
128 #endif /* PHP_PROPRO_H */
136 * vim600: noet sw=4 ts=4 fdm=marker
137 * vim<600: noet sw=4 ts=4