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-2014, Michael Wallner <mike@php.net>            |
  10     +--------------------------------------------------------------------+
  11 */
  12
  13 #ifndef PHP_HTTP_CLIENT_H
  14 #define PHP_HTTP_CLIENT_H
  15
  16 typedef enum php_http_client_setopt_opt {
  17         PHP_HTTP_CLIENT_OPT_ENABLE_PIPELINING,
  18         PHP_HTTP_CLIENT_OPT_USE_EVENTS,
  19 } php_http_client_setopt_opt_t;
  20
  21 typedef enum php_http_client_getopt_opt {
  22         PHP_HTTP_CLIENT_OPT_PROGRESS_INFO,              /* php_http_client_progress_state_t** */
  23         PHP_HTTP_CLIENT_OPT_TRANSFER_INFO,              /* HashTable* */
  24 } php_http_client_getopt_opt_t;
  25
  26 typedef struct php_http_client_enqueue {
  27         php_http_message_t *request; /* unique */
  28         HashTable *options;
  29         void (*dtor)(struct php_http_client_enqueue *);
  30         void *opaque;
  31         struct {
  32                 zend_fcall_info fci;
  33                 zend_fcall_info_cache fcc;
  34         } closure;
  35 } php_http_client_enqueue_t;
  36
  37 typedef struct php_http_client *(*php_http_client_init_func_t)(struct php_http_client *p, void *init_arg);
  38 typedef struct php_http_client *(*php_http_client_copy_func_t)(struct php_http_client *from, struct php_http_client *to);
  39 typedef void (*php_http_client_dtor_func_t)(struct php_http_client *p);
  40 typedef void (*php_http_client_reset_func_t)(struct php_http_client *p);
  41 typedef STATUS (*php_http_client_exec_func_t)(struct php_http_client *p);
  42 typedef int (*php_http_client_once_func_t)(struct php_http_client *p);
  43 typedef STATUS (*php_http_client_wait_func_t)(struct php_http_client *p, struct timeval *custom_timeout);
  44 typedef STATUS (*php_http_client_enqueue_func_t)(struct php_http_client *p, php_http_client_enqueue_t *enqueue);
  45 typedef STATUS (*php_http_client_dequeue_func_t)(struct php_http_client *p, php_http_client_enqueue_t *enqueue);
  46 typedef STATUS (*php_http_client_setopt_func_t)(struct php_http_client *p, php_http_client_setopt_opt_t opt, void *arg);
  47 typedef STATUS (*php_http_client_getopt_func_t)(struct php_http_client *h, php_http_client_getopt_opt_t opt, void *arg, void **res);
  48
  49 typedef struct php_http_client_ops {
  50         php_resource_factory_ops_t *rsrc;
  51         php_http_client_init_func_t init;
  52         php_http_client_copy_func_t copy;
  53         php_http_client_dtor_func_t dtor;
  54         php_http_client_reset_func_t reset;
  55         php_http_client_exec_func_t exec;
  56         php_http_client_wait_func_t wait;
  57         php_http_client_once_func_t once;
  58         php_http_client_enqueue_func_t enqueue;
  59         php_http_client_dequeue_func_t dequeue;
  60         php_http_client_setopt_func_t setopt;
  61         php_http_client_getopt_func_t getopt;
  62 } php_http_client_ops_t;
  63
  64 typedef struct php_http_client_driver {
  65         const char *name_str;
  66         size_t name_len;
  67         php_http_client_ops_t *client_ops;
  68 } php_http_client_driver_t;
  69
  70 PHP_HTTP_API STATUS php_http_client_driver_add(php_http_client_driver_t *driver);
  71 PHP_HTTP_API STATUS php_http_client_driver_get(const char *name_str, size_t name_len, php_http_client_driver_t *driver);
  72
  73 typedef struct php_http_client_progress_state {
  74         struct {
  75                 double now;
  76                 double total;
  77         } ul;
  78         struct {
  79                 double now;
  80                 double total;
  81         } dl;
  82         const char *info;
  83         unsigned started:1;
  84         unsigned finished:1;
  85 } php_http_client_progress_state_t;
  86
  87 typedef STATUS (*php_http_client_response_callback_t)(void *arg, struct php_http_client *client, php_http_client_enqueue_t *e, php_http_message_t **request, php_http_message_t **response);
  88 typedef void (*php_http_client_progress_callback_t)(void *arg, struct php_http_client *client, php_http_client_enqueue_t *e, php_http_client_progress_state_t *state);
  89
  90 typedef struct php_http_client {
  91         void *ctx;
  92         php_resource_factory_t *rf;
  93         php_http_client_ops_t *ops;
  94
  95         struct {
  96                 struct {
  97                         php_http_client_response_callback_t func;
  98                         void *arg;
  99                 } response;
 100                 struct {
 101                         php_http_client_progress_callback_t func;
 102                         void *arg;
 103                 } progress;
 104         } callback;
 105
 106         zend_llist requests;
 107         zend_llist responses;
 108
 109 #ifdef ZTS
 110         void ***ts;
 111 #endif
 112 } php_http_client_t;
 113
 114 PHP_HTTP_API zend_class_entry *php_http_client_class_entry;
 115
 116 typedef struct php_http_client_object {
 117         zend_object zo;
 118         zend_object_value zv;
 119         php_http_client_t *client;
 120         long iterator;
 121 } php_http_client_object_t;
 122
 123 PHP_HTTP_API php_http_client_t *php_http_client_init(php_http_client_t *h, php_http_client_ops_t *ops, php_resource_factory_t *rf, void *init_arg TSRMLS_DC);
 124 PHP_HTTP_API php_http_client_t *php_http_client_copy(php_http_client_t *from, php_http_client_t *to);
 125 PHP_HTTP_API void php_http_client_dtor(php_http_client_t *h);
 126 PHP_HTTP_API void php_http_client_free(php_http_client_t **h);
 127
 128 PHP_HTTP_API STATUS php_http_client_enqueue(php_http_client_t *h, php_http_client_enqueue_t *enqueue);
 129 PHP_HTTP_API STATUS php_http_client_dequeue(php_http_client_t *h, php_http_message_t *request);
 130
 131 PHP_HTTP_API STATUS php_http_client_wait(php_http_client_t *h, struct timeval *custom_timeout);
 132 PHP_HTTP_API int php_http_client_once(php_http_client_t *h);
 133
 134 PHP_HTTP_API STATUS php_http_client_exec(php_http_client_t *h);
 135 PHP_HTTP_API void php_http_client_reset(php_http_client_t *h);
 136
 137 PHP_HTTP_API STATUS php_http_client_setopt(php_http_client_t *h, php_http_client_setopt_opt_t opt, void *arg);
 138 PHP_HTTP_API STATUS php_http_client_getopt(php_http_client_t *h, php_http_client_getopt_opt_t opt, void *arg, void *res_ptr);
 139
 140 typedef int (*php_http_client_enqueue_cmp_func_t)(php_http_client_enqueue_t *cmp, void *arg);
 141 /* compare with request message pointer if compare_func is NULL */
 142 PHP_HTTP_API php_http_client_enqueue_t *php_http_client_enqueued(php_http_client_t *h, void *compare_arg, php_http_client_enqueue_cmp_func_t compare_func);
 143
 144 PHP_MINIT_FUNCTION(http_client);
 145 PHP_MSHUTDOWN_FUNCTION(http_client);
 146
 147 #endif
 148
 149 /*
 150  * Local variables:
 151  * tab-width: 4
 152  * c-basic-offset: 4
 153  * End:
 154  * vim600: noet sw=4 ts=4 fdm=marker
 155  * vim<600: noet sw=4 ts=4
 156  */