git.m6w6.name Git - m6w6/ext-http/blob - 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-2007, 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 = zend_read_property(THIS_CE, this, ZEND_STRS(#n)-1, 0 TSRMLS_CC); \
  87                 RETVAL_ZVAL(__prop, 1, 0); \
  88         }
  89 #define RETURN_PROP_EX(this, n) \
  90         { \
  91                 zval *__prop = zend_read_property(THIS_CE, this, ZEND_STRS(#n)-1, 0 TSRMLS_CC); \
  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 /* max request method length */
 108 #define HTTP_REQUEST_METHOD_MAXLEN 31
 109
 110 /* def URL arg separator */
 111 #define HTTP_URL_ARGSEP "&"
 112
 113 /* send buffer size */
 114 #define HTTP_SENDBUF_SIZE 40960
 115
 116 /* CURL buffer size */
 117 #define HTTP_CURLBUF_SIZE 16384
 118
 119 /* known methods */
 120 #define HTTP_KNOWN_METHODS \
 121                 /* HTTP 1.1 */ \
 122                 "GET, HEAD, POST, PUT, DELETE, OPTIONS, TRACE, CONNECT, " \
 123                 /* WebDAV - RFC 2518 */ \
 124                 "PROPFIND, PROPPATCH, MKCOL, COPY, MOVE, LOCK, UNLOCK, " \
 125                 /* WebDAV Versioning - RFC 3253 */ \
 126                 "VERSION-CONTROL, REPORT, CHECKOUT, CHECKIN, UNCHECKOUT, " \
 127                 "MKWORKSPACE, UPDATE, LABEL, MERGE, BASELINE-CONTROL, MKACTIVITY, " \
 128                 /* WebDAV Access Control - RFC 3744 */ \
 129                 "ACL, " \
 130                 /* END */
 131
 132 #ifdef ZEND_ENGINE_2
 133 #       include "ext/standard/file.h"
 134 #       define HTTP_DEFAULT_STREAM_CONTEXT FG(default_context)
 135 #else
 136 #       define HTTP_DEFAULT_STREAM_CONTEXT NULL
 137 #endif
 138
 139 #define HTTP_PHP_INI_ENTRY(entry, default, scope, updater, global) \
 140         STD_PHP_INI_ENTRY(entry, default, scope, updater, global, zend_http_globals, http_globals)
 141 #define HTTP_PHP_INI_ENTRY_EX(entry, default, scope, updater, displayer, global) \
 142         STD_PHP_INI_ENTRY_EX(entry, default, scope, updater, global, zend_http_globals, http_globals, displayer)
 143
 144
 145 #define HTTP_LONG_CONSTANT(name, const) REGISTER_LONG_CONSTANT(name, const, CONST_CS | CONST_PERSISTENT)
 146
 147 /* {{{ objects & properties */
 148 #ifdef ZEND_ENGINE_2
 149
 150 #       define HTTP_STATIC_ME_ALIAS(me, al, ai) ZEND_FENTRY(me, ZEND_FN(al), ai, ZEND_ACC_PUBLIC | ZEND_ACC_STATIC)
 151
 152 #       define HTTP_REGISTER_CLASS_EX(classname, name, parent, flags) \
 153         { \
 154                 zend_class_entry ce; \
 155                 memset(&ce, 0, sizeof(zend_class_entry)); \
 156                 INIT_CLASS_ENTRY(ce, #classname, name## _fe); \
 157                 ce.create_object = _ ##name## _new; \
 158                 name## _ce = zend_register_internal_class_ex(&ce, parent, NULL TSRMLS_CC); \
 159                 name## _ce->ce_flags |= flags;  \
 160                 memcpy(& name## _handlers, zend_get_std_object_handlers(), sizeof(zend_object_handlers)); \
 161         }
 162
 163 #       define HTTP_REGISTER_CLASS(classname, name, parent, flags) \
 164         { \
 165                 zend_class_entry ce; \
 166                 memset(&ce, 0, sizeof(zend_class_entry)); \
 167                 INIT_CLASS_ENTRY(ce, #classname, name## _fe); \
 168                 ce.create_object = NULL; \
 169                 name## _ce = zend_register_internal_class_ex(&ce, parent, NULL TSRMLS_CC); \
 170                 name## _ce->ce_flags |= flags;  \
 171         }
 172
 173 #       define HTTP_REGISTER_EXCEPTION(classname, cename, parent) \
 174         { \
 175                 zend_class_entry ce; \
 176                 memset(&ce, 0, sizeof(zend_class_entry)); \
 177                 INIT_CLASS_ENTRY(ce, #classname, NULL); \
 178                 ce.create_object = NULL; \
 179                 cename = zend_register_internal_class_ex(&ce, parent, NULL TSRMLS_CC); \
 180         }
 181
 182 #       define getObject(t, o) getObjectEx(t, o, getThis())
 183 #       define getObjectEx(t, o, v) t * o = ((t *) zend_object_store_get_object(v TSRMLS_CC))
 184 #       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);
 185 #       ifndef WONKY
 186 #               define freeObject(o) \
 187                         if (OBJ_GUARDS(o)) { \
 188                                 zend_hash_destroy(OBJ_GUARDS(o)); \
 189                                 FREE_HASHTABLE(OBJ_GUARDS(o)); \
 190                         } \
 191                         if (OBJ_PROP(o)) { \
 192                                 zend_hash_destroy(OBJ_PROP(o)); \
 193                                 FREE_HASHTABLE(OBJ_PROP(o)); \
 194                         } \
 195                         efree(o);
 196 #       else
 197 #               define freeObject(o) \
 198                         if (OBJ_PROP(o)) { \
 199                                 zend_hash_destroy(OBJ_PROP(o)); \
 200                                 FREE_HASHTABLE(OBJ_PROP(o)); \
 201                         } \
 202                         efree(o);
 203 #       endif
 204 #       define OBJ_PROP(o) (o)->zo.properties
 205 #       define OBJ_GUARDS(o) (o)->zo.guards
 206
 207 #       define ACC_PROP_PRIVATE(ce, flags)              ((flags & ZEND_ACC_PRIVATE) && (EG(scope) && ce == EG(scope))
 208 #       define ACC_PROP_PROTECTED(ce, flags)    ((flags & ZEND_ACC_PROTECTED) && (zend_check_protected(ce, EG(scope))))
 209 #       define ACC_PROP_PUBLIC(flags)                   (flags & ZEND_ACC_PUBLIC)
 210 #       define ACC_PROP(ce, flags)                              (ACC_PROP_PUBLIC(flags) || ACC_PROP_PRIVATE(ce, flags) || ACC_PROP_PROTECTED(ce, flags))
 211
 212 #       define SET_EH_THROW_HTTP() SET_EH_THROW_EX(http_exception_get_default())
 213 #       define SET_EH_THROW_EX(ex) php_set_error_handling(EH_THROW, ex TSRMLS_CC)
 214 #       define SET_EH_NORMAL() php_set_error_handling(EH_NORMAL, NULL TSRMLS_CC)
 215
 216 #endif /* ZEND_ENGINE_2 */
 217 /* }}} */
 218
 219 #ifdef ZEND_ENGINE_2
 220 #       define with_error_handling(eh, ec) \
 221         { \
 222                 error_handling_t __eh = PG(error_handling); \
 223                 zend_class_entry *__ec= PG(exception_class); \
 224                 php_set_error_handling(eh, ec TSRMLS_CC);
 225 #       define end_error_handling() \
 226                 php_set_error_handling(__eh, __ec TSRMLS_CC); \
 227         }
 228 #else
 229 #       define with_error_handling(eh, ec)
 230 #       define end_error_handling()
 231 #endif
 232
 233 #if (PHP_MAJOR_VERSION == 5 && PHP_MINOR_VERSION >= 2) || PHP_MAJOR_VERSION > 5
 234 #       define  ZEND_EXCEPTION_GET_DEFAULT() zend_exception_get_default(TSRMLS_C)
 235 #else
 236 #       define  ZEND_EXCEPTION_GET_DEFAULT() zend_exception_get_default()
 237 #endif
 238
 239 #ifndef E_THROW
 240 #       define E_THROW 0
 241 #endif
 242 #ifdef ZEND_ENGINE_2
 243 #       define HE_THROW         E_THROW TSRMLS_CC
 244 #       define HE_NOTICE        (HTTP_G->only_exceptions ? E_THROW : E_NOTICE) TSRMLS_CC
 245 #       define HE_WARNING       (HTTP_G->only_exceptions ? E_THROW : E_WARNING) TSRMLS_CC
 246 #       define HE_ERROR         (HTTP_G->only_exceptions ? E_THROW : E_ERROR) TSRMLS_CC
 247 #else
 248 #       define HE_THROW         E_WARNING TSRMLS_CC
 249 #       define HE_NOTICE        E_NOTICE TSRMLS_CC
 250 #       define HE_WARNING       E_WARNING TSRMLS_CC
 251 #       define HE_ERROR         E_ERROR TSRMLS_CC
 252 #endif
 253
 254 #define HTTP_E_RUNTIME                          1L
 255 #define HTTP_E_INVALID_PARAM            2L
 256 #define HTTP_E_HEADER                           3L
 257 #define HTTP_E_MALFORMED_HEADERS        4L
 258 #define HTTP_E_REQUEST_METHOD           5L
 259 #define HTTP_E_MESSAGE_TYPE                     6L
 260 #define HTTP_E_ENCODING                         7L
 261 #define HTTP_E_REQUEST                          8L
 262 #define HTTP_E_REQUEST_POOL                     9L
 263 #define HTTP_E_SOCKET                           10L
 264 #define HTTP_E_RESPONSE                         11L
 265 #define HTTP_E_URL                                      12L
 266 #define HTTP_E_QUERYSTRING                      13L
 267
 268 #ifdef ZEND_ENGINE_2
 269 #       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)
 270 #       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)
 271 #       define HTTP_END_ARGS                                                                            }
 272 #       define HTTP_EMPTY_ARGS_EX(class, method, ret_ref)                       HTTP_BEGIN_ARGS_EX(class, method, ret_ref, 0) HTTP_END_ARGS
 273 #       define HTTP_ARGS(class, method)                                                         args_for_ ##class## _ ##method
 274 #       define HTTP_ARG_VAL(name, pass_ref)                                                     ZEND_ARG_INFO(pass_ref, name)
 275 #       define HTTP_ARG_OBJ(class, name, allow_null)                            ZEND_ARG_OBJ_INFO(0, name, class, allow_null)
 276 #endif
 277
 278 #ifdef ZEND_ENGINE_2
 279 #       define EMPTY_FUNCTION_ENTRY {NULL, NULL, NULL, 0, 0}
 280 #else
 281 #       define EMPTY_FUNCTION_ENTRY {NULL, NULL, NULL}
 282 #endif
 283
 284 #ifdef HTTP_HAVE_CURL
 285 #       ifdef ZEND_ENGINE_2
 286 #               define HTTP_DECLARE_ARG_PASS_INFO() \
 287                         static \
 288                         ZEND_BEGIN_ARG_INFO(http_arg_pass_ref_2, 0) \
 289                                 ZEND_ARG_PASS_INFO(0) \
 290                                 ZEND_ARG_PASS_INFO(1) \
 291                         ZEND_END_ARG_INFO(); \
 292  \
 293                         static \
 294                         ZEND_BEGIN_ARG_INFO(http_arg_pass_ref_3, 0) \
 295                                 ZEND_ARG_PASS_INFO(0) \
 296                                 ZEND_ARG_PASS_INFO(0) \
 297                                 ZEND_ARG_PASS_INFO(1) \
 298                         ZEND_END_ARG_INFO(); \
 299  \
 300                         static \
 301                         ZEND_BEGIN_ARG_INFO(http_arg_pass_ref_4, 0) \
 302                                 ZEND_ARG_PASS_INFO(0) \
 303                                 ZEND_ARG_PASS_INFO(0) \
 304                                 ZEND_ARG_PASS_INFO(0) \
 305                                 ZEND_ARG_PASS_INFO(1) \
 306                         ZEND_END_ARG_INFO(); \
 307  \
 308                         static \
 309                         ZEND_BEGIN_ARG_INFO(http_arg_pass_ref_5, 0) \
 310                                 ZEND_ARG_PASS_INFO(0) \
 311                                 ZEND_ARG_PASS_INFO(0) \
 312                                 ZEND_ARG_PASS_INFO(0) \
 313                                 ZEND_ARG_PASS_INFO(0) \
 314                                 ZEND_ARG_PASS_INFO(1) \
 315                         ZEND_END_ARG_INFO();
 316
 317 #       else
 318 #               define HTTP_DECLARE_ARG_PASS_INFO() \
 319                         static unsigned char http_arg_pass_ref_2[] = {2, BYREF_NONE, BYREF_FORCE}; \
 320                         static unsigned char http_arg_pass_ref_3[] = {3, BYREF_NONE, BYREF_NONE, BYREF_FORCE}; \
 321                         static unsigned char http_arg_pass_ref_4[] = {4, BYREF_NONE, BYREF_NONE, BYREF_NONE, BYREF_FORCE}; \
 322                         static unsigned char http_arg_pass_ref_5[] = {5, BYREF_NONE, BYREF_NONE, BYREF_NONE, BYREF_NONE, BYREF_FORCE};
 323 #       endif /* ZEND_ENGINE_2 */
 324 #else
 325 #       ifdef ZEND_ENGINE_2
 326 #               define HTTP_DECLARE_ARG_PASS_INFO() \
 327                         static \
 328                         ZEND_BEGIN_ARG_INFO(http_arg_pass_ref_2, 0) \
 329                                 ZEND_ARG_PASS_INFO(0) \
 330                                 ZEND_ARG_PASS_INFO(1) \
 331                         ZEND_END_ARG_INFO(); \
 332 \
 333                         static \
 334                         ZEND_BEGIN_ARG_INFO(http_arg_pass_ref_4, 0) \
 335                                 ZEND_ARG_PASS_INFO(0) \
 336                                 ZEND_ARG_PASS_INFO(0) \
 337                                 ZEND_ARG_PASS_INFO(0) \
 338                                 ZEND_ARG_PASS_INFO(1) \
 339                         ZEND_END_ARG_INFO();
 340 #       else
 341 #               define HTTP_DECLARE_ARG_PASS_INFO() \
 342                         static unsigned char http_arg_pass_ref_2[] = {2, BYREF_NONE, BYREF_FORCE}; \
 343                         static unsigned char http_arg_pass_ref_4[] = {4, BYREF_NONE, BYREF_NONE, BYREF_NONE, BYREF_FORCE};
 344 #       endif /* ZEND_ENGINE_2 */
 345 #endif /* HTTP_HAVE_CURL */
 346
 347
 348 #ifndef HAVE_CURL_SHARE_STRERROR
 349 #       define curl_share_strerror(dummy) "unknown error"
 350 #endif
 351 #ifndef HAVE_CURL_EASY_STRERROR
 352 #       define curl_easy_strerror(dummy) "unknown error"
 353 #endif
 354 #ifndef HAVE_CURL_MULTI_STRERROR
 355 #       define curl_multi_strerror(dummy) "unknown error"
 356 #endif
 357
 358 #define PHP_MINIT_CALL(func) PHP_MINIT(func)(INIT_FUNC_ARGS_PASSTHRU)
 359 #define PHP_RINIT_CALL(func) PHP_RINIT(func)(INIT_FUNC_ARGS_PASSTHRU)
 360 #define PHP_MSHUTDOWN_CALL(func) PHP_MSHUTDOWN(func)(SHUTDOWN_FUNC_ARGS_PASSTHRU)
 361 #define PHP_RSHUTDOWN_CALL(func) PHP_RSHUTDOWN(func)(SHUTDOWN_FUNC_ARGS_PASSTHRU)
 362
 363 #define Z_OBJ_DELREF(z) \
 364         if (Z_OBJ_HT(z)->del_ref) { \
 365                 Z_OBJ_HT(z)->del_ref(&(z) TSRMLS_CC); \
 366         }
 367 #define Z_OBJ_ADDREF(z) \
 368         if (Z_OBJ_HT(z)->add_ref) { \
 369                 Z_OBJ_HT(z)->add_ref(&(z) TSRMLS_CC); \
 370         }
 371 #define Z_OBJ_DELREF_P(z) \
 372         if (Z_OBJ_HT_P(z)->del_ref) { \
 373                 Z_OBJ_HT_P(z)->del_ref((z) TSRMLS_CC); \
 374         }
 375 #define Z_OBJ_ADDREF_P(z) \
 376         if (Z_OBJ_HT_P(z)->add_ref) { \
 377                 Z_OBJ_HT_P(z)->add_ref((z) TSRMLS_CC); \
 378         }
 379 #define Z_OBJ_DELREF_PP(z) \
 380         if (Z_OBJ_HT_PP(z)->del_ref) { \
 381                 Z_OBJ_HT_PP(z)->del_ref(*(z) TSRMLS_CC); \
 382         }
 383 #define Z_OBJ_ADDREF_PP(z) \
 384         if (Z_OBJ_HT_PP(z)->add_ref) { \
 385                 Z_OBJ_HT_PP(z)->add_ref(*(z) TSRMLS_CC); \
 386         }
 387
 388 #endif /* PHP_HTTP_STD_DEFS_H */
 389
 390 /*
 391  * Local variables:
 392  * tab-width: 4
 393  * c-basic-offset: 4
 394  * End:
 395  * vim600: noet sw=4 ts=4 fdm=marker
 396  * vim<600: noet sw=4 ts=4
 397  */
 398