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