2 +--------------------------------------------------------------------+
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 +--------------------------------------------------------------------+
13 #ifndef PHP_HTTP_REQUEST_H
14 #define PHP_HTTP_REQUEST_H
16 #include "php_http_request_method.h"
17 #include "php_http_message_body.h"
18 #include "php_http_message_parser.h"
20 typedef struct php_http_request_progress_state
{
32 } php_http_request_progress_state_t
;
34 #define PHP_HTTP_REQUEST_PROGRESS_CALLBACK_USER 0
35 #define PHP_HTTP_REQUEST_PROGRESS_CALLBACK_INTERN 1
36 typedef struct php_http_request_progress_callback
{
39 void (*intern
)(php_http_request_progress_state_t
* TSRMLS_DC
);
42 unsigned pass_state
:1;
43 } php_http_request_progress_callback_t
;
45 typedef struct php_http_request_progress
{
46 php_http_request_progress_state_t state
;
47 php_http_request_progress_callback_t
*callback
;
49 } php_http_request_progress_t
;
51 static inline void php_http_request_progress_dtor(php_http_request_progress_t
*progress TSRMLS_DC
)
53 if (progress
->callback
) {
54 if (progress
->callback
->type
== PHP_HTTP_REQUEST_PROGRESS_CALLBACK_USER
) {
55 zval_ptr_dtor(&progress
->callback
->func
.user
);
57 efree(progress
->callback
);
59 memset(progress
, 0, sizeof(*progress
));
62 static inline void php_http_request_progress_notify(php_http_request_progress_t
*progress TSRMLS_DC
)
64 if (progress
->callback
) {
70 with_error_handling(EH_NORMAL
, NULL
) {
71 switch (progress
->callback
->type
) {
72 case PHP_HTTP_REQUEST_PROGRESS_CALLBACK_USER
:
73 if (progress
->callback
->pass_state
) {
78 add_assoc_bool(param
, "started", progress
->state
.started
);
79 add_assoc_bool(param
, "finished", progress
->state
.finished
);
80 add_assoc_string(param
, "info", estrdup(progress
->state
.info
), 0);
81 add_assoc_double(param
, "dltotal", progress
->state
.dl
.total
);
82 add_assoc_double(param
, "dlnow", progress
->state
.dl
.now
);
83 add_assoc_double(param
, "ultotal", progress
->state
.ul
.total
);
84 add_assoc_double(param
, "ulnow", progress
->state
.ul
.now
);
87 call_user_function(EG(function_table
), NULL
, progress
->callback
->func
.user
, &retval
, 1, ¶m TSRMLS_CC
);
90 zval_ptr_dtor(¶m
);
93 call_user_function(EG(function_table
), NULL
, progress
->callback
->func
.user
, &retval
, 0, NULL TSRMLS_CC
);
97 case PHP_HTTP_REQUEST_PROGRESS_CALLBACK_INTERN
:
98 progress
->callback
->func
.intern(progress
->callback
->pass_state
? &progress
->state
: NULL TSRMLS_CC
);
103 } end_error_handling();
109 typedef enum php_http_request_setopt_opt
{
110 PHP_HTTP_REQUEST_OPT_SETTINGS
, /* HashTable* */
111 PHP_HTTP_REQUEST_OPT_PROGRESS_CALLBACK
, /* php_http_request_progress_callback_t* */
112 PHP_HTTP_REQUEST_OPT_COOKIES_ENABLE
, /* - */
113 PHP_HTTP_REQUEST_OPT_COOKIES_RESET
, /* - */
114 PHP_HTTP_REQUEST_OPT_COOKIES_RESET_SESSION
, /* - */
115 PHP_HTTP_REQUEST_OPT_COOKIES_FLUSH
, /* - */
116 } php_http_request_setopt_opt_t
;
118 typedef enum php_http_request_getopt_opt
{
119 PHP_HTTP_REQUEST_OPT_PROGRESS_INFO
, /* php_http_request_progress_t** */
120 PHP_HTTP_REQUEST_OPT_TRANSFER_INFO
, /* HashTable* */
121 } php_http_request_getopt_opt_t
;
123 typedef struct php_http_request php_http_request_t
;
125 typedef php_http_request_t
*(*php_http_request_init_func_t
)(php_http_request_t
*h
, void *arg
);
126 typedef php_http_request_t
*(*php_http_request_copy_func_t
)(php_http_request_t
*from
, php_http_request_t
*to
);
127 typedef void (*php_http_request_dtor_func_t
)(php_http_request_t
*h
);
128 typedef STATUS (*php_http_request_exec_func_t
)(php_http_request_t
*h
, php_http_request_method_t meth
, const char *url
, php_http_message_body_t
*body
);
129 typedef STATUS (*php_http_request_reset_func_t
)(php_http_request_t
*h
);
130 typedef STATUS (*php_http_request_setopt_func_t
)(php_http_request_t
*h
, php_http_request_setopt_opt_t opt
, void *arg
);
131 typedef STATUS (*php_http_request_getopt_func_t
)(php_http_request_t
*h
, php_http_request_getopt_opt_t opt
, void *arg
);
133 typedef struct php_http_request_ops
{
134 php_http_resource_factory_ops_t
*rsrc
;
135 php_http_request_init_func_t init
;
136 php_http_request_copy_func_t copy
;
137 php_http_request_dtor_func_t dtor
;
138 php_http_request_reset_func_t reset
;
139 php_http_request_exec_func_t exec
;
140 php_http_request_setopt_func_t setopt
;
141 php_http_request_getopt_func_t getopt
;
142 } php_http_request_ops_t
;
144 PHP_HTTP_API php_http_request_ops_t
*php_http_request_get_default_ops(TSRMLS_D
);
146 struct php_http_request
{
148 php_http_resource_factory_t
*rf
;
149 php_http_request_ops_t
*ops
;
150 php_http_message_parser_t
*parser
;
151 php_http_message_t
*message
;
152 php_http_buffer_t
*buffer
;
153 zval
*persistent_handle_id
;
159 PHP_HTTP_API php_http_request_t
*php_http_request_init(php_http_request_t
*h
, php_http_request_ops_t
*ops
, php_http_resource_factory_t
*rf
, void *init_arg TSRMLS_DC
);
160 PHP_HTTP_API php_http_request_t
*php_http_request_copy(php_http_request_t
*from
, php_http_request_t
*to
);
161 PHP_HTTP_API STATUS
php_http_request_exec(php_http_request_t
*h
, php_http_request_method_t meth
, const char *url
, php_http_message_body_t
*body
);
162 PHP_HTTP_API STATUS
php_http_request_reset(php_http_request_t
*h
);
163 PHP_HTTP_API STATUS
php_http_request_setopt(php_http_request_t
*h
, php_http_request_setopt_opt_t opt
, void *arg
);
164 PHP_HTTP_API STATUS
php_http_request_getopt(php_http_request_t
*h
, php_http_request_getopt_opt_t opt
, void *arg
);
165 PHP_HTTP_API
void php_http_request_dtor(php_http_request_t
*h
);
166 PHP_HTTP_API
void php_http_request_free(php_http_request_t
**h
);
168 typedef struct php_http_request_object
{
170 php_http_request_t
*request
;
171 } php_http_request_object_t
;
173 extern zend_class_entry
*php_http_request_class_entry
;
174 extern zend_function_entry php_http_request_method_entry
[];
176 extern zend_object_value
php_http_request_object_new(zend_class_entry
*ce TSRMLS_DC
);
177 extern zend_object_value
php_http_request_object_new_ex(zend_class_entry
*ce
, php_http_request_t
*r
, php_http_request_object_t
**ptr TSRMLS_DC
);
178 extern zend_object_value
php_http_request_object_clone(zval
*zobject TSRMLS_DC
);
179 extern void php_http_request_object_free(void *object TSRMLS_DC
);
181 extern STATUS
php_http_request_object_requesthandler(php_http_request_object_t
*obj
, zval
*this_ptr
, php_http_request_method_t
*meth
, char **url
, php_http_message_body_t
**body TSRMLS_DC
);
182 extern STATUS
php_http_request_object_responsehandler(php_http_request_object_t
*obj
, zval
*this_ptr TSRMLS_DC
);
184 PHP_METHOD(HttpRequest
, __construct
);
185 PHP_METHOD(HttpRequest
, getObservers
);
186 PHP_METHOD(HttpRequest
, notify
);
187 PHP_METHOD(HttpRequest
, attach
);
188 PHP_METHOD(HttpRequest
, detach
);
189 PHP_METHOD(HttpRequest
, getProgress
);
190 PHP_METHOD(HttpRequest
, getTransferInfo
);
191 PHP_METHOD(HttpRequest
, setOptions
);
192 PHP_METHOD(HttpRequest
, getOptions
);
193 PHP_METHOD(HttpRequest
, addSslOptions
);
194 PHP_METHOD(HttpRequest
, setSslOptions
);
195 PHP_METHOD(HttpRequest
, getSslOptions
);
196 PHP_METHOD(HttpRequest
, addHeaders
);
197 PHP_METHOD(HttpRequest
, getHeaders
);
198 PHP_METHOD(HttpRequest
, setHeaders
);
199 PHP_METHOD(HttpRequest
, addCookies
);
200 PHP_METHOD(HttpRequest
, getCookies
);
201 PHP_METHOD(HttpRequest
, setCookies
);
202 PHP_METHOD(HttpRequest
, enableCookies
);
203 PHP_METHOD(HttpRequest
, resetCookies
);
204 PHP_METHOD(HttpRequest
, flushCookies
);
205 PHP_METHOD(HttpRequest
, setMethod
);
206 PHP_METHOD(HttpRequest
, getMethod
);
207 PHP_METHOD(HttpRequest
, setUrl
);
208 PHP_METHOD(HttpRequest
, getUrl
);
209 PHP_METHOD(HttpRequest
, setContentType
);
210 PHP_METHOD(HttpRequest
, getContentType
);
211 PHP_METHOD(HttpRequest
, setQueryData
);
212 PHP_METHOD(HttpRequest
, getQueryData
);
213 PHP_METHOD(HttpRequest
, addQueryData
);
214 PHP_METHOD(HttpRequest
, getBody
);
215 PHP_METHOD(HttpRequest
, setBody
);
216 PHP_METHOD(HttpRequest
, addBody
);
217 PHP_METHOD(HttpRequest
, send
);
218 PHP_METHOD(HttpRequest
, getResponseData
);
219 PHP_METHOD(HttpRequest
, getResponseHeader
);
220 PHP_METHOD(HttpRequest
, getResponseCookies
);
221 PHP_METHOD(HttpRequest
, getResponseCode
);
222 PHP_METHOD(HttpRequest
, getResponseStatus
);
223 PHP_METHOD(HttpRequest
, getResponseBody
);
224 PHP_METHOD(HttpRequest
, getResponseMessage
);
225 PHP_METHOD(HttpRequest
, getRawResponseMessage
);
226 PHP_METHOD(HttpRequest
, getRequestMessage
);
227 PHP_METHOD(HttpRequest
, getRawRequestMessage
);
228 PHP_METHOD(HttpRequest
, getHistory
);
229 PHP_METHOD(HttpRequest
, clearHistory
);
230 PHP_METHOD(HttpRequest
, getMessageClass
);
231 PHP_METHOD(HttpRequest
, setMessageClass
);
233 extern PHP_MINIT_FUNCTION(http_request
);
242 * vim600: noet sw=4 ts=4 fdm=marker
243 * vim<600: noet sw=4 ts=4