2 +----------------------------------------------------------------------+
4 +----------------------------------------------------------------------+
5 | This source file is subject to version 3.0 of the PHP license, that |
6 | is bundled with this package in the file LICENSE, and is available |
7 | through the world-wide-web at http://www.php.net/license/3_0.txt. |
8 | If you did not receive a copy of the PHP license and are unable to |
9 | obtain it through the world-wide-web, please send a note to |
10 | license@php.net so we can mail you a copy immediately. |
11 +----------------------------------------------------------------------+
12 | Copyright (c) 2004-2005 Michael Wallner <mike@php.net> |
13 +----------------------------------------------------------------------+
18 #ifndef PHP_HTTP_STD_DEFS_H
19 #define PHP_HTTP_STD_DEFS_H
21 #if defined(PHP_WIN32)
22 # if defined(HTTP_EXPORTS)
23 # define PHP_HTTP_API __declspec(dllexport)
24 # elif defined(COMPILE_DL_HTTP)
25 # define PHP_HTTP_API __declspec(dllimport)
33 /* make functions that return SUCCESS|FAILURE more obvious */
37 #define lenof(S) (sizeof(S) - 1)
40 #define STR_SET(target, source) \
41 if(target) efree(target); \
44 /* return bool (v == SUCCESS) */
45 #define RETVAL_SUCCESS(v) RETVAL_BOOL(SUCCESS == (v))
46 #define RETURN_SUCCESS(v) RETURN_BOOL(SUCCESS == (v))
47 /* return object(values) */
48 #define RETVAL_OBJECT(o) \
49 return_value->is_ref = 1; \
50 return_value->type = IS_OBJECT; \
51 return_value->value.obj = (o)->value.obj; \
52 zval_add_ref(&return_value)
53 #define RETURN_OBJECT(o) \
56 #define RETVAL_OBJVAL(ov) \
57 return_value->is_ref = 1; \
58 return_value->type = IS_OBJECT; \
59 return_value->value.obj = (ov); \
60 zend_objects_store_add_ref(return_value TSRMLS_CC)
61 #define RETURN_OBJVAL(ov) \
65 /* function accepts no args */
67 if (ZEND_NUM_ARGS()) { \
68 zend_error(E_NOTICE, "Wrong parameter count for %s()", get_active_function_name(TSRMLS_C)); \
71 /* check if return value is used */
72 #define IF_RETVAL_USED \
73 if (!return_value_used) { \
78 #define HTTP_CRLF "\r\n"
80 /* default cache control */
81 #define HTTP_DEFAULT_CACHECONTROL "private, must-revalidate, max-age=0"
84 #define HTTP_URL_MAXLEN 2048
85 #define HTTP_URI_MAXLEN HTTP_URL_MAXLEN
87 /* def URL arg separator */
88 #define HTTP_URL_ARGSEP "&"
89 #define HTTP_URI_ARGSEP HTTP_URL_ARGSEP
91 /* send buffer size */
92 #define HTTP_SENDBUF_SIZE 2097152
94 /* CURL buffer size */
95 #define HTTP_CURLBUF_SIZE 16384
98 #define HTTP_KNOWN_METHODS \
100 "GET, HEAD, POST, PUT, DELETE, OPTIONS, TRACE, CONNECT, " \
101 /* WebDAV - RFC 2518 */ \
102 "PROPFIND, PROPPATCH, MKCOL, COPY, MOVE, LOCK, UNLOCK, " \
103 /* WebDAV Versioning - RFC 3253 */ \
104 "VERSION-CONTROL, REPORT, CHECKOUT, CHECKIN, UNCHECKOUT, " \
105 "MKWORKSPACE, UPDATE, LABEL, MERGE, BASELINE-CONTROL, MKACTIVITY, " \
106 /* WebDAV Access Control - RFC 3744 */ \
111 /* server vars shorthand */
112 #define HTTP_SERVER_VARS Z_ARRVAL_P(PG(http_globals)[TRACK_VARS_SERVER])
114 #define HTTP_PHP_INI_ENTRY(entry, default, scope, updater, global) \
115 STD_PHP_INI_ENTRY(entry, default, scope, updater, global, zend_http_globals, http_globals)
118 #define FOREACH_VAL(array, val) FOREACH_HASH_VAL(Z_ARRVAL_P(array), val)
119 #define FOREACH_HASH_VAL(hash, val) \
120 for ( zend_hash_internal_pointer_reset(hash); \
121 zend_hash_get_current_data(hash, (void **) &val) == SUCCESS; \
122 zend_hash_move_forward(hash))
124 #define FOREACH_KEY(array, strkey, numkey) FOREACH_HASH_KEY(Z_ARRVAL_P(array), strkey, numkey)
125 #define FOREACH_HASH_KEY(hash, strkey, numkey) \
126 for ( zend_hash_internal_pointer_reset(hash); \
127 zend_hash_get_current_key(hash, &strkey, &numkey, 0) != HASH_KEY_NON_EXISTANT; \
128 zend_hash_move_forward(hash)) \
130 #define FOREACH_KEYVAL(array, strkey, numkey, val) FOREACH_HASH_KEYVAL(Z_ARRVAL_P(array), strkey, numkey, val)
131 #define FOREACH_HASH_KEYVAL(hash, strkey, numkey, val) \
132 for ( zend_hash_internal_pointer_reset(hash); \
133 zend_hash_get_current_key(hash, &strkey, &numkey, 0) != HASH_KEY_NON_EXISTANT && \
134 zend_hash_get_current_data(hash, (void **) &val) == SUCCESS; \
135 zend_hash_move_forward(hash)) \
137 #define array_copy(src, dst) zend_hash_copy(Z_ARRVAL_P(dst), Z_ARRVAL_P(src), (copy_ctor_func_t) zval_add_ref, NULL, sizeof(zval *))
138 #define array_merge(src, dst) zend_hash_merge(Z_ARRVAL_P(dst), Z_ARRVAL_P(src), (copy_ctor_func_t) zval_add_ref, NULL, sizeof(zval *), 1)
139 #define array_append(src, dst) \
146 for ( zend_hash_internal_pointer_reset(Z_ARRVAL_P(src)); \
147 zend_hash_get_current_key_ex(Z_ARRVAL_P(src), &key, &klen, &idx, 0, NULL) != HASH_KEY_NON_EXISTANT && \
148 zend_hash_get_current_data(Z_ARRVAL_P(src), (void **) &data) == SUCCESS; \
149 zend_hash_move_forward(Z_ARRVAL_P(src))) \
154 if (SUCCESS == zend_hash_find(Z_ARRVAL_P(dst), key, klen, (void **) &tmp)) { \
155 if (Z_TYPE_PP(tmp) != IS_ARRAY) { \
156 convert_to_array_ex(tmp); \
158 add_next_index_zval(*tmp, *data); \
160 add_assoc_zval(dst, key, *data); \
162 zval_add_ref(data); \
169 #define HTTP_LONG_CONSTANT(name, const) REGISTER_LONG_CONSTANT(name, const, CONST_CS | CONST_PERSISTENT)
171 /* {{{ objects & properties */
174 # define HTTP_STATIC_ME_ALIAS(me, al, ai) ZEND_FENTRY(me, ZEND_FN(al), ai, ZEND_ACC_PUBLIC | ZEND_ACC_STATIC)
176 # define HTTP_REGISTER_CLASS_EX(classname, name, parent, flags) \
178 zend_class_entry ce; \
179 INIT_CLASS_ENTRY(ce, #classname, name## _fe); \
180 ce.create_object = name## _new; \
181 name## _ce = zend_register_internal_class_ex(&ce, parent, NULL TSRMLS_CC); \
182 name## _ce->ce_flags |= flags; \
183 memcpy(& name## _handlers, zend_get_std_object_handlers(), sizeof(zend_object_handlers)); \
184 name## _declare_default_properties(); \
187 # define HTTP_REGISTER_CLASS(classname, name, parent, flags) \
189 zend_class_entry ce; \
190 INIT_CLASS_ENTRY(ce, #classname, name## _fe); \
191 ce.create_object = NULL; \
192 name## _ce = zend_register_internal_class_ex(&ce, parent, NULL TSRMLS_CC); \
193 name## _ce->ce_flags |= flags; \
196 # define getObject(t, o) getObjectEx(t, o, getThis())
197 # define getObjectEx(t, o, v) t * o = ((t *) zend_object_store_get_object(v TSRMLS_CC))
198 # define OBJ_PROP(o) o->zo.properties
199 # define DCL_PROP(a, t, n, v) zend_declare_property_ ##t(ce, (#n), sizeof(#n), (v), (ZEND_ACC_ ##a) TSRMLS_CC)
200 # define DCL_PROP_Z(a, n, v) zend_declare_property(ce, (#n), sizeof(#n), (v), (ZEND_ACC_ ##a) TSRMLS_CC)
201 # define DCL_PROP_N(a, n) zend_declare_property_null(ce, (#n), sizeof(#n), (ZEND_ACC_ ##a) TSRMLS_CC)
202 # define UPD_PROP(o, t, n, v) UPD_PROP_EX(o, getThis(), t, n, v)
203 # define UPD_PROP_EX(o, this, t, n, v) zend_update_property_ ##t(o->zo.ce, this, (#n), sizeof(#n), (v) TSRMLS_CC)
204 # define SET_PROP(o, n, z) SET_PROP_EX(o, getThis(), n, z)
205 # define SET_PROP_EX(o, this, n, z) zend_update_property(o->zo.ce, this, (#n), sizeof(#n), (z) TSRMLS_CC)
206 # define GET_PROP(o, n) GET_PROP_EX(o, getThis(), n)
207 # define GET_PROP_EX(o, this, n) zend_read_property(o->zo.ce, this, (#n), sizeof(#n), 0 TSRMLS_CC)
209 # define INIT_PARR(o, n) \
212 MAKE_STD_ZVAL(__tmp); \
214 SET_PROP(o, n, __tmp); \
217 # define FREE_PARR(o, p) \
219 zval *__tmp = NULL; \
220 if (__tmp = GET_PROP(o, p)) { \
227 # define SET_EH_THROW() SET_EH_THROW_EX(zend_exception_get_default())
228 # define SET_EH_THROW_HTTP() SET_EH_THROW_EX(http_exception_get_default())
229 # define SET_EH_THROW_EX(ex) php_set_error_handling(EH_THROW, ex TSRMLS_CC)
230 # define SET_EH_NORMAL() php_set_error_handling(EH_NORMAL, NULL TSRMLS_CC)
232 #endif /* ZEND_ENGINE_2 */
239 #define HTTP_E_UNKOWN 0L
240 #define HTTP_E_PARSE 1L
241 #define HTTP_E_HEADER 2L
242 #define HTTP_E_OBUFFER 3L
243 #define HTTP_E_CURL 4L
244 #define HTTP_E_ENCODE 5L
245 #define HTTP_E_PARAM 6L
246 #define HTTP_E_URL 7L
247 #define HTTP_E_MSG 8L
249 #ifdef HTTP_HAVE_CURL
250 # ifdef ZEND_ENGINE_2
251 # define HTTP_DECLARE_ARG_PASS_INFO() \
253 ZEND_BEGIN_ARG_INFO(http_arg_pass_ref_3, 0) \
254 ZEND_ARG_PASS_INFO(0) \
255 ZEND_ARG_PASS_INFO(0) \
256 ZEND_ARG_PASS_INFO(1) \
257 ZEND_END_ARG_INFO(); \
260 ZEND_BEGIN_ARG_INFO(http_arg_pass_ref_4, 0) \
261 ZEND_ARG_PASS_INFO(0) \
262 ZEND_ARG_PASS_INFO(0) \
263 ZEND_ARG_PASS_INFO(0) \
264 ZEND_ARG_PASS_INFO(1) \
265 ZEND_END_ARG_INFO(); \
268 ZEND_BEGIN_ARG_INFO(http_arg_pass_ref_5, 0) \
269 ZEND_ARG_PASS_INFO(0) \
270 ZEND_ARG_PASS_INFO(0) \
271 ZEND_ARG_PASS_INFO(0) \
272 ZEND_ARG_PASS_INFO(0) \
273 ZEND_ARG_PASS_INFO(1) \
276 # define HTTP_DECLARE_ARG_PASS_INFO() \
277 static unsigned char http_arg_pass_ref_3[] = {3, BYREF_NONE, BYREF_NONE, BYREF_FORCE}; \
278 static unsigned char http_arg_pass_ref_4[] = {4, BYREF_NONE, BYREF_NONE, BYREF_NONE, BYREF_FORCE}; \
279 static unsigned char http_arg_pass_ref_5[] = {5, BYREF_NONE, BYREF_NONE, BYREF_NONE, BYREF_NONE, BYREF_FORCE}
280 # endif /* ZEND_ENGINE_2 */
282 # define HTTP_DECLARE_ARG_PASS_INFO()
283 #endif /* HTTP_HAVE_CURL */
286 #endif /* PHP_HTTP_STD_DEFS_H */
293 * vim600: noet sw=4 ts=4 fdm=marker
294 * vim<600: noet sw=4 ts=4