git.m6w6.name Git - m6w6/ext-http/blob - http_request_object.c

   1 /*
   2    +----------------------------------------------------------------------+
   3    | PECL :: http                                                         |
   4    +----------------------------------------------------------------------+
   5    | This source file is subject to version 3.0 of the PHP license, that  |
   6    | is bundled with this package in the file LICENSE, and is available   |
   7    | through the world-wide-web at http://www.php.net/license/3_0.txt.    |
   8    | If you did not receive a copy of the PHP license and are unable to   |
   9    | obtain it through the world-wide-web, please send a note to          |
  10    | license@php.net so we can mail you a copy immediately.               |
  11    +----------------------------------------------------------------------+
  12    | Copyright (c) 2004-2005 Michael Wallner <mike@php.net>               |
  13    +----------------------------------------------------------------------+
  14 */
  15
  16 /* $Id$ */
  17
  18
  19 #ifdef HAVE_CONFIG_H
  20 #       include "config.h"
  21 #endif
  22 #include "php.h"
  23
  24 #if defined(ZEND_ENGINE_2) && defined(HTTP_HAVE_CURL)
  25
  26 #include "php_http_std_defs.h"
  27 #include "php_http_request_object.h"
  28 #include "php_http_request_api.h"
  29 #include "php_http_request_pool_api.h"
  30 #include "php_http_api.h"
  31 #include "php_http_url_api.h"
  32 #include "php_http_message_api.h"
  33 #include "php_http_message_object.h"
  34 #include "php_http_exception_object.h"
  35
  36 #ifdef PHP_WIN32
  37 #       include <winsock2.h>
  38 #endif
  39 #include <curl/curl.h>
  40
  41 #define HTTP_BEGIN_ARGS(method, req_args)               HTTP_BEGIN_ARGS_EX(HttpRequest, method, ZEND_RETURN_REFERENCE_AGNOSTIC, req_args)
  42 #define HTTP_EMPTY_ARGS(method, ret_ref)                HTTP_EMPTY_ARGS_EX(HttpRequest, method, ret_ref)
  43 #define HTTP_REQUEST_ME(method, visibility)             PHP_ME(HttpRequest, method, HTTP_ARGS(HttpRequest, method), visibility)
  44
  45 HTTP_EMPTY_ARGS(__destruct, 0);
  46 HTTP_BEGIN_ARGS(__construct, 0)
  47         HTTP_ARG_VAL(url, 0)
  48         HTTP_ARG_VAL(method, 0)
  49 HTTP_END_ARGS;
  50
  51 HTTP_EMPTY_ARGS(getOptions, 0);
  52 HTTP_EMPTY_ARGS(unsetOptions, 0);
  53 HTTP_BEGIN_ARGS(setOptions, 1)
  54         HTTP_ARG_VAL(options, 0)
  55 HTTP_END_ARGS;
  56
  57 HTTP_EMPTY_ARGS(getSslOptions, 0);
  58 HTTP_EMPTY_ARGS(unsetSslOptions, 0);
  59 HTTP_BEGIN_ARGS(setSslOptions, 1)
  60         HTTP_ARG_VAL(ssl_options, 0)
  61 HTTP_END_ARGS;
  62
  63 HTTP_EMPTY_ARGS(getHeaders, 0);
  64 HTTP_EMPTY_ARGS(unsetHeaders, 0);
  65 HTTP_BEGIN_ARGS(addHeaders, 1)
  66         HTTP_ARG_VAL(headers, 0)
  67 HTTP_END_ARGS;
  68
  69 HTTP_EMPTY_ARGS(getCookies, 0);
  70 HTTP_EMPTY_ARGS(unsetCookies, 0);
  71 HTTP_BEGIN_ARGS(addCookies, 1)
  72         HTTP_ARG_VAL(cookies, 0)
  73 HTTP_END_ARGS;
  74
  75 HTTP_EMPTY_ARGS(getUrl, 0);
  76 HTTP_BEGIN_ARGS(setUrl, 1)
  77         HTTP_ARG_VAL(url, 0)
  78 HTTP_END_ARGS;
  79
  80 HTTP_EMPTY_ARGS(getMethod, 0);
  81 HTTP_BEGIN_ARGS(setMethod, 1)
  82         HTTP_ARG_VAL(request_method, 0)
  83 HTTP_END_ARGS;
  84
  85 HTTP_EMPTY_ARGS(getContentType, 0);
  86 HTTP_BEGIN_ARGS(setContentType, 1)
  87         HTTP_ARG_VAL(content_type, 0)
  88 HTTP_END_ARGS;
  89
  90 HTTP_EMPTY_ARGS(getQueryData, 0);
  91 HTTP_EMPTY_ARGS(unsetQueryData, 0);
  92 HTTP_BEGIN_ARGS(setQueryData, 1)
  93         HTTP_ARG_VAL(query_data, 0)
  94 HTTP_END_ARGS;
  95
  96 HTTP_BEGIN_ARGS(addQueryData, 1)
  97         HTTP_ARG_VAL(query_data, 0)
  98 HTTP_END_ARGS;
  99
 100 HTTP_EMPTY_ARGS(getPostFields, 0);
 101 HTTP_EMPTY_ARGS(unsetPostFields, 0);
 102 HTTP_BEGIN_ARGS(setPostFields, 1)
 103         HTTP_ARG_VAL(post_fields, 0)
 104 HTTP_END_ARGS;
 105
 106 HTTP_BEGIN_ARGS(addPostFields, 1)
 107         HTTP_ARG_VAL(post_fields, 0)
 108 HTTP_END_ARGS;
 109
 110 HTTP_EMPTY_ARGS(getPostFiles, 0);
 111 HTTP_EMPTY_ARGS(unsetPostFiles, 0);
 112 HTTP_BEGIN_ARGS(setPostFiles, 1)
 113         HTTP_ARG_VAL(post_files, 0)
 114 HTTP_END_ARGS;
 115
 116 HTTP_BEGIN_ARGS(addPostFile, 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(getPutFile, 0);
 123 HTTP_EMPTY_ARGS(unsetPutFile, 0);
 124 HTTP_BEGIN_ARGS(setPutFile, 1)
 125         HTTP_ARG_VAL(filename, 0)
 126 HTTP_END_ARGS;
 127
 128 HTTP_EMPTY_ARGS(getResponseData, 0);
 129 HTTP_BEGIN_ARGS(getResponseHeader, 0)
 130         HTTP_ARG_VAL(name, 0)
 131 HTTP_END_ARGS;
 132
 133 HTTP_BEGIN_ARGS(getResponseCookie, 0)
 134         HTTP_ARG_VAL(name, 0)
 135 HTTP_END_ARGS;
 136
 137 HTTP_EMPTY_ARGS(getResponseBody, 0);
 138 HTTP_EMPTY_ARGS(getResponseCode, 0);
 139 HTTP_BEGIN_ARGS(getResponseInfo, 0)
 140         HTTP_ARG_VAL(name, 0)
 141 HTTP_END_ARGS;
 142
 143 HTTP_EMPTY_ARGS(getResponseMessage, 1);
 144 HTTP_EMPTY_ARGS(send, 0);
 145
 146 #define http_request_object_declare_default_properties() _http_request_object_declare_default_properties(TSRMLS_C)
 147 static inline void _http_request_object_declare_default_properties(TSRMLS_D);
 148
 149 zend_class_entry *http_request_object_ce;
 150 zend_function_entry http_request_object_fe[] = {
 151         HTTP_REQUEST_ME(__construct, ZEND_ACC_PUBLIC|ZEND_ACC_CTOR)
 152         HTTP_REQUEST_ME(__destruct, ZEND_ACC_PUBLIC|ZEND_ACC_DTOR)
 153
 154         HTTP_REQUEST_ME(setOptions, ZEND_ACC_PUBLIC)
 155         HTTP_REQUEST_ME(getOptions, ZEND_ACC_PUBLIC)
 156         HTTP_REQUEST_ME(unsetOptions, ZEND_ACC_PUBLIC)
 157         HTTP_REQUEST_ME(setSslOptions, ZEND_ACC_PUBLIC)
 158         HTTP_REQUEST_ME(getSslOptions, ZEND_ACC_PUBLIC)
 159         HTTP_REQUEST_ME(unsetSslOptions, ZEND_ACC_PUBLIC)
 160
 161         HTTP_REQUEST_ME(addHeaders, ZEND_ACC_PUBLIC)
 162         HTTP_REQUEST_ME(getHeaders, ZEND_ACC_PUBLIC)
 163         HTTP_REQUEST_ME(unsetHeaders, ZEND_ACC_PUBLIC)
 164         HTTP_REQUEST_ME(addCookies, ZEND_ACC_PUBLIC)
 165         HTTP_REQUEST_ME(getCookies, ZEND_ACC_PUBLIC)
 166         HTTP_REQUEST_ME(unsetCookies, ZEND_ACC_PUBLIC)
 167
 168         HTTP_REQUEST_ME(setMethod, ZEND_ACC_PUBLIC)
 169         HTTP_REQUEST_ME(getMethod, ZEND_ACC_PUBLIC)
 170
 171         HTTP_REQUEST_ME(setUrl, ZEND_ACC_PUBLIC)
 172         HTTP_REQUEST_ME(getUrl, ZEND_ACC_PUBLIC)
 173
 174         HTTP_REQUEST_ME(setContentType, ZEND_ACC_PUBLIC)
 175         HTTP_REQUEST_ME(getContentType, ZEND_ACC_PUBLIC)
 176
 177         HTTP_REQUEST_ME(setQueryData, ZEND_ACC_PUBLIC)
 178         HTTP_REQUEST_ME(getQueryData, ZEND_ACC_PUBLIC)
 179         HTTP_REQUEST_ME(addQueryData, ZEND_ACC_PUBLIC)
 180         HTTP_REQUEST_ME(unsetQueryData, ZEND_ACC_PUBLIC)
 181
 182         HTTP_REQUEST_ME(setPostFields, ZEND_ACC_PUBLIC)
 183         HTTP_REQUEST_ME(getPostFields, ZEND_ACC_PUBLIC)
 184         HTTP_REQUEST_ME(addPostFields, ZEND_ACC_PUBLIC)
 185         HTTP_REQUEST_ME(unsetPostFields, ZEND_ACC_PUBLIC)
 186
 187         HTTP_REQUEST_ME(setPostFiles, ZEND_ACC_PUBLIC)
 188         HTTP_REQUEST_ME(addPostFile, ZEND_ACC_PUBLIC)
 189         HTTP_REQUEST_ME(getPostFiles, ZEND_ACC_PUBLIC)
 190         HTTP_REQUEST_ME(unsetPostFiles, ZEND_ACC_PUBLIC)
 191
 192         HTTP_REQUEST_ME(setPutFile, ZEND_ACC_PUBLIC)
 193         HTTP_REQUEST_ME(getPutFile, ZEND_ACC_PUBLIC)
 194         HTTP_REQUEST_ME(unsetPutFile, ZEND_ACC_PUBLIC)
 195
 196         HTTP_REQUEST_ME(send, ZEND_ACC_PUBLIC)
 197
 198         HTTP_REQUEST_ME(getResponseData, ZEND_ACC_PUBLIC)
 199         HTTP_REQUEST_ME(getResponseHeader, ZEND_ACC_PUBLIC)
 200         HTTP_REQUEST_ME(getResponseCookie, ZEND_ACC_PUBLIC)
 201         HTTP_REQUEST_ME(getResponseCode, ZEND_ACC_PUBLIC)
 202         HTTP_REQUEST_ME(getResponseBody, ZEND_ACC_PUBLIC)
 203         HTTP_REQUEST_ME(getResponseInfo, ZEND_ACC_PUBLIC)
 204         HTTP_REQUEST_ME(getResponseMessage, ZEND_ACC_PUBLIC)
 205
 206         {NULL, NULL, NULL}
 207 };
 208 static zend_object_handlers http_request_object_handlers;
 209
 210 void _http_request_object_init(INIT_FUNC_ARGS)
 211 {
 212         HTTP_REGISTER_CLASS_EX(HttpRequest, http_request_object, NULL, 0);
 213
 214         /* HTTP/1.1 */
 215         HTTP_LONG_CONSTANT("HTTP_GET", HTTP_GET);
 216         HTTP_LONG_CONSTANT("HTTP_HEAD", HTTP_HEAD);
 217         HTTP_LONG_CONSTANT("HTTP_POST", HTTP_POST);
 218         HTTP_LONG_CONSTANT("HTTP_PUT", HTTP_PUT);
 219         HTTP_LONG_CONSTANT("HTTP_DELETE", HTTP_DELETE);
 220         HTTP_LONG_CONSTANT("HTTP_OPTIONS", HTTP_OPTIONS);
 221         HTTP_LONG_CONSTANT("HTTP_TRACE", HTTP_TRACE);
 222         HTTP_LONG_CONSTANT("HTTP_CONNECT", HTTP_CONNECT);
 223         /* WebDAV - RFC 2518 */
 224         HTTP_LONG_CONSTANT("HTTP_PROPFIND", HTTP_PROPFIND);
 225         HTTP_LONG_CONSTANT("HTTP_PROPPATCH", HTTP_PROPPATCH);
 226         HTTP_LONG_CONSTANT("HTTP_MKCOL", HTTP_MKCOL);
 227         HTTP_LONG_CONSTANT("HTTP_COPY", HTTP_COPY);
 228         HTTP_LONG_CONSTANT("HTTP_MOVE", HTTP_MOVE);
 229         HTTP_LONG_CONSTANT("HTTP_LOCK", HTTP_LOCK);
 230         HTTP_LONG_CONSTANT("HTTP_UNLOCK", HTTP_UNLOCK);
 231         /* WebDAV Versioning - RFC 3253 */
 232         HTTP_LONG_CONSTANT("HTTP_VERSION_CONTROL", HTTP_VERSION_CONTROL);
 233         HTTP_LONG_CONSTANT("HTTP_REPORT", HTTP_REPORT);
 234         HTTP_LONG_CONSTANT("HTTP_CHECKOUT", HTTP_CHECKOUT);
 235         HTTP_LONG_CONSTANT("HTTP_CHECKIN", HTTP_CHECKIN);
 236         HTTP_LONG_CONSTANT("HTTP_UNCHECKOUT", HTTP_UNCHECKOUT);
 237         HTTP_LONG_CONSTANT("HTTP_MKWORKSPACE", HTTP_MKWORKSPACE);
 238         HTTP_LONG_CONSTANT("HTTP_UPDATE", HTTP_UPDATE);
 239         HTTP_LONG_CONSTANT("HTTP_LABEL", HTTP_LABEL);
 240         HTTP_LONG_CONSTANT("HTTP_MERGE", HTTP_MERGE);
 241         HTTP_LONG_CONSTANT("HTTP_BASELINE_CONTROL", HTTP_BASELINE_CONTROL);
 242         HTTP_LONG_CONSTANT("HTTP_MKACTIVITY", HTTP_MKACTIVITY);
 243         /* WebDAV Access Control - RFC 3744 */
 244         HTTP_LONG_CONSTANT("HTTP_ACL", HTTP_ACL);
 245
 246
 247 #       if LIBCURL_VERSION_NUM >= 0x070a05
 248         HTTP_LONG_CONSTANT("HTTP_AUTH_BASIC", CURLAUTH_BASIC);
 249         HTTP_LONG_CONSTANT("HTTP_AUTH_DIGEST", CURLAUTH_DIGEST);
 250         HTTP_LONG_CONSTANT("HTTP_AUTH_NTLM", CURLAUTH_NTLM);
 251 #       endif /* LIBCURL_VERSION_NUM */
 252 }
 253
 254 zend_object_value _http_request_object_new(zend_class_entry *ce TSRMLS_DC)
 255 {
 256         zend_object_value ov;
 257         http_request_object *o;
 258
 259         o = ecalloc(1, sizeof(http_request_object));
 260         o->zo.ce = ce;
 261         o->ch = curl_easy_init();
 262         o->pool = NULL;
 263
 264         phpstr_init_ex(&o->response, HTTP_CURLBUF_SIZE, 0);
 265
 266         ALLOC_HASHTABLE(OBJ_PROP(o));
 267         zend_hash_init(OBJ_PROP(o), 0, NULL, ZVAL_PTR_DTOR, 0);
 268         zend_hash_copy(OBJ_PROP(o), &ce->default_properties, (copy_ctor_func_t) zval_add_ref, NULL, sizeof(zval *));
 269
 270         ov.handle = zend_objects_store_put(o, (zend_objects_store_dtor_t) zend_objects_destroy_object, http_request_object_free, NULL TSRMLS_CC);
 271         ov.handlers = &http_request_object_handlers;
 272
 273         return ov;
 274 }
 275
 276 static inline void _http_request_object_declare_default_properties(TSRMLS_D)
 277 {
 278         zend_class_entry *ce = http_request_object_ce;
 279
 280         DCL_PROP_N(PROTECTED, options);
 281         DCL_PROP_N(PROTECTED, responseInfo);
 282         DCL_PROP_N(PROTECTED, responseData);
 283         DCL_PROP_N(PROTECTED, responseCode);
 284         DCL_PROP_N(PROTECTED, responseMessage);
 285         DCL_PROP_N(PROTECTED, postFields);
 286         DCL_PROP_N(PROTECTED, postFiles);
 287
 288         DCL_PROP(PROTECTED, long, method, HTTP_GET);
 289
 290         DCL_PROP(PROTECTED, string, url, "");
 291         DCL_PROP(PROTECTED, string, contentType, "");
 292         DCL_PROP(PROTECTED, string, queryData, "");
 293         DCL_PROP(PROTECTED, string, putFile, "");
 294 }
 295
 296 void _http_request_object_free(zend_object *object TSRMLS_DC)
 297 {
 298         http_request_object *o = (http_request_object *) object;
 299
 300         if (OBJ_PROP(o)) {
 301                 zend_hash_destroy(OBJ_PROP(o));
 302                 FREE_HASHTABLE(OBJ_PROP(o));
 303         }
 304         if (o->ch) {
 305                 curl_easy_cleanup(o->ch);
 306         }
 307         phpstr_dtor(&o->response);
 308         efree(o);
 309 }
 310
 311 STATUS _http_request_object_requesthandler(http_request_object *obj, zval *this_ptr, http_request_body *body TSRMLS_DC)
 312 {
 313         zval *meth, *URL, *qdata, *opts;
 314         char *request_uri;
 315         STATUS status;
 316
 317         if (!body) {
 318                 return FAILURE;
 319         }
 320         if ((!obj->ch) && (!(obj->ch = curl_easy_init()))) {
 321                 http_error(E_WARNING, HTTP_E_CURL, "Could not initilaize curl");
 322                 return FAILURE;
 323         }
 324
 325         meth  = GET_PROP(obj, method);
 326         URL   = GET_PROP(obj, url);
 327         qdata = GET_PROP(obj, queryData);
 328         opts  = GET_PROP(obj, options);
 329
 330         // HTTP_URI_MAXLEN+1 long char *
 331         if (!(request_uri = http_absolute_uri_ex(Z_STRVAL_P(URL), Z_STRLEN_P(URL), NULL, 0, NULL, 0, 0))) {
 332                 return FAILURE;
 333         }
 334
 335         if (Z_STRLEN_P(qdata) && (strlen(request_uri) < HTTP_URI_MAXLEN)) {
 336                 if (!strchr(request_uri, '?')) {
 337                         strcat(request_uri, "?");
 338                 } else {
 339                         strcat(request_uri, "&");
 340                 }
 341                 strncat(request_uri, Z_STRVAL_P(qdata), HTTP_URI_MAXLEN - strlen(request_uri));
 342         }
 343
 344         switch (Z_LVAL_P(meth))
 345         {
 346                 case HTTP_GET:
 347                 case HTTP_HEAD:
 348                         body->type = -1;
 349                         status = http_request_init(obj->ch, Z_LVAL_P(meth), request_uri, NULL, Z_ARRVAL_P(opts), &obj->response);
 350                 break;
 351
 352                 case HTTP_PUT:
 353                 {
 354                         php_stream *stream;
 355                         php_stream_statbuf ssb;
 356                         zval *file = GET_PROP(obj, putFile);
 357
 358                         if (    (stream = php_stream_open_wrapper(Z_STRVAL_P(file), "rb", REPORT_ERRORS|ENFORCE_SAFE_MODE, NULL)) &&
 359                                         !php_stream_stat(stream, &ssb)) {
 360                                 body->type = HTTP_REQUEST_BODY_UPLOADFILE;
 361                                 body->data = stream;
 362                                 body->size = ssb.sb.st_size;
 363
 364                                 status = http_request_init(obj->ch, HTTP_PUT, request_uri, body, Z_ARRVAL_P(opts), &obj->response);
 365                         } else {
 366                                 status = FAILURE;
 367                         }
 368                 }
 369                 break;
 370
 371                 case HTTP_POST:
 372                 {
 373                         zval *fields = GET_PROP(obj, postFields), *files = GET_PROP(obj, postFiles);
 374
 375                         if (SUCCESS == (status = http_request_body_fill(body, Z_ARRVAL_P(fields), Z_ARRVAL_P(files)))) {
 376                                 status = http_request_init(obj->ch, HTTP_POST, request_uri, body, Z_ARRVAL_P(opts), &obj->response);
 377                         }
 378                 }
 379                 break;
 380
 381                 default:
 382                 {
 383                         zval *post = GET_PROP(obj, postData);
 384
 385                         body->type = HTTP_REQUEST_BODY_CSTRING;
 386                         body->data = Z_STRVAL_P(post);
 387                         body->size = Z_STRLEN_P(post);
 388
 389                         status = http_request_init(obj->ch, Z_LVAL_P(meth), request_uri, body, Z_ARRVAL_P(opts), &obj->response);
 390                 }
 391                 break;
 392         }
 393
 394         efree(request_uri);
 395         return status;
 396 }
 397
 398 STATUS _http_request_object_responsehandler(http_request_object *obj, zval *this_ptr TSRMLS_DC)
 399 {
 400         http_message *msg;
 401
 402         phpstr_fix(&obj->response);
 403
 404         if (msg = http_message_parse(PHPSTR_VAL(&obj->response), PHPSTR_LEN(&obj->response))) {
 405                 char *body;
 406                 size_t body_len;
 407                 zval *headers, *message, *resp = GET_PROP(obj, responseData), *info = GET_PROP(obj, responseInfo);
 408
 409                 UPD_PROP(obj, long, responseCode, msg->info.response.code);
 410
 411                 MAKE_STD_ZVAL(headers)
 412                 array_init(headers);
 413
 414                 zend_hash_copy(Z_ARRVAL_P(headers), &msg->hdrs, (copy_ctor_func_t) zval_add_ref, NULL, sizeof(zval *));
 415                 phpstr_data(PHPSTR(msg), &body, &body_len);
 416
 417                 add_assoc_zval(resp, "headers", headers);
 418                 add_assoc_stringl(resp, "body", body, body_len, 0);
 419
 420                 MAKE_STD_ZVAL(message);
 421                 message->type = IS_OBJECT;
 422                 message->is_ref = 1;
 423                 message->value.obj = http_message_object_from_msg(msg);
 424                 SET_PROP(obj, responseMessage, message);
 425                 zval_ptr_dtor(&message);
 426
 427                 http_request_info(obj->ch, Z_ARRVAL_P(info));
 428                 SET_PROP(obj, responseInfo, info);
 429
 430                 return SUCCESS;
 431         }
 432         return FAILURE;
 433 }
 434
 435 /* ### USERLAND ### */
 436
 437 /* {{{ proto void HttpRequest::__construct([string url[, long request_method = HTTP_GET]])
 438  *
 439  * Instantiate a new HttpRequest object which can be used to issue HEAD, GET
 440  * and POST (including posting files) HTTP requests.
 441  */
 442 PHP_METHOD(HttpRequest, __construct)
 443 {
 444         char *URL = NULL;
 445         int URL_len;
 446         long meth = -1;
 447         getObject(http_request_object, obj);
 448
 449         SET_EH_THROW_HTTP();
 450         if (SUCCESS == zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "|sl", &URL, &URL_len, &meth)) {
 451                 INIT_PARR(obj, options);
 452                 INIT_PARR(obj, responseInfo);
 453                 INIT_PARR(obj, responseData);
 454                 INIT_PARR(obj, postFields);
 455                 INIT_PARR(obj, postFiles);
 456
 457                 if (URL) {
 458                         UPD_PROP(obj, string, url, URL);
 459                 }
 460                 if (meth > -1) {
 461                         UPD_PROP(obj, long, method, meth);
 462                 }
 463         }
 464         SET_EH_NORMAL();
 465 }
 466 /* }}} */
 467
 468 /* {{{ proto void HttpRequest::__destruct()
 469  *
 470  * Destroys the HttpRequest object.
 471  */
 472 PHP_METHOD(HttpRequest, __destruct)
 473 {
 474         getObject(http_request_object, obj);
 475
 476         NO_ARGS;
 477
 478         FREE_PARR(obj, options);
 479         FREE_PARR(obj, responseInfo);
 480         FREE_PARR(obj, responseData);
 481         FREE_PARR(obj, postFields);
 482         FREE_PARR(obj, postFiles);
 483 }
 484 /* }}} */
 485
 486 /* {{{ proto bool HttpRequest::setOptions(array options)
 487  *
 488  * Set the request options to use.  See http_get() for a full list of available options.
 489  */
 490 PHP_METHOD(HttpRequest, setOptions)
 491 {
 492         char *key = NULL;
 493         ulong idx = 0;
 494         zval *opts, *old_opts, **opt;
 495         getObject(http_request_object, obj);
 496
 497         if (SUCCESS != zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "a/", &opts)) {
 498                 RETURN_FALSE;
 499         }
 500
 501         old_opts = GET_PROP(obj, options);
 502
 503         /* headers and cookies need extra attention -- thus cannot use array_merge() directly */
 504         FOREACH_KEYVAL(opts, key, idx, opt) {
 505                 if (key) {
 506                         if (!strcmp(key, "headers")) {
 507                                 zval **headers;
 508                                 if (SUCCESS == zend_hash_find(Z_ARRVAL_P(old_opts), "headers", sizeof("headers"), (void **) &headers)) {
 509                                         array_merge(*opt, *headers);
 510                                         continue;
 511                                 }
 512                         } else if (!strcmp(key, "cookies")) {
 513                                 zval **cookies;
 514                                 if (SUCCESS == zend_hash_find(Z_ARRVAL_P(old_opts), "cookies", sizeof("cookies"), (void **) &cookies)) {
 515                                         array_merge(*opt, *cookies);
 516                                         continue;
 517                                 }
 518                         }
 519                         zval_add_ref(opt);
 520                         add_assoc_zval(old_opts, key, *opt);
 521
 522                         /* reset */
 523                         key = NULL;
 524                 }
 525         }
 526
 527         RETURN_TRUE;
 528 }
 529 /* }}} */
 530
 531 /* {{{ proto array HttpRequest::getOptions()
 532  *
 533  * Get current set options.
 534  */
 535 PHP_METHOD(HttpRequest, getOptions)
 536 {
 537         NO_ARGS;
 538
 539         IF_RETVAL_USED {
 540                 zval *opts;
 541                 getObject(http_request_object, obj);
 542
 543                 opts = GET_PROP(obj, options);
 544                 array_init(return_value);
 545                 array_copy(opts, return_value);
 546         }
 547 }
 548 /* }}} */
 549
 550 /* {{{ proto void HttpRequest::unsetOptions()
 551  *
 552  * Unset all options/headers/cookies.
 553  */
 554 PHP_METHOD(HttpRequest, unsetOptions)
 555 {
 556         getObject(http_request_object, obj);
 557
 558         NO_ARGS;
 559
 560         FREE_PARR(obj, options);
 561         INIT_PARR(obj, options);
 562 }
 563 /* }}} */
 564
 565 /* {{{ proto bool HttpRequest::setSslOptions(array options)
 566  *
 567  * Set additional SSL options.
 568  */
 569 PHP_METHOD(HttpRequest, setSslOptions)
 570 {
 571         zval *opts, *old_opts, **ssl_options;
 572         getObject(http_request_object, obj);
 573
 574         if (SUCCESS != zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "a/", &opts)) {
 575                 RETURN_FALSE;
 576         }
 577
 578         old_opts = GET_PROP(obj, options);
 579
 580         if (SUCCESS == zend_hash_find(Z_ARRVAL_P(old_opts), "ssl", sizeof("ssl"), (void **) &ssl_options)) {
 581                 array_merge(opts, *ssl_options);
 582         } else {
 583                 zval_add_ref(&opts);
 584                 add_assoc_zval(old_opts, "ssl", opts);
 585         }
 586
 587         RETURN_TRUE;
 588 }
 589 /* }}} */
 590
 591 /* {{{ proto array HttpRequest::getSslOtpions()
 592  *
 593  * Get previously set SSL options.
 594  */
 595 PHP_METHOD(HttpRequest, getSslOptions)
 596 {
 597         NO_ARGS;
 598
 599         IF_RETVAL_USED {
 600                 zval *opts, **ssl_options;
 601                 getObject(http_request_object, obj);
 602
 603                 opts = GET_PROP(obj, options);
 604
 605                 array_init(return_value);
 606
 607                 if (SUCCESS == zend_hash_find(Z_ARRVAL_P(opts), "ssl", sizeof("ssl"), (void **) &ssl_options)) {
 608                         array_copy(*ssl_options, return_value);
 609                 }
 610         }
 611 }
 612 /* }}} */
 613
 614 /* {{{ proto void HttpRequest::unsetSslOptions()
 615  *
 616  * Unset previously set SSL options.
 617  */
 618 PHP_METHOD(HttpRequest, unsetSslOptions)
 619 {
 620         zval *opts;
 621         getObject(http_request_object, obj);
 622
 623         NO_ARGS;
 624
 625         opts = GET_PROP(obj, options);
 626         zend_hash_del(Z_ARRVAL_P(opts), "ssl", sizeof("ssl"));
 627 }
 628 /* }}} */
 629
 630 /* {{{ proto bool HttpRequest::addHeaders(array headers)
 631  *
 632  * Add request header name/value pairs.
 633  */
 634 PHP_METHOD(HttpRequest, addHeaders)
 635 {
 636         zval *opts, **headers, *new_headers;
 637         getObject(http_request_object, obj);
 638
 639         if (SUCCESS != zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "a/", &new_headers)) {
 640                 RETURN_FALSE;
 641         }
 642
 643         opts = GET_PROP(obj, options);
 644
 645         if (SUCCESS == zend_hash_find(Z_ARRVAL_P(opts), "headers", sizeof("headers"), (void **) &headers)) {
 646                 array_merge(new_headers, *headers);
 647         } else {
 648                 zval_add_ref(&new_headers);
 649                 add_assoc_zval(opts, "headers", new_headers);
 650         }
 651
 652         RETURN_TRUE;
 653 }
 654 /* }}} */
 655
 656 /* {{{ proto array HttpRequest::getHeaders()
 657  *
 658  * Get previously set request headers.
 659  */
 660 PHP_METHOD(HttpRequest, getHeaders)
 661 {
 662         NO_ARGS;
 663
 664         IF_RETVAL_USED {
 665                 zval *opts, **headers;
 666                 getObject(http_request_object, obj);
 667
 668                 opts = GET_PROP(obj, options);
 669
 670                 array_init(return_value);
 671
 672                 if (SUCCESS == zend_hash_find(Z_ARRVAL_P(opts), "headers", sizeof("headers"), (void **) &headers)) {
 673                         array_copy(*headers, return_value);
 674                 }
 675         }
 676 }
 677 /* }}} */
 678
 679 /* {{{ proto void HttpRequest::unsetHeaders()
 680  *
 681  * Unset previously set request headers.
 682  */
 683 PHP_METHOD(HttpRequest, unsetHeaders)
 684 {
 685         zval *opts;
 686         getObject(http_request_object, obj);
 687
 688         NO_ARGS;
 689
 690         opts = GET_PROP(obj, options);
 691         zend_hash_del(Z_ARRVAL_P(opts), "headers", sizeof("headers"));
 692 }
 693 /* }}} */
 694
 695 /* {{{ proto bool HttpRequest::addCookies(array cookies)
 696  *
 697  * Add cookies.
 698  */
 699 PHP_METHOD(HttpRequest, addCookies)
 700 {
 701         zval *opts, **cookies, *new_cookies;
 702         getObject(http_request_object, obj);
 703
 704         if (SUCCESS != zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "a/", &new_cookies)) {
 705                 RETURN_FALSE;
 706         }
 707
 708         opts = GET_PROP(obj, options);
 709
 710         if (SUCCESS == zend_hash_find(Z_ARRVAL_P(opts), "cookies", sizeof("cookies"), (void **) &cookies)) {
 711                 array_merge(new_cookies, *cookies);
 712         } else {
 713                 zval_add_ref(&new_cookies);
 714                 add_assoc_zval(opts, "cookies", new_cookies);
 715         }
 716
 717         RETURN_TRUE;
 718 }
 719 /* }}} */
 720
 721 /* {{{ proto array HttpRequest::getCookies()
 722  *
 723  * Get previously set cookies.
 724  */
 725 PHP_METHOD(HttpRequest, getCookies)
 726 {
 727         NO_ARGS;
 728
 729         IF_RETVAL_USED {
 730                 zval *opts, **cookies;
 731                 getObject(http_request_object, obj);
 732
 733                 opts = GET_PROP(obj, options);
 734
 735                 array_init(return_value);
 736
 737                 if (SUCCESS == zend_hash_find(Z_ARRVAL_P(opts), "cookies", sizeof("cookies"), (void **) &cookies)) {
 738                         array_copy(*cookies, return_value);
 739                 }
 740         }
 741 }
 742 /* }}} */
 743
 744 /* {{{ proto void HttpRequest::unsetCookies()
 745  *
 746  */
 747 PHP_METHOD(HttpRequest, unsetCookies)
 748 {
 749         zval *opts;
 750         getObject(http_request_object, obj);
 751
 752         NO_ARGS;
 753
 754         opts = GET_PROP(obj, options);
 755         zend_hash_del(Z_ARRVAL_P(opts), "cookies", sizeof("cookies"));
 756 }
 757 /* }}} */
 758
 759 /* {{{ proto bool HttpRequest::setUrl(string url)
 760  *
 761  * Set the request URL.
 762  */
 763 PHP_METHOD(HttpRequest, setUrl)
 764 {
 765         char *URL = NULL;
 766         int URL_len;
 767         getObject(http_request_object, obj);
 768
 769         if (SUCCESS != zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "s", &URL, &URL_len)) {
 770                 RETURN_FALSE;
 771         }
 772
 773         UPD_PROP(obj, string, url, URL);
 774         RETURN_TRUE;
 775 }
 776 /* }}} */
 777
 778 /* {{{ proto string HttpRequest::getUrl()
 779  *
 780  * Get the previously set request URL.
 781  */
 782 PHP_METHOD(HttpRequest, getUrl)
 783 {
 784         NO_ARGS;
 785
 786         IF_RETVAL_USED {
 787                 zval *URL;
 788                 getObject(http_request_object, obj);
 789
 790                 URL = GET_PROP(obj, url);
 791                 RETURN_STRINGL(Z_STRVAL_P(URL), Z_STRLEN_P(URL), 1);
 792         }
 793 }
 794 /* }}} */
 795
 796 /* {{{ proto bool HttpRequest::setMethod(long request_method)
 797  *
 798  * Set the request methods; one of the <tt>HTTP_HEAD</tt>, <tt>HTTP_GET</tt> or
 799  * <tt>HTTP_POST</tt> constants.
 800  */
 801 PHP_METHOD(HttpRequest, setMethod)
 802 {
 803         long meth;
 804         getObject(http_request_object, obj);
 805
 806         if (SUCCESS != zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "l", &meth)) {
 807                 RETURN_FALSE;
 808         }
 809
 810         UPD_PROP(obj, long, method, meth);
 811         RETURN_TRUE;
 812 }
 813 /* }}} */
 814
 815 /* {{{ proto long HttpRequest::getMethod()
 816  *
 817  * Get the previously set request method.
 818  */
 819 PHP_METHOD(HttpRequest, getMethod)
 820 {
 821         NO_ARGS;
 822
 823         IF_RETVAL_USED {
 824                 zval *meth;
 825                 getObject(http_request_object, obj);
 826
 827                 meth = GET_PROP(obj, method);
 828                 RETURN_LONG(Z_LVAL_P(meth));
 829         }
 830 }
 831 /* }}} */
 832
 833 /* {{{ proto bool HttpRequest::setContentType(string content_type)
 834  *
 835  * Set the content type the post request should have.
 836  * Use this only if you know what you're doing.
 837  */
 838 PHP_METHOD(HttpRequest, setContentType)
 839 {
 840         char *ctype;
 841         int ct_len;
 842         getObject(http_request_object, obj);
 843
 844         if (SUCCESS != zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "s", &ctype, &ct_len)) {
 845                 RETURN_FALSE;
 846         }
 847
 848         if (!strchr(ctype, '/')) {
 849                 http_error_ex(E_WARNING, HTTP_E_PARAM, "Content-Type '%s' doesn't seem to contain a primary and a secondary part", ctype);
 850                 RETURN_FALSE;
 851         }
 852
 853         UPD_PROP(obj, string, contentType, ctype);
 854         RETURN_TRUE;
 855 }
 856 /* }}} */
 857
 858 /* {{{ proto string HttpRequest::getContentType()
 859  *
 860  * Get the previously content type.
 861  */
 862 PHP_METHOD(HttpRequest, getContentType)
 863 {
 864         NO_ARGS;
 865
 866         IF_RETVAL_USED {
 867                 zval *ctype;
 868                 getObject(http_request_object, obj);
 869
 870                 ctype = GET_PROP(obj, contentType);
 871                 RETURN_STRINGL(Z_STRVAL_P(ctype), Z_STRLEN_P(ctype), 1);
 872         }
 873 }
 874 /* }}} */
 875
 876 /* {{{ proto bool HttpRequest::setQueryData(mixed query_data)
 877  *
 878  * Set the URL query parameters to use.
 879  * Overwrites previously set query parameters.
 880  * Affects any request types.
 881  */
 882 PHP_METHOD(HttpRequest, setQueryData)
 883 {
 884         zval *qdata;
 885         char *query_data = NULL;
 886         getObject(http_request_object, obj);
 887
 888         if (SUCCESS != zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "z", &qdata)) {
 889                 RETURN_FALSE;
 890         }
 891
 892         if ((Z_TYPE_P(qdata) == IS_ARRAY) || (Z_TYPE_P(qdata) == IS_OBJECT)) {
 893                 if (SUCCESS != http_urlencode_hash(HASH_OF(qdata), &query_data)) {
 894                         RETURN_FALSE;
 895                 }
 896                 UPD_PROP(obj, string, queryData, query_data);
 897                 efree(query_data);
 898                 RETURN_TRUE;
 899         }
 900
 901         convert_to_string(qdata);
 902         UPD_PROP(obj, string, queryData, Z_STRVAL_P(qdata));
 903         RETURN_TRUE;
 904 }
 905 /* }}} */
 906
 907 /* {{{ proto string HttpRequest::getQueryData()
 908  *
 909  * Get the current query data in form of an urlencoded query string.
 910  */
 911 PHP_METHOD(HttpRequest, getQueryData)
 912 {
 913         NO_ARGS;
 914
 915         IF_RETVAL_USED {
 916                 zval *qdata;
 917                 getObject(http_request_object, obj);
 918
 919                 qdata = GET_PROP(obj, queryData);
 920                 RETURN_STRINGL(Z_STRVAL_P(qdata), Z_STRLEN_P(qdata), 1);
 921         }
 922 }
 923 /* }}} */
 924
 925 /* {{{ proto bool HttpRequest::addQueryData(array query_params)
 926  *
 927  * Add parameters to the query parameter list.
 928  * Affects any request type.
 929  */
 930 PHP_METHOD(HttpRequest, addQueryData)
 931 {
 932         zval *qdata, *old_qdata;
 933         char *query_data = NULL;
 934         getObject(http_request_object, obj);
 935
 936         if (SUCCESS != zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "a", &qdata)) {
 937                 RETURN_FALSE;
 938         }
 939
 940         old_qdata = GET_PROP(obj, queryData);
 941
 942         if (SUCCESS != http_urlencode_hash_ex(HASH_OF(qdata), 1, Z_STRVAL_P(old_qdata), Z_STRLEN_P(old_qdata), &query_data, NULL)) {
 943                 RETURN_FALSE;
 944         }
 945
 946         UPD_PROP(obj, string, queryData, query_data);
 947         efree(query_data);
 948
 949         RETURN_TRUE;
 950 }
 951 /* }}} */
 952
 953 /* {{{ proto void HttpRequest::unsetQueryData()
 954  *
 955  * Clean the query parameters.
 956  * Affects any request type.
 957  */
 958 PHP_METHOD(HttpRequest, unsetQueryData)
 959 {
 960         getObject(http_request_object, obj);
 961
 962         NO_ARGS;
 963
 964         UPD_PROP(obj, string, queryData, "");
 965 }
 966 /* }}} */
 967
 968 /* {{{ proto bool HttpRequest::addPostFields(array post_data)
 969  *
 970  * Adds POST data entries.
 971  * Affects only POST requests.
 972  */
 973 PHP_METHOD(HttpRequest, addPostFields)
 974 {
 975         zval *post, *post_data;
 976         getObject(http_request_object, obj);
 977
 978         if (SUCCESS != zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "a", &post_data)) {
 979                 RETURN_FALSE;
 980         }
 981
 982         post = GET_PROP(obj, postFields);
 983         array_merge(post_data, post);
 984
 985         RETURN_TRUE;
 986 }
 987 /* }}} */
 988
 989 /* {{{ proto bool HttpRequest::setPostFields(array post_data)
 990  *
 991  * Set the POST data entries.
 992  * Overwrites previously set POST data.
 993  * Affects only POST requests.
 994  */
 995 PHP_METHOD(HttpRequest, setPostFields)
 996 {
 997         zval *post, *post_data;
 998         getObject(http_request_object, obj);
 999
1000         if (SUCCESS != zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "a", &post_data)) {
1001                 RETURN_FALSE;
1002         }
1003
1004         post = GET_PROP(obj, postFields);
1005         zend_hash_clean(Z_ARRVAL_P(post));
1006         array_copy(post_data, post);
1007
1008         RETURN_TRUE;
1009 }
1010 /* }}}*/
1011
1012 /* {{{ proto array HttpRequest::getPostFields()
1013  *
1014  * Get previously set POST data.
1015  */
1016 PHP_METHOD(HttpRequest, getPostFields)
1017 {
1018         NO_ARGS;
1019
1020         IF_RETVAL_USED {
1021                 zval *post_data;
1022                 getObject(http_request_object, obj);
1023
1024                 post_data = GET_PROP(obj, postFields);
1025                 array_init(return_value);
1026                 array_copy(post_data, return_value);
1027         }
1028 }
1029 /* }}} */
1030
1031 /* {{{ proto void HttpRequest::unsetPostFields()
1032  *
1033  * Clean POST data entires.
1034  * Affects only POST requests.
1035  */
1036 PHP_METHOD(HttpRequest, unsetPostFields)
1037 {
1038         zval *post_data;
1039         getObject(http_request_object, obj);
1040
1041         NO_ARGS;
1042
1043         post_data = GET_PROP(obj, postFields);
1044         zend_hash_clean(Z_ARRVAL_P(post_data));
1045 }
1046 /* }}} */
1047
1048 /* {{{ proto bool HttpRequest::addPostFile(string name, string file[, string content_type = "application/x-octetstream"])
1049  *
1050  * Add a file to the POST request.
1051  * Affects only POST requests.
1052  */
1053 PHP_METHOD(HttpRequest, addPostFile)
1054 {
1055         zval *files, *entry;
1056         char *name, *file, *type = NULL;
1057         int name_len, file_len, type_len = 0;
1058         getObject(http_request_object, obj);
1059
1060         if (SUCCESS != zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "ss|s", &name, &name_len, &file, &file_len, &type, &type_len)) {
1061                 RETURN_FALSE;
1062         }
1063
1064         if (type_len) {
1065                 if (!strchr(type, '/')) {
1066                         http_error_ex(E_WARNING, HTTP_E_PARAM, "Content-Type '%s' doesn't seem to contain a primary and a secondary part", type);
1067                         RETURN_FALSE;
1068                 }
1069         } else {
1070                 type = "application/x-octetstream";
1071                 type_len = sizeof("application/x-octetstream") - 1;
1072         }
1073
1074         MAKE_STD_ZVAL(entry);
1075         array_init(entry);
1076
1077         add_assoc_stringl(entry, "name", name, name_len, 1);
1078         add_assoc_stringl(entry, "type", type, type_len, 1);
1079         add_assoc_stringl(entry, "file", file, file_len, 1);
1080
1081         files  = GET_PROP(obj, postFiles);
1082         add_next_index_zval(files, entry);
1083
1084         RETURN_TRUE;
1085 }
1086 /* }}} */
1087
1088 /* {{{ proto bool HttpRequest::setPostFiles(array post_files)
1089  *
1090  * Set files to post.
1091  * Overwrites previously set post files.
1092  * Affects only POST requests.
1093  */
1094 PHP_METHOD(HttpRequest, setPostFiles)
1095 {
1096         zval *files, *pFiles;
1097         getObject(http_request_object, obj);
1098
1099         if (SUCCESS != zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "a", &files)) {
1100                 RETURN_FALSE;
1101         }
1102
1103         pFiles = GET_PROP(obj, postFiles);
1104         zend_hash_clean(Z_ARRVAL_P(pFiles));
1105         array_copy(files, pFiles);
1106
1107         RETURN_TRUE;
1108 }
1109 /* }}} */
1110
1111 /* {{{ proto array HttpRequest::getPostFiles()
1112  *
1113  * Get all previously added POST files.
1114  */
1115 PHP_METHOD(HttpRequest, getPostFiles)
1116 {
1117         NO_ARGS;
1118
1119         IF_RETVAL_USED {
1120                 zval *files;
1121                 getObject(http_request_object, obj);
1122
1123                 files = GET_PROP(obj, postFiles);
1124
1125                 array_init(return_value);
1126                 array_copy(files, return_value);
1127         }
1128 }
1129 /* }}} */
1130
1131 /* {{{ proto void HttpRequest::unsetPostFiles()
1132  *
1133  * Unset the POST files list.
1134  * Affects only POST requests.
1135  */
1136 PHP_METHOD(HttpRequest, unsetPostFiles)
1137 {
1138         zval *files;
1139         getObject(http_request_object, obj);
1140
1141         NO_ARGS;
1142
1143         files = GET_PROP(obj, postFiles);
1144         zend_hash_clean(Z_ARRVAL_P(files));
1145 }
1146 /* }}} */
1147
1148 /* {{{ proto bool HttpRequest::SetPutFile(string file)
1149  *
1150  * Set file to put.
1151  * Affects only PUT requests.
1152  */
1153 PHP_METHOD(HttpRequest, setPutFile)
1154 {
1155         char *file;
1156         int file_len;
1157         getObject(http_request_object, obj);
1158
1159         if (SUCCESS != zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "s", &file, &file_len)) {
1160                 RETURN_FALSE;
1161         }
1162
1163         UPD_PROP(obj, string, putFile, file);
1164         RETURN_TRUE;
1165 }
1166 /* }}} */
1167
1168 /* {{{ proto string HttpRequest::getPutFile()
1169  *
1170  * Get previously set put file.
1171  */
1172 PHP_METHOD(HttpRequest, getPutFile)
1173 {
1174         NO_ARGS;
1175
1176         IF_RETVAL_USED {
1177                 zval *putfile;
1178                 getObject(http_request_object, obj);
1179
1180                 putfile = GET_PROP(obj, putFile);
1181                 RETVAL_STRINGL(Z_STRVAL_P(putfile), Z_STRLEN_P(putfile), 1);
1182         }
1183 }
1184 /* }}} */
1185
1186 /* {{{ proto void HttpRequest::unsetPutFile()
1187  *
1188  * Unset file to put.
1189  * Affects only PUT requests.
1190  */
1191 PHP_METHOD(HttpRequest, unsetPutFile)
1192 {
1193         getObject(http_request_object, obj);
1194
1195         NO_ARGS;
1196
1197         UPD_PROP(obj, string, putFile, "");
1198 }
1199 /* }}} */
1200
1201 /* {{{ proto array HttpRequest::getResponseData()
1202  *
1203  * Get all response data after the request has been sent.
1204  */
1205 PHP_METHOD(HttpRequest, getResponseData)
1206 {
1207         NO_ARGS;
1208
1209         IF_RETVAL_USED {
1210                 zval *data;
1211                 getObject(http_request_object, obj);
1212
1213                 data = GET_PROP(obj, responseData);
1214                 array_init(return_value);
1215                 array_copy(data, return_value);
1216         }
1217 }
1218 /* }}} */
1219
1220 /* {{{ proto mixed HttpRequest::getResponseHeader([string name])
1221  *
1222  * Get response header(s) after the request has been sent.
1223  */
1224 PHP_METHOD(HttpRequest, getResponseHeader)
1225 {
1226         IF_RETVAL_USED {
1227                 zval *data, **headers, **header;
1228                 char *header_name = NULL;
1229                 int header_len = 0;
1230                 getObject(http_request_object, obj);
1231
1232                 if (SUCCESS != zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "|s", &header_name, &header_len)) {
1233                         RETURN_FALSE;
1234                 }
1235
1236                 data = GET_PROP(obj, responseData);
1237                 if (SUCCESS != zend_hash_find(Z_ARRVAL_P(data), "headers", sizeof("headers"), (void **) &headers)) {
1238                         RETURN_FALSE;
1239                 }
1240
1241                 if (!header_len || !header_name) {
1242                         array_init(return_value);
1243                         array_copy(*headers, return_value);
1244                 } else if (SUCCESS == zend_hash_find(Z_ARRVAL_PP(headers), pretty_key(header_name, header_len, 1, 1), header_len + 1, (void **) &header)) {
1245                         RETURN_STRINGL(Z_STRVAL_PP(header), Z_STRLEN_PP(header), 1);
1246                 } else {
1247                         RETURN_FALSE;
1248                 }
1249         }
1250 }
1251 /* }}} */
1252
1253 /* {{{ proto array HttpRequest::getResponseCookie([string name])
1254  *
1255  * Get response cookie(s) after the request has been sent.
1256  */
1257 PHP_METHOD(HttpRequest, getResponseCookie)
1258 {
1259         IF_RETVAL_USED {
1260                 zval *data, **headers;
1261                 char *cookie_name = NULL;
1262                 int cookie_len = 0;
1263                 getObject(http_request_object, obj);
1264
1265                 if (SUCCESS != zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "|s", &cookie_name, &cookie_len)) {
1266                         RETURN_FALSE;
1267                 }
1268
1269                 array_init(return_value);
1270
1271                 data = GET_PROP(obj, responseData);
1272                 if (SUCCESS == zend_hash_find(Z_ARRVAL_P(data), "headers", sizeof("headers"), (void **) &headers)) {
1273                         ulong idx = 0;
1274                         char *key = NULL;
1275                         zval **header = NULL;
1276
1277                         FOREACH_HASH_KEYVAL(Z_ARRVAL_PP(headers), key, idx, header) {
1278                                 if (key && !strcasecmp(key, "Set-Cookie")) {
1279                                         /* several cookies? */
1280                                         if (Z_TYPE_PP(header) == IS_ARRAY) {
1281                                                 zval **cookie;
1282
1283                                                 FOREACH_HASH_VAL(Z_ARRVAL_PP(header), cookie) {
1284                                                         zval *cookie_hash;
1285                                                         MAKE_STD_ZVAL(cookie_hash);
1286                                                         array_init(cookie_hash);
1287
1288                                                         if (SUCCESS == http_parse_cookie(Z_STRVAL_PP(cookie), Z_ARRVAL_P(cookie_hash))) {
1289                                                                 if (!cookie_len) {
1290                                                                         add_next_index_zval(return_value, cookie_hash);
1291                                                                 } else {
1292                                                                         zval **name;
1293
1294                                                                         if (    (SUCCESS == zend_hash_find(Z_ARRVAL_P(cookie_hash), "name", sizeof("name"), (void **) &name)) &&
1295                                                                                         (!strcmp(Z_STRVAL_PP(name), cookie_name))) {
1296                                                                                 add_next_index_zval(return_value, cookie_hash);
1297                                                                                 return; /* <<< FOUND >>> */
1298                                                                         } else {
1299                                                                                 zval_dtor(cookie_hash);
1300                                                                                 efree(cookie_hash);
1301                                                                         }
1302                                                                 }
1303                                                         } else {
1304                                                                 zval_dtor(cookie_hash);
1305                                                                 efree(cookie_hash);
1306                                                         }
1307                                                 }
1308                                         } else {
1309                                                 zval *cookie_hash;
1310                                                 MAKE_STD_ZVAL(cookie_hash);
1311                                                 array_init(cookie_hash);
1312
1313                                                 if (SUCCESS == http_parse_cookie(Z_STRVAL_PP(header), Z_ARRVAL_P(cookie_hash))) {
1314                                                         if (!cookie_len) {
1315                                                                 add_next_index_zval(return_value, cookie_hash);
1316                                                         } else {
1317                                                                 zval **name;
1318
1319                                                                 if (    (SUCCESS == zend_hash_find(Z_ARRVAL_P(cookie_hash), "name", sizeof("name"), (void **) &name)) &&
1320                                                                                 (!strcmp(Z_STRVAL_PP(name), cookie_name))) {
1321                                                                         add_next_index_zval(return_value, cookie_hash);
1322                                                                 } else {
1323                                                                         zval_dtor(cookie_hash);
1324                                                                         efree(cookie_hash);
1325                                                                 }
1326                                                         }
1327                                                 } else {
1328                                                         zval_dtor(cookie_hash);
1329                                                         efree(cookie_hash);
1330                                                 }
1331                                         }
1332                                         break;
1333                                 }
1334                                 /* reset key */
1335                                 key = NULL;
1336                         }
1337                 }
1338         }
1339 }
1340 /* }}} */
1341
1342 /* {{{ proto string HttpRequest::getResponseBody()
1343  *
1344  * Get the response body after the request has been sent.
1345  */
1346 PHP_METHOD(HttpRequest, getResponseBody)
1347 {
1348         NO_ARGS;
1349
1350         IF_RETVAL_USED {
1351                 zval *data, **body;
1352                 getObject(http_request_object, obj);
1353
1354                 data = GET_PROP(obj, responseData);
1355                 if (SUCCESS == zend_hash_find(Z_ARRVAL_P(data), "body", sizeof("body"), (void **) &body)) {
1356                         RETURN_STRINGL(Z_STRVAL_PP(body), Z_STRLEN_PP(body), 1);
1357                 } else {
1358                         RETURN_FALSE;
1359                 }
1360         }
1361 }
1362 /* }}} */
1363
1364 /* {{{ proto int HttpRequest::getResponseCode()
1365  *
1366  * Get the response code after the request has been sent.
1367  */
1368 PHP_METHOD(HttpRequest, getResponseCode)
1369 {
1370         NO_ARGS;
1371
1372         IF_RETVAL_USED {
1373                 zval *code;
1374                 getObject(http_request_object, obj);
1375
1376                 code = GET_PROP(obj, responseCode);
1377                 RETURN_LONG(Z_LVAL_P(code));
1378         }
1379 }
1380 /* }}} */
1381
1382 /* {{{ proto array HttpRequest::getResponseInfo([string name])
1383  *
1384  * Get response info after the request has been sent.
1385  * See http_get() for a full list of returned info.
1386  */
1387 PHP_METHOD(HttpRequest, getResponseInfo)
1388 {
1389         IF_RETVAL_USED {
1390                 zval *info, **infop;
1391                 char *info_name = NULL;
1392                 int info_len = 0;
1393                 getObject(http_request_object, obj);
1394
1395                 if (SUCCESS != zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "|s", &info_name, &info_len)) {
1396                         RETURN_FALSE;
1397                 }
1398
1399                 info = GET_PROP(obj, responseInfo);
1400
1401                 if (info_len && info_name) {
1402                         if (SUCCESS == zend_hash_find(Z_ARRVAL_P(info), pretty_key(info_name, info_len, 0, 0), info_len + 1, (void **) &infop)) {
1403                                 RETURN_ZVAL(*infop, 1, ZVAL_PTR_DTOR);
1404                         } else {
1405                                 http_error_ex(E_NOTICE, HTTP_E_PARAM, "Could not find response info named %s", info_name);
1406                                 RETURN_FALSE;
1407                         }
1408                 } else {
1409                         array_init(return_value);
1410                         array_copy(info, return_value);
1411                 }
1412         }
1413 }
1414 /* }}}*/
1415
1416 /* {{{ proto HttpMessage HttpRequest::getResponseMessage()
1417  *
1418  * Get the full response as HttpMessage object.
1419  */
1420 PHP_METHOD(HttpRequest, getResponseMessage)
1421 {
1422         NO_ARGS;
1423
1424         IF_RETVAL_USED {
1425                 zval *message;
1426                 getObject(http_request_object, obj);
1427
1428                 message = GET_PROP(obj, responseMessage);
1429                 if (Z_TYPE_P(message) == IS_OBJECT) {
1430                         RETVAL_OBJECT(message);
1431                 } else {
1432                         RETURN_NULL();
1433                 }
1434         }
1435 }
1436 /* }}} */
1437
1438 /* {{{ proto bool HttpRequest::send()
1439  *
1440  * Send the HTTP request.
1441  *
1442  * GET example:
1443  * <pre>
1444  * <?php
1445  * $r = new HttpRequest('http://example.com/feed.rss', HTTP_GET);
1446  * $r->setOptions(array('lastmodified' => filemtime('local.rss')));
1447  * $r->addQueryData(array('category' => 3));
1448  * try {
1449  *     $r->send();
1450  *     if ($r->getResponseCode() == 200) {
1451  *         file_put_contents('local.rss', $r->getResponseBody());
1452  *    }
1453  * } catch (HttpException $ex) {
1454  *     echo $ex;
1455  * }
1456  * ?>
1457  * </pre>
1458  *
1459  * POST example:
1460  * <pre>
1461  * <?php
1462  * $r = new HttpRequest('http://example.com/form.php', HTTP_POST);
1463  * $r->setOptions(array('cookies' => array('lang' => 'de')));
1464  * $r->addpostFields(array('user' => 'mike', 'pass' => 's3c|r3t'));
1465  * $r->addPostFile('image', 'profile.jpg', 'image/jpeg');
1466  * if ($r->send()) {
1467  *     echo $r->getResponseBody();
1468  * }
1469  * ?>
1470  * </pre>
1471  */
1472 PHP_METHOD(HttpRequest, send)
1473 {
1474         STATUS status = FAILURE;
1475         http_request_body body = {0};
1476         getObject(http_request_object, obj);
1477
1478         NO_ARGS;
1479
1480         SET_EH_THROW_HTTP();
1481
1482         if (obj->pool) {
1483                 http_error(E_WARNING, HTTP_E_CURL, "Cannot perform HttpRequest::send() while attached to an HttpRequestPool");
1484                 SET_EH_NORMAL();
1485                 RETURN_FALSE;
1486         }
1487
1488         if (SUCCESS == (status = http_request_object_requesthandler(obj, getThis(), &body))) {
1489                 status = http_request_exec(obj->ch, NULL);
1490         }
1491         http_request_body_dtor(&body);
1492
1493         /* final data handling */
1494         if (SUCCESS == status) {
1495                 status = http_request_object_responsehandler(obj, getThis());
1496         }
1497
1498         SET_EH_NORMAL();
1499         RETURN_SUCCESS(status);
1500 }
1501 /* }}} */
1502
1503 #endif /* ZEND_ENGINE_2 && HTTP_HAVE_CURL */
1504
1505 /*
1506  * Local variables:
1507  * tab-width: 4
1508  * c-basic-offset: 4
1509  * End:
1510  * vim600: noet sw=4 ts=4 fdm=marker
1511  * vim<600: noet sw=4 ts=4
1512  */
1513