projects / m6w6 / ext-http / blob
? search:


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