git.m6w6.name Git - m6w6/ext-http/blob - php_http_client.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-2011, Michael Wallner <mike@php.net>            |
  10     +--------------------------------------------------------------------+
  11 */
  12
  13 #ifndef PHP_HTTP_CLIENT_H
  14 #define PHP_HTTP_CLIENT_H
  15
  16 #include "php_http_message_body.h"
  17 #include "php_http_message_parser.h"
  18
  19 typedef struct php_http_client_progress_state {
  20         struct {
  21                 double now;
  22                 double total;
  23         } ul;
  24         struct {
  25                 double now;
  26                 double total;
  27         } dl;
  28         const char *info;
  29         unsigned started:1;
  30         unsigned finished:1;
  31 } php_http_client_progress_state_t;
  32
  33 #define PHP_HTTP_CLIENT_PROGRESS_CALLBACK_USER 0
  34 #define PHP_HTTP_CLIENT_PROGRESS_CALLBACK_INTERN 1
  35 typedef struct php_http_client_progress_callback {
  36         union {
  37                 zval *user;
  38                 void (*intern)(php_http_client_progress_state_t* TSRMLS_DC);
  39         } func;
  40         unsigned type:1;
  41         unsigned pass_state:1;
  42 } php_http_client_progress_callback_t;
  43
  44 typedef struct php_http_client_progress {
  45         php_http_client_progress_state_t state;
  46         php_http_client_progress_callback_t *callback;
  47         unsigned in_cb:1;
  48 } php_http_client_progress_t;
  49
  50 static inline void php_http_client_progress_dtor(php_http_client_progress_t *progress TSRMLS_DC)
  51 {
  52         if (progress->callback) {
  53                 if (progress->callback->type == PHP_HTTP_CLIENT_PROGRESS_CALLBACK_USER) {
  54                         zval_ptr_dtor(&progress->callback->func.user);
  55                 }
  56                 efree(progress->callback);
  57         }
  58         memset(progress, 0, sizeof(*progress));
  59 }
  60
  61 static inline void php_http_client_progress_notify(php_http_client_progress_t *progress TSRMLS_DC)
  62 {
  63         if (progress->callback) {
  64                 zval retval;
  65
  66                 INIT_PZVAL(&retval);
  67                 ZVAL_NULL(&retval);
  68
  69                 with_error_handling(EH_NORMAL, NULL) {
  70                         switch (progress->callback->type) {
  71                                 case PHP_HTTP_CLIENT_PROGRESS_CALLBACK_USER:
  72                                         if (progress->callback->pass_state) {
  73                                                 zval *param;
  74
  75                                                 MAKE_STD_ZVAL(param);
  76                                                 array_init(param);
  77                                                 add_assoc_bool(param, "started", progress->state.started);
  78                                                 add_assoc_bool(param, "finished", progress->state.finished);
  79                                                 add_assoc_string(param, "info", estrdup(progress->state.info), 0);
  80                                                 add_assoc_double(param, "dltotal", progress->state.dl.total);
  81                                                 add_assoc_double(param, "dlnow", progress->state.dl.now);
  82                                                 add_assoc_double(param, "ultotal", progress->state.ul.total);
  83                                                 add_assoc_double(param, "ulnow", progress->state.ul.now);
  84
  85                                                 progress->in_cb = 1;
  86                                                 call_user_function(EG(function_table), NULL, progress->callback->func.user, &retval, 1, &param TSRMLS_CC);
  87                                                 progress->in_cb = 0;
  88
  89                                                 zval_ptr_dtor(&param);
  90                                         } else {
  91                                                 progress->in_cb = 1;
  92                                                 call_user_function(EG(function_table), NULL, progress->callback->func.user, &retval, 0, NULL TSRMLS_CC);
  93                                                 progress->in_cb = 0;
  94                                         }
  95                                         break;
  96                                 case PHP_HTTP_CLIENT_PROGRESS_CALLBACK_INTERN:
  97                                         progress->callback->func.intern(progress->callback->pass_state ? &progress->state : NULL TSRMLS_CC);
  98                                         break;
  99                                 default:
 100                                         break;
 101                         }
 102                 } end_error_handling();
 103
 104                 zval_dtor(&retval);
 105         }
 106 }
 107
 108 typedef enum php_http_client_setopt_opt {
 109         PHP_HTTP_CLIENT_OPT_SETTINGS,                                           /* HashTable* */
 110         PHP_HTTP_CLIENT_OPT_PROGRESS_CALLBACK,                          /* php_http_client_progress_callback_t* */
 111         PHP_HTTP_CLIENT_OPT_COOKIES_ENABLE,                             /* - */
 112         PHP_HTTP_CLIENT_OPT_COOKIES_RESET,                                      /* - */
 113         PHP_HTTP_CLIENT_OPT_COOKIES_RESET_SESSION,                      /* - */
 114         PHP_HTTP_CLIENT_OPT_COOKIES_FLUSH,                                      /* - */
 115 } php_http_client_setopt_opt_t;
 116
 117 typedef enum php_http_client_getopt_opt {
 118         PHP_HTTP_CLIENT_OPT_PROGRESS_INFO,              /* php_http_client_progress_t** */
 119         PHP_HTTP_CLIENT_OPT_TRANSFER_INFO,              /* HashTable* */
 120 } php_http_client_getopt_opt_t;
 121
 122 typedef struct php_http_client *(*php_http_client_init_func_t)(struct php_http_client *h, void *arg);
 123 typedef struct php_http_client *(*php_http_client_copy_func_t)(struct php_http_client *from, struct php_http_client *to);
 124 typedef void (*php_http_client_dtor_func_t)(struct php_http_client *h);
 125 typedef STATUS (*php_http_client_exec_func_t)(struct php_http_client *h, php_http_message_t *msg);
 126 typedef STATUS (*php_http_client_reset_func_t)(struct php_http_client *h);
 127 typedef STATUS (*php_http_client_setopt_func_t)(struct php_http_client *h, php_http_client_setopt_opt_t opt, void *arg);
 128 typedef STATUS (*php_http_client_getopt_func_t)(struct php_http_client *h, php_http_client_getopt_opt_t opt, void *arg);
 129
 130 typedef struct php_http_client_ops {
 131         php_http_resource_factory_ops_t *rsrc;
 132         php_http_client_init_func_t init;
 133         php_http_client_copy_func_t copy;
 134         php_http_client_dtor_func_t dtor;
 135         php_http_client_reset_func_t reset;
 136         php_http_client_exec_func_t exec;
 137         php_http_client_setopt_func_t setopt;
 138         php_http_client_getopt_func_t getopt;
 139 } php_http_client_ops_t;
 140
 141 typedef struct php_http_client {
 142         void *ctx;
 143         php_http_resource_factory_t *rf;
 144         php_http_client_ops_t *ops;
 145         php_http_message_parser_t *parser;
 146         php_http_message_t *message;
 147         php_http_buffer_t *buffer;
 148 #ifdef ZTS
 149         void ***ts;
 150 #endif
 151 } php_http_client_t;
 152
 153 PHP_HTTP_API php_http_client_t *php_http_client_init(php_http_client_t *h, php_http_client_ops_t *ops, php_http_resource_factory_t *rf, void *init_arg TSRMLS_DC);
 154 PHP_HTTP_API php_http_client_t *php_http_client_copy(php_http_client_t *from, php_http_client_t *to);
 155 PHP_HTTP_API STATUS php_http_client_exec(php_http_client_t *h, php_http_message_t *msg);
 156 PHP_HTTP_API STATUS php_http_client_reset(php_http_client_t *h);
 157 PHP_HTTP_API STATUS php_http_client_setopt(php_http_client_t *h, php_http_client_setopt_opt_t opt, void *arg);
 158 PHP_HTTP_API STATUS php_http_client_getopt(php_http_client_t *h, php_http_client_getopt_opt_t opt, void *arg);
 159 PHP_HTTP_API void php_http_client_dtor(php_http_client_t *h);
 160 PHP_HTTP_API void php_http_client_free(php_http_client_t **h);
 161
 162 typedef struct php_http_client_object {
 163         zend_object zo;
 164         php_http_client_t *client;
 165 } php_http_client_object_t;
 166
 167 extern zend_class_entry *php_http_client_class_entry;
 168 extern zend_function_entry php_http_client_method_entry[];
 169
 170 extern zend_object_value php_http_client_object_new(zend_class_entry *ce TSRMLS_DC);
 171 extern zend_object_value php_http_client_object_new_ex(zend_class_entry *ce, php_http_client_t *r, php_http_client_object_t **ptr TSRMLS_DC);
 172 extern zend_object_value php_http_client_object_clone(zval *zobject TSRMLS_DC);
 173 extern void php_http_client_object_free(void *object TSRMLS_DC);
 174
 175 extern zend_object_handlers *php_http_client_get_object_handlers(void);
 176
 177 extern STATUS php_http_client_object_requesthandler(php_http_client_object_t *obj, zval *this_ptr, char **meth, char **url, php_http_message_body_t **body TSRMLS_DC);
 178 extern STATUS php_http_client_object_responsehandler(php_http_client_object_t *obj, zval *this_ptr TSRMLS_DC);
 179
 180 PHP_METHOD(HttpClient, __construct);
 181 PHP_METHOD(HttpClient, getObservers);
 182 PHP_METHOD(HttpClient, notify);
 183 PHP_METHOD(HttpClient, attach);
 184 PHP_METHOD(HttpClient, detach);
 185 PHP_METHOD(HttpClient, getProgress);
 186 PHP_METHOD(HttpClient, getTransferInfo);
 187 PHP_METHOD(HttpClient, setOptions);
 188 PHP_METHOD(HttpClient, getOptions);
 189 PHP_METHOD(HttpClient, addSslOptions);
 190 PHP_METHOD(HttpClient, setSslOptions);
 191 PHP_METHOD(HttpClient, getSslOptions);
 192 PHP_METHOD(HttpClient, addCookies);
 193 PHP_METHOD(HttpClient, getCookies);
 194 PHP_METHOD(HttpClient, setCookies);
 195 PHP_METHOD(HttpClient, enableCookies);
 196 PHP_METHOD(HttpClient, resetCookies);
 197 PHP_METHOD(HttpClient, flushCookies);
 198 PHP_METHOD(HttpClient, send);
 199 PHP_METHOD(HttpClient, getResponseMessage);
 200 PHP_METHOD(HttpClient, getRawResponseMessage);
 201 PHP_METHOD(HttpClient, getRequestMessage);
 202 PHP_METHOD(HttpClient, getRawRequestMessage);
 203 PHP_METHOD(HttpClient, getHistory);
 204 PHP_METHOD(HttpClient, clearHistory);
 205 PHP_METHOD(HttpClient, getMessageClass);
 206 PHP_METHOD(HttpClient, setMessageClass);
 207
 208 extern PHP_MINIT_FUNCTION(http_client);
 209
 210 #endif
 211
 212 /*
 213  * Local variables:
 214  * tab-width: 4
 215  * c-basic-offset: 4
 216  * End:
 217  * vim600: noet sw=4 ts=4 fdm=marker
 218  * vim<600: noet sw=4 ts=4
 219  */
 220