git.m6w6.name Git - m6w6/ext-http/blob - http_response_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
  16 #ifdef HAVE_CONFIG_H
  17 #       include "config.h"
  18 #endif
  19 #include "php.h"
  20
  21 #include "missing.h"
  22
  23 /* broken static properties in PHP 5.0 */
  24 #if defined(ZEND_ENGINE_2) && !defined(WONKY)
  25
  26 #include "SAPI.h"
  27 #include "php_ini.h"
  28
  29 #include "php_http.h"
  30 #include "php_http_api.h"
  31 #include "php_http_std_defs.h"
  32 #include "php_http_response_object.h"
  33 #include "php_http_exception_object.h"
  34 #include "php_http_send_api.h"
  35 #include "php_http_cache_api.h"
  36 #include "php_http_headers_api.h"
  37
  38 #ifdef HTTP_HAVE_MHASH
  39 #       include <mhash.h>
  40 #endif
  41 #ifdef HTTP_HAVE_MAGIC
  42 #       include <magic.h>
  43 #endif
  44
  45 ZEND_EXTERN_MODULE_GLOBALS(http);
  46
  47 #define GET_STATIC_PROP(n)                      *GET_STATIC_PROP_EX(http_response_object_ce, n)
  48 #define UPD_STATIC_PROP(t, n, v)        UPD_STATIC_PROP_EX(http_response_object_ce, t, n, v)
  49 #define SET_STATIC_PROP(n, v)           SET_STATIC_PROP_EX(http_response_object_ce, n, v)
  50 #define UPD_STATIC_STRL(n, v, l)        UPD_STATIC_STRL_EX(http_response_object_ce, n, v, l)
  51
  52 #define HTTP_BEGIN_ARGS(method, req_args)               HTTP_BEGIN_ARGS_EX(HttpResponse, method, 0, req_args)
  53 #define HTTP_EMPTY_ARGS(method, ret_ref)                HTTP_EMPTY_ARGS_EX(HttpResponse, method, ret_ref)
  54 #define HTTP_RESPONSE_ME(method, visibility)    PHP_ME(HttpResponse, method, HTTP_ARGS(HttpResponse, method), visibility|ZEND_ACC_STATIC)
  55 #define HTTP_RESPONSE_ALIAS(method, func)               HTTP_STATIC_ME_ALIAS(method, func, HTTP_ARGS(HttpResponse, method))
  56
  57 HTTP_BEGIN_ARGS(setHeader, 2)
  58         HTTP_ARG_VAL(name, 0)
  59         HTTP_ARG_VAL(value, 0)
  60         HTTP_ARG_VAL(replace, 0)
  61 HTTP_END_ARGS;
  62
  63 HTTP_BEGIN_ARGS(getHeader, 0)
  64         HTTP_ARG_VAL(name, 0)
  65 HTTP_END_ARGS;
  66
  67 HTTP_EMPTY_ARGS(getETag, 0);
  68 HTTP_BEGIN_ARGS(setETag, 1)
  69         HTTP_ARG_VAL(etag, 0)
  70 HTTP_END_ARGS;
  71
  72 HTTP_EMPTY_ARGS(getLastModified, 0);
  73 HTTP_BEGIN_ARGS(setLastModified, 1)
  74         HTTP_ARG_VAL(timestamp, 0)
  75 HTTP_END_ARGS;
  76
  77 HTTP_EMPTY_ARGS(getCache, 0);
  78 HTTP_BEGIN_ARGS(setCache, 1)
  79         HTTP_ARG_VAL(cache, 0)
  80 HTTP_END_ARGS;
  81
  82 HTTP_EMPTY_ARGS(getGzip, 0);
  83 HTTP_BEGIN_ARGS(setGzip, 1)
  84         HTTP_ARG_VAL(gzip, 0)
  85 HTTP_END_ARGS;
  86
  87 HTTP_EMPTY_ARGS(getCacheControl, 0);
  88 HTTP_BEGIN_ARGS(setCacheControl, 1)
  89         HTTP_ARG_VAL(cache_control, 0)
  90         HTTP_ARG_VAL(max_age, 0)
  91 HTTP_END_ARGS;
  92
  93 HTTP_EMPTY_ARGS(getContentType, 0);
  94 HTTP_BEGIN_ARGS(setContentType, 1)
  95         HTTP_ARG_VAL(content_type, 0)
  96 HTTP_END_ARGS;
  97
  98 HTTP_BEGIN_ARGS(guessContentType, 1)
  99         HTTP_ARG_VAL(magic_file, 0)
 100         HTTP_ARG_VAL(magic_mode, 0)
 101 HTTP_END_ARGS;
 102
 103 HTTP_EMPTY_ARGS(getContentDisposition, 0);
 104 HTTP_BEGIN_ARGS(setContentDisposition, 1)
 105         HTTP_ARG_VAL(filename, 0)
 106         HTTP_ARG_VAL(send_inline, 0)
 107 HTTP_END_ARGS;
 108
 109 HTTP_EMPTY_ARGS(getThrottleDelay, 0);
 110 HTTP_BEGIN_ARGS(setThrottleDelay, 1)
 111         HTTP_ARG_VAL(seconds, 0)
 112 HTTP_END_ARGS;
 113
 114 HTTP_EMPTY_ARGS(getBufferSize, 0);
 115 HTTP_BEGIN_ARGS(setBufferSize, 1)
 116         HTTP_ARG_VAL(bytes, 0)
 117 HTTP_END_ARGS;
 118
 119 HTTP_EMPTY_ARGS(getData, 0);
 120 HTTP_BEGIN_ARGS(setData, 1)
 121         HTTP_ARG_VAL(data, 0)
 122 HTTP_END_ARGS;
 123
 124 HTTP_EMPTY_ARGS(getStream, 0);
 125 HTTP_BEGIN_ARGS(setStream, 1)
 126         HTTP_ARG_VAL(stream, 0)
 127 HTTP_END_ARGS;
 128
 129 HTTP_EMPTY_ARGS(getFile, 0);
 130 HTTP_BEGIN_ARGS(setFile, 1)
 131         HTTP_ARG_VAL(filepath, 0)
 132 HTTP_END_ARGS;
 133
 134 HTTP_BEGIN_ARGS(send, 0)
 135         HTTP_ARG_VAL(clean_ob, 0)
 136 HTTP_END_ARGS;
 137
 138 HTTP_EMPTY_ARGS(capture, 0);
 139
 140 HTTP_BEGIN_ARGS(redirect, 0)
 141         HTTP_ARG_VAL(url, 0)
 142         HTTP_ARG_VAL(params, 0)
 143         HTTP_ARG_VAL(session, 0)
 144         HTTP_ARG_VAL(permanent, 0)
 145 HTTP_END_ARGS;
 146
 147 HTTP_BEGIN_ARGS(status, 1)
 148         HTTP_ARG_VAL(code, 0)
 149 HTTP_END_ARGS;
 150
 151 HTTP_EMPTY_ARGS(getRequestHeaders, 0);
 152 HTTP_EMPTY_ARGS(getRequestBody, 0);
 153
 154 #define http_response_object_declare_default_properties() _http_response_object_declare_default_properties(TSRMLS_C)
 155 static inline void _http_response_object_declare_default_properties(TSRMLS_D);
 156 #define http_grab_response_headers _http_grab_response_headers
 157 static void _http_grab_response_headers(void *data, void *arg TSRMLS_DC);
 158
 159 zend_class_entry *http_response_object_ce;
 160 zend_function_entry http_response_object_fe[] = {
 161
 162         HTTP_RESPONSE_ME(setHeader, ZEND_ACC_PUBLIC)
 163         HTTP_RESPONSE_ME(getHeader, ZEND_ACC_PUBLIC)
 164
 165         HTTP_RESPONSE_ME(setETag, ZEND_ACC_PUBLIC)
 166         HTTP_RESPONSE_ME(getETag, ZEND_ACC_PUBLIC)
 167
 168         HTTP_RESPONSE_ME(setLastModified, ZEND_ACC_PUBLIC)
 169         HTTP_RESPONSE_ME(getLastModified, ZEND_ACC_PUBLIC)
 170
 171         HTTP_RESPONSE_ME(setContentDisposition, ZEND_ACC_PUBLIC)
 172         HTTP_RESPONSE_ME(getContentDisposition, ZEND_ACC_PUBLIC)
 173
 174         HTTP_RESPONSE_ME(setContentType, ZEND_ACC_PUBLIC)
 175         HTTP_RESPONSE_ME(getContentType, ZEND_ACC_PUBLIC)
 176
 177         HTTP_RESPONSE_ME(guessContentType, ZEND_ACC_PUBLIC)
 178
 179         HTTP_RESPONSE_ME(setCache, ZEND_ACC_PUBLIC)
 180         HTTP_RESPONSE_ME(getCache, ZEND_ACC_PUBLIC)
 181
 182         HTTP_RESPONSE_ME(setCacheControl, ZEND_ACC_PUBLIC)
 183         HTTP_RESPONSE_ME(getCacheControl, ZEND_ACC_PUBLIC)
 184
 185         HTTP_RESPONSE_ME(setGzip, ZEND_ACC_PUBLIC)
 186         HTTP_RESPONSE_ME(getGzip, ZEND_ACC_PUBLIC)
 187
 188         HTTP_RESPONSE_ME(setThrottleDelay, ZEND_ACC_PUBLIC)
 189         HTTP_RESPONSE_ME(getThrottleDelay, ZEND_ACC_PUBLIC)
 190
 191         HTTP_RESPONSE_ME(setBufferSize, ZEND_ACC_PUBLIC)
 192         HTTP_RESPONSE_ME(getBufferSize, ZEND_ACC_PUBLIC)
 193
 194         HTTP_RESPONSE_ME(setData, ZEND_ACC_PUBLIC)
 195         HTTP_RESPONSE_ME(getData, ZEND_ACC_PUBLIC)
 196
 197         HTTP_RESPONSE_ME(setFile, ZEND_ACC_PUBLIC)
 198         HTTP_RESPONSE_ME(getFile, ZEND_ACC_PUBLIC)
 199
 200         HTTP_RESPONSE_ME(setStream, ZEND_ACC_PUBLIC)
 201         HTTP_RESPONSE_ME(getStream, ZEND_ACC_PUBLIC)
 202
 203         HTTP_RESPONSE_ME(send, ZEND_ACC_PUBLIC)
 204         HTTP_RESPONSE_ME(capture, ZEND_ACC_PUBLIC)
 205
 206         HTTP_RESPONSE_ALIAS(redirect, http_redirect)
 207         HTTP_RESPONSE_ALIAS(status, http_send_status)
 208         HTTP_RESPONSE_ALIAS(getRequestHeaders, http_get_request_headers)
 209         HTTP_RESPONSE_ALIAS(getRequestBody, http_get_request_body)
 210
 211         EMPTY_FUNCTION_ENTRY
 212 };
 213
 214 PHP_MINIT_FUNCTION(http_response_object)
 215 {
 216         HTTP_REGISTER_CLASS(HttpResponse, http_response_object, NULL, 0);
 217         http_response_object_declare_default_properties();
 218         return SUCCESS;
 219 }
 220
 221 static inline void _http_response_object_declare_default_properties(TSRMLS_D)
 222 {
 223         zend_class_entry *ce = http_response_object_ce;
 224
 225         DCL_STATIC_PROP(PRIVATE, bool, sent, 0);
 226         DCL_STATIC_PROP(PRIVATE, bool, catch, 0);
 227         DCL_STATIC_PROP(PRIVATE, long, mode, -1);
 228         DCL_STATIC_PROP(PRIVATE, long, stream, 0);
 229         DCL_STATIC_PROP_N(PRIVATE, file);
 230         DCL_STATIC_PROP_N(PRIVATE, data);
 231         DCL_STATIC_PROP(PROTECTED, bool, cache, 0);
 232         DCL_STATIC_PROP(PROTECTED, bool, gzip, 0);
 233         DCL_STATIC_PROP_N(PROTECTED, eTag);
 234         DCL_STATIC_PROP(PROTECTED, long, lastModified, 0);
 235         DCL_STATIC_PROP_N(PROTECTED, cacheControl);
 236         DCL_STATIC_PROP_N(PROTECTED, contentType);
 237         DCL_STATIC_PROP_N(PROTECTED, contentDisposition);
 238         DCL_STATIC_PROP(PROTECTED, long, bufferSize, HTTP_SENDBUF_SIZE);
 239         DCL_STATIC_PROP(PROTECTED, double, throttleDelay, 0.0);
 240
 241 #ifndef WONKY
 242         DCL_CONST(long, "REDIRECT", HTTP_REDIRECT);
 243         DCL_CONST(long, "REDIRECT_PERM", HTTP_REDIRECT_PERM);
 244         DCL_CONST(long, "REDIRECT_POST", HTTP_REDIRECT_POST);
 245         DCL_CONST(long, "REDIRECT_TEMP", HTTP_REDIRECT_TEMP);
 246
 247         DCL_CONST(long, "ETAG_MD5", HTTP_ETAG_MD5);
 248         DCL_CONST(long, "ETAG_SHA1", HTTP_ETAG_SHA1);
 249         DCL_CONST(long, "ETAG_CRC32", HTTP_ETAG_CRC32);
 250
 251 #       ifdef HTTP_HAVE_HASH_EXT
 252         DCL_CONST(long, "ETAG_SHA256", HTTP_ETAG_SHA256);
 253         DCL_CONST(long, "ETAG_SHA384", HTTP_ETAG_SHA384);
 254         DCL_CONST(long, "ETAG_SHA512", HTTP_ETAG_SHA512);
 255         DCL_CONST(long, "ETAG_RIPEMD128", HTTP_ETAG_RIPEMD128);
 256         DCL_CONST(long, "ETAG_RIPEMD160", HTTP_ETAG_RIPEMD160);
 257 #       endif
 258
 259 #       ifdef HTTP_HAVE_MHASH
 260         {
 261                 int l, i, c = mhash_count();
 262
 263                 for (i = 0; i <= c; ++i) {
 264                         char const_name[256] = {0};
 265                         const char *hash_name = mhash_get_hash_name_static(i);
 266
 267                         if (hash_name) {
 268                                 l = snprintf(const_name, 255, "ETAG_MHASH_%s", hash_name);
 269                                 zend_declare_class_constant_long(ce, const_name, l, i TSRMLS_CC);
 270                         }
 271                 }
 272         }
 273 #       endif /* HTTP_HAVE_MHASH */
 274 #endif /* WONKY */
 275 }
 276
 277 static void _http_grab_response_headers(void *data, void *arg TSRMLS_DC)
 278 {
 279         phpstr_appendl(PHPSTR(arg), ((sapi_header_struct *)data)->header);
 280         phpstr_appends(PHPSTR(arg), HTTP_CRLF);
 281 }
 282
 283 /* ### USERLAND ### */
 284
 285 /* {{{ proto static bool HttpResponse::setHeader(string name, mixed value[, bool replace = true])
 286  *
 287  * Send an HTTP header.
 288  *
 289  * Expects a string parameter containing the name of the header and a mixed
 290  * parameter containing the value of the header, which will be converted to
 291  * a string.  Additionally accepts an optional boolean parameter, which
 292  * specifies whether an existing header should be replaced.  If the second
 293  * parameter is unset no header with this name will be sent.
 294  *
 295  * Returns TRUE on success, or FALSE on failure.
 296  *
 297  * Throws HttpHeaderException if http.only_exceptions is TRUE.
 298  */
 299 PHP_METHOD(HttpResponse, setHeader)
 300 {
 301         zend_bool replace = 1;
 302         char *name;
 303         int name_len = 0;
 304         zval *value = NULL, *orig = NULL;
 305
 306         if (SUCCESS != zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "sz/!|b", &name, &name_len, &value, &replace)) {
 307                 RETURN_FALSE;
 308         }
 309         if (SG(headers_sent)) {
 310                 http_error(HE_WARNING, HTTP_E_HEADER, "Cannot add another header when headers have already been sent");
 311                 RETURN_FALSE;
 312         }
 313         if (!name_len) {
 314                 http_error(HE_WARNING, HTTP_E_HEADER, "Cannot send anonymous headers");
 315                 RETURN_FALSE;
 316         }
 317
 318         /* delete header if value == null */
 319         if (!value || Z_TYPE_P(value) == IS_NULL) {
 320                 RETURN_SUCCESS(http_send_header_ex(name, name_len, "", 0, replace, NULL));
 321         }
 322         /* send multiple header if replace is false and value is an array */
 323         if (!replace && Z_TYPE_P(value) == IS_ARRAY) {
 324                 zval **data;
 325                 HashPosition pos;
 326
 327                 FOREACH_VAL(pos, value, data) {
 328                         zval *orig = *data;
 329
 330                         convert_to_string_ex(data);
 331                         if (SUCCESS != http_send_header_ex(name, name_len, Z_STRVAL_PP(data), Z_STRLEN_PP(data), 0, NULL)) {
 332                                 if (orig != *data) {
 333                                         zval_ptr_dtor(data);
 334                                 }
 335                                 RETURN_FALSE;
 336                         }
 337                         if (orig != *data) {
 338                                 zval_ptr_dtor(data);
 339                         }
 340                 }
 341                 RETURN_TRUE;
 342         }
 343         /* send standard header */
 344         orig = value;
 345         convert_to_string_ex(&value);
 346         RETVAL_SUCCESS(http_send_header_ex(name, name_len, Z_STRVAL_P(value), Z_STRLEN_P(value), replace, NULL));
 347         if (orig != value) {
 348                 zval_ptr_dtor(&value);
 349         }
 350 }
 351 /* }}} */
 352
 353 /* {{{ proto static mixed HttpResponse::getHeader([string name])
 354  *
 355  * Get header(s) about to be sent.
 356  *
 357  * Accepts a string as optional parameter which specifies the name of the
 358  * header to read.  If the parameter is empty or omitted, an associative array
 359  * with all headers will be returned.
 360  *
 361  * Returns either a string containing the value of the header matching name,
 362  * FALSE on failure, or an associative array with all headers.
 363  */
 364 PHP_METHOD(HttpResponse, getHeader)
 365 {
 366         char *name = NULL;
 367         int name_len = 0;
 368         phpstr headers;
 369
 370         if (SUCCESS != zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "|s", &name, &name_len)) {
 371                 RETURN_FALSE;
 372         }
 373
 374         phpstr_init(&headers);
 375         zend_llist_apply_with_argument(&SG(sapi_headers).headers, http_grab_response_headers, &headers TSRMLS_CC);
 376         phpstr_fix(&headers);
 377
 378         if (name && name_len) {
 379                 zval **header;
 380                 HashTable headers_ht;
 381
 382                 zend_hash_init(&headers_ht, sizeof(zval *), NULL, ZVAL_PTR_DTOR, 0);
 383                 if (    (SUCCESS == http_parse_headers_ex(PHPSTR_VAL(&headers), &headers_ht, 1)) &&
 384                                 (SUCCESS == zend_hash_find(&headers_ht, name, name_len + 1, (void **) &header))) {
 385                         RETVAL_ZVAL(*header, 1, 0);
 386                 } else {
 387                         RETVAL_NULL();
 388                 }
 389                 zend_hash_destroy(&headers_ht);
 390         } else {
 391                 array_init(return_value);
 392                 http_parse_headers_ex(PHPSTR_VAL(&headers), Z_ARRVAL_P(return_value), 1);
 393         }
 394
 395         phpstr_dtor(&headers);
 396 }
 397 /* }}} */
 398
 399 /* {{{ proto static bool HttpResponse::setCache(bool cache)
 400  *
 401  * Whether it sould be attempted to cache the entitity.
 402  * This will result in necessary caching headers and checks of clients
 403  * "If-Modified-Since" and "If-None-Match" headers.  If one of those headers
 404  * matches a "304 Not Modified" status code will be issued.
 405  *
 406  * NOTE: If you're using sessions, be shure that you set session.cache_limiter
 407  * to something more appropriate than "no-cache"!
 408  *
 409  * Expects a boolean as parameter specifying whether caching should be attempted.
 410  *
 411  * Returns TRUE ons success, or FALSE on failure.
 412  */
 413 PHP_METHOD(HttpResponse, setCache)
 414 {
 415         zend_bool do_cache = 0;
 416
 417         if (SUCCESS != zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "b", &do_cache)) {
 418                 RETURN_FALSE;
 419         }
 420
 421         RETURN_SUCCESS(UPD_STATIC_PROP(bool, cache, do_cache));
 422 }
 423 /* }}} */
 424
 425 /* {{{ proto static bool HttpResponse::getCache()
 426  *
 427  * Get current caching setting.
 428  *
 429  * Returns TRUE if caching should be attempted, else FALSE.
 430  */
 431 PHP_METHOD(HttpResponse, getCache)
 432 {
 433         NO_ARGS;
 434
 435         IF_RETVAL_USED {
 436                 zval *cache_p, *cache = convert_to_type_ex(IS_BOOL, GET_STATIC_PROP(cache), &cache_p);
 437
 438                 RETVAL_ZVAL(cache, 1, 0);
 439
 440                 if (cache_p) {
 441                         zval_ptr_dtor(&cache_p);
 442                 }
 443         }
 444 }
 445 /* }}}*/
 446
 447 /* {{{ proto static bool HttpResponse::setGzip(bool gzip)
 448  *
 449  * Enable on-thy-fly gzipping of the sent entity.
 450  *
 451  * Expects a boolean as parameter indicating if GZip compression should be enabled.
 452  *
 453  * Returns TRUE on success, or FALSE on failure.
 454  */
 455 PHP_METHOD(HttpResponse, setGzip)
 456 {
 457         zend_bool do_gzip = 0;
 458
 459         if (SUCCESS != zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "b", &do_gzip)) {
 460                 RETURN_FALSE;
 461         }
 462
 463         RETURN_SUCCESS(UPD_STATIC_PROP(bool, gzip, do_gzip));
 464 }
 465 /* }}} */
 466
 467 /* {{{ proto static bool HttpResponse::getGzip()
 468  *
 469  * Get current gzipping setting.
 470  *
 471  * Returns TRUE if GZip compression is enabled, else FALSE.
 472  */
 473 PHP_METHOD(HttpResponse, getGzip)
 474 {
 475         NO_ARGS;
 476
 477         IF_RETVAL_USED {
 478                 zval *gzip_p, *gzip = convert_to_type_ex(IS_BOOL, GET_STATIC_PROP(gzip), &gzip_p);
 479
 480                 RETVAL_ZVAL(gzip, 1, 0);
 481
 482                 if (gzip_p) {
 483                         zval_ptr_dtor(&gzip_p);
 484                 }
 485         }
 486 }
 487 /* }}} */
 488
 489 /* {{{ proto static bool HttpResponse::setCacheControl(string control[, int max_age = 0])
 490  *
 491  * Set a custom cache-control header, usually being "private" or "public";
 492  * The max_age parameter controls how long the cache entry is valid on the client side.
 493  *
 494  * Expects a string parameter containing the primary cache control setting.
 495  * Addtitionally accepts an int parameter specifying the max-age setting.
 496  *
 497  * Returns TRUE on success, or FALSE if control does not match one of
 498  * "public" , "private" or "no-cache".
 499  *
 500  * Throws HttpInvalidParamException if http.only_exceptions is TRUE.
 501  */
 502 PHP_METHOD(HttpResponse, setCacheControl)
 503 {
 504         char *ccontrol, *cctl;
 505         int cc_len;
 506         long max_age = 0;
 507
 508         if (SUCCESS != zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "s|l", &ccontrol, &cc_len, &max_age)) {
 509                 RETURN_FALSE;
 510         }
 511
 512         if (strcmp(ccontrol, "public") && strcmp(ccontrol, "private") && strcmp(ccontrol, "no-cache")) {
 513                 http_error_ex(HE_WARNING, HTTP_E_INVALID_PARAM, "Cache-Control '%s' doesn't match public, private or no-cache", ccontrol);
 514                 RETURN_FALSE;
 515         } else {
 516                 size_t cctl_len = spprintf(&cctl, 0, "%s, must-revalidate, max-age=%ld", ccontrol, max_age);
 517                 RETVAL_SUCCESS(UPD_STATIC_STRL(cacheControl, cctl, cctl_len));
 518                 efree(cctl);
 519         }
 520 }
 521 /* }}} */
 522
 523 /* {{{ proto static string HttpResponse::getCacheControl()
 524  *
 525  * Get current Cache-Control header setting.
 526  *
 527  * Returns the current cache control setting as a string like sent in a header.
 528  */
 529 PHP_METHOD(HttpResponse, getCacheControl)
 530 {
 531         NO_ARGS;
 532
 533         IF_RETVAL_USED {
 534                 zval *ccontrol_p, *ccontrol = convert_to_type_ex(IS_STRING, GET_STATIC_PROP(cacheControl), &ccontrol_p);
 535
 536                 RETVAL_ZVAL(ccontrol, 1, 0);
 537
 538                 if (ccontrol_p) {
 539                         zval_ptr_dtor(&ccontrol_p);
 540                 }
 541         }
 542 }
 543 /* }}} */
 544
 545 /* {{{ proto static bool HttpResponse::setContentType(string content_type)
 546  *
 547  * Set the content-type of the sent entity.
 548  *
 549  * Expects a string as parameter specifying the content type of the sent entity.
 550  *
 551  * Returns TRUE on success, or FALSE if the content type does not seem to
 552  * contain a primary and secondary content type part.
 553  *
 554  * Throws HttpInvalidParamException if http.only_exceptions is TRUE.
 555  */
 556 PHP_METHOD(HttpResponse, setContentType)
 557 {
 558         char *ctype;
 559         int ctype_len;
 560
 561         if (SUCCESS != zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "s", &ctype, &ctype_len)) {
 562                 RETURN_FALSE;
 563         }
 564
 565         HTTP_CHECK_CONTENT_TYPE(ctype, RETURN_FALSE);
 566         RETURN_SUCCESS(UPD_STATIC_STRL(contentType, ctype, ctype_len));
 567 }
 568 /* }}} */
 569
 570 /* {{{ proto static string HttpResponse::getContentType()
 571  *
 572  * Get current Content-Type header setting.
 573  *
 574  * Returns the currently set content type as string.
 575  */
 576 PHP_METHOD(HttpResponse, getContentType)
 577 {
 578         NO_ARGS;
 579
 580         IF_RETVAL_USED {
 581                 zval *ctype_p, *ctype = convert_to_type_ex(IS_STRING, GET_STATIC_PROP(contentType), &ctype_p);
 582
 583                 RETVAL_ZVAL(ctype, 1, 0);
 584
 585                 if (ctype_p) {
 586                         zval_ptr_dtor(&ctype_p);
 587                 }
 588         }
 589 }
 590 /* }}} */
 591
 592 /* {{{ proto static string HttpResponse::guessContentType(string magic_file[, int magic_mode = MAGIC_MIME])
 593  *
 594  * Attempts to guess the content type of supplied payload through libmagic.
 595  * If the attempt is successful, the guessed content type will automatically
 596  * be set as response content type.
 597  *
 598  * Expects a string parameter specifying the magic.mime database to use.
 599  * Additionally accepts an optional int parameter, being flags for libmagic.
 600  *
 601  * Returns the guessed content type on success, or FALSE on failure.
 602  *
 603  * Throws HttpRuntimeException, HttpInvalidParamException
 604  * if http.only_exceptions is TRUE.
 605  */
 606 PHP_METHOD(HttpResponse, guessContentType)
 607 {
 608         char *magic_file, *ct = NULL;
 609         int magic_file_len;
 610         long magic_mode = 0;
 611
 612         RETVAL_FALSE;
 613
 614 #ifdef HTTP_HAVE_MAGIC
 615         magic_mode = MAGIC_MIME;
 616
 617         SET_EH_THROW_HTTP();
 618         if (SUCCESS == zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "s|l", &magic_file, &magic_file_len, &magic_mode)) {
 619                 switch (Z_LVAL_P(GET_STATIC_PROP(mode))) {
 620                         case SEND_DATA:
 621                         {
 622                                 zval *data = GET_STATIC_PROP(data);
 623                                 ct = http_guess_content_type(magic_file, magic_mode, Z_STRVAL_P(data), Z_STRLEN_P(data), SEND_DATA);
 624                         }
 625                         break;
 626
 627                         case SEND_RSRC:
 628                         {
 629                                 php_stream *s;
 630                                 zval *z = GET_STATIC_PROP(stream);
 631                                 z->type = IS_RESOURCE;
 632                                 php_stream_from_zval(s, &z);
 633                                 ct = http_guess_content_type(magic_file, magic_mode, s, 0, SEND_RSRC);
 634                         }
 635                         break;
 636
 637                         default:
 638                                 ct = http_guess_content_type(magic_file, magic_mode, Z_STRVAL_P(GET_STATIC_PROP(file)), 0, -1);
 639                         break;
 640                 }
 641                 if (ct) {
 642                         UPD_STATIC_PROP(string, contentType, ct);
 643                         RETVAL_STRING(ct, 0);
 644                 }
 645         }
 646         SET_EH_NORMAL();
 647 #else
 648         http_error(HE_THROW, HTTP_E_RUNTIME, "Cannot guess Content-Type; libmagic not available");
 649 #endif
 650 }
 651 /* }}} */
 652
 653 /* {{{ proto static bool HttpResponse::setContentDisposition(string filename[, bool inline = false])
 654  *
 655  * Set the Content-Disposition.  The Content-Disposition header is very useful
 656  * if the data actually sent came from a file or something similar, that should
 657  * be "saved" by the client/user (i.e. by browsers "Save as..." popup window).
 658  *
 659  * Expects a string parameter specifying the file name the "Save as..." dialogue
 660  * should display.  Optionally accepts a bool parameter, which, if set to true
 661  * and the user agent knows how to handle the content type, will probably not
 662  * cause the popup window to be shown.
 663  *
 664  * Returns TRUE on success or FALSE on failure.
 665  */
 666 PHP_METHOD(HttpResponse, setContentDisposition)
 667 {
 668         char *file, *cd;
 669         int file_len;
 670         size_t cd_len;
 671         zend_bool send_inline = 0;
 672
 673         if (SUCCESS != zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "s|b", &file, &file_len, &send_inline)) {
 674                 RETURN_FALSE;
 675         }
 676
 677         cd_len = spprintf(&cd, 0, "%s; filename=\"%s\"", send_inline ? "inline" : "attachment", file);
 678         RETVAL_SUCCESS(UPD_STATIC_STRL(contentDisposition, cd, cd_len));
 679         efree(cd);
 680 }
 681 /* }}} */
 682
 683 /* {{{ proto static string HttpResponse::getContentDisposition()
 684  *
 685  * Get current Content-Disposition setting.
 686  *
 687  * Returns the current content disposition as string like sent in a header.
 688  */
 689 PHP_METHOD(HttpResponse, getContentDisposition)
 690 {
 691         NO_ARGS;
 692
 693         IF_RETVAL_USED {
 694                 zval *cd_p, *cd = convert_to_type_ex(IS_STRING, GET_STATIC_PROP(contentDisposition), &cd_p);
 695
 696                 RETVAL_ZVAL(cd, 1, 0);
 697
 698                 if (cd_p) {
 699                         zval_ptr_dtor(&cd_p);
 700                 }
 701         }
 702 }
 703 /* }}} */
 704
 705 /* {{{ proto static bool HttpResponse::setETag(string etag)
 706  *
 707  * Set a custom ETag.  Use this only if you know what you're doing.
 708  *
 709  * Expects an unquoted string as parameter containing the ETag.
 710  *
 711  * Returns TRUE on success, or FALSE on failure.
 712  */
 713 PHP_METHOD(HttpResponse, setETag)
 714 {
 715         char *etag;
 716         int etag_len;
 717
 718         if (SUCCESS != zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "s", &etag, &etag_len)) {
 719                 RETURN_FALSE;
 720         }
 721
 722         RETURN_SUCCESS(UPD_STATIC_STRL(eTag, etag, etag_len));
 723 }
 724 /* }}} */
 725
 726 /* {{{ proto static string HttpResponse::getETag()
 727  *
 728  * Get calculated or previously set custom ETag.
 729  *
 730  * Returns the calculated or previously set ETag as unquoted string.
 731  */
 732 PHP_METHOD(HttpResponse, getETag)
 733 {
 734         NO_ARGS;
 735
 736         IF_RETVAL_USED {
 737                 zval *etag_p, *etag = convert_to_type_ex(IS_STRING, GET_STATIC_PROP(eTag), &etag_p);
 738
 739                 RETVAL_ZVAL(etag, 1, 0);
 740
 741                 if (etag_p) {
 742                         zval_ptr_dtor(&etag_p);
 743                 }
 744         }
 745 }
 746 /* }}} */
 747
 748 /* {{{ proto static bool HttpResponse::setLastModified(int timestamp)
 749  *
 750  * Set a custom Last-Modified date.
 751  *
 752  * Expects an unix timestamp as parameter representing the last modification
 753  * time of the sent entity.
 754  *
 755  * Returns TRUE on success, or FALSE on failure.
 756  */
 757 PHP_METHOD(HttpResponse, setLastModified)
 758 {
 759         long lm;
 760
 761         if (SUCCESS != zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "l", &lm)) {
 762                 RETURN_FALSE;
 763         }
 764
 765         RETURN_SUCCESS(UPD_STATIC_PROP(long, lastModified, lm));
 766 }
 767 /* }}} */
 768
 769 /* {{{ proto static int HttpResponse::getLastModified()
 770  *
 771  * Get calculated or previously set custom Last-Modified date.
 772  *
 773  * Returns the calculated or previously set unix timestamp.
 774  */
 775 PHP_METHOD(HttpResponse, getLastModified)
 776 {
 777         NO_ARGS;
 778
 779         IF_RETVAL_USED {
 780                 zval *lm_p, *lm = convert_to_type_ex(IS_LONG, GET_STATIC_PROP(lastModified), &lm_p);
 781
 782                 RETVAL_ZVAL(lm, 1, 0);
 783
 784                 if (lm_p) {
 785                         zval_ptr_dtor(&lm_p);
 786                 }
 787         }
 788 }
 789 /* }}} */
 790
 791 /* {{{ proto static bool HttpResponse::setThrottleDelay(double seconds)
 792  *
 793  * Sets the throttle delay for use with HttpResponse::setBufferSize().
 794  *
 795  * Provides a basic throttling mechanism, which will yield the current process
 796  * resp. thread until the entity has been completely sent, though.
 797  *
 798  * Note: This doesn't really work with the FastCGI SAPI.
 799  *
 800  * Expects a double parameter specifying the seconds too sleep() after
 801  * each chunk sent.
 802  *
 803  * Returns TRUE on success, or FALSE on failure.
 804  */
 805 PHP_METHOD(HttpResponse, setThrottleDelay)
 806 {
 807         double seconds;
 808
 809         if (SUCCESS != zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "d", &seconds)) {
 810                 RETURN_FALSE;
 811         }
 812         RETURN_SUCCESS(UPD_STATIC_PROP(double, throttleDelay, seconds));
 813 }
 814 /* }}} */
 815
 816 /* {{{ proto static double HttpResponse::getThrottleDelay()
 817  *
 818  * Get the current throttle delay.
 819  *
 820  * Returns a double representing the throttle delay in seconds.
 821  */
 822 PHP_METHOD(HttpResponse, getThrottleDelay)
 823 {
 824         NO_ARGS;
 825
 826         IF_RETVAL_USED {
 827                 zval *delay_p, *delay = convert_to_type_ex(IS_DOUBLE, GET_STATIC_PROP(throttleDelay), &delay_p);
 828
 829                 RETVAL_ZVAL(delay, 1, 0);
 830
 831                 if (delay_p) {
 832                         zval_ptr_dtor(&delay_p);
 833                 }
 834         }
 835 }
 836 /* }}} */
 837
 838 /* {{{ proto static bool HttpResponse::setBufferSize(int bytes)
 839  *
 840  * Sets the send buffer size for use with HttpResponse::setThrottleDelay().
 841  *
 842  * Provides a basic throttling mechanism, which will yield the current process
 843  * resp. thread until the entity has been completely sent, though.
 844  *
 845  * Note: This doesn't really work with the FastCGI SAPI.
 846  *
 847  * Expects an int parameter representing the chunk size in bytes.
 848  *
 849  * Returns TRUE on success, or FALSE on failure.
 850  */
 851 PHP_METHOD(HttpResponse, setBufferSize)
 852 {
 853         long bytes;
 854
 855         if (SUCCESS != zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "l", &bytes)) {
 856                 RETURN_FALSE;
 857         }
 858         RETURN_SUCCESS(UPD_STATIC_PROP(long, bufferSize, bytes));
 859 }
 860 /* }}} */
 861
 862 /* {{{ proto static int HttpResponse::getBufferSize()
 863  *
 864  * Get current buffer size.
 865  *
 866  * Returns an int representing the current buffer size in bytes.
 867  */
 868 PHP_METHOD(HttpResponse, getBufferSize)
 869 {
 870         NO_ARGS;
 871
 872         IF_RETVAL_USED {
 873                 zval *size_p, *size = convert_to_type_ex(IS_LONG, GET_STATIC_PROP(bufferSize), &size_p);
 874
 875                 RETVAL_ZVAL(size, 1, 0);
 876
 877                 if (size_p) {
 878                         zval_ptr_dtor(&size_p);
 879                 }
 880         }
 881 }
 882 /* }}} */
 883
 884 /* {{{ proto static bool HttpResponse::setData(mixed data)
 885  *
 886  * Set the data to be sent.
 887  *
 888  * Expects one parameter, which will be converted to a string and contains
 889  * the data to send.
 890  *
 891  * Returns TRUE on success, or FALSE on failure.
 892  */
 893 PHP_METHOD(HttpResponse, setData)
 894 {
 895         char *etag;
 896         zval *the_data;
 897
 898         if (SUCCESS != zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "z", &the_data)) {
 899                 RETURN_FALSE;
 900         }
 901         if (Z_TYPE_P(the_data) != IS_STRING) {
 902                 convert_to_string_ex(&the_data);
 903         }
 904
 905         if (    (SUCCESS != SET_STATIC_PROP(data, the_data)) ||
 906                         (SUCCESS != UPD_STATIC_PROP(long, mode, SEND_DATA))) {
 907                 RETURN_FALSE;
 908         }
 909
 910         UPD_STATIC_PROP(long, lastModified, http_last_modified(the_data, SEND_DATA));
 911         if ((etag = http_etag(Z_STRVAL_P(the_data), Z_STRLEN_P(the_data), SEND_DATA))) {
 912                 UPD_STATIC_PROP(string, eTag, etag);
 913                 efree(etag);
 914         }
 915
 916         RETURN_TRUE;
 917 }
 918 /* }}} */
 919
 920 /* {{{ proto static string HttpResponse::getData()
 921  *
 922  * Get the previously set data to be sent.
 923  *
 924  * Returns a string containing the previously set data to send.
 925  */
 926 PHP_METHOD(HttpResponse, getData)
 927 {
 928         NO_ARGS;
 929
 930         IF_RETVAL_USED {
 931                 zval *the_data = GET_STATIC_PROP(data);
 932
 933                 RETURN_ZVAL(the_data, 1, 0);
 934         }
 935 }
 936 /* }}} */
 937
 938 /* {{{ proto static bool HttpResponse::setStream(resource stream)
 939  *
 940  * Set the resource to be sent.
 941  *
 942  * Expects a resource parameter referencing an already opened stream from
 943  * which the data to send will be read.
 944  *
 945  * Returns TRUE on success, or FALSE on failure.
 946  */
 947 PHP_METHOD(HttpResponse, setStream)
 948 {
 949         char *etag;
 950         zval *the_stream;
 951         php_stream *the_real_stream;
 952         php_stream_statbuf ssb;
 953
 954         if (SUCCESS != zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "r", &the_stream)) {
 955                 RETURN_FALSE;
 956         }
 957
 958         php_stream_from_zval(the_real_stream, &the_stream);
 959         if (php_stream_stat(the_real_stream, &ssb)) {
 960                 RETURN_FALSE;
 961         }
 962
 963         if (    (SUCCESS != UPD_STATIC_PROP(long, stream, Z_LVAL_P(the_stream))) ||
 964                         (SUCCESS != UPD_STATIC_PROP(long, mode, SEND_RSRC))) {
 965                 RETURN_FALSE;
 966         }
 967         zend_list_addref(Z_LVAL_P(the_stream));
 968
 969         UPD_STATIC_PROP(long, lastModified, http_last_modified(the_real_stream, SEND_RSRC));
 970         if ((etag = http_etag(the_real_stream, 0, SEND_RSRC))) {
 971                 UPD_STATIC_PROP(string, eTag, etag);
 972                 efree(etag);
 973         }
 974
 975         RETURN_TRUE;
 976 }
 977 /* }}} */
 978
 979 /* {{{ proto static resource HttpResponse::getStream()
 980  *
 981  * Get the previously set resource to be sent.
 982  *
 983  * Returns the previously set resource.
 984  */
 985 PHP_METHOD(HttpResponse, getStream)
 986 {
 987         NO_ARGS;
 988
 989         IF_RETVAL_USED {
 990                 zval *stream_p;
 991
 992                 RETVAL_RESOURCE(Z_LVAL_P(convert_to_type_ex(IS_LONG, GET_STATIC_PROP(stream), &stream_p)));
 993
 994                 if (stream_p) {
 995                         zval_ptr_dtor(&stream_p);
 996                 }
 997         }
 998 }
 999 /* }}} */
