- http_build_url() replaces http_absolute_(url|uri)/http_build_uri;
[m6w6/ext-http] / http_request_object.c
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-2005, Michael Wallner <mike@php.net> |
10 +--------------------------------------------------------------------+
11 */
12
13 /* $Id$ */
14
15 #ifdef HAVE_CONFIG_H
16 # include "config.h"
17 #endif
18
19 #define HTTP_WANT_CURL
20 #include "php_http.h"
21
22 #if defined(ZEND_ENGINE_2) && defined(HTTP_HAVE_CURL)
23
24 #include "zend_interfaces.h"
25
26 #include "php_http_api.h"
27 #include "php_http_exception_object.h"
28 #include "php_http_message_api.h"
29 #include "php_http_message_object.h"
30 #include "php_http_request_api.h"
31 #include "php_http_request_object.h"
32 #include "php_http_request_pool_api.h"
33 #include "php_http_url_api.h"
34
35 ZEND_EXTERN_MODULE_GLOBALS(http);
36
37 #define HTTP_BEGIN_ARGS(method, ret_ref, req_args) HTTP_BEGIN_ARGS_EX(HttpRequest, method, ret_ref, req_args)
38 #define HTTP_EMPTY_ARGS(method, ret_ref) HTTP_EMPTY_ARGS_EX(HttpRequest, method, ret_ref)
39 #define HTTP_REQUEST_ME(method, visibility) PHP_ME(HttpRequest, method, HTTP_ARGS(HttpRequest, method), visibility)
40 #define HTTP_REQUEST_ALIAS(method, func) HTTP_STATIC_ME_ALIAS(method, func, HTTP_ARGS(HttpRequest, method))
41
42 HTTP_EMPTY_ARGS(__destruct, 0);
43 HTTP_BEGIN_ARGS(__construct, 0, 0)
44 HTTP_ARG_VAL(url, 0)
45 HTTP_ARG_VAL(method, 0)
46 HTTP_ARG_VAL(options, 0)
47 HTTP_END_ARGS;
48
49 HTTP_EMPTY_ARGS(getOptions, 0);
50 HTTP_BEGIN_ARGS(setOptions, 0, 0)
51 HTTP_ARG_VAL(options, 0)
52 HTTP_END_ARGS;
53
54 HTTP_EMPTY_ARGS(getSslOptions, 0);
55 HTTP_BEGIN_ARGS(setSslOptions, 0, 0)
56 HTTP_ARG_VAL(ssl_options, 0)
57 HTTP_END_ARGS;
58
59 HTTP_EMPTY_ARGS(getHeaders, 0);
60 HTTP_BEGIN_ARGS(setHeaders, 0, 0)
61 HTTP_ARG_VAL(headers, 0)
62 HTTP_END_ARGS;
63
64 HTTP_BEGIN_ARGS(addHeaders, 0, 1)
65 HTTP_ARG_VAL(headers, 0)
66 HTTP_END_ARGS;
67
68 HTTP_EMPTY_ARGS(getCookies, 0);
69 HTTP_BEGIN_ARGS(setCookies, 0, 0)
70 HTTP_ARG_VAL(cookies, 0)
71 HTTP_END_ARGS;
72
73 HTTP_BEGIN_ARGS(addCookies, 0, 1)
74 HTTP_ARG_VAL(cookies, 0)
75 HTTP_END_ARGS;
76
77 HTTP_EMPTY_ARGS(getUrl, 0);
78 HTTP_BEGIN_ARGS(setUrl, 0, 1)
79 HTTP_ARG_VAL(url, 0)
80 HTTP_END_ARGS;
81
82 HTTP_EMPTY_ARGS(getMethod, 0);
83 HTTP_BEGIN_ARGS(setMethod, 0, 1)
84 HTTP_ARG_VAL(request_method, 0)
85 HTTP_END_ARGS;
86
87 HTTP_EMPTY_ARGS(getContentType, 0);
88 HTTP_BEGIN_ARGS(setContentType, 0, 1)
89 HTTP_ARG_VAL(content_type, 0)
90 HTTP_END_ARGS;
91
92 HTTP_EMPTY_ARGS(getQueryData, 0);
93 HTTP_BEGIN_ARGS(setQueryData, 0, 0)
94 HTTP_ARG_VAL(query_data, 0)
95 HTTP_END_ARGS;
96
97 HTTP_BEGIN_ARGS(addQueryData, 0, 1)
98 HTTP_ARG_VAL(query_data, 0)
99 HTTP_END_ARGS;
100
101 HTTP_EMPTY_ARGS(getPostFields, 0);
102 HTTP_BEGIN_ARGS(setPostFields, 0, 0)
103 HTTP_ARG_VAL(post_fields, 0)
104 HTTP_END_ARGS;
105
106 HTTP_BEGIN_ARGS(addPostFields, 0, 1)
107 HTTP_ARG_VAL(post_fields, 0)
108 HTTP_END_ARGS;
109
110 HTTP_EMPTY_ARGS(getPostFiles, 0);
111 HTTP_BEGIN_ARGS(setPostFiles, 0, 0)
112 HTTP_ARG_VAL(post_files, 0)
113 HTTP_END_ARGS;
114
115 HTTP_BEGIN_ARGS(addPostFile, 0, 2)
116 HTTP_ARG_VAL(formname, 0)
117 HTTP_ARG_VAL(filename, 0)
118 HTTP_ARG_VAL(content_type, 0)
119 HTTP_END_ARGS;
120
121 HTTP_EMPTY_ARGS(getRawPostData, 0);
122 HTTP_BEGIN_ARGS(setRawPostData, 0, 0)
123 HTTP_ARG_VAL(raw_post_data, 0)
124 HTTP_END_ARGS;
125
126 HTTP_BEGIN_ARGS(addRawPostData, 0, 1)
127 HTTP_ARG_VAL(raw_post_data, 0)
128 HTTP_END_ARGS;
129
130 HTTP_EMPTY_ARGS(getPutFile, 0);
131 HTTP_BEGIN_ARGS(setPutFile, 0, 0)
132 HTTP_ARG_VAL(filename, 0)
133 HTTP_END_ARGS;
134
135 HTTP_EMPTY_ARGS(getResponseData, 0);
136 HTTP_BEGIN_ARGS(getResponseHeader, 0, 0)
137 HTTP_ARG_VAL(name, 0)
138 HTTP_END_ARGS;
139
140 HTTP_BEGIN_ARGS(getResponseCookie, 0, 0)
141 HTTP_ARG_VAL(name, 0)
142 HTTP_END_ARGS;
143
144 HTTP_EMPTY_ARGS(getResponseBody, 0);
145 HTTP_EMPTY_ARGS(getResponseCode, 0);
146 HTTP_BEGIN_ARGS(getResponseInfo, 0, 0)
147 HTTP_ARG_VAL(name, 0)
148 HTTP_END_ARGS;
149
150 HTTP_EMPTY_ARGS(getResponseMessage, 1);
151 HTTP_EMPTY_ARGS(getRequestMessage, 1);
152 HTTP_EMPTY_ARGS(getHistory, 1);
153 HTTP_EMPTY_ARGS(clearHistory, 0);
154 HTTP_EMPTY_ARGS(send, 1);
155
156 HTTP_BEGIN_ARGS(get, 0, 1)
157 HTTP_ARG_VAL(url, 0)
158 HTTP_ARG_VAL(options, 0)
159 HTTP_ARG_VAL(info, 1)
160 HTTP_END_ARGS;
161
162 HTTP_BEGIN_ARGS(head, 0, 1)
163 HTTP_ARG_VAL(url, 0)
164 HTTP_ARG_VAL(options, 0)
165 HTTP_ARG_VAL(info, 1)
166 HTTP_END_ARGS;
167
168 HTTP_BEGIN_ARGS(postData, 0, 2)
169 HTTP_ARG_VAL(url, 0)
170 HTTP_ARG_VAL(data, 0)
171 HTTP_ARG_VAL(options, 0)
172 HTTP_ARG_VAL(info, 1)
173 HTTP_END_ARGS;
174
175 HTTP_BEGIN_ARGS(postFields, 0, 2)
176 HTTP_ARG_VAL(url, 0)
177 HTTP_ARG_VAL(data, 0)
178 HTTP_ARG_VAL(options, 0)
179 HTTP_ARG_VAL(info, 1)
180 HTTP_END_ARGS;
181
182 HTTP_BEGIN_ARGS(putFile, 0, 2)
183 HTTP_ARG_VAL(url, 0)
184 HTTP_ARG_VAL(file, 0)
185 HTTP_ARG_VAL(options, 0)
186 HTTP_ARG_VAL(info, 1)
187 HTTP_END_ARGS;
188
189 HTTP_BEGIN_ARGS(putStream, 0, 2)
190 HTTP_ARG_VAL(url, 0)
191 HTTP_ARG_VAL(stream, 0)
192 HTTP_ARG_VAL(options, 0)
193 HTTP_ARG_VAL(info, 1)
194 HTTP_END_ARGS;
195
196 HTTP_BEGIN_ARGS(methodRegister, 0, 1)
197 HTTP_ARG_VAL(method_name, 0)
198 HTTP_END_ARGS;
199
200 HTTP_BEGIN_ARGS(methodUnregister, 0, 1)
201 HTTP_ARG_VAL(method, 0)
202 HTTP_END_ARGS;
203
204 HTTP_BEGIN_ARGS(methodName, 0, 1)
205 HTTP_ARG_VAL(method_id, 0)
206 HTTP_END_ARGS;
207
208 HTTP_BEGIN_ARGS(methodExists, 0, 1)
209 HTTP_ARG_VAL(method, 0)
210 HTTP_END_ARGS;
211
212 #define http_request_object_declare_default_properties() _http_request_object_declare_default_properties(TSRMLS_C)
213 static inline void _http_request_object_declare_default_properties(TSRMLS_D);
214
215 zend_class_entry *http_request_object_ce;
216 zend_function_entry http_request_object_fe[] = {
217 HTTP_REQUEST_ME(__construct, ZEND_ACC_PUBLIC|ZEND_ACC_CTOR)
218 HTTP_REQUEST_ME(__destruct, ZEND_ACC_PUBLIC|ZEND_ACC_DTOR)
219
220 HTTP_REQUEST_ME(setOptions, ZEND_ACC_PUBLIC)
221 HTTP_REQUEST_ME(getOptions, ZEND_ACC_PUBLIC)
222 HTTP_REQUEST_ME(setSslOptions, ZEND_ACC_PUBLIC)
223 HTTP_REQUEST_ME(getSslOptions, ZEND_ACC_PUBLIC)
224
225 HTTP_REQUEST_ME(addHeaders, ZEND_ACC_PUBLIC)
226 HTTP_REQUEST_ME(getHeaders, ZEND_ACC_PUBLIC)
227 HTTP_REQUEST_ME(setHeaders, ZEND_ACC_PUBLIC)
228
229 HTTP_REQUEST_ME(addCookies, ZEND_ACC_PUBLIC)
230 HTTP_REQUEST_ME(getCookies, ZEND_ACC_PUBLIC)
231 HTTP_REQUEST_ME(setCookies, ZEND_ACC_PUBLIC)
232
233 HTTP_REQUEST_ME(setMethod, ZEND_ACC_PUBLIC)
234 HTTP_REQUEST_ME(getMethod, ZEND_ACC_PUBLIC)
235
236 HTTP_REQUEST_ME(setUrl, ZEND_ACC_PUBLIC)
237 HTTP_REQUEST_ME(getUrl, ZEND_ACC_PUBLIC)
238
239 HTTP_REQUEST_ME(setContentType, ZEND_ACC_PUBLIC)
240 HTTP_REQUEST_ME(getContentType, ZEND_ACC_PUBLIC)
241
242 HTTP_REQUEST_ME(setQueryData, ZEND_ACC_PUBLIC)
243 HTTP_REQUEST_ME(getQueryData, ZEND_ACC_PUBLIC)
244 HTTP_REQUEST_ME(addQueryData, ZEND_ACC_PUBLIC)
245
246 HTTP_REQUEST_ME(setPostFields, ZEND_ACC_PUBLIC)
247 HTTP_REQUEST_ME(getPostFields, ZEND_ACC_PUBLIC)
248 HTTP_REQUEST_ME(addPostFields, ZEND_ACC_PUBLIC)
249
250 HTTP_REQUEST_ME(setRawPostData, ZEND_ACC_PUBLIC)
251 HTTP_REQUEST_ME(getRawPostData, ZEND_ACC_PUBLIC)
252 HTTP_REQUEST_ME(addRawPostData, ZEND_ACC_PUBLIC)
253
254 HTTP_REQUEST_ME(setPostFiles, ZEND_ACC_PUBLIC)
255 HTTP_REQUEST_ME(addPostFile, ZEND_ACC_PUBLIC)
256 HTTP_REQUEST_ME(getPostFiles, ZEND_ACC_PUBLIC)
257
258 HTTP_REQUEST_ME(setPutFile, ZEND_ACC_PUBLIC)
259 HTTP_REQUEST_ME(getPutFile, ZEND_ACC_PUBLIC)
260
261 HTTP_REQUEST_ME(send, ZEND_ACC_PUBLIC)
262
263 HTTP_REQUEST_ME(getResponseData, ZEND_ACC_PUBLIC)
264 HTTP_REQUEST_ME(getResponseHeader, ZEND_ACC_PUBLIC)
265 HTTP_REQUEST_ME(getResponseCookie, ZEND_ACC_PUBLIC)
266 HTTP_REQUEST_ME(getResponseCode, ZEND_ACC_PUBLIC)
267 HTTP_REQUEST_ME(getResponseBody, ZEND_ACC_PUBLIC)
268 HTTP_REQUEST_ME(getResponseInfo, ZEND_ACC_PUBLIC)
269 HTTP_REQUEST_ME(getResponseMessage, ZEND_ACC_PUBLIC)
270 HTTP_REQUEST_ME(getRequestMessage, ZEND_ACC_PUBLIC)
271 HTTP_REQUEST_ME(getHistory, ZEND_ACC_PUBLIC)
272 HTTP_REQUEST_ME(clearHistory, ZEND_ACC_PUBLIC)
273
274 HTTP_REQUEST_ALIAS(get, http_get)
275 HTTP_REQUEST_ALIAS(head, http_head)
276 HTTP_REQUEST_ALIAS(postData, http_post_data)
277 HTTP_REQUEST_ALIAS(postFields, http_post_fields)
278 HTTP_REQUEST_ALIAS(putFile, http_put_file)
279 HTTP_REQUEST_ALIAS(putStream, http_put_stream)
280
281 HTTP_REQUEST_ALIAS(methodRegister, http_request_method_register)
282 HTTP_REQUEST_ALIAS(methodUnregister, http_request_method_unregister)
283 HTTP_REQUEST_ALIAS(methodName, http_request_method_name)
284 HTTP_REQUEST_ALIAS(methodExists, http_request_method_exists)
285
286 EMPTY_FUNCTION_ENTRY
287 };
288 static zend_object_handlers http_request_object_handlers;
289
290 PHP_MINIT_FUNCTION(http_request_object)
291 {
292 HTTP_REGISTER_CLASS_EX(HttpRequest, http_request_object, NULL, 0);
293 http_request_object_handlers.clone_obj = _http_request_object_clone_obj;
294 return SUCCESS;
295 }
296
297 zend_object_value _http_request_object_new(zend_class_entry *ce TSRMLS_DC)
298 {
299 return http_request_object_new_ex(ce, curl_easy_init(), NULL);
300 }
301
302 zend_object_value _http_request_object_new_ex(zend_class_entry *ce, CURL *ch, http_request_object **ptr TSRMLS_DC)
303 {
304 zend_object_value ov;
305 http_request_object *o;
306
307 o = ecalloc(1, sizeof(http_request_object));
308 o->zo.ce = ce;
309 o->request = http_request_init_ex(NULL, ch, 0, NULL);
310 phpstr_init(&o->history);
311
312 if (ptr) {
313 *ptr = o;
314 }
315
316 ALLOC_HASHTABLE(OBJ_PROP(o));
317 zend_hash_init(OBJ_PROP(o), 0, NULL, ZVAL_PTR_DTOR, 0);
318 zend_hash_copy(OBJ_PROP(o), &ce->default_properties, (copy_ctor_func_t) zval_add_ref, NULL, sizeof(zval *));
319
320 ov.handle = putObject(http_request_object, o);
321 ov.handlers = &http_request_object_handlers;
322
323 return ov;
324 }
325
326 zend_object_value _http_request_object_clone_obj(zval *this_ptr TSRMLS_DC)
327 {
328 zend_object *old_zo;
329 zend_object_value new_ov;
330 http_request_object *new_obj;
331 getObject(http_request_object, old_obj);
332
333 old_zo = zend_objects_get_address(this_ptr TSRMLS_CC);
334 new_ov = http_request_object_new_ex(old_zo->ce, curl_easy_duphandle(old_obj->request->ch), &new_obj);
335
336 zend_objects_clone_members(&new_obj->zo, new_ov, old_zo, Z_OBJ_HANDLE_P(this_ptr) TSRMLS_CC);
337 phpstr_append(&new_obj->history, old_obj->history.data, old_obj->history.used);
338 phpstr_append(&new_obj->request->conv.request, old_obj->request->conv.request.data, old_obj->request->conv.request.used);
339 phpstr_append(&new_obj->request->conv.response, old_obj->request->conv.response.data, old_obj->request->conv.response.used);
340
341 return new_ov;
342 }
343
344 static inline void _http_request_object_declare_default_properties(TSRMLS_D)
345 {
346 zend_class_entry *ce = http_request_object_ce;
347
348 DCL_PROP_N(PROTECTED, options);
349 DCL_PROP_N(PROTECTED, responseInfo);
350 DCL_PROP_N(PROTECTED, responseData);
351 DCL_PROP(PROTECTED, long, responseCode, 0);
352 DCL_PROP_N(PROTECTED, responseMessage);
353 DCL_PROP_N(PROTECTED, postFields);
354 DCL_PROP_N(PROTECTED, postFiles);
355
356 DCL_PROP(PROTECTED, long, method, HTTP_GET);
357
358 DCL_PROP(PROTECTED, string, url, "");
359 DCL_PROP(PROTECTED, string, contentType, "");
360 DCL_PROP(PROTECTED, string, rawPostData, "");
361 DCL_PROP(PROTECTED, string, queryData, "");
362 DCL_PROP(PROTECTED, string, putFile, "");
363
364 DCL_PROP(PUBLIC, bool, recordHistory, 0);
365
366 #ifndef WONKY
367 /*
368 * Request Method Constants
369 */
370 /* HTTP/1.1 */
371 DCL_CONST(long, "METH_GET", HTTP_GET);
372 DCL_CONST(long, "METH_HEAD", HTTP_HEAD);
373 DCL_CONST(long, "METH_POST", HTTP_POST);
374 DCL_CONST(long, "METH_PUT", HTTP_PUT);
375 DCL_CONST(long, "METH_DELETE", HTTP_DELETE);
376 DCL_CONST(long, "METH_OPTIONS", HTTP_OPTIONS);
377 DCL_CONST(long, "METH_TRACE", HTTP_TRACE);
378 DCL_CONST(long, "METH_CONNECT", HTTP_CONNECT);
379 /* WebDAV - RFC 2518 */
380 DCL_CONST(long, "METH_PROPFIND", HTTP_PROPFIND);
381 DCL_CONST(long, "METH_PROPPATCH", HTTP_PROPPATCH);
382 DCL_CONST(long, "METH_MKCOL", HTTP_MKCOL);
383 DCL_CONST(long, "METH_COPY", HTTP_COPY);
384 DCL_CONST(long, "METH_MOVE", HTTP_MOVE);
385 DCL_CONST(long, "METH_LOCK", HTTP_LOCK);
386 DCL_CONST(long, "METH_UNLOCK", HTTP_UNLOCK);
387 /* WebDAV Versioning - RFC 3253 */
388 DCL_CONST(long, "METH_VERSION_CONTROL", HTTP_VERSION_CONTROL);
389 DCL_CONST(long, "METH_REPORT", HTTP_REPORT);
390 DCL_CONST(long, "METH_CHECKOUT", HTTP_CHECKOUT);
391 DCL_CONST(long, "METH_CHECKIN", HTTP_CHECKIN);
392 DCL_CONST(long, "METH_UNCHECKOUT", HTTP_UNCHECKOUT);
393 DCL_CONST(long, "METH_MKWORKSPACE", HTTP_MKWORKSPACE);
394 DCL_CONST(long, "METH_UPDATE", HTTP_UPDATE);
395 DCL_CONST(long, "METH_LABEL", HTTP_LABEL);
396 DCL_CONST(long, "METH_MERGE", HTTP_MERGE);
397 DCL_CONST(long, "METH_BASELINE_CONTROL", HTTP_BASELINE_CONTROL);
398 DCL_CONST(long, "METH_MKACTIVITY", HTTP_MKACTIVITY);
399 /* WebDAV Access Control - RFC 3744 */
400 DCL_CONST(long, "METH_ACL", HTTP_ACL);
401
402 /*
403 * Auth Constants
404 */
405 DCL_CONST(long, "AUTH_BASIC", CURLAUTH_BASIC);
406 DCL_CONST(long, "AUTH_DIGEST", CURLAUTH_DIGEST);
407 DCL_CONST(long, "AUTH_NTLM", CURLAUTH_NTLM);
408 DCL_CONST(long, "AUTH_ANY", CURLAUTH_ANY);
409 #endif /* WONKY */
410 }
411
412 void _http_request_object_free(zend_object *object TSRMLS_DC)
413 {
414 http_request_object *o = (http_request_object *) object;
415
416 if (OBJ_PROP(o)) {
417 zend_hash_destroy(OBJ_PROP(o));
418 FREE_HASHTABLE(OBJ_PROP(o));
419 }
420 http_request_free(&o->request);
421 phpstr_dtor(&o->history);
422 efree(o);
423 }
424
425 STATUS _http_request_object_requesthandler(http_request_object *obj, zval *this_ptr TSRMLS_DC)
426 {
427 zval *URL, *URL_p, *meth_p;
428 STATUS status = SUCCESS;
429
430 http_request_reset(obj->request);
431 HTTP_CHECK_CURL_INIT(obj->request->ch, curl_easy_init(), return FAILURE);
432
433 URL = convert_to_type_ex(IS_STRING, GET_PROP(obj, url), &URL_p);
434 obj->request->url = http_absolute_url(Z_STRVAL_P(URL));
435 if (URL_p) zval_ptr_dtor(&URL_p);
436
437 switch (obj->request->meth = Z_LVAL_P(convert_to_type_ex(IS_LONG, GET_PROP(obj, method), &meth_p)))
438 {
439 case HTTP_GET:
440 case HTTP_HEAD:
441 break;
442
443 case HTTP_PUT:
444 {
445 php_stream_statbuf ssb;
446 php_stream *stream = php_stream_open_wrapper(Z_STRVAL_P(GET_PROP(obj, putFile)), "rb", REPORT_ERRORS|ENFORCE_SAFE_MODE, NULL);
447
448 if (stream && !php_stream_stat(stream, &ssb)) {
449 http_request_body_init_ex(obj->request->body, HTTP_REQUEST_BODY_UPLOADFILE, stream, ssb.sb.st_size, 1);
450 } else {
451 status = FAILURE;
452 }
453 }
454 break;
455
456 case HTTP_POST:
457 default:
458 {
459 /* check for raw post data */
460 zval *raw_data_p, *raw_data = convert_to_type_ex(IS_STRING, GET_PROP(obj, rawPostData), &raw_data_p);
461
462 if (Z_STRLEN_P(raw_data)) {
463 zval *ctype_p, *ctype = convert_to_type_ex(IS_STRING, GET_PROP(obj, contentType), &ctype_p);
464
465 if (Z_STRLEN_P(ctype)) {
466 zval **headers, *opts = GET_PROP(obj, options);
467
468 convert_to_array(opts);
469
470 if (SUCCESS == zend_hash_find(Z_ARRVAL_P(opts), "headers", sizeof("headers"), (void **) &headers)) {
471 zval **ct_header;
472
473 convert_to_array(*headers);
474 /* only override if not already set */
475 if (SUCCESS != zend_hash_find(Z_ARRVAL_PP(headers), "Content-Type", sizeof("Content-Type"), (void **) &ct_header)) {
476 add_assoc_stringl(*headers, "Content-Type", Z_STRVAL_P(ctype), Z_STRLEN_P(ctype), 1);
477 }
478 } else {
479 zval *headers;
480
481 MAKE_STD_ZVAL(headers);
482 array_init(headers);
483 add_assoc_stringl(headers, "Content-Type", Z_STRVAL_P(ctype), Z_STRLEN_P(ctype), 1);
484 add_assoc_zval(opts, "headers", headers);
485 }
486 }
487
488 if (ctype_p) {
489 zval_ptr_dtor(&ctype_p);
490 }
491
492 obj->request->body = http_request_body_init_ex(obj->request->body, HTTP_REQUEST_BODY_CSTRING,
493 estrndup(Z_STRVAL_P(raw_data), Z_STRLEN_P(raw_data)), Z_STRLEN_P(raw_data), 1);
494
495 } else {
496 zval *fields_cpy, *files_cpy;
497 HashTable *fields = Z_ARRVAL_P(convert_to_type_ex(IS_ARRAY, GET_PROP(obj, postFields), &fields_cpy));
498 HashTable *files = Z_ARRVAL_P(convert_to_type_ex(IS_ARRAY, GET_PROP(obj, postFiles), &files_cpy));
499
500 if (!(obj->request->body = http_request_body_fill(obj->request->body, fields, files))) {
501 status = FAILURE;
502 }
503
504 if (fields_cpy) {
505 zval_ptr_dtor(&fields_cpy);
506 }
507 if (files_cpy) {
508 zval_ptr_dtor(&files_cpy);
509 }
510 }
511
512 if (raw_data_p) {
513 zval_ptr_dtor(&raw_data_p);
514 }
515 }
516 break;
517 }
518
519 if (meth_p) {
520 zval_ptr_dtor(&meth_p);
521 }
522
523 if (status == SUCCESS) {
524 zval *qdata_p, *qdata = convert_to_type_ex(IS_STRING, GET_PROP(obj, queryData), &qdata_p);
525 zval *opt_p, *options = convert_to_type_ex(IS_ARRAY, GET_PROP(obj, options), &opt_p);
526
527 if (Z_STRLEN_P(qdata)) {
528 if (!strchr(obj->request->url, '?')) {
529 strlcat(obj->request->url, "?", HTTP_URL_MAXLEN);
530 } else {
531 strlcat(obj->request->url, "&", HTTP_URL_MAXLEN);
532 }
533 strlcat(obj->request->url, Z_STRVAL_P(qdata), HTTP_URL_MAXLEN);
534 }
535
536 http_request_prepare(obj->request, Z_ARRVAL_P(options));
537
538 if (opt_p) {
539 zval_ptr_dtor(&opt_p);
540 }
541 if (qdata_p) {
542 zval_ptr_dtor(&qdata_p);
543 }
544 }
545
546 return status;
547 }
548
549 STATUS _http_request_object_responsehandler(http_request_object *obj, zval *this_ptr TSRMLS_DC)
550 {
551 http_message *msg;
552
553 phpstr_fix(&obj->request->conv.request);
554 phpstr_fix(&obj->request->conv.response);
555
556 msg = http_message_parse(PHPSTR_VAL(&obj->request->conv.response), PHPSTR_LEN(&obj->request->conv.response));
557
558 if (!msg) {
559 return FAILURE;
560 } else {
561 char *body;
562 size_t body_len;
563 zval *headers, *message,
564 *resp = convert_to_type(IS_ARRAY, GET_PROP(obj, responseData)),
565 *info = convert_to_type(IS_ARRAY, GET_PROP(obj, responseInfo));
566
567 SEP_PROP(&resp);
568 SEP_PROP(&info);
569
570 if (zval_is_true(GET_PROP(obj, recordHistory))) {
571 /* we need to act like a zipper, as we'll receive
572 * the requests and the responses in separate chains
573 * for redirects
574 */
575 http_message *response = msg, *request = http_message_parse(PHPSTR_VAL(&obj->request->conv.request), PHPSTR_LEN(&obj->request->conv.request));
576 http_message *free_msg = request;
577
578 do {
579 char *message;
580 size_t msglen;
581
582 http_message_tostring(response, &message, &msglen);
583 phpstr_append(&obj->history, message, msglen);
584 efree(message);
585
586 http_message_tostring(request, &message, &msglen);
587 phpstr_append(&obj->history, message, msglen);
588 efree(message);
589
590 } while ((response = response->parent) && (request = request->parent));
591
592 http_message_free(&free_msg);
593 phpstr_fix(&obj->history);
594 }
595
596 UPD_PROP(obj, long, responseCode, msg->http.info.response.code);
597
598 MAKE_STD_ZVAL(headers);
599 array_init(headers);
600
601 zend_hash_copy(Z_ARRVAL_P(headers), &msg->hdrs, (copy_ctor_func_t) zval_add_ref, NULL, sizeof(zval *));
602 phpstr_data(PHPSTR(msg), &body, &body_len);
603
604 add_assoc_zval(resp, "headers", headers);
605 add_assoc_stringl(resp, "body", body, body_len, 0);
606 SET_PROP(obj, responseData, resp);
607
608 MAKE_STD_ZVAL(message);
609 ZVAL_OBJVAL(message, http_message_object_new_ex(http_message_object_ce, msg, NULL));
610 SET_PROP(obj, responseMessage, message);
611 zval_ptr_dtor(&message);
612
613 http_request_info(obj->request, Z_ARRVAL_P(info));
614 SET_PROP(obj, responseInfo, info);
615
616 return SUCCESS;
617 }
618 }
619
620 #define http_request_object_set_options_subr(key, ow) \
621 _http_request_object_set_options_subr(INTERNAL_FUNCTION_PARAM_PASSTHRU, (key), sizeof(key), (ow))
622 static inline void _http_request_object_set_options_subr(INTERNAL_FUNCTION_PARAMETERS, char *key, size_t len, int overwrite)
623 {
624 zval *opts, **options, *new_options = NULL;
625 getObject(http_request_object, obj);
626
627 if (SUCCESS != zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "|a/!", &new_options)) {
628 RETURN_FALSE;
629 }
630
631 opts = convert_to_type(IS_ARRAY, GET_PROP(obj, options));
632
633 if (SUCCESS == zend_hash_find(Z_ARRVAL_P(opts), key, len, (void **) &options)) {
634 convert_to_array(*options);
635 if (overwrite) {
636 zend_hash_clean(Z_ARRVAL_PP(options));
637 }
638 if (new_options && zend_hash_num_elements(Z_ARRVAL_P(new_options))) {
639 if (overwrite) {
640 array_copy(new_options, *options);
641 } else {
642 array_merge(new_options, *options);
643 }
644 }
645 } else if (new_options && zend_hash_num_elements(Z_ARRVAL_P(new_options))) {
646 ZVAL_ADDREF(new_options);
647 add_assoc_zval(opts, key, new_options);
648 }
649
650 RETURN_TRUE;
651 }
652
653 #define http_request_object_get_options_subr(key) \
654 _http_request_get_options_subr(INTERNAL_FUNCTION_PARAM_PASSTHRU, (key), sizeof(key))
655 static inline void _http_request_get_options_subr(INTERNAL_FUNCTION_PARAMETERS, char *key, size_t len)
656 {
657 NO_ARGS;
658
659 IF_RETVAL_USED {
660 zval *opts_p, *opts, **options;
661 getObject(http_request_object, obj);
662
663 opts = convert_to_type_ex(IS_ARRAY, GET_PROP(obj, options), &opts_p);
664
665 array_init(return_value);
666
667 if (SUCCESS == zend_hash_find(Z_ARRVAL_P(opts), key, len, (void **) &options)) {
668 convert_to_array(*options);
669 array_copy(*options, return_value);
670 }
671
672 if (opts_p) {
673 zval_ptr_dtor(&opts_p);
674 }
675 }
676 }
677
678
679 /* ### USERLAND ### */
680
681 /* {{{ proto void HttpRequest::__construct([string url[, int request_method = HTTP_METH_GET[, array options]]])
682 *
683 * Instantiate a new HttpRequest object.
684 *
685 * Accepts a string as optional parameter containing the target request url.
686 * Additianally accepts an optional int parameter specifying the request method
687 * to use and an associative array as optional third parameter which will be
688 * passed to HttpRequest::setOptions().
689 *
690 * Throws HttpException.
691 */
692 PHP_METHOD(HttpRequest, __construct)
693 {
694 char *URL = NULL;
695 int URL_len;
696 long meth = -1;
697 zval *options = NULL;
698 getObject(http_request_object, obj);
699
700 SET_EH_THROW_HTTP();
701 if (SUCCESS == zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "|sla", &URL, &URL_len, &meth, &options)) {
702 INIT_PARR(obj, options);
703 INIT_PARR(obj, responseInfo);
704 INIT_PARR(obj, responseData);
705 INIT_PARR(obj, postFields);
706 INIT_PARR(obj, postFiles);
707
708 if (URL) {
709 UPD_STRL(obj, url, URL, URL_len);
710 }
711 if (meth > -1) {
712 UPD_PROP(obj, long, method, meth);
713 }
714 if (options) {
715 zend_call_method_with_1_params(&getThis(), Z_OBJCE_P(getThis()), NULL, "setoptions", NULL, options);
716 }
717 }
718 SET_EH_NORMAL();
719 }
720 /* }}} */
721
722 /* {{{ proto void HttpRequest::__destruct()
723 *
724 * Destroys the HttpRequest object.
725 */
726 PHP_METHOD(HttpRequest, __destruct)
727 {
728 getObject(http_request_object, obj);
729
730 NO_ARGS;
731
732 FREE_PARR(obj, options);
733 FREE_PARR(obj, responseInfo);
734 FREE_PARR(obj, responseData);
735 FREE_PARR(obj, postFields);
736 FREE_PARR(obj, postFiles);
737 }
738 /* }}} */
739
740 /* {{{ proto bool HttpRequest::setOptions([array options])
741 *
742 * Set the request options to use. See http_get() for a full list of available options.
743 *
744 * Accepts an array as optional parameters, wich values will overwrite the
745 * currently set request options. If the parameter is empty or mitted,
746 * the optoions of the HttpRequest object will be reset.
747 *
748 * Returns TRUE on success, or FALSE on failure.
749 */
750 PHP_METHOD(HttpRequest, setOptions)
751 {
752 char *key = NULL;
753 ulong idx = 0;
754 HashPosition pos;
755 zval *opts = NULL, *old_opts, **opt;
756 getObject(http_request_object, obj);
757
758 if (SUCCESS != zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "|a!", &opts)) {
759 RETURN_FALSE;
760 }
761
762 old_opts = convert_to_type(IS_ARRAY, GET_PROP(obj, options));
763 SEP_PROP(&old_opts);
764
765 if (!opts || !zend_hash_num_elements(Z_ARRVAL_P(opts))) {
766 zend_hash_clean(Z_ARRVAL_P(old_opts));
767 SET_PROP(obj, options, old_opts);
768 RETURN_TRUE;
769 }
770
771 /* some options need extra attention -- thus cannot use array_merge() directly */
772 FOREACH_KEYVAL(pos, opts, key, idx, opt) {
773 if (key) {
774 if (!strcmp(key, "headers")) {
775 zval **headers;
776 if (SUCCESS == zend_hash_find(Z_ARRVAL_P(old_opts), "headers", sizeof("headers"), (void **) &headers)) {
777 convert_to_array_ex(opt);
778 convert_to_array(*headers);
779 array_merge(*opt, *headers);
780 continue;
781 }
782 } else if (!strcmp(key, "cookies")) {
783 zval **cookies;
784 if (SUCCESS == zend_hash_find(Z_ARRVAL_P(old_opts), "cookies", sizeof("cookies"), (void **) &cookies)) {
785 convert_to_array_ex(opt);
786 convert_to_array(*cookies);
787 array_merge(*opt, *cookies);
788 continue;
789 }
790 } else if (!strcmp(key, "ssl")) {
791 zval **ssl;
792 if (SUCCESS == zend_hash_find(Z_ARRVAL_P(old_opts), "ssl", sizeof("ssl"), (void **) &ssl)) {
793 convert_to_array_ex(opt);
794 convert_to_array(*ssl);
795 array_merge(*opt, *ssl);
796 continue;
797 }
798 } else if ((!strcasecmp(key, "url")) || (!strcasecmp(key, "uri"))) {
799 if (Z_TYPE_PP(opt) != IS_STRING) {
800 convert_to_string_ex(opt);
801 }
802 UPD_STRL(obj, url, Z_STRVAL_PP(opt), Z_STRLEN_PP(opt));
803 continue;
804 } else if (!strcmp(key, "method")) {
805 if (Z_TYPE_PP(opt) != IS_LONG) {
806 convert_to_long_ex(opt);
807 }
808 UPD_PROP(obj, long, method, Z_LVAL_PP(opt));
809 continue;
810 }
811
812 ZVAL_ADDREF(*opt);
813 add_assoc_zval(old_opts, key, *opt);
814
815 /* reset */
816 key = NULL;
817 }
818 }
819 SET_PROP(obj, options, old_opts);
820
821 RETURN_TRUE;
822 }
823 /* }}} */
824
825 /* {{{ proto array HttpRequest::getOptions()
826 *
827 * Get currently set options.
828 *
829 * Returns an associative array containing currently set options.
830 */
831 PHP_METHOD(HttpRequest, getOptions)
832 {
833 NO_ARGS;
834
835 IF_RETVAL_USED {
836 zval *opts_p, *opts;
837 getObject(http_request_object, obj);
838
839 opts = convert_to_type_ex(IS_ARRAY, GET_PROP(obj, options), &opts_p);
840 array_init(return_value);
841 array_copy(opts, return_value);
842
843 if (opts_p) {
844 zval_ptr_dtor(&opts_p);
845 }
846 }
847 }
848 /* }}} */
849
850 /* {{{ proto bool HttpRequest::setSslOptions([array options])
851 *
852 * Set SSL options.
853 *
854 * Accepts an associative array as parameter containing any SSL specific options.
855 * If the parameter is empty or omitted, the SSL options will be reset.
856 *
857 * Returns TRUE on success, or FALSE on failure.
858 */
859 PHP_METHOD(HttpRequest, setSslOptions)
860 {
861 http_request_object_set_options_subr("ssl", 1);
862 }
863 /* }}} */
864
865 /* {{{ proto bool HttpRequest::addSslOptions(array options)
866 *
867 * Set additional SSL options.
868 *
869 * Expects an associative array as parameter containing additional SSL specific options.
870 *
871 * Returns TRUE on success, or FALSE on failure.
872 */
873 PHP_METHOD(HttpRequest, addSslOptions)
874 {
875 http_request_object_set_options_subr("ssl", 0);
876 }
877 /* }}} */
878
879 /* {{{ proto array HttpRequest::getSslOtpions()
880 *
881 * Get previously set SSL options.
882 *
883 * Returns an associative array containing any previously set SSL options.
884 */
885 PHP_METHOD(HttpRequest, getSslOptions)
886 {
887 http_request_object_get_options_subr("ssl");
888 }
889 /* }}} */
890
891 /* {{{ proto bool HttpRequest::addHeaders(array headers)
892 *
893 * Add request header name/value pairs.
894 *
895 * Expects an ssociative array as parameter containing additional header
896 * name/value pairs.
897 *
898 * Returns TRUE on success, or FALSE on failure.
899 */
900 PHP_METHOD(HttpRequest, addHeaders)
901 {
902 http_request_object_set_options_subr("headers", 0);
903 }
904
905 /* {{{ proto bool HttpRequest::setHeaders([array headers])
906 *
907 * Set request header name/value pairs.
908 *
909 * Accepts an associative array as parameter containing header name/value pairs.
910 * If the parameter is empty or omitted, all previously set headers will be unset.
911 *
912 * Returns TRUE on success, or FALSE on failure.
913 */
914 PHP_METHOD(HttpRequest, setHeaders)
915 {
916 http_request_object_set_options_subr("headers", 1);
917 }
918 /* }}} */
919
920 /* {{{ proto array HttpRequest::getHeaders()
921 *
922 * Get previously set request headers.
923 *
924 * Returns an associative array containing all currently set headers.
925 */
926 PHP_METHOD(HttpRequest, getHeaders)
927 {
928 http_request_object_get_options_subr("headers");
929 }
930 /* }}} */
931
932 /* {{{ proto bool HttpRequest::setCookies([array cookies])
933 *
934 * Set cookies.
935 *
936 * Accepts an associative array as parameter containing cookie name/value pairs.
937 * If the parameter is empty or omitted, all previously set cookies will be unset.
938 *
939 * Returns TRUE on success, or FALSE on failure.
940 */
941 PHP_METHOD(HttpRequest, setCookies)
942 {
943 http_request_object_set_options_subr("cookies", 1);
944 }
945 /* }}} */
946
947 /* {{{ proto bool HttpRequest::addCookies(array cookies)
948 *
949 * Add cookies.
950 *
951 * Expects an associative array as parameter containing any cookie name/value
952 * pairs to add.
953 *
954 * Returns TRUE on success, or FALSE on failure.
955 */
956 PHP_METHOD(HttpRequest, addCookies)
957 {
958 http_request_object_set_options_subr("cookies", 0);
959 }
960 /* }}} */
961
962 /* {{{ proto array HttpRequest::getCookies()
963 *
964 * Get previously set cookies.
965 *
966 * Returns an associative array containing any previously set cookies.
967 */
968 PHP_METHOD(HttpRequest, getCookies)
969 {
970 http_request_object_get_options_subr("cookies");
971 }
972 /* }}} */
973
974 /* {{{ proto bool HttpRequest::setUrl(string url)
975 *
976 * Set the request URL.
977 *
978 * Expects a string as parameter specifying the request url.
979 *
980 * Returns TRUE on success, or FALSE on failure.
981 */
982 PHP_METHOD(HttpRequest, setUrl)
983 {
984 char *URL = NULL;
985 int URL_len;
986 getObject(http_request_object, obj);
987
988 if (SUCCESS != zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "s", &URL, &URL_len)) {
989 RETURN_FALSE;
990 }
991
992 UPD_STRL(obj, url, URL, URL_len);
993 RETURN_TRUE;
994 }
995 /* }}} */
996
997 /* {{{ proto string HttpRequest::getUrl()
998 *
999 * Get the previously set request URL.
1000 *
1001 * Returns the currently set request url as string.
1002 */
1003 PHP_METHOD(HttpRequest, getUrl)
1004 {
1005 NO_ARGS;
1006
1007 IF_RETVAL_USED {
1008 getObject(http_request_object, obj);
1009 zval *URL = GET_PROP(obj, url);
1010
1011 RETURN_ZVAL(URL, 1, 0);
1012 }
1013 }
1014 /* }}} */
1015
1016 /* {{{ proto bool HttpRequest::setMethod(int request_method)
1017 *
1018 * Set the request method.
1019 *
1020 * Expects an int as parameter specifying the request method to use.
1021 * In PHP 5.1+ HttpRequest::METH_*, otherwise the HTTP_METH_* constants can be used.
1022 *
1023 * Returns TRUE on success, or FALSE on failure.
1024 */
1025 PHP_METHOD(HttpRequest, setMethod)
1026 {
1027 long meth;
1028 getObject(http_request_object, obj);
1029
1030 if (SUCCESS != zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "l", &meth)) {
1031 RETURN_FALSE;
1032 }
1033
1034 UPD_PROP(obj, long, method, meth);
1035 RETURN_TRUE;
1036 }
1037 /* }}} */
1038
1039 /* {{{ proto int HttpRequest::getMethod()
1040 *
1041 * Get the previously set request method.
1042 *
1043 * Returns the currently set request method.
1044 */
1045 PHP_METHOD(HttpRequest, getMethod)
1046 {
1047 NO_ARGS;
1048
1049 IF_RETVAL_USED {
1050 getObject(http_request_object, obj);
1051 zval *meth = GET_PROP(obj, method);
1052
1053 RETURN_ZVAL(meth, 1, 0);
1054 }
1055 }
1056 /* }}} */
1057
1058 /* {{{ proto bool HttpRequest::setContentType(string content_type)
1059 *
1060 * Set the content type the post request should have.
1061 *
1062 * Expects a string as parameters containing the content type of the request
1063 * (primary/secondary).
1064 *
1065 * Returns TRUE on success, or FALSE if the content type does not seem to
1066 * contain a primary and a secondary part.
1067 */
1068 PHP_METHOD(HttpRequest, setContentType)
1069 {
1070 char *ctype;
1071 int ct_len;
1072 getObject(http_request_object, obj);
1073
1074 if (SUCCESS != zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "s", &ctype, &ct_len)) {
1075 RETURN_FALSE;
1076 }
1077
1078 HTTP_CHECK_CONTENT_TYPE(ctype, RETURN_FALSE);
1079 UPD_STRL(obj, contentType, ctype, ct_len);
1080 RETURN_TRUE;
1081 }
1082 /* }}} */
1083
1084 /* {{{ proto string HttpRequest::getContentType()
1085 *
1086 * Get the previously content type.
1087 *
1088 * Returns the previously set content type as string.
1089 */
1090 PHP_METHOD(HttpRequest, getContentType)
1091 {
1092 NO_ARGS;
1093
1094 IF_RETVAL_USED {
1095 getObject(http_request_object, obj);
1096 zval *ctype = GET_PROP(obj, contentType);
1097
1098 RETURN_ZVAL(ctype, 1, 0);
1099 }
1100 }
1101 /* }}} */
1102
1103 /* {{{ proto bool HttpRequest::setQueryData([mixed query_data])
1104 *
1105 * Set the URL query parameters to use, overwriting previously set query parameters.
1106 * Affects any request types.
1107 *
1108 * Accepts a string or associative array parameter containing the pre-encoded
1109 * query string or to be encoded query fields. If the parameter is empty or
1110 * omitted, the query data will be unset.
1111 *
1112 * Returns TRUE on success, or FALSE on failure.
1113 */
1114 PHP_METHOD(HttpRequest, setQueryData)
1115 {
1116 zval *qdata = NULL;
1117 getObject(http_request_object, obj);
1118
1119 if (SUCCESS != zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "z!", &qdata)) {
1120 RETURN_FALSE;
1121 }
1122
1123 if ((!qdata) || Z_TYPE_P(qdata) == IS_NULL) {
1124 UPD_STRL(obj, queryData, "", 0);
1125 } else if ((Z_TYPE_P(qdata) == IS_ARRAY) || (Z_TYPE_P(qdata) == IS_OBJECT)) {
1126 char *query_data = NULL;
1127
1128 if (SUCCESS != http_urlencode_hash(HASH_OF(qdata), &query_data)) {
1129 RETURN_FALSE;
1130 }
1131
1132 UPD_PROP(obj, string, queryData, query_data);
1133 efree(query_data);
1134 } else {
1135 convert_to_string_ex(&qdata);
1136 UPD_STRL(obj, queryData, Z_STRVAL_P(qdata), Z_STRLEN_P(qdata));
1137 }
1138 RETURN_TRUE;
1139 }
1140 /* }}} */
1141
1142 /* {{{ proto string HttpRequest::getQueryData()
1143 *
1144 * Get the current query data in form of an urlencoded query string.
1145 *
1146 * Returns a string containing the urlencoded query.
1147 */
1148 PHP_METHOD(HttpRequest, getQueryData)
1149 {
1150 NO_ARGS;
1151
1152 IF_RETVAL_USED {
1153 getObject(http_request_object, obj);
1154 zval *qdata_p, *qdata = convert_to_type_ex(IS_STRING, GET_PROP(obj, queryData), &qdata_p);
1155
1156 RETURN_ZVAL(qdata, 1, 0);
1157
1158 if (qdata_p) {
1159 zval_ptr_dtor(&qdata_p);
1160 }
1161 }
1162 }
1163 /* }}} */
1164
1165 /* {{{ proto bool HttpRequest::addQueryData(array query_params)
1166 *
1167 * Add parameters to the query parameter list, leaving previously set unchanged.
1168 * Affects any request type.
1169 *
1170 * Expects an associative array as parameter containing the query fields to add.
1171 *
1172 * Returns TRUE on success, or FALSE on failure.
1173 */
1174 PHP_METHOD(HttpRequest, addQueryData)
1175 {
1176 zval *qdata, *old_qdata, *old_qdata_p;
1177 char *query_data = NULL;
1178 size_t query_data_len = 0;
1179 getObject(http_request_object, obj);
1180
1181 if (SUCCESS != zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "a", &qdata)) {
1182 RETURN_FALSE;
1183 }
1184
1185 old_qdata = convert_to_type_ex(IS_STRING, GET_PROP(obj, queryData), &old_qdata_p);
1186
1187 if (SUCCESS != http_urlencode_hash_ex(HASH_OF(qdata), 1, Z_STRVAL_P(old_qdata), Z_STRLEN_P(old_qdata), &query_data, &query_data_len)) {
1188 if (old_qdata_p) {
1189 zval_ptr_dtor(&old_qdata_p);
1190 }
1191 RETURN_FALSE;
1192 }
1193
1194 UPD_STRL(obj, queryData, query_data, query_data_len);
1195 efree(query_data);
1196
1197 if (old_qdata_p) {
1198 zval_ptr_dtor(&old_qdata_p);
1199 }
1200
1201 RETURN_TRUE;
1202 }
1203 /* }}} */
1204
1205 /* {{{ proto bool HttpRequest::addPostFields(array post_data)
1206 *
1207 * Adds POST data entries, leaving previously set unchanged, unless a
1208 * post entry with the same name already exists.
1209 * Affects only POST and custom requests.
1210 *
1211 * Expects an associative array as parameter containing the post fields.
1212 *
1213 * Returns TRUE on success, or FALSE on failure.
1214 */
1215 PHP_METHOD(HttpRequest, addPostFields)
1216 {
1217 zval *post, *post_data;
1218 getObject(http_request_object, obj);
1219
1220 if (SUCCESS != zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "a", &post_data)) {
1221 RETURN_FALSE;
1222 }
1223
1224 post = convert_to_type(IS_ARRAY, GET_PROP(obj, postFields));
1225 array_merge(post_data, post);
1226
1227 RETURN_TRUE;
1228 }
1229 /* }}} */
1230
1231 /* {{{ proto bool HttpRequest::setPostFields([array post_data])
1232 *
1233 * Set the POST data entries, overwriting previously set POST data.
1234 * Affects only POST and custom requests.
1235 *
1236 * Accepts an associative array as parameter containing the post fields.
1237 * If the parameter is empty or omitted, the post data will be unset.
1238 *
1239 * Returns TRUE on success, or FALSE on failure.
1240 */
1241 PHP_METHOD(HttpRequest, setPostFields)
1242 {
1243 zval *post, *post_data = NULL;
1244 getObject(http_request_object, obj);
1245
1246 if (SUCCESS != zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "a!", &post_data)) {
1247 RETURN_FALSE;
1248 }
1249
1250 post = convert_to_type(IS_ARRAY, GET_PROP(obj, postFields));
1251
1252 SEP_PROP(&post);
1253 zend_hash_clean(Z_ARRVAL_P(post));
1254 if (post_data && zend_hash_num_elements(Z_ARRVAL_P(post_data))) {
1255 array_copy(post_data, post);
1256 }
1257 SET_PROP(obj, postFields, post);
1258
1259 RETURN_TRUE;
1260 }
1261 /* }}}*/
1262
1263 /* {{{ proto array HttpRequest::getPostFields()
1264 *
1265 * Get previously set POST data.
1266 *
1267 * Returns the currently set post fields as associative array.
1268 */
1269 PHP_METHOD(HttpRequest, getPostFields)
1270 {
1271 NO_ARGS;
1272
1273 IF_RETVAL_USED {
1274 getObject(http_request_object, obj);
1275 zval *post_data_p, *post_data = convert_to_type_ex(IS_ARRAY, GET_PROP(obj, postFields), &post_data_p);
1276
1277 array_init(return_value);
1278 array_copy(post_data, return_value);
1279
1280 if (post_data_p) {
1281 zval_ptr_dtor(&post_data_p);
1282 }
1283 }
1284 }
1285 /* }}} */
1286
1287 /* {{{ proto bool HttpRequest::setRawPostData([string raw_post_data])
1288 *
1289 * Set raw post data to send, overwriting previously set raw post data. Don't
1290 * forget to specify a content type. Affects only POST and custom requests.
1291 * Only either post fields or raw post data can be used for each request.
1292 * Raw post data has higher precedence and will be used even if post fields
1293 * are set.
1294 *
1295 * Accepts a string as parameter containing the *raw* post data.
1296 *
1297 * Returns TRUE on success, or FALSE on failure.
1298 */
1299 PHP_METHOD(HttpRequest, setRawPostData)
1300 {
1301 char *raw_data = NULL;
1302 int data_len = 0;
1303 getObject(http_request_object, obj);
1304
1305 if (SUCCESS != zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "|s", &raw_data, &data_len)) {
1306 RETURN_FALSE;
1307 }
1308
1309 if (!raw_data) {
1310 raw_data = "";
1311 }
1312
1313 UPD_STRL(obj, rawPostData, raw_data, data_len);
1314 RETURN_TRUE;
1315 }
1316 /* }}} */
1317
1318 /* {{{ proto bool HttpRequest::addRawPostData(string raw_post_data)
1319 *
1320 * Add raw post data, leaving previously set raw post data unchanged.
1321 * Affects only POST and custom requests.
1322 *
1323 * Expects a string as parameter containing the raw post data to concatenate.
1324 *
1325 * Returns TRUE on success, or FALSE on failure.
1326 */
1327 PHP_METHOD(HttpRequest, addRawPostData)
1328 {
1329 char *raw_data, *new_data;
1330 int data_len;
1331 getObject(http_request_object, obj);
1332
1333 if (SUCCESS != zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "s", &raw_data, &data_len)) {
1334 RETURN_FALSE;
1335 }
1336
1337 if (data_len) {
1338 zval *zdata_p, *zdata = convert_to_type_ex(IS_STRING, GET_PROP(obj, rawPostData), &zdata_p);
1339
1340 new_data = emalloc(Z_STRLEN_P(zdata) + data_len + 1);
1341 new_data[Z_STRLEN_P(zdata) + data_len] = '\0';
1342
1343 if (Z_STRLEN_P(zdata)) {
1344 memcpy(new_data, Z_STRVAL_P(zdata), Z_STRLEN_P(zdata));
1345 }
1346
1347 memcpy(new_data + Z_STRLEN_P(zdata), raw_data, data_len);
1348 UPD_STRL(obj, rawPostData, new_data, Z_STRLEN_P(zdata) + data_len);
1349
1350 if (zdata_p) {
1351 zval_ptr_dtor(&zdata_p);
1352 }
1353 }
1354
1355 RETURN_TRUE;
1356 }
1357 /* }}} */
1358
1359 /* {{{ proto string HttpRequest::getRawPostData()
1360 *
1361 * Get previously set raw post data.
1362 *
1363 * Returns a string containing the currently set raw post data.
1364 */
1365 PHP_METHOD(HttpRequest, getRawPostData)
1366 {
1367 NO_ARGS;
1368
1369 IF_RETVAL_USED {
1370 getObject(http_request_object, obj);
1371 zval *raw_data_p, *raw_data = convert_to_type_ex(IS_STRING, GET_PROP(obj, rawPostData), &raw_data_p);
1372
1373 RETVAL_ZVAL(raw_data, 1, 0);
1374
1375 if (raw_data_p) {
1376 zval_ptr_dtor(&raw_data_p);
1377 }
1378 }
1379 }
1380 /* }}} */
1381
1382 /* {{{ proto bool HttpRequest::addPostFile(string name, string file[, string content_type = "application/x-octetstream"])
1383 *
1384 * Add a file to the POST request, leaving prefiously set files unchanged.
1385 * Affects only POST and custom requests. Cannot be used with raw post data.
1386 *
1387 * Expects a string parameter containing the form element name, and a string
1388 * paremeter containing the path to the file which should be uploaded.
1389 * Additionally accepts an optional string parameter which chould contain
1390 * the content type of the file.
1391 *
1392 * Returns TRUE on success, or FALSE if the content type seems not to contain a
1393 * primary and a secondary content type part.
1394 */
1395 PHP_METHOD(HttpRequest, addPostFile)
1396 {
1397 zval *files, *entry;
1398 char *name, *file, *type = NULL;
1399 int name_len, file_len, type_len = 0;
1400 getObject(http_request_object, obj);
1401
1402 if (SUCCESS != zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "ss|s", &name, &name_len, &file, &file_len, &type, &type_len)) {
1403 RETURN_FALSE;
1404 }
1405
1406 if (type_len) {
1407 HTTP_CHECK_CONTENT_TYPE(type, RETURN_FALSE);
1408 } else {
1409 type = "application/x-octetstream";
1410 type_len = sizeof("application/x-octetstream") - 1;
1411 }
1412
1413 MAKE_STD_ZVAL(entry);
1414 array_init(entry);
1415
1416 add_assoc_stringl(entry, "name", name, name_len, 1);
1417 add_assoc_stringl(entry, "type", type, type_len, 1);
1418 add_assoc_stringl(entry, "file", file, file_len, 1);
1419
1420 files = convert_to_type(IS_ARRAY, GET_PROP(obj, postFiles));
1421 add_next_index_zval(files, entry);
1422
1423 RETURN_TRUE;
1424 }
1425 /* }}} */
1426
1427 /* {{{ proto bool HttpRequest::setPostFiles([array post_files])
1428 *
1429 * Set files to post, overwriting previously set post files.
1430 * Affects only POST and requests. Cannot be used with raw post data.
1431 *
1432 * Accepts an array containing the files to post. Each entry should be an
1433 * associative array with "name", "file" and "type" keys. If the parameter
1434 * is empty or omitted the post files will be unset.
1435 *
1436 * Returns TRUE on success, or FALSE on failure.
1437 */
1438 PHP_METHOD(HttpRequest, setPostFiles)
1439 {
1440 zval *files, *pFiles;
1441 getObject(http_request_object, obj);
1442
1443 if (SUCCESS != zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "a", &files)) {
1444 RETURN_FALSE;
1445 }
1446
1447 pFiles = convert_to_type(IS_ARRAY, GET_PROP(obj, postFiles));
1448
1449 SEP_PROP(&pFiles);
1450 zend_hash_clean(Z_ARRVAL_P(pFiles));
1451 if (files && zend_hash_num_elements(Z_ARRVAL_P(files))) {
1452 array_copy(files, pFiles);
1453 }
1454 SET_PROP(obj, postFiles, pFiles);
1455
1456 RETURN_TRUE;
1457 }
1458 /* }}} */
1459
1460 /* {{{ proto array HttpRequest::getPostFiles()
1461 *
1462 * Get all previously added POST files.
1463 *
1464 * Returns an array containing currently set post files.
1465 */
1466 PHP_METHOD(HttpRequest, getPostFiles)
1467 {
1468 NO_ARGS;
1469
1470 IF_RETVAL_USED {
1471 getObject(http_request_object, obj);
1472 zval *files_p, *files = convert_to_type_ex(IS_ARRAY, GET_PROP(obj, postFiles), &files_p);
1473
1474 array_init(return_value);
1475 array_copy(files, return_value);
1476
1477 if (files_p) {
1478 zval_ptr_dtor(&files_p);
1479 }
1480 }
1481 }
1482 /* }}} */
1483
1484 /* {{{ proto bool HttpRequest::setPutFile([string file])
1485 *
1486 * Set file to put. Affects only PUT requests.
1487 *
1488 * Accepts a string as parameter referencing the path to file.
1489 * If the parameter is empty or omitted the put file will be unset.
1490 *
1491 * Returns TRUE on success, or FALSE on failure.
1492 */
1493 PHP_METHOD(HttpRequest, setPutFile)
1494 {
1495 char *file = "";
1496 int file_len = 0;
1497 getObject(http_request_object, obj);
1498
1499 if (SUCCESS != zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "|s", &file, &file_len)) {
1500 RETURN_FALSE;
1501 }
1502
1503 UPD_STRL(obj, putFile, file, file_len);
1504 RETURN_TRUE;
1505 }
1506 /* }}} */
1507
1508 /* {{{ proto string HttpRequest::getPutFile()
1509 *
1510 * Get previously set put file.
1511 *
1512 * Returns a string containing the path to the currently set put file.
1513 */
1514 PHP_METHOD(HttpRequest, getPutFile)
1515 {
1516 NO_ARGS;
1517
1518 IF_RETVAL_USED {
1519 getObject(http_request_object, obj);
1520 zval *putfile_p, *putfile = convert_to_type_ex(IS_STRING, GET_PROP(obj, putFile), &putfile_p);
1521
1522 RETVAL_ZVAL(putfile, 1, 0);
1523
1524 if (putfile_p) {
1525 zval_ptr_dtor(&putfile_p);
1526 }
1527 }
1528 }
1529 /* }}} */
1530
1531 /* {{{ proto array HttpRequest::getResponseData()
1532 *
1533 * Get all response data after the request has been sent.
1534 *
1535 * Returns an associative array with the key "headers" containing an associative
1536 * array holding all response headers, as well as the ley "body" containing a
1537 * string with the response body.
1538 *
1539 * If redirects were allowed and several responses were received, the data
1540 * references the last received response.
1541 */
1542 PHP_METHOD(HttpRequest, getResponseData)
1543 {
1544 NO_ARGS;
1545
1546 IF_RETVAL_USED {
1547 getObject(http_request_object, obj);
1548 zval *data_p, *data = convert_to_type_ex(IS_ARRAY, GET_PROP(obj, responseData), &data_p);
1549
1550 array_init(return_value);
1551 array_copy(data, return_value);
1552
1553 if (data_p) {
1554 zval_ptr_dtor(&data_p);
1555 }
1556 }
1557 }
1558 /* }}} */
1559
1560 /* {{{ proto mixed HttpRequest::getResponseHeader([string name])
1561 *
1562 * Get response header(s) after the request has been sent.
1563 *
1564 * Accepts an string as optional parameter specifying a certain header to read.
1565 * If the parameter is empty or omitted all response headers will be returned.
1566 *
1567 * Returns either a string with the value of the header matching name if requested,
1568 * FALSE on failure, or an associative array containing all reponse headers.
1569 *
1570 * If redirects were allowed and several responses were received, the data
1571 * references the last received response.
1572 */
1573 PHP_METHOD(HttpRequest, getResponseHeader)
1574 {
1575 IF_RETVAL_USED {
1576 zval *data_p, *data, **headers, **header;
1577 char *header_name = NULL;
1578 int header_len = 0;
1579 getObject(http_request_object, obj);
1580
1581 if (SUCCESS != zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "|s", &header_name, &header_len)) {
1582 RETURN_FALSE;
1583 }
1584
1585 data = convert_to_type_ex(IS_ARRAY, GET_PROP(obj, responseData), &data_p);
1586 if (SUCCESS == zend_hash_find(Z_ARRVAL_P(data), "headers", sizeof("headers"), (void **) &headers)) {
1587 convert_to_array(*headers);
1588 if (!header_len || !header_name) {
1589 array_init(return_value);
1590 array_copy(*headers, return_value);
1591 } else if (SUCCESS == zend_hash_find(Z_ARRVAL_PP(headers), pretty_key(header_name, header_len, 1, 1), header_len + 1, (void **) &header)) {
1592 RETVAL_ZVAL(*header, 1, 0);
1593 } else {
1594 RETVAL_FALSE;
1595 }
1596 } else {
1597 RETVAL_FALSE;
1598 }
1599
1600 if (data_p) {
1601 zval_ptr_dtor(&data_p);
1602 }
1603 }
1604 }
1605 /* }}} */
1606
1607 /* {{{ proto array HttpRequest::getResponseCookie([string name])
1608 *
1609 * Get response cookie(s) after the request has been sent.
1610 *
1611 * Accepts a string as optional parameter specifying the name of the cookie to read.
1612 * If the parameter is empty or omitted, an associative array with all received
1613 * cookies will be returned.
1614 *
1615 * Returns either an associative array with the cookie's name, value and any
1616 * additional params of the cookie matching name if requested, FALSE on failure,
1617 * or an array containing all received cookies as arrays.
1618 *
1619 * If redirects were allowed and several responses were received, the data
1620 * references the last received response.
1621 */
1622 PHP_METHOD(HttpRequest, getResponseCookie)
1623 {
1624 IF_RETVAL_USED {
1625 zval *data, **headers;
1626 char *cookie_name = NULL;
1627 int cookie_len = 0;
1628 getObject(http_request_object, obj);
1629
1630 if (SUCCESS != zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "|s", &cookie_name, &cookie_len)) {
1631 RETURN_FALSE;
1632 }
1633
1634 array_init(return_value);
1635
1636 data = convert_to_type(IS_ARRAY, GET_PROP(obj, responseData));
1637 if (SUCCESS == zend_hash_find(Z_ARRVAL_P(data), "headers", sizeof("headers"), (void **) &headers)) {
1638 ulong idx = 0;
1639 char *key = NULL;
1640 zval **header = NULL;
1641 HashPosition pos1;
1642
1643 convert_to_array(*headers);
1644 FOREACH_HASH_KEYVAL(pos1, Z_ARRVAL_PP(headers), key, idx, header) {
1645 if (key && !strcasecmp(key, "Set-Cookie")) {
1646 /* several cookies? */
1647 if (Z_TYPE_PP(header) == IS_ARRAY) {
1648 zval **cookie;
1649 HashPosition pos2;
1650
1651 FOREACH_HASH_VAL(pos2, Z_ARRVAL_PP(header), cookie) {
1652 zval *cookie_hash;
1653 MAKE_STD_ZVAL(cookie_hash);
1654 array_init(cookie_hash);
1655
1656 if (SUCCESS == http_parse_cookie(Z_STRVAL_PP(cookie), Z_ARRVAL_P(cookie_hash))) {
1657 if (!cookie_len) {
1658 add_next_index_zval(return_value, cookie_hash);
1659 } else {
1660 zval **name;
1661
1662 if ( (SUCCESS == zend_hash_find(Z_ARRVAL_P(cookie_hash), "name", sizeof("name"), (void **) &name)) &&
1663 (!strcmp(Z_STRVAL_PP(name), cookie_name))) {
1664 add_next_index_zval(return_value, cookie_hash);
1665 return; /* <<< FOUND >>> */
1666 } else {
1667 zval_dtor(cookie_hash);
1668 efree(cookie_hash);
1669 }
1670 }
1671 } else {
1672 zval_dtor(cookie_hash);
1673 efree(cookie_hash);
1674 }
1675 }
1676 } else {
1677 zval *cookie_hash;
1678
1679 MAKE_STD_ZVAL(cookie_hash);
1680 array_init(cookie_hash);
1681 convert_to_string_ex(header);
1682
1683 if (SUCCESS == http_parse_cookie(Z_STRVAL_PP(header), Z_ARRVAL_P(cookie_hash))) {
1684 if (!cookie_len) {
1685 add_next_index_zval(return_value, cookie_hash);
1686 } else {
1687 zval **name;
1688
1689 if ( (SUCCESS == zend_hash_find(Z_ARRVAL_P(cookie_hash), "name", sizeof("name"), (void **) &name)) &&
1690 (!strcmp(Z_STRVAL_PP(name), cookie_name))) {
1691 add_next_index_zval(return_value, cookie_hash);
1692 } else {
1693 zval_dtor(cookie_hash);
1694 efree(cookie_hash);
1695 }
1696 }
1697 } else {
1698 zval_dtor(cookie_hash);
1699 efree(cookie_hash);
1700 }
1701 }
1702 break;
1703 }
1704 /* reset key */
1705 key = NULL;
1706 }
1707 }
1708 }
1709 }
1710 /* }}} */
1711
1712 /* {{{ proto string HttpRequest::getResponseBody()
1713 *
1714 * Get the response body after the request has been sent.
1715 *
1716 * Returns a string containing the response body.
1717 *
1718 * If redirects were allowed and several responses were received, the data
1719 * references the last received response.
1720 */
1721 PHP_METHOD(HttpRequest, getResponseBody)
1722 {
1723 NO_ARGS;
1724
1725 IF_RETVAL_USED {
1726 zval **body;
1727 getObject(http_request_object, obj);
1728 zval *data = convert_to_type(IS_ARRAY, GET_PROP(obj, responseData));
1729
1730 if (SUCCESS == zend_hash_find(Z_ARRVAL_P(data), "body", sizeof("body"), (void **) &body)) {
1731 RETURN_ZVAL(*body, 1, 0);
1732 } else {
1733 RETURN_FALSE;
1734 }
1735 }
1736 }
1737 /* }}} */
1738
1739 /* {{{ proto int HttpRequest::getResponseCode()
1740 *
1741 * Get the response code after the request has been sent.
1742 *
1743 * Returns an int representing the response code.
1744 *
1745 * If redirects were allowed and several responses were received, the data
1746 * references the last received response.
1747 */
1748 PHP_METHOD(HttpRequest, getResponseCode)
1749 {
1750 NO_ARGS;
1751
1752 IF_RETVAL_USED {
1753 getObject(http_request_object, obj);
1754 zval *code_p, *code = convert_to_type_ex(IS_LONG, GET_PROP(obj, responseCode), &code_p);
1755
1756 RETVAL_ZVAL(code, 1, 0);
1757
1758 if (code_p) {
1759 zval_ptr_dtor(&code_p);
1760 }
1761 }
1762 }
1763 /* }}} */
1764
1765 /* {{{ proto mixed HttpRequest::getResponseInfo([string name])
1766 *
1767 * Get response info after the request has been sent.
1768 * See http_get() for a full list of returned info.
1769 *
1770 * Accepts a string as optional parameter specifying the info to read.
1771 * If the parameter is empty or omitted, an associative array containing
1772 * all available info will be returned.
1773 *
1774 * Returns either a scalar containing the value of the info matching name if
1775 * requested, FALSE on failure, or an associative array containing all
1776 * available info.
1777 *
1778 * If redirects were allowed and several responses were received, the data
1779 * references the last received response.
1780 */
1781 PHP_METHOD(HttpRequest, getResponseInfo)
1782 {
1783 IF_RETVAL_USED {
1784 zval *info, **infop;
1785 char *info_name = NULL;
1786 int info_len = 0;
1787 getObject(http_request_object, obj);
1788
1789 if (SUCCESS != zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "|s", &info_name, &info_len)) {
1790 RETURN_FALSE;
1791 }
1792
1793 info = convert_to_type(IS_ARRAY, GET_PROP(obj, responseInfo));
1794
1795 if (info_len && info_name) {
1796 if (SUCCESS == zend_hash_find(Z_ARRVAL_P(info), pretty_key(info_name, info_len, 0, 0), info_len + 1, (void **) &infop)) {
1797 RETURN_ZVAL(*infop, 1, 0);
1798 } else {
1799 http_error_ex(HE_NOTICE, HTTP_E_INVALID_PARAM, "Could not find response info named %s", info_name);
1800 RETURN_FALSE;
1801 }
1802 } else {
1803 array_init(return_value);
1804 array_copy(info, return_value);
1805 }
1806 }
1807 }
1808 /* }}}*/
1809
1810 /* {{{ proto HttpMessage HttpRequest::getResponseMessage()
1811 *
1812 * Get the full response as HttpMessage object after the request has been sent.
1813 *
1814 * Returns an HttpMessage object of the response.
1815 *
1816 * If redirects were allowed and several responses were received, the data
1817 * references the last received response. Use HttpMessage::getParentMessage()
1818 * to access the data of previously received responses whithin this request
1819 * cycle.
1820 *
1821 * Throws HttpException.
1822 */
1823 PHP_METHOD(HttpRequest, getResponseMessage)
1824 {
1825 NO_ARGS;
1826
1827 IF_RETVAL_USED {
1828 zval *message;
1829 getObject(http_request_object, obj);
1830
1831 SET_EH_THROW_HTTP();
1832 message = GET_PROP(obj, responseMessage);
1833 if (Z_TYPE_P(message) == IS_OBJECT) {
1834 RETVAL_OBJECT(message);
1835 } else {
1836 RETVAL_NULL();
1837 }
1838 SET_EH_NORMAL();
1839 }
1840 }
1841 /* }}} */
1842
1843 /* {{{ proto HttpMessage HttpRequest::getRequestMessage()
1844 *
1845 * Get sent HTTP message.
1846 *
1847 * Returns an HttpMessage object representing the sent request.
1848 *
1849 * If redirects were allowed and several responses were received, the data
1850 * references the last received response. Use HttpMessage::getParentMessage()
1851 * to access the data of previously sent requests whithin this request
1852 * cycle.
1853 *
1854 * Note that the internal request message is immutable, that means that the
1855 * request message received through HttpRequest::getRequestMessage() will
1856 * always look the same for the same request, regardless of any changes you
1857 * may have made to the returned object.
1858 *
1859 * Throws HttpMalformedHeadersException, HttpEncodingException.
1860 */
1861 PHP_METHOD(HttpRequest, getRequestMessage)
1862 {
1863 NO_ARGS;
1864
1865 IF_RETVAL_USED {
1866 http_message *msg;
1867 getObject(http_request_object, obj);
1868
1869 SET_EH_THROW_HTTP();
1870 if ((msg = http_message_parse(PHPSTR_VAL(&obj->request->conv.request), PHPSTR_LEN(&obj->request->conv.request)))) {
1871 ZVAL_OBJVAL(return_value, http_message_object_new_ex(http_message_object_ce, msg, NULL));
1872 }
1873 SET_EH_NORMAL();
1874 }
1875 }
1876 /* }}} */
1877
1878 /* {{{ proto HttpMessage HttpRequest::getHistory()
1879 *
1880 * Get all sent requests and received responses as an HttpMessage object.
1881 *
1882 * If you don't want to record history at all, set the instance variable
1883 * HttpRequest::$recoedHistory to FALSE.
1884 *
1885 * Returns an HttpMessage object representing the complete request/response
1886 * history.
1887 *
1888 * The object references the last received response, use HttpMessage::getParentMessage()
1889 * to access the data of previously sent requests and received responses.
1890 *
1891 * Note that the internal history is immutable, that means that any changes
1892 * you make the the message list won't affect a history message list newly
1893 * created by another call to HttpRequest::getHistory().
1894 *
1895 * Throws HttpMalformedHeaderException, HttpEncodingException.
1896 */
1897 PHP_METHOD(HttpRequest, getHistory)
1898 {
1899 NO_ARGS;
1900
1901 IF_RETVAL_USED {
1902 http_message *msg;
1903 getObject(http_request_object, obj);
1904
1905 SET_EH_THROW_HTTP();
1906 if ((msg = http_message_parse(PHPSTR_VAL(&obj->history), PHPSTR_LEN(&obj->history)))) {
1907 ZVAL_OBJVAL(return_value, http_message_object_new_ex(http_message_object_ce, msg, NULL));
1908 }
1909 SET_EH_NORMAL();
1910 }
1911 }
1912 /* }}} */
1913
1914 /* {{{ proto void HttpRequest::clearHistory()
1915 *
1916 * Clear the history.
1917 */
1918 PHP_METHOD(HttpRequest, clearHistory)
1919 {
1920 NO_ARGS {
1921 getObject(http_request_object, obj);
1922 phpstr_dtor(&obj->history);
1923 }
1924 }
1925 /* }}} */
1926
1927 /* {{{ proto HttpMessage HttpRequest::send()
1928 *
1929 * Send the HTTP request.
1930 *
1931 * Returns the received response as HttpMessage object.
1932 *
1933 * NOTE: While an exception may be thrown, the transfer could have succeeded
1934 * at least partially, so you might want to check the return values of various
1935 * HttpRequest::getResponse*() methods.
1936 *
1937 * Throws HttpRuntimeException, HttpRequestException,
1938 * HttpMalformedHeaderException, HttpEncodingException.
1939 *
1940 * GET example:
1941 * <pre>
1942 * <?php
1943 * $r = new HttpRequest('http://example.com/feed.rss', HttpRequest::METH_GET);
1944 * $r->setOptions(array('lastmodified' => filemtime('local.rss')));
1945 * $r->addQueryData(array('category' => 3));
1946 * try {
1947 * $r->send();
1948 * if ($r->getResponseCode() == 200) {
1949 * file_put_contents('local.rss', $r->getResponseBody());
1950 * }
1951 * } catch (HttpException $ex) {
1952 * echo $ex;
1953 * }
1954 * ?>
1955 * </pre>
1956 *
1957 * POST example:
1958 * <pre>
1959 * <?php
1960 * $r = new HttpRequest('http://example.com/form.php', HttpRequest::METH_POST);
1961 * $r->setOptions(array('cookies' => array('lang' => 'de')));
1962 * $r->addPostFields(array('user' => 'mike', 'pass' => 's3c|r3t'));
1963 * $r->addPostFile('image', 'profile.jpg', 'image/jpeg');
1964 * try {
1965 * echo $r->send()->getBody();
1966 * } catch (HttpException $ex) {
1967 * echo $ex;
1968 * }
1969 * ?>
1970 * </pre>
1971 */
1972 PHP_METHOD(HttpRequest, send)
1973 {
1974 getObject(http_request_object, obj);
1975
1976 NO_ARGS;
1977
1978 SET_EH_THROW_HTTP();
1979
1980 if (obj->pool) {
1981 http_error(HE_WARNING, HTTP_E_RUNTIME, "Cannot perform HttpRequest::send() while attached to an HttpRequestPool");
1982 SET_EH_NORMAL();
1983 RETURN_FALSE;
1984 }
1985
1986 RETVAL_NULL();
1987
1988 if (SUCCESS == http_request_object_requesthandler(obj, getThis())) {
1989 http_request_exec(obj->request);
1990 if (SUCCESS == http_request_object_responsehandler(obj, getThis())) {
1991 RETVAL_OBJECT(GET_PROP(obj, responseMessage));
1992 }
1993 }
1994
1995 SET_EH_NORMAL();
1996 }
1997 /* }}} */
1998
1999 #endif /* ZEND_ENGINE_2 && HTTP_HAVE_CURL */
2000
2001 /*
2002 * Local variables:
2003 * tab-width: 4
2004 * c-basic-offset: 4
2005 * End:
2006 * vim600: noet sw=4 ts=4 fdm=marker
2007 * vim<600: noet sw=4 ts=4
2008 */
2009