- fix pers. handles ident string setting
[m6w6/ext-http] / php_http_std_defs.h
1 /*
2 +--------------------------------------------------------------------+
3 | PECL :: http |
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) 2004-2006, Michael Wallner <mike@php.net> |
10 +--------------------------------------------------------------------+
11 */
12
13 /* $Id$ */
14
15 #ifndef PHP_HTTP_STD_DEFS_H
16 #define PHP_HTTP_STD_DEFS_H
17
18 #if defined(PHP_WIN32)
19 # if defined(HTTP_EXPORTS)
20 # define PHP_HTTP_API __declspec(dllexport)
21 # elif defined(COMPILE_DL_HTTP)
22 # define PHP_HTTP_API __declspec(dllimport)
23 # else
24 # define PHP_HTTP_API
25 # endif
26 #else
27 # define PHP_HTTP_API
28 #endif
29
30 /* make functions that return SUCCESS|FAILURE more obvious */
31 typedef int STATUS;
32
33 /* lenof() */
34 #define lenof(S) (sizeof(S) - 1)
35
36 #ifndef MIN
37 # define MIN(a,b) (a<b?a:b)
38 #endif
39 #ifndef MAX
40 # define MAX(a,b) (a>b?a:b)
41 #endif
42
43 /* STR_SET() */
44 #ifndef STR_SET
45 # define STR_SET(STR, SET) \
46 { \
47 STR_FREE(STR); \
48 STR = SET; \
49 }
50 #endif
51
52 #define STR_PTR(s) (s?s:"")
53
54 #define INIT_ZARR(zv, ht) \
55 { \
56 INIT_PZVAL(&(zv)); \
57 Z_TYPE(zv) = IS_ARRAY; \
58 Z_ARRVAL(zv) = (ht); \
59 }
60
61 /* return bool (v == SUCCESS) */
62 #define RETVAL_SUCCESS(v) RETVAL_BOOL(SUCCESS == (v))
63 #define RETURN_SUCCESS(v) RETURN_BOOL(SUCCESS == (v))
64 /* return object(values) */
65 #define RETVAL_OBJECT(o, addref) \
66 RETVAL_OBJVAL((o)->value.obj, addref)
67 #define RETURN_OBJECT(o, addref) \
68 RETVAL_OBJECT(o, addref); \
69 return
70 #define RETVAL_OBJVAL(ov, addref) \
71 ZVAL_OBJVAL(return_value, ov, addref)
72 #define RETURN_OBJVAL(ov, addref) \
73 RETVAL_OBJVAL(ov, addref); \
74 return
75 #define ZVAL_OBJVAL(zv, ov, addref) \
76 (zv)->type = IS_OBJECT; \
77 (zv)->value.obj = (ov);\
78 if (addref && Z_OBJ_HT_P(zv)->add_ref) { \
79 Z_OBJ_HT_P(zv)->add_ref((zv) TSRMLS_CC); \
80 }
81 /* return property */
82 #define RETVAL_PROP(n) RETVAL_PROP_EX(getThis(), n)
83 #define RETURN_PROP(n) RETURN_PROP_EX(getThis(), n)
84 #define RETVAL_PROP_EX(this, n) \
85 { \
86 zval *__prop = GET_PROP_EX(this, n); \
87 RETVAL_ZVAL(__prop, 1, 0); \
88 }
89 #define RETURN_PROP_EX(this, n) \
90 { \
91 zval *__prop = GET_PROP_EX(this, n); \
92 RETURN_ZVAL(__prop, 1, 0); \
93 }
94
95 /* function accepts no args */
96 #define NO_ARGS zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "");
97
98 /* CR LF */
99 #define HTTP_CRLF "\r\n"
100
101 /* default cache control */
102 #define HTTP_DEFAULT_CACHECONTROL "private, must-revalidate, max-age=0"
103
104 /* max URL length */
105 #define HTTP_URL_MAXLEN 4096
106
107 /* def URL arg separator */
108 #define HTTP_URL_ARGSEP "&"
109
110 /* send buffer size */
111 #define HTTP_SENDBUF_SIZE 8000 /*40960*/
112
113 /* CURL buffer size */
114 #define HTTP_CURLBUF_SIZE 16384
115
116 /* known methods */
117 #define HTTP_KNOWN_METHODS \
118 /* HTTP 1.1 */ \
119 "GET, HEAD, POST, PUT, DELETE, OPTIONS, TRACE, CONNECT, " \
120 /* WebDAV - RFC 2518 */ \
121 "PROPFIND, PROPPATCH, MKCOL, COPY, MOVE, LOCK, UNLOCK, " \
122 /* WebDAV Versioning - RFC 3253 */ \
123 "VERSION-CONTROL, REPORT, CHECKOUT, CHECKIN, UNCHECKOUT, " \
124 "MKWORKSPACE, UPDATE, LABEL, MERGE, BASELINE-CONTROL, MKACTIVITY, " \
125 /* WebDAV Access Control - RFC 3744 */ \
126 "ACL, " \
127 /* END */
128
129 #ifdef ZEND_ENGINE_2
130 # include "ext/standard/file.h"
131 # define HTTP_DEFAULT_STREAM_CONTEXT FG(default_context)
132 #else
133 # define HTTP_DEFAULT_STREAM_CONTEXT NULL
134 #endif
135
136 #define HTTP_PHP_INI_ENTRY(entry, default, scope, updater, global) \
137 STD_PHP_INI_ENTRY(entry, default, scope, updater, global, zend_http_globals, http_globals)
138 #define HTTP_PHP_INI_ENTRY_EX(entry, default, scope, updater, displayer, global) \
139 STD_PHP_INI_ENTRY_EX(entry, default, scope, updater, global, zend_http_globals, http_globals, displayer)
140
141
142 #define HTTP_LONG_CONSTANT(name, const) REGISTER_LONG_CONSTANT(name, const, CONST_CS | CONST_PERSISTENT)
143
144 /* {{{ objects & properties */
145 #ifdef ZEND_ENGINE_2
146
147 # define HTTP_STATIC_ME_ALIAS(me, al, ai) ZEND_FENTRY(me, ZEND_FN(al), ai, ZEND_ACC_PUBLIC | ZEND_ACC_STATIC)
148
149 # define HTTP_REGISTER_CLASS_EX(classname, name, parent, flags) \
150 { \
151 zend_class_entry ce; \
152 memset(&ce, 0, sizeof(zend_class_entry)); \
153 INIT_CLASS_ENTRY(ce, #classname, name## _fe); \
154 ce.create_object = _ ##name## _new; \
155 name## _ce = zend_register_internal_class_ex(&ce, parent, NULL TSRMLS_CC); \
156 name## _ce->ce_flags |= flags; \
157 memcpy(& name## _handlers, zend_get_std_object_handlers(), sizeof(zend_object_handlers)); \
158 }
159
160 # define HTTP_REGISTER_CLASS(classname, name, parent, flags) \
161 { \
162 zend_class_entry ce; \
163 memset(&ce, 0, sizeof(zend_class_entry)); \
164 INIT_CLASS_ENTRY(ce, #classname, name## _fe); \
165 ce.create_object = NULL; \
166 name## _ce = zend_register_internal_class_ex(&ce, parent, NULL TSRMLS_CC); \
167 name## _ce->ce_flags |= flags; \
168 }
169
170 # define HTTP_REGISTER_EXCEPTION(classname, cename, parent) \
171 { \
172 zend_class_entry ce; \
173 memset(&ce, 0, sizeof(zend_class_entry)); \
174 INIT_CLASS_ENTRY(ce, #classname, NULL); \
175 ce.create_object = NULL; \
176 cename = zend_register_internal_class_ex(&ce, parent, NULL TSRMLS_CC); \
177 }
178
179 # define getObject(t, o) getObjectEx(t, o, getThis())
180 # define getObjectEx(t, o, v) t * o = ((t *) zend_object_store_get_object(v TSRMLS_CC))
181 # define putObject(t, o) zend_objects_store_put(o, (zend_objects_store_dtor_t) zend_objects_destroy_object, (zend_objects_free_object_storage_t) _ ##t## _free, NULL TSRMLS_CC);
182 # ifndef WONKY
183 # define freeObject(o) \
184 if (OBJ_GUARDS(o)) { \
185 zend_hash_destroy(OBJ_GUARDS(o)); \
186 FREE_HASHTABLE(OBJ_GUARDS(o)); \
187 } \
188 if (OBJ_PROP(o)) { \
189 zend_hash_destroy(OBJ_PROP(o)); \
190 FREE_HASHTABLE(OBJ_PROP(o)); \
191 } \
192 efree(o);
193 # else
194 # define freeObject(o) \
195 if (OBJ_PROP(o)) { \
196 zend_hash_destroy(OBJ_PROP(o)); \
197 FREE_HASHTABLE(OBJ_PROP(o)); \
198 } \
199 efree(o);
200 # endif
201 # define OBJ_PROP(o) (o)->zo.properties
202 # define OBJ_GUARDS(o) (o)->zo.guards
203
204 # define DCL_STATIC_PROP(a, t, n, v) zend_declare_property_ ##t(OBJ_PROP_CE, (#n), sizeof(#n)-1, (v), (ZEND_ACC_ ##a | ZEND_ACC_STATIC) TSRMLS_CC)
205 # define DCL_STATIC_PROP_Z(a, n, v) zend_declare_property(OBJ_PROP_CE, (#n), sizeof(#n)-1, (v), (ZEND_ACC_ ##a | ZEND_ACC_STATIC) TSRMLS_CC)
206 # define DCL_STATIC_PROP_N(a, n) zend_declare_property_null(OBJ_PROP_CE, (#n), sizeof(#n)-1, (ZEND_ACC_ ##a | ZEND_ACC_STATIC) TSRMLS_CC)
207 # define GET_STATIC_PROP_EX(ce, n) zend_std_get_static_property(ce, (#n), sizeof(#n)-1, 0 TSRMLS_CC)
208 # define UPD_STATIC_PROP_EX(ce, t, n, v) zend_update_static_property_ ##t(ce, #n, sizeof(#n)-1, (v) TSRMLS_CC)
209 # define UPD_STATIC_STRL_EX(ce, n, v, l) zend_update_static_property_stringl(ce, #n, sizeof(#n)-1, (v), (l) TSRMLS_CC)
210 # define SET_STATIC_PROP_EX(ce, n, v) zend_update_static_property(ce, #n, sizeof(#n)-1, v TSRMLS_CC)
211 # define GET_STATIC_PROP(n) *GET_STATIC_PROP_EX(OBJ_PROP_CE, n)
212 # define UPD_STATIC_PROP(t, n, v) UPD_STATIC_PROP_EX(OBJ_PROP_CE, t, n, v)
213 # define SET_STATIC_PROP(n, v) SET_STATIC_PROP_EX(OBJ_PROP_CE, n, v)
214 # define UPD_STATIC_STRL(n, v, l) UPD_STATIC_STRL_EX(OBJ_PROP_CE, n, v, l)
215
216 # define DCL_PROP(a, t, n, v) zend_declare_property_ ##t(OBJ_PROP_CE, (#n), sizeof(#n)-1, (v), (ZEND_ACC_ ##a) TSRMLS_CC)
217 # define DCL_PROP_Z(a, n, v) zend_declare_property(OBJ_PROP_CE, (#n), sizeof(#n)-1, (v), (ZEND_ACC_ ##a) TSRMLS_CC)
218 # define DCL_PROP_N(a, n) zend_declare_property_null(OBJ_PROP_CE, (#n), sizeof(#n)-1, (ZEND_ACC_ ##a) TSRMLS_CC)
219 # define UPD_PROP(t, n, v) UPD_PROP_EX(getThis(), t, n, v)
220 # define UPD_PROP_EX(this, t, n, v) zend_update_property_ ##t(OBJ_PROP_CE, this, (#n), sizeof(#n)-1, (v) TSRMLS_CC)
221 # define UPD_STRL(n, v, l) zend_update_property_stringl(OBJ_PROP_CE, getThis(), (#n), sizeof(#n)-1, (v), (l) TSRMLS_CC)
222 # define SET_PROP(n, z) SET_PROP_EX(getThis(), n, z)
223 # define SET_PROP_EX(this, n, z) zend_update_property(OBJ_PROP_CE, this, (#n), sizeof(#n)-1, (z) TSRMLS_CC)
224 # define GET_PROP(n) GET_PROP_EX(getThis(), n)
225 # define GET_PROP_EX(this, n) zend_read_property(OBJ_PROP_CE, this, (#n), sizeof(#n)-1, 0 TSRMLS_CC)
226
227 # define DCL_CONST(t, n, v) zend_declare_class_constant_ ##t(OBJ_PROP_CE, (n), sizeof(n)-1, (v) TSRMLS_CC)
228
229 # define ACC_PROP_PRIVATE(ce, flags) ((flags & ZEND_ACC_PRIVATE) && (EG(scope) && ce == EG(scope))
230 # define ACC_PROP_PROTECTED(ce, flags) ((flags & ZEND_ACC_PROTECTED) && (zend_check_protected(ce, EG(scope))))
231 # define ACC_PROP_PUBLIC(flags) (flags & ZEND_ACC_PUBLIC)
232 # define ACC_PROP(ce, flags) (ACC_PROP_PUBLIC(flags) || ACC_PROP_PRIVATE(ce, flags) || ACC_PROP_PROTECTED(ce, flags))
233
234 # define SET_EH_THROW_HTTP() SET_EH_THROW_EX(http_exception_get_default())
235 # define SET_EH_THROW_EX(ex) php_set_error_handling(EH_THROW, ex TSRMLS_CC)
236 # define SET_EH_NORMAL() php_set_error_handling(EH_NORMAL, NULL TSRMLS_CC)
237
238 #endif /* ZEND_ENGINE_2 */
239 /* }}} */
240
241 #ifdef ZEND_ENGINE_2
242 # define with_error_handling(eh, ec) \
243 { \
244 error_handling_t __eh = PG(error_handling); \
245 zend_class_entry *__ec= PG(exception_class); \
246 php_set_error_handling(eh, ec TSRMLS_CC);
247 # define end_error_handling() \
248 php_set_error_handling(__eh, __ec TSRMLS_CC); \
249 }
250 #else
251 # define with_error_handling(eh, ec)
252 # define end_error_handling()
253 #endif
254
255 #if (PHP_MAJOR_VERSION == 5 && PHP_MINOR_VERSION >= 2) || PHP_MAJOR_VERSION > 5
256 # define ZEND_EXCEPTION_GET_DEFAULT() zend_exception_get_default(TSRMLS_C)
257 #else
258 # define ZEND_EXCEPTION_GET_DEFAULT() zend_exception_get_default()
259 #endif
260
261 #ifndef E_THROW
262 # define E_THROW 0
263 #endif
264 #ifdef ZEND_ENGINE_2
265 # define HE_THROW E_THROW TSRMLS_CC
266 # define HE_NOTICE (HTTP_G->only_exceptions ? E_THROW : E_NOTICE) TSRMLS_CC
267 # define HE_WARNING (HTTP_G->only_exceptions ? E_THROW : E_WARNING) TSRMLS_CC
268 # define HE_ERROR (HTTP_G->only_exceptions ? E_THROW : E_ERROR) TSRMLS_CC
269 #else
270 # define HE_THROW E_WARNING TSRMLS_CC
271 # define HE_NOTICE E_NOTICE TSRMLS_CC
272 # define HE_WARNING E_WARNING TSRMLS_CC
273 # define HE_ERROR E_ERROR TSRMLS_CC
274 #endif
275
276 #define HTTP_E_RUNTIME 1L
277 #define HTTP_E_INVALID_PARAM 2L
278 #define HTTP_E_HEADER 3L
279 #define HTTP_E_MALFORMED_HEADERS 4L
280 #define HTTP_E_REQUEST_METHOD 5L
281 #define HTTP_E_MESSAGE_TYPE 6L
282 #define HTTP_E_ENCODING 7L
283 #define HTTP_E_REQUEST 8L
284 #define HTTP_E_REQUEST_POOL 9L
285 #define HTTP_E_SOCKET 10L
286 #define HTTP_E_RESPONSE 11L
287 #define HTTP_E_URL 12L
288 #define HTTP_E_QUERYSTRING 13L
289
290 #ifdef ZEND_ENGINE_2
291 # define HTTP_BEGIN_ARGS_EX(class, method, ret_ref, req_args) static ZEND_BEGIN_ARG_INFO_EX(args_for_ ##class## _ ##method , 0, ret_ref, req_args)
292 # define HTTP_BEGIN_ARGS_AR(class, method, ret_ref, req_args) static ZEND_BEGIN_ARG_INFO_EX(args_for_ ##class## _ ##method , 1, ret_ref, req_args)
293 # define HTTP_END_ARGS }
294 # define HTTP_EMPTY_ARGS_EX(class, method, ret_ref) HTTP_BEGIN_ARGS_EX(class, method, ret_ref, 0) HTTP_END_ARGS
295 # define HTTP_ARGS(class, method) args_for_ ##class## _ ##method
296 # define HTTP_ARG_VAL(name, pass_ref) ZEND_ARG_INFO(pass_ref, name)
297 # define HTTP_ARG_OBJ(class, name, allow_null) ZEND_ARG_OBJ_INFO(0, name, class, allow_null)
298 #endif
299
300 #ifdef ZEND_ENGINE_2
301 # define EMPTY_FUNCTION_ENTRY {NULL, NULL, NULL, 0, 0}
302 #else
303 # define EMPTY_FUNCTION_ENTRY {NULL, NULL, NULL}
304 #endif
305
306 #ifdef HTTP_HAVE_CURL
307 # ifdef ZEND_ENGINE_2
308 # define HTTP_DECLARE_ARG_PASS_INFO() \
309 static \
310 ZEND_BEGIN_ARG_INFO(http_arg_pass_ref_2, 0) \
311 ZEND_ARG_PASS_INFO(0) \
312 ZEND_ARG_PASS_INFO(1) \
313 ZEND_END_ARG_INFO(); \
314 \
315 static \
316 ZEND_BEGIN_ARG_INFO(http_arg_pass_ref_3, 0) \
317 ZEND_ARG_PASS_INFO(0) \
318 ZEND_ARG_PASS_INFO(0) \
319 ZEND_ARG_PASS_INFO(1) \
320 ZEND_END_ARG_INFO(); \
321 \
322 static \
323 ZEND_BEGIN_ARG_INFO(http_arg_pass_ref_4, 0) \
324 ZEND_ARG_PASS_INFO(0) \
325 ZEND_ARG_PASS_INFO(0) \
326 ZEND_ARG_PASS_INFO(0) \
327 ZEND_ARG_PASS_INFO(1) \
328 ZEND_END_ARG_INFO(); \
329 \
330 static \
331 ZEND_BEGIN_ARG_INFO(http_arg_pass_ref_5, 0) \
332 ZEND_ARG_PASS_INFO(0) \
333 ZEND_ARG_PASS_INFO(0) \
334 ZEND_ARG_PASS_INFO(0) \
335 ZEND_ARG_PASS_INFO(0) \
336 ZEND_ARG_PASS_INFO(1) \
337 ZEND_END_ARG_INFO();
338
339 # else
340 # define HTTP_DECLARE_ARG_PASS_INFO() \
341 static unsigned char http_arg_pass_ref_2[] = {2, BYREF_NONE, BYREF_FORCE}; \
342 static unsigned char http_arg_pass_ref_3[] = {3, BYREF_NONE, BYREF_NONE, BYREF_FORCE}; \
343 static unsigned char http_arg_pass_ref_4[] = {4, BYREF_NONE, BYREF_NONE, BYREF_NONE, BYREF_FORCE}; \
344 static unsigned char http_arg_pass_ref_5[] = {5, BYREF_NONE, BYREF_NONE, BYREF_NONE, BYREF_NONE, BYREF_FORCE};
345 # endif /* ZEND_ENGINE_2 */
346 #else
347 # ifdef ZEND_ENGINE_2
348 # define HTTP_DECLARE_ARG_PASS_INFO() \
349 static \
350 ZEND_BEGIN_ARG_INFO(http_arg_pass_ref_2, 0) \
351 ZEND_ARG_PASS_INFO(0) \
352 ZEND_ARG_PASS_INFO(1) \
353 ZEND_END_ARG_INFO(); \
354 \
355 static \
356 ZEND_BEGIN_ARG_INFO(http_arg_pass_ref_4, 0) \
357 ZEND_ARG_PASS_INFO(0) \
358 ZEND_ARG_PASS_INFO(0) \
359 ZEND_ARG_PASS_INFO(0) \
360 ZEND_ARG_PASS_INFO(1) \
361 ZEND_END_ARG_INFO();
362 # else
363 # define HTTP_DECLARE_ARG_PASS_INFO() \
364 static unsigned char http_arg_pass_ref_2[] = {2, BYREF_NONE, BYREF_FORCE}; \
365 static unsigned char http_arg_pass_ref_4[] = {4, BYREF_NONE, BYREF_NONE, BYREF_NONE, BYREF_FORCE};
366 # endif /* ZEND_ENGINE_2 */
367 #endif /* HTTP_HAVE_CURL */
368
369
370 #ifndef HAVE_CURL_SHARE_STRERROR
371 # define curl_share_strerror(dummy) "unknown error"
372 #endif
373 #ifndef HAVE_CURL_EASY_STRERROR
374 # define curl_easy_strerror(dummy) "unknown error"
375 #endif
376 #ifndef HAVE_CURL_MULTI_STRERROR
377 # define curl_multi_strerror(dummy) "unknown error"
378 #endif
379
380 #define PHP_MINIT_CALL(func) PHP_MINIT(func)(INIT_FUNC_ARGS_PASSTHRU)
381 #define PHP_RINIT_CALL(func) PHP_RINIT(func)(INIT_FUNC_ARGS_PASSTHRU)
382 #define PHP_MSHUTDOWN_CALL(func) PHP_MSHUTDOWN(func)(SHUTDOWN_FUNC_ARGS_PASSTHRU)
383 #define PHP_RSHUTDOWN_CALL(func) PHP_RSHUTDOWN(func)(SHUTDOWN_FUNC_ARGS_PASSTHRU)
384
385 #define Z_OBJ_DELREF(z) \
386 if (Z_OBJ_HT(z)->del_ref) { \
387 Z_OBJ_HT(z)->del_ref(&(z) TSRMLS_CC); \
388 }
389 #define Z_OBJ_ADDREF(z) \
390 if (Z_OBJ_HT(z)->add_ref) { \
391 Z_OBJ_HT(z)->add_ref(&(z) TSRMLS_CC); \
392 }
393 #define Z_OBJ_DELREF_P(z) \
394 if (Z_OBJ_HT_P(z)->del_ref) { \
395 Z_OBJ_HT_P(z)->del_ref((z) TSRMLS_CC); \
396 }
397 #define Z_OBJ_ADDREF_P(z) \
398 if (Z_OBJ_HT_P(z)->add_ref) { \
399 Z_OBJ_HT_P(z)->add_ref((z) TSRMLS_CC); \
400 }
401 #define Z_OBJ_DELREF_PP(z) \
402 if (Z_OBJ_HT_PP(z)->del_ref) { \
403 Z_OBJ_HT_PP(z)->del_ref(*(z) TSRMLS_CC); \
404 }
405 #define Z_OBJ_ADDREF_PP(z) \
406 if (Z_OBJ_HT_PP(z)->add_ref) { \
407 Z_OBJ_HT_PP(z)->add_ref(*(z) TSRMLS_CC); \
408 }
409
410 #endif /* PHP_HTTP_STD_DEFS_H */
411
412 /*
413 * Local variables:
414 * tab-width: 4
415 * c-basic-offset: 4
416 * End:
417 * vim600: noet sw=4 ts=4 fdm=marker
418 * vim<600: noet sw=4 ts=4
419 */
420