1000
1001 /* {{{ proto static bool HttpResponse::setFile(string file)
1002  *
1003  * Set the file to be sent.
1004  *
1005  * Expects a string as parameter, specifying the path to the file to send.
1006  *
1007  * Returns TRUE on success, or FALSE on failure.
1008  */
1009 PHP_METHOD(HttpResponse, setFile)
1010 {
1011         char *the_file, *etag;
1012         int file_len;
1013         php_stream_statbuf ssb;
1014
1015         if (SUCCESS != zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "s", &the_file, &file_len)) {
1016                 RETURN_FALSE;
1017         }
1018
1019         if (php_stream_stat_path(the_file, &ssb)) {
1020                 RETURN_FALSE;
1021         }
1022
1023         if (    (SUCCESS != UPD_STATIC_STRL(file, the_file, file_len)) ||
1024                         (SUCCESS != UPD_STATIC_PROP(long, mode, -1))) {
1025                 RETURN_FALSE;
1026         }
1027
1028         UPD_STATIC_PROP(long, lastModified, http_last_modified(the_file, -1));
1029         if ((etag = http_etag(the_file, 0, -1))) {
1030                 UPD_STATIC_PROP(string, eTag, etag);
1031                 efree(etag);
1032         }
1033
1034         RETURN_TRUE;
1035 }
1036 /* }}} */
1037
1038 /* {{{ proto static string HttpResponse::getFile()
1039  *
1040  * Get the previously set file to be sent.
1041  *
1042  * Returns the previously set path to the file to send as string.
1043  */
1044 PHP_METHOD(HttpResponse, getFile)
1045 {
1046         NO_ARGS;
1047
1048         IF_RETVAL_USED {
1049                 zval *the_file_p, *the_file = convert_to_type_ex(IS_STRING, GET_STATIC_PROP(file), &the_file_p);
1050
1051                 RETVAL_ZVAL(the_file, 1, 0);
1052
1053                 if (the_file_p) {
1054                         zval_ptr_dtor(&the_file_p);
1055                 }
1056         }
1057 }
1058 /* }}} */
1059
1060 /* {{{ proto static bool HttpResponse::send([bool clean_ob = true])
1061  *
1062  * Finally send the entity.
1063  *
1064  * Accepts an optional boolean parameter, specifying wheter the ouput
1065  * buffers should be discarded prior sending.  A successful caching attempt
1066  * will cause a script termination, and write a log entry if the INI setting
1067  * http.cache_log is set.
1068  *
1069  * Returns TRUE on success, or FALSE on failure.
1070  *
1071  * Throws HttpHeaderException, HttpResponseException if http.onyl_excpetions is TRUE.
1072  *
1073  * Example:
1074  * <pre>
1075  * <?php
1076  * HttpResponse::setCache(true);
1077  * HttpResponse::setContentType('application/pdf');
1078  * HttpResponse::setContentDisposition("$user.pdf", false);
1079  * HttpResponse::setFile('sheet.pdf');
1080  * HttpResponse::send();
1081  * ?>
1082  * </pre>
1083  */
1084 PHP_METHOD(HttpResponse, send)
1085 {
1086         zval *sent;
1087         zend_bool clean_ob = 1;
1088
1089         if (SUCCESS != zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "|b", &clean_ob)) {
1090                 RETURN_FALSE;
1091         }
1092
1093         HTTP_CHECK_HEADERS_SENT(RETURN_FALSE);
1094
1095         sent = GET_STATIC_PROP(sent);
1096         if (Z_LVAL_P(sent)) {
1097                 http_error(HE_WARNING, HTTP_E_RESPONSE, "Cannot send HttpResponse, response has already been sent");
1098                 RETURN_FALSE;
1099         } else {
1100                 Z_LVAL_P(sent) = 1;
1101         }
1102
1103         /* capture mode */
1104         if (zval_is_true(GET_STATIC_PROP(catch))) {
1105                 zval *etag_p, *the_data;
1106
1107                 MAKE_STD_ZVAL(the_data);
1108                 php_ob_get_buffer(the_data TSRMLS_CC);
1109                 SET_STATIC_PROP(data, the_data);
1110                 ZVAL_LONG(GET_STATIC_PROP(mode), SEND_DATA);
1111
1112                 if (!Z_STRLEN_P(convert_to_type_ex(IS_STRING, GET_STATIC_PROP(eTag), &etag_p))) {
1113                         char *etag = http_etag(Z_STRVAL_P(the_data), Z_STRLEN_P(the_data), SEND_DATA);
1114                         if (etag) {
1115                                 UPD_STATIC_PROP(string, eTag, etag);
1116                                 efree(etag);
1117                         }
1118                 }
1119                 zval_ptr_dtor(&the_data);
1120
1121                 if (etag_p) {
1122                         zval_ptr_dtor(&etag_p);
1123                 }
1124
1125                 clean_ob = 1;
1126         }
1127
1128         if (clean_ob) {
1129                 /* interrupt on-the-fly etag generation */
1130                 HTTP_G(etag).started = 0;
1131                 /* discard previous output buffers */
1132                 php_end_ob_buffers(0 TSRMLS_CC);
1133         }
1134
1135         /* caching */
1136         if (zval_is_true(GET_STATIC_PROP(cache))) {
1137                 zval *cctl, *cctl_p, *etag, *etag_p, *lmod, *lmod_p;
1138
1139                 etag = convert_to_type_ex(IS_STRING, GET_STATIC_PROP(eTag), &etag_p);
1140                 lmod = convert_to_type_ex(IS_LONG, GET_STATIC_PROP(lastModified), &lmod_p);
1141                 cctl = convert_to_type_ex(IS_STRING, GET_STATIC_PROP(cacheControl), &cctl_p);
1142
1143                 http_cache_etag(Z_STRVAL_P(etag), Z_STRLEN_P(etag), Z_STRVAL_P(cctl), Z_STRLEN_P(cctl));
1144                 http_cache_last_modified(Z_LVAL_P(lmod), Z_LVAL_P(lmod) ? Z_LVAL_P(lmod) : time(NULL), Z_STRVAL_P(cctl), Z_STRLEN_P(cctl));
1145
1146                 if (etag_p) zval_ptr_dtor(&etag_p);
1147                 if (lmod_p) zval_ptr_dtor(&lmod_p);
1148                 if (cctl_p) zval_ptr_dtor(&cctl_p);
1149
1150                 if (php_ob_handler_used("blackhole" TSRMLS_CC)) {
1151                         RETURN_TRUE;
1152                 }
1153         }
1154
1155         /* content type */
1156         {
1157                 zval *ctype_p, *ctype = convert_to_type_ex(IS_STRING, GET_STATIC_PROP(contentType), &ctype_p);
1158                 if (Z_STRLEN_P(ctype)) {
1159                         http_send_content_type(Z_STRVAL_P(ctype), Z_STRLEN_P(ctype));
1160                 } else {
1161                         char *ctypes = INI_STR("default_mimetype");
1162                         size_t ctlen = ctypes ? strlen(ctypes) : 0;
1163
1164                         if (ctlen) {
1165                                 http_send_content_type(ctypes, ctlen);
1166                         } else {
1167                                 http_send_content_type("application/x-octetstream", lenof("application/x-octetstream"));
1168                         }
1169                 }
1170                 if (ctype_p) {
1171                         zval_ptr_dtor(&ctype_p);
1172                 }
1173         }
1174
1175         /* content disposition */
1176         {
1177                 zval *cd_p, *cd = convert_to_type_ex(IS_STRING, GET_STATIC_PROP(contentDisposition), &cd_p);
1178                 if (Z_STRLEN_P(cd)) {
1179                         http_send_header_ex("Content-Disposition", lenof("Content-Disposition"), Z_STRVAL_P(cd), Z_STRLEN_P(cd), 1, NULL);
1180                 }
1181                 if (cd_p) {
1182                         zval_ptr_dtor(&cd_p);
1183                 }
1184         }
1185
1186         /* throttling */
1187         {
1188                 zval *bsize_p, *bsize = convert_to_type_ex(IS_LONG, GET_STATIC_PROP(bufferSize), &bsize_p);
1189                 zval *delay_p, *delay = convert_to_type_ex(IS_DOUBLE, GET_STATIC_PROP(throttleDelay), &delay_p);
1190                 HTTP_G(send).buffer_size    = Z_LVAL_P(bsize);
1191                 HTTP_G(send).throttle_delay = Z_DVAL_P(delay);
1192                 if (bsize_p) zval_ptr_dtor(&bsize_p);
1193                 if (delay_p) zval_ptr_dtor(&delay_p);
1194         }
1195
1196         /* gzip */
1197         HTTP_G(send).gzip_encoding = zval_is_true(GET_STATIC_PROP(gzip));
1198
1199         /* start ob */
1200         php_start_ob_buffer(NULL, HTTP_G(send).buffer_size, 0 TSRMLS_CC);
1201
1202         /* send */
1203         switch (Z_LVAL_P(GET_STATIC_PROP(mode)))
1204         {
1205                 case SEND_DATA:
1206                 {
1207                         zval *zdata_p, *zdata = convert_to_type_ex(IS_STRING, GET_STATIC_PROP(data), &zdata_p);
1208                         RETVAL_SUCCESS(http_send_data_ex(Z_STRVAL_P(zdata), Z_STRLEN_P(zdata), 1));
1209                         if (zdata_p) zval_ptr_dtor(&zdata_p);
1210                         return;
1211                 }
1212
1213                 case SEND_RSRC:
1214                 {
1215                         php_stream *the_real_stream;
1216                         zval *the_stream_p, *the_stream = convert_to_type_ex(IS_LONG, GET_STATIC_PROP(stream), &the_stream_p);
1217                         the_stream->type = IS_RESOURCE;
1218                         php_stream_from_zval(the_real_stream, &the_stream);
1219                         RETVAL_SUCCESS(http_send_stream_ex(the_real_stream, 0, 1));
1220                         if (the_stream_p) zval_ptr_dtor(&the_stream_p);
1221                         return;
1222                 }
1223
1224                 default:
1225                 {
1226                         zval *file_p;
1227                         RETVAL_SUCCESS(http_send_file_ex(Z_STRVAL_P(convert_to_type_ex(IS_STRING, GET_STATIC_PROP(file), &file_p)), 1));
1228                         if (file_p) zval_ptr_dtor(&file_p);
1229                         return;
1230                 }
1231         }
1232 }
1233 /* }}} */
1234
1235 /* {{{ proto static void HttpResponse::capture()
1236  *
1237  * Capture script output.
1238  *
1239  * Example:
1240  * <pre>
1241  * <?php
1242  * HttpResponse::setCache(true);
1243  * HttpResponse::capture();
1244  * // script follows
1245  * ?>
1246  * </pre>
1247  */
1248 PHP_METHOD(HttpResponse, capture)
1249 {
1250         NO_ARGS;
1251
1252         HTTP_CHECK_HEADERS_SENT(RETURN_FALSE);
1253
1254         UPD_STATIC_PROP(long, catch, 1);
1255
1256         php_end_ob_buffers(0 TSRMLS_CC);
1257         php_start_ob_buffer(NULL, 40960, 0 TSRMLS_CC);
1258
1259         /* register shutdown function */
1260         {
1261                 zval func, retval, arg, *argp[1];
1262
1263                 INIT_PZVAL(&arg);
1264                 INIT_PZVAL(&func);
1265                 INIT_PZVAL(&retval);
1266                 ZVAL_STRINGL(&func, "register_shutdown_function", lenof("register_shutdown_function"), 0);
1267
1268                 array_init(&arg);
1269                 add_next_index_stringl(&arg, "HttpResponse", lenof("HttpResponse"), 1);
1270                 add_next_index_stringl(&arg, "send", lenof("send"), 1);
1271                 argp[0] = &arg;
1272                 call_user_function(EG(function_table), NULL, &func, &retval, 1, argp TSRMLS_CC);
1273                 zval_dtor(&arg);
1274         }
1275 }
1276 /* }}} */
1277
1278 #endif /* ZEND_ENGINE_2 && !WONKY */
1279
1280 /*
1281  * Local variables:
1282  * tab-width: 4
1283  * c-basic-offset: 4
1284  * End:
1285  * vim600: noet sw=4 ts=4 fdm=marker
1286  * vim<600: noet sw=4 ts=4
1287  */
1288