git.m6w6.name Git - m6w6/ext-http/blob - http_response_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 #include "missing.h"
  25
  26 /* broken static properties in PHP 5.0 */
  27 #if defined(ZEND_ENGINE_2) && !defined(WONKY)
  28
  29 #include "SAPI.h"
  30 #include "php_ini.h"
  31
  32 #include "php_http.h"
  33 #include "php_http_api.h"
  34 #include "php_http_std_defs.h"
  35 #include "php_http_response_object.h"
  36 #include "php_http_exception_object.h"
  37 #include "php_http_send_api.h"
  38 #include "php_http_cache_api.h"
  39 #include "php_http_headers_api.h"
  40
  41 #ifdef HTTP_HAVE_MHASH
  42 #       include <mhash.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 void _http_response_object_init(INIT_FUNC_ARGS)
 215 {
 216         HTTP_REGISTER_CLASS(HttpResponse, http_response_object, NULL, 0);
 217         http_response_object_declare_default_properties();
 218 }
 219
 220 static inline void _http_response_object_declare_default_properties(TSRMLS_D)
 221 {
 222         zend_class_entry *ce = http_response_object_ce;
 223
 224         DCL_STATIC_PROP(PRIVATE, bool, sent, 0);
 225         DCL_STATIC_PROP(PRIVATE, bool, catch, 0);
 226         DCL_STATIC_PROP(PRIVATE, long, mode, -1);
 227         DCL_STATIC_PROP(PRIVATE, long, stream, 0);
 228         DCL_STATIC_PROP_N(PRIVATE, file);
 229         DCL_STATIC_PROP_N(PRIVATE, data);
 230         DCL_STATIC_PROP(PROTECTED, bool, cache, 0);
 231         DCL_STATIC_PROP(PROTECTED, bool, gzip, 0);
 232         DCL_STATIC_PROP_N(PROTECTED, eTag);
 233         DCL_STATIC_PROP(PROTECTED, long, lastModified, 0);
 234         DCL_STATIC_PROP_N(PROTECTED, cacheControl);
 235         DCL_STATIC_PROP_N(PROTECTED, contentType);
 236         DCL_STATIC_PROP_N(PROTECTED, contentDisposition);
 237         DCL_STATIC_PROP(PROTECTED, long, bufferSize, HTTP_SENDBUF_SIZE);
 238         DCL_STATIC_PROP(PROTECTED, double, throttleDelay, 0.0);
 239
 240 #ifndef WONKY
 241         DCL_CONST(long, "ETAG_MD5", HTTP_ETAG_MD5);
 242         DCL_CONST(long, "ETAG_SHA1", HTTP_ETAG_SHA1);
 243         DCL_CONST(long, "ETAG_CRC32", HTTP_ETAG_CRC32);
 244
 245 #       ifdef HTTP_HAVE_MHASH
 246         {
 247                 int l, i, c = mhash_count();
 248
 249                 for (i = 0; i <= c; ++i) {
 250                         char const_name[256] = {0};
 251                         const char *hash_name = mhash_get_hash_name_static(i);
 252
 253                         if (hash_name) {
 254                                 l = snprintf(const_name, 255, "ETAG_MHASH_%s", hash_name);
 255                                 zend_declare_class_constant_long(ce, const_name, l, i TSRMLS_CC);
 256                         }
 257                 }
 258         }
 259 #       endif /* HTTP_HAVE_MHASH */
 260 #endif /* WONKY */
 261 }
 262
 263 static void _http_grab_response_headers(void *data, void *arg TSRMLS_DC)
 264 {
 265         phpstr_appendl(PHPSTR(arg), ((sapi_header_struct *)data)->header);
 266         phpstr_appends(PHPSTR(arg), HTTP_CRLF);
 267 }
 268
 269 /* ### USERLAND ### */
 270
 271 /* {{{ proto static bool HttpResponse::setHeader(string name, mixed value[, bool replace = true)
 272  */
 273 PHP_METHOD(HttpResponse, setHeader)
 274 {
 275         zend_bool replace = 1;
 276         char *name;
 277         int name_len = 0;
 278         zval *value = NULL;
 279
 280         if (SUCCESS != zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "sz/!|b", &name, &name_len, &value, &replace)) {
 281                 RETURN_FALSE;
 282         }
 283         if (SG(headers_sent)) {
 284                 http_error(HE_WARNING, HTTP_E_HEADER, "Cannot add another header when headers have already been sent");
 285                 RETURN_FALSE;
 286         }
 287         if (!name_len) {
 288                 http_error(HE_WARNING, HTTP_E_HEADER, "Cannot send anonymous headers");
 289                 RETURN_FALSE;
 290         }
 291
 292         /* delete header if value == null */
 293         if (!value || Z_TYPE_P(value) == IS_NULL) {
 294                 RETURN_SUCCESS(http_send_header_ex(name, name_len, "", 0, replace, NULL));
 295         }
 296         /* send multiple header if replace is false and value is an array */
 297         if (!replace && Z_TYPE_P(value) == IS_ARRAY) {
 298                 zval **data;
 299
 300                 FOREACH_VAL(value, data) {
 301                         convert_to_string_ex(data);
 302                         if (SUCCESS != http_send_header_ex(name, name_len, Z_STRVAL_PP(data), Z_STRLEN_PP(data), 0, NULL)) {
 303                                 RETURN_FALSE;
 304                         }
 305                 }
 306                 RETURN_TRUE;
 307         }
 308         /* send standard header */
 309         if (Z_TYPE_P(value) != IS_STRING) {
 310                 convert_to_string_ex(&value);
 311         }
 312         RETURN_SUCCESS(http_send_header_ex(name, name_len, Z_STRVAL_P(value), Z_STRLEN_P(value), replace, NULL));
 313 }
 314 /* }}} */
 315
 316 /* {{{ proto static mixed HttpResponse::getHeader([string name])
 317  */
 318 PHP_METHOD(HttpResponse, getHeader)
 319 {
 320         char *name = NULL;
 321         int name_len = 0;
 322         phpstr headers;
 323
 324         if (SUCCESS != zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "|s", &name, &name_len)) {
 325                 RETURN_FALSE;
 326         }
 327
 328         phpstr_init(&headers);
 329         zend_llist_apply_with_argument(&SG(sapi_headers).headers, http_grab_response_headers, &headers TSRMLS_CC);
 330         phpstr_fix(&headers);
 331
 332         if (name && name_len) {
 333                 zval **header;
 334                 HashTable headers_ht;
 335
 336                 zend_hash_init(&headers_ht, sizeof(zval *), NULL, ZVAL_PTR_DTOR, 0);
 337                 if (    (SUCCESS == http_parse_headers_ex(PHPSTR_VAL(&headers), &headers_ht, 1)) &&
 338                                 (SUCCESS == zend_hash_find(&headers_ht, name, name_len + 1, (void **) &header))) {
 339                         RETVAL_ZVAL(*header, 1, 0);
 340                 } else {
 341                         RETVAL_NULL();
 342                 }
 343                 zend_hash_destroy(&headers_ht);
 344         } else {
 345                 array_init(return_value);
 346                 http_parse_headers_ex(PHPSTR_VAL(&headers), Z_ARRVAL_P(return_value), 1);
 347         }
 348
 349         phpstr_dtor(&headers);
 350 }
 351 /* }}} */
 352
 353 /* {{{ proto static bool HttpResponse::setCache(bool cache)
 354  *
 355  * Whether it sould be attempted to cache the entitity.
 356  * This will result in necessary caching headers and checks of clients
 357  * "If-Modified-Since" and "If-None-Match" headers.  If one of those headers
 358  * matches a "304 Not Modified" status code will be issued.
 359  *
 360  * NOTE: If you're using sessions, be shure that you set session.cache_limiter
 361  * to something more appropriate than "no-cache"!
 362  */
 363 PHP_METHOD(HttpResponse, setCache)
 364 {
 365         zend_bool do_cache = 0;
 366
 367         if (SUCCESS != zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "b", &do_cache)) {
 368                 RETURN_FALSE;
 369         }
 370
 371         RETURN_SUCCESS(UPD_STATIC_PROP(bool, cache, do_cache));
 372 }
 373 /* }}} */
 374
 375 /* {{{ proto static bool HttpResponse::getCache()
 376  *
 377  * Get current caching setting.
 378  */
 379 PHP_METHOD(HttpResponse, getCache)
 380 {
 381         NO_ARGS;
 382
 383         IF_RETVAL_USED {
 384                 zval *cache = convert_to_type_ex(IS_BOOL, GET_STATIC_PROP(cache));
 385
 386                 RETURN_ZVAL(cache, 1, 0);
 387         }
 388 }
 389 /* }}}*/
 390
 391 /* {{{ proto static bool HttpResponse::setGzip(bool gzip)
 392  *
 393  * Enable on-thy-fly gzipping of the sent entity.
 394  */
 395 PHP_METHOD(HttpResponse, setGzip)
 396 {
 397         zend_bool do_gzip = 0;
 398
 399         if (SUCCESS != zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "b", &do_gzip)) {
 400                 RETURN_FALSE;
 401         }
 402
 403         RETURN_SUCCESS(UPD_STATIC_PROP(bool, gzip, do_gzip));
 404 }
 405 /* }}} */
 406
 407 /* {{{ proto static bool HttpResponse::getGzip()
 408  *
 409  * Get current gzipping setting.
 410  */
 411 PHP_METHOD(HttpResponse, getGzip)
 412 {
 413         NO_ARGS;
 414
 415         IF_RETVAL_USED {
 416                 zval *gzip = convert_to_type_ex(IS_BOOL, GET_STATIC_PROP(gzip));
 417
 418                 RETURN_ZVAL(gzip, 1, 0);
 419         }
 420 }
 421 /* }}} */
 422
 423 /* {{{ proto static bool HttpResponse::setCacheControl(string control[, long max_age = 0])
 424  *
 425  * Set a custom cache-control header, usually being "private" or "public";
 426  * The max_age parameter controls how long the cache entry is valid on the client side.
 427  */
 428 PHP_METHOD(HttpResponse, setCacheControl)
 429 {
 430         char *ccontrol, *cctl;
 431         int cc_len;
 432         long max_age = 0;
 433
 434         if (SUCCESS != zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "s|l", &ccontrol, &cc_len, &max_age)) {
 435                 RETURN_FALSE;
 436         }
 437
 438         if (strcmp(ccontrol, "public") && strcmp(ccontrol, "private") && strcmp(ccontrol, "no-cache")) {
 439                 http_error_ex(HE_WARNING, HTTP_E_INVALID_PARAM, "Cache-Control '%s' doesn't match public, private or no-cache", ccontrol);
 440                 RETURN_FALSE;
 441         } else {
 442                 size_t cctl_len = spprintf(&cctl, 0, "%s, must-revalidate, max_age=%ld", ccontrol, max_age);
 443                 RETVAL_SUCCESS(UPD_STATIC_STRL(cacheControl, cctl, cctl_len));
 444                 efree(cctl);
 445         }
 446 }
 447 /* }}} */
 448
 449 /* {{{ proto static string HttpResponse::getCacheControl()
 450  *
 451  * Get current Cache-Control header setting.
 452  */
 453 PHP_METHOD(HttpResponse, getCacheControl)
 454 {
 455         NO_ARGS;
 456
 457         IF_RETVAL_USED {
 458                 zval *ccontrol = convert_to_type_ex(IS_STRING, GET_STATIC_PROP(cacheControl));
 459
 460                 RETURN_ZVAL(ccontrol, 1, 0);
 461         }
 462 }
 463 /* }}} */
 464
 465 /* {{{ proto static bool HttpResponse::setContentType(string content_type)
 466  *
 467  * Set the content-type of the sent entity.
 468  */
 469 PHP_METHOD(HttpResponse, setContentType)
 470 {
 471         char *ctype;
 472         int ctype_len;
 473
 474         if (SUCCESS != zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "s", &ctype, &ctype_len)) {
 475                 RETURN_FALSE;
 476         }
 477
 478         if (!strchr(ctype, '/')) {
 479                 http_error_ex(HE_WARNING, HTTP_E_INVALID_PARAM, "Content type '%s' doesn't seem to contain a primary and a secondary part", ctype);
 480                 RETURN_FALSE;
 481         }
 482
 483         RETURN_SUCCESS(UPD_STATIC_STRL(contentType, ctype, ctype_len));
 484 }
 485 /* }}} */
 486
 487 /* {{{ proto static string HttpResponse::getContentType()
 488  *
 489  * Get current Content-Type header setting.
 490  */
 491 PHP_METHOD(HttpResponse, getContentType)
 492 {
 493         NO_ARGS;
 494
 495         IF_RETVAL_USED {
 496                 zval *ctype = convert_to_type_ex(IS_STRING, GET_STATIC_PROP(contentType));
 497
 498                 RETURN_ZVAL(ctype, 1, 0);
 499         }
 500 }
 501 /* }}} */
 502
 503 /* {{{ proto static string HttpResponse::guessContentType(string magic_file[, long magic_mode = MAGIC_MIME])
 504  *
 505  * Attempts to guess the content type of supplied payload through libmagic.
 506  */
 507 PHP_METHOD(HttpResponse, guessContentType)
 508 {
 509         char *magic_file, *ct = NULL;
 510         int magic_file_len;
 511         long magic_mode = 0;
 512
 513         RETVAL_NULL();
 514
 515 #ifdef HTTP_HAVE_MAGIC
 516         magic_mode = MAGIC_MIME;
 517
 518         SET_EH_THROW_HTTP();
 519         if (SUCCESS == zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "s|l", &magic_file, &magic_file_len, &magic_mode)) {
 520                 switch (Z_LVAL_P(GET_STATIC_PROP(mode))) {
 521                         case SEND_DATA:
 522                         {
 523                                 zval *data = GET_STATIC_PROP(data);
 524                                 ct = http_guess_content_type(magic_file, magic_mode, Z_STRVAL_P(data), Z_STRLEN_P(data), SEND_DATA);
 525                         }
 526                         break;
 527
 528                         case SEND_RSRC:
 529                         {
 530                                 php_stream *s;
 531                                 zval *z = GET_STATIC_PROP(stream);
 532                                 z->type = IS_RESOURCE;
 533                                 php_stream_from_zval(s, &z);
 534                                 ct = http_guess_content_type(magic_file, magic_mode, s, 0, SEND_RSRC);
 535                         }
 536                         break;
 537
 538                         default:
 539                                 ct = http_guess_content_type(magic_file, magic_mode, Z_STRVAL_P(GET_STATIC_PROP(file)), 0, -1);
 540                         break;
 541                 }
 542                 if (ct) {
 543                         UPD_STATIC_PROP(string, contentType, ct);
 544                         RETVAL_STRING(ct, 0);
 545                 }
 546         }
 547         SET_EH_NORMAL();
 548 #else
 549         http_error(HE_THROW, HTTP_E_RUNTIME, "Cannot guess Content-Type; libmagic not available");
 550 #endif
 551 }
 552 /* }}} */
 553
 554 /* {{{ proto static bool HttpResponse::setContentDisposition(string filename[, bool inline = false])
 555  *
 556  * Set the Content-Disposition of the sent entity.  This setting aims to suggest
 557  * the receiveing user agent how to handle the sent entity;  usually the client
 558  * will show the user a "Save As..." popup.
 559  */
 560 PHP_METHOD(HttpResponse, setContentDisposition)
 561 {
 562         char *file, *cd;
 563         int file_len;
 564         size_t cd_len;
 565         zend_bool send_inline = 0;
 566
 567         if (SUCCESS != zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "s|b", &file, &file_len, &send_inline)) {
 568                 RETURN_FALSE;
 569         }
 570
 571         cd_len = spprintf(&cd, 0, "%s; filename=\"%s\"", send_inline ? "inline" : "attachment", file);
 572         RETVAL_SUCCESS(UPD_STATIC_STRL(contentDisposition, cd, cd_len));
 573         efree(cd);
 574 }
 575 /* }}} */
 576
 577 /* {{{ proto static string HttpResponse::getContentDisposition()
 578  *
 579  * Get current Content-Disposition setting.
 580  */
 581 PHP_METHOD(HttpResponse, getContentDisposition)
 582 {
 583         NO_ARGS;
 584
 585         IF_RETVAL_USED {
 586                 zval *cd = convert_to_type_ex(IS_STRING, GET_STATIC_PROP(contentDisposition));
 587
 588                 RETURN_ZVAL(cd, 1, 0);
 589         }
 590 }
 591 /* }}} */
 592
 593 /* {{{ proto static bool HttpResponse::setETag(string etag)
 594  *
 595  * Set a custom ETag.  Use this only if you know what you're doing.
 596  */
 597 PHP_METHOD(HttpResponse, setETag)
 598 {
 599         char *etag;
 600         int etag_len;
 601
 602         if (SUCCESS != zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "s", &etag, &etag_len)) {
 603                 RETURN_FALSE;
 604         }
 605
 606         RETURN_SUCCESS(UPD_STATIC_STRL(eTag, etag, etag_len));
 607 }
 608 /* }}} */
 609
 610 /* {{{ proto static string HttpResponse::getETag()
 611  *
 612  * Get calculated or previously set custom ETag.
 613  */
 614 PHP_METHOD(HttpResponse, getETag)
 615 {
 616         NO_ARGS;
 617
 618         IF_RETVAL_USED {
 619                 zval *etag = convert_to_type_ex(IS_STRING, GET_STATIC_PROP(eTag));
 620
 621                 RETURN_ZVAL(etag, 1, 0);
 622         }
 623 }
 624 /* }}} */
 625
 626 /* {{{ proto static bool HttpResponse::setLastModified(long timestamp)
 627  *
 628  * Set a custom Last-Modified date.
 629  */
 630 PHP_METHOD(HttpResponse, setLastModified)
 631 {
 632         long lm;
 633
 634         if (SUCCESS != zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "l", &lm)) {
 635                 RETURN_FALSE;
 636         }
 637
 638         RETURN_SUCCESS(UPD_STATIC_PROP(long, lastModified, lm));
 639 }
 640 /* }}} */
 641
 642 /* {{{ proto static HttpResponse::getLastModified()
 643  *
 644  * Get calculated or previously set custom Last-Modified date.
 645  */
 646 PHP_METHOD(HttpResponse, getLastModified)
 647 {
 648         NO_ARGS;
 649
 650         IF_RETVAL_USED {
 651                 zval *lm = convert_to_type_ex(IS_LONG, GET_STATIC_PROP(lastModified));
 652
 653                 RETURN_ZVAL(lm, 1, 0);
 654         }
 655 }
 656 /* }}} */
 657
 658 /* {{{ proto static bool HttpResponse::setThrottleDelay(double seconds)
 659  *
 660  */
 661 PHP_METHOD(HttpResponse, setThrottleDelay)
 662 {
 663         double seconds;
 664
 665         if (SUCCESS != zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "d", &seconds)) {
 666                 RETURN_FALSE;
 667         }
 668         RETURN_SUCCESS(UPD_STATIC_PROP(double, throttleDelay, seconds));
 669 }
 670 /* }}} */
 671
 672 /* {{{ proto static double HttpResponse::getThrottleDelay()
 673  *
 674  */
 675 PHP_METHOD(HttpResponse, getThrottleDelay)
 676 {
 677         NO_ARGS;
 678
 679         IF_RETVAL_USED {
 680                 zval *delay = convert_to_type_ex(IS_DOUBLE, GET_STATIC_PROP(throttleDelay));
 681
 682                 RETURN_ZVAL(delay, 1, 0);
 683         }
 684 }
 685 /* }}} */
 686
 687 /* {{{ proto static bool HttpResponse::setBufferSize(long bytes)
 688  *
 689  */
 690 PHP_METHOD(HttpResponse, setBufferSize)
 691 {
 692         long bytes;
 693
 694         if (SUCCESS != zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "l", &bytes)) {
 695                 RETURN_FALSE;
 696         }
 697         RETURN_SUCCESS(UPD_STATIC_PROP(long, bufferSize, bytes));
 698 }
 699 /* }}} */
 700
 701 /* {{{ proto static long HttpResponse::getBufferSize()
 702  *
 703  */
 704 PHP_METHOD(HttpResponse, getBufferSize)
 705 {
 706         NO_ARGS;
 707
 708         IF_RETVAL_USED {
 709                 zval *size = convert_to_type_ex(IS_LONG, GET_STATIC_PROP(bufferSize));
 710
 711                 RETURN_ZVAL(size, 1, 0);
 712         }
 713 }
 714 /* }}} */
 715
 716 /* {{{ proto static bool HttpResponse::setData(string data)
 717  *
 718  * Set the data to be sent.
 719  */
 720 PHP_METHOD(HttpResponse, setData)
 721 {
 722         zval *the_data;
 723
 724         if (SUCCESS != zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "z", &the_data)) {
 725                 RETURN_FALSE;
 726         }
 727         if (Z_TYPE_P(the_data) != IS_STRING) {
 728                 convert_to_string_ex(&the_data);
 729         }
 730
 731         if (    (SUCCESS != SET_STATIC_PROP(data, the_data)) ||
 732                         (SUCCESS != UPD_STATIC_PROP(long, mode, SEND_DATA))) {
 733                 RETURN_FALSE;
 734         }
 735
 736         if (!(Z_LVAL_P(convert_to_type_ex(IS_LONG, GET_STATIC_PROP(lastModified))) > 0)) {
 737                 UPD_STATIC_PROP(long, lastModified, http_last_modified(the_data, SEND_DATA));
 738         }
 739         if (!Z_STRLEN_P(convert_to_type_ex(IS_STRING, GET_STATIC_PROP(eTag)))) {
 740                 char *etag = http_etag(Z_STRVAL_P(the_data), Z_STRLEN_P(the_data), SEND_DATA);
 741                 if (etag) {
 742                         UPD_STATIC_PROP(string, eTag, etag);
 743                         efree(etag);
 744                 }
 745         }
 746
 747         RETURN_TRUE;
 748 }
 749 /* }}} */
 750
 751 /* {{{ proto static string HttpResponse::getData()
 752  *
 753  * Get the previously set data to be sent.
 754  */
 755 PHP_METHOD(HttpResponse, getData)
 756 {
 757         NO_ARGS;
 758
 759         IF_RETVAL_USED {
 760                 zval *the_data = GET_STATIC_PROP(data);
 761
 762                 RETURN_ZVAL(the_data, 1, 0);
 763         }
 764 }
 765 /* }}} */
 766
 767 /* {{{ proto static bool HttpResponse::setStream(resource stream)
 768  *
 769  * Set the resource to be sent.
 770  */
 771 PHP_METHOD(HttpResponse, setStream)
 772 {
 773         zval *the_stream;
 774         php_stream *the_real_stream;
 775         php_stream_statbuf ssb;
 776
 777         if (SUCCESS != zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "r", &the_stream)) {
 778                 RETURN_FALSE;
 779         }
 780
 781         php_stream_from_zval(the_real_stream, &the_stream);
 782         if (php_stream_stat(the_real_stream, &ssb)) {
 783                 RETURN_FALSE;
 784         }
 785
 786         if (    (SUCCESS != UPD_STATIC_PROP(long, stream, Z_LVAL_P(the_stream))) ||
 787                         (SUCCESS != UPD_STATIC_PROP(long, mode, SEND_RSRC))) {
 788                 RETURN_FALSE;
 789         }
 790         zend_list_addref(Z_LVAL_P(the_stream));
 791
 792         if (!(Z_LVAL_P(convert_to_type_ex(IS_LONG, GET_STATIC_PROP(lastModified))) > 0)) {
 793                 UPD_STATIC_PROP(long, lastModified, http_last_modified(the_real_stream, SEND_RSRC));
 794         }
 795         if (!Z_STRLEN_P(convert_to_type_ex(IS_STRING, GET_STATIC_PROP(eTag)))) {
 796                 char *etag = http_etag(the_real_stream, 0, SEND_RSRC);
 797                 if (etag) {
 798                         UPD_STATIC_PROP(string, eTag, etag);
 799                         efree(etag);
 800                 }
 801         }
 802
 803         RETURN_TRUE;
 804 }
 805 /* }}} */
 806
 807 /* {{{ proto static resource HttpResponse::getStream()
 808  *
 809  * Get the previously set resource to be sent.
 810  */
 811 PHP_METHOD(HttpResponse, getStream)
 812 {
 813         NO_ARGS;
 814
 815         IF_RETVAL_USED {
 816                 RETURN_RESOURCE(Z_LVAL_P(convert_to_type_ex(IS_LONG, GET_STATIC_PROP(stream))));
 817         }
 818 }
 819 /* }}} */
 820
 821 /* {{{ proto static bool HttpResponse::setFile(string file)
 822  *
 823  * Set the file to be sent.
 824  */
 825 PHP_METHOD(HttpResponse, setFile)
 826 {
 827         char *the_file;
 828         int file_len;
 829         php_stream_statbuf ssb;
 830
 831         if (SUCCESS != zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "s", &the_file, &file_len)) {
 832                 RETURN_FALSE;
 833         }
 834
 835         if (php_stream_stat_path(the_file, &ssb)) {
 836                 RETURN_FALSE;
 837         }
 838
 839         if (    (SUCCESS != UPD_STATIC_STRL(file, the_file, file_len)) ||
 840                         (SUCCESS != UPD_STATIC_PROP(long, mode, -1))) {
 841                 RETURN_FALSE;
 842         }
 843
 844         if (!(Z_LVAL_P(convert_to_type_ex(IS_LONG, GET_STATIC_PROP(lastModified))) > 0)) {
 845                 UPD_STATIC_PROP(long, lastModified, http_last_modified(the_file, -1));
 846         }
 847         if (!Z_STRLEN_P(convert_to_type_ex(IS_STRING, GET_STATIC_PROP(eTag)))) {
 848                 char *etag = http_etag(the_file, 0, -1);
 849                 if (etag) {
 850                         UPD_STATIC_PROP(string, eTag, etag);
 851                         efree(etag);
 852                 }
 853         }
 854
 855         RETURN_TRUE;
 856 }
 857 /* }}} */
 858
 859 /* {{{ proto static string HttpResponse::getFile()
 860  *
 861  * Get the previously set file to be sent.
 862  */
 863 PHP_METHOD(HttpResponse, getFile)
 864 {
 865         NO_ARGS;
 866
 867         IF_RETVAL_USED {
 868                 zval *the_file = convert_to_type_ex(IS_STRING, GET_STATIC_PROP(file));
 869
 870                 RETURN_ZVAL(the_file, 1, 0);
 871         }
 872 }
 873 /* }}} */
 874
 875 /* {{{ proto static bool HttpResponse::send([bool clean_ob = true])
 876  *
 877  * Finally send the entity.
 878  *
 879  * Example:
 880  * <pre>
 881  * <?php
 882  * HttpResponse::setCache(true);
 883  * HttpResponse::setContentType('application/pdf');
 884  * HttpResponse::setContentDisposition("$user.pdf", false);
 885  * HttpResponse::setFile('sheet.pdf');
 886  * HttpResponse::send();
 887  * ?>
 888  * </pre>
 889  */
 890 PHP_METHOD(HttpResponse, send)
 891 {
 892         zval *sent;
 893         zend_bool clean_ob = 1;
 894
 895         if (SUCCESS != zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "|b", &clean_ob)) {
 896                 RETURN_FALSE;
 897         }
 898         if (SG(headers_sent)) {
 899                 http_error(HE_WARNING, HTTP_E_RESPONSE, "Cannot send HttpResponse, headers have already been sent");
 900                 RETURN_FALSE;
 901         }
 902
 903         sent = GET_STATIC_PROP(sent);
 904         if (zval_is_true(sent)) {
 905                 http_error(HE_WARNING, HTTP_E_RESPONSE, "Cannot send HttpResponse, response has already been sent");
 906                 RETURN_FALSE;
 907         } else {
 908                 Z_LVAL_P(sent) = 1;
 909         }
 910
 911         /* capture mode */
 912         if (zval_is_true(GET_STATIC_PROP(catch))) {
 913                 zval *the_data;
 914
 915                 MAKE_STD_ZVAL(the_data);
 916                 php_ob_get_buffer(the_data TSRMLS_CC);
 917                 SET_STATIC_PROP(data, the_data);
 918                 ZVAL_LONG(GET_STATIC_PROP(mode), SEND_DATA);
 919
 920                 if (!Z_STRLEN_P(convert_to_type_ex(IS_STRING, GET_STATIC_PROP(eTag)))) {
 921                         char *etag = http_etag(Z_STRVAL_P(the_data), Z_STRLEN_P(the_data), SEND_DATA);
 922                         if (etag) {
 923                                 UPD_STATIC_PROP(string, eTag, etag);
 924                                 efree(etag);
 925                         }
 926                 }
 927                 zval_ptr_dtor(&the_data);
 928
 929                 clean_ob = 1;
 930         }
 931
 932         if (clean_ob) {
 933                 /* interrupt on-the-fly etag generation */
 934                 HTTP_G(etag).started = 0;
 935                 /* discard previous output buffers */
 936                 php_end_ob_buffers(0 TSRMLS_CC);
 937         }
 938
 939         /* gzip */
 940         if (zval_is_true(GET_STATIC_PROP(gzip))) {
 941                 php_start_ob_buffer_named("ob_gzhandler", 0, 0 TSRMLS_CC);
 942         } else {
 943                 php_start_ob_buffer(NULL, 0, 0 TSRMLS_CC);
 944         }
 945
 946         /* caching */
 947         if (zval_is_true(GET_STATIC_PROP(cache))) {
 948                 zval *cctl, *etag, *lmod;
 949
 950                 etag = convert_to_type_ex(IS_STRING, GET_STATIC_PROP(eTag));
 951                 lmod = convert_to_type_ex(IS_LONG, GET_STATIC_PROP(lastModified));
 952                 cctl = convert_to_type_ex(IS_STRING, GET_STATIC_PROP(cacheControl));
 953
 954                 http_cache_etag(Z_STRVAL_P(etag), Z_STRLEN_P(etag), Z_STRVAL_P(cctl), Z_STRLEN_P(cctl));
 955                 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));
 956         }
 957
 958         /* content type */
 959         {
 960                 zval *ctype = convert_to_type_ex(IS_STRING, GET_STATIC_PROP(contentType));
 961                 if (Z_STRLEN_P(ctype)) {
 962                         http_send_content_type(Z_STRVAL_P(ctype), Z_STRLEN_P(ctype));
 963                 } else {
 964                         char *ctypes = INI_STR("default_mimetype");
 965                         size_t ctlen = ctypes ? strlen(ctypes) : 0;
 966
 967                         if (ctlen) {
 968                                 http_send_content_type(ctypes, ctlen);
 969                         } else {
 970                                 http_send_content_type("application/x-octetstream", lenof("application/x-octetstream"));
 971                         }
 972                 }
 973         }
 974
 975         /* content disposition */
 976         {
 977                 zval *cd = GET_STATIC_PROP(contentDisposition);
 978                 if (Z_STRLEN_P(cd)) {
 979                         http_send_header_ex("Content-Disposition", lenof("Content-Disposition"), Z_STRVAL_P(cd), Z_STRLEN_P(cd), 1, NULL);
 980                 }
 981         }
 982
 983         /* throttling */
 984         {
 985                 HTTP_G(send).buffer_size    = Z_LVAL_P(convert_to_type_ex(IS_LONG, GET_STATIC_PROP(bufferSize)));
 986                 HTTP_G(send).throttle_delay = Z_DVAL_P(convert_to_type_ex(IS_DOUBLE, GET_STATIC_PROP(throttleDelay)));
 987         }
 988
 989         /* send */
 990         {
 991                 switch (Z_LVAL_P(GET_STATIC_PROP(mode)))
 992                 {
 993                         case SEND_DATA:
 994                         {
 995                                 zval *zdata = convert_to_type_ex(IS_STRING, GET_STATIC_PROP(data));
 996                                 RETURN_SUCCESS(http_send_data_ex(Z_STRVAL_P(zdata), Z_STRLEN_P(zdata), 1));
 997                         }
 998
 999                         case SEND_RSRC:
1000                         {
1001                                 php_stream *the_real_stream;
1002                                 zval *the_stream = convert_to_type_ex(IS_LONG, GET_STATIC_PROP(stream));
1003                                 the_stream->type = IS_RESOURCE;
1004                                 php_stream_from_zval(the_real_stream, &the_stream);
1005                                 RETURN_SUCCESS(http_send_stream_ex(the_real_stream, 0, 1));
1006                         }
1007
1008                         default:
1009                         {
1010                                 RETURN_SUCCESS(http_send_file_ex(Z_STRVAL_P(convert_to_type_ex(IS_STRING, GET_STATIC_PROP(file))), 1));
1011                         }
1012                 }
1013         }
1014 }
1015 /* }}} */
1016
1017 /* {{{ proto static void HttpResponse::capture()
1018  *
1019  * Capture script output.
1020  *
1021  * Example:
1022  * <pre>
1023  * <?php
1024  * HttpResponse::setCache(true);
1025  * HttpResponse::capture();
1026  * // script follows
1027  * ?>
1028  * </pre>
1029  */
1030 PHP_METHOD(HttpResponse, capture)
1031 {
1032         NO_ARGS;
1033
1034         UPD_STATIC_PROP(long, catch, 1);
1035
1036         php_end_ob_buffers(0 TSRMLS_CC);
1037         php_start_ob_buffer(NULL, 0, 0 TSRMLS_CC);
1038
1039         /* register shutdown function */
1040         {
1041                 zval func, retval, arg, *argp[1];
1042
1043                 INIT_PZVAL(&arg);
1044                 INIT_PZVAL(&func);
1045                 INIT_PZVAL(&retval);
1046                 ZVAL_STRINGL(&func, "register_shutdown_function", lenof("register_shutdown_function"), 0);
1047
1048                 array_init(&arg);
1049                 add_next_index_stringl(&arg, "HttpResponse", lenof("HttpResponse"), 1);
1050                 add_next_index_stringl(&arg, "send", lenof("send"), 1);
1051                 argp[0] = &arg;
1052                 call_user_function(EG(function_table), NULL, &func, &retval, 1, argp TSRMLS_CC);
1053                 zval_dtor(&arg);
1054         }
1055 }
1056 /* }}} */
1057
1058 #endif /* ZEND_ENGINE_2 && !WONKY */
1059
1060 /*
1061  * Local variables:
1062  * tab-width: 4
1063  * c-basic-offset: 4
1064  * End:
1065  * vim600: noet sw=4 ts=4 fdm=marker
1066  * vim<600: noet sw=4 ts=4
1067  */
1068