+ NO_ARGS;
+
+ IF_RETVAL_USED {
+ zval *cache = convert_to_type_ex(IS_BOOL, GET_STATIC_PROP(cache));
+
+ RETURN_ZVAL(cache, 1, 0);
+ }
+}
+/* }}}*/
+
+/* {{{ proto static bool HttpResponse::setGzip(bool gzip)
+ *
+ * Enable on-thy-fly gzipping of the sent entity.
+ *
+ * Expects a boolean as parameter indicating if GZip compression should be enabled.
+ *
+ * Returns TRUE on success, or FALSE on failure.
+ */
+PHP_METHOD(HttpResponse, setGzip)
+{
+ zend_bool do_gzip = 0;
+
+ if (SUCCESS != zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "b", &do_gzip)) {
+ RETURN_FALSE;
+ }
+
+ RETURN_SUCCESS(UPD_STATIC_PROP(bool, gzip, do_gzip));
+}
+/* }}} */
+
+/* {{{ proto static bool HttpResponse::getGzip()
+ *
+ * Get current gzipping setting.
+ *
+ * Returns TRUE if GZip compression is enabled, else FALSE.
+ */
+PHP_METHOD(HttpResponse, getGzip)
+{
+ NO_ARGS;
+
+ IF_RETVAL_USED {
+ zval *gzip = convert_to_type_ex(IS_BOOL, GET_STATIC_PROP(gzip));
+
+ RETURN_ZVAL(gzip, 1, 0);
+ }
+}
+/* }}} */
+
+/* {{{ proto static bool HttpResponse::setCacheControl(string control[, int max_age = 0])
+ *
+ * Set a custom cache-control header, usually being "private" or "public";
+ * The max_age parameter controls how long the cache entry is valid on the client side.
+ *
+ * Expects a string parameter containing the primary cache control setting.
+ * Addtitionally accepts an int parameter specifying the max-age setting.
+ *
+ * Returns TRUE on success, or FALSE if control does not match one of
+ * "public" , "private" or "no-cache".
+ *
+ * Throws HttpInvalidParamException if http.only_exceptions is TRUE.
+ */
+PHP_METHOD(HttpResponse, setCacheControl)
+{
+ char *ccontrol, *cctl;
+ int cc_len;
+ long max_age = 0;
+
+ if (SUCCESS != zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "s|l", &ccontrol, &cc_len, &max_age)) {
+ RETURN_FALSE;
+ }
+
+ if (strcmp(ccontrol, "public") && strcmp(ccontrol, "private") && strcmp(ccontrol, "no-cache")) {
+ http_error_ex(HE_WARNING, HTTP_E_INVALID_PARAM, "Cache-Control '%s' doesn't match public, private or no-cache", ccontrol);
+ RETURN_FALSE;
+ } else {
+ size_t cctl_len = spprintf(&cctl, 0, "%s, must-revalidate, max_age=%ld", ccontrol, max_age);
+ RETVAL_SUCCESS(UPD_STATIC_STRL(cacheControl, cctl, cctl_len));
+ efree(cctl);
+ }
+}
+/* }}} */
+
+/* {{{ proto static string HttpResponse::getCacheControl()
+ *
+ * Get current Cache-Control header setting.
+ *
+ * Returns the current cache control setting as a string like sent in a header.
+ */
+PHP_METHOD(HttpResponse, getCacheControl)
+{
+ NO_ARGS;
+
+ IF_RETVAL_USED {
+ zval *ccontrol = convert_to_type_ex(IS_STRING, GET_STATIC_PROP(cacheControl));
+
+ RETURN_ZVAL(ccontrol, 1, 0);
+ }
+}
+/* }}} */
+
+/* {{{ proto static bool HttpResponse::setContentType(string content_type)
+ *
+ * Set the content-type of the sent entity.
+ *
+ * Expects a string as parameter specifying the content type of the sent entity.
+ *
+ * Returns TRUE on success, or FALSE if the content type does not seem to
+ * contain a primary and secondary content type part.
+ *
+ * Throws HttpInvalidParamException if http.only_exceptions is TRUE.
+ */
+PHP_METHOD(HttpResponse, setContentType)
+{
+ char *ctype;
+ int ctype_len;
+
+ if (SUCCESS != zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "s", &ctype, &ctype_len)) {
+ RETURN_FALSE;
+ }
+
+ HTTP_CHECK_CONTENT_TYPE(ctype, RETURN_FALSE);
+ RETURN_SUCCESS(UPD_STATIC_STRL(contentType, ctype, ctype_len));
+}
+/* }}} */
+
+/* {{{ proto static string HttpResponse::getContentType()
+ *
+ * Get current Content-Type header setting.
+ *
+ * Returns the currently set content type as string.
+ */
+PHP_METHOD(HttpResponse, getContentType)
+{
+ NO_ARGS;
+
+ IF_RETVAL_USED {
+ zval *ctype = convert_to_type_ex(IS_STRING, GET_STATIC_PROP(contentType));
+
+ RETURN_ZVAL(ctype, 1, 0);
+ }
+}
+/* }}} */
+
+/* {{{ proto static string HttpResponse::guessContentType(string magic_file[, int magic_mode = MAGIC_MIME])
+ *
+ * Attempts to guess the content type of supplied payload through libmagic.
+ * If the attempt is successful, the guessed content type will automatically
+ * be set as response content type.
+ *
+ * Expects a string parameter specifying the magic.mime database to use.
+ * Additionally accepts an optional int parameter, being flags for libmagic.
+ *
+ * Returns the guessed content type on success, or FALSE on failure.
+ *
+ * Throws HttpRuntimeException, HttpInvalidParamException
+ * if http.only_exceptions is TRUE.
+ */
+PHP_METHOD(HttpResponse, guessContentType)
+{
+ char *magic_file, *ct = NULL;
+ int magic_file_len;
+ long magic_mode = 0;
+
+ RETVAL_FALSE;
+
+#ifdef HTTP_HAVE_MAGIC
+ magic_mode = MAGIC_MIME;
+
+ SET_EH_THROW_HTTP();
+ if (SUCCESS == zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "s|l", &magic_file, &magic_file_len, &magic_mode)) {
+ switch (Z_LVAL_P(GET_STATIC_PROP(mode))) {
+ case SEND_DATA:
+ {
+ zval *data = GET_STATIC_PROP(data);
+ ct = http_guess_content_type(magic_file, magic_mode, Z_STRVAL_P(data), Z_STRLEN_P(data), SEND_DATA);
+ }
+ break;
+
+ case SEND_RSRC:
+ {
+ php_stream *s;
+ zval *z = GET_STATIC_PROP(stream);
+ z->type = IS_RESOURCE;
+ php_stream_from_zval(s, &z);
+ ct = http_guess_content_type(magic_file, magic_mode, s, 0, SEND_RSRC);
+ }
+ break;
+
+ default:
+ ct = http_guess_content_type(magic_file, magic_mode, Z_STRVAL_P(GET_STATIC_PROP(file)), 0, -1);
+ break;
+ }
+ if (ct) {
+ UPD_STATIC_PROP(string, contentType, ct);
+ RETVAL_STRING(ct, 0);
+ }
+ }
+ SET_EH_NORMAL();
+#else
+ http_error(HE_THROW, HTTP_E_RUNTIME, "Cannot guess Content-Type; libmagic not available");
+#endif
+}
+/* }}} */
+
+/* {{{ proto static bool HttpResponse::setContentDisposition(string filename[, bool inline = false])
+ *
+ * Set the Content-Disposition. The Content-Disposition header is very useful
+ * if the data actually sent came from a file or something similar, that should
+ * be "saved" by the client/user (i.e. by browsers "Save as..." popup window).
+ *
+ * Expects a string parameter specifying the file name the "Save as..." dialogue
+ * should display. Optionally accepts a bool parameter, which, if set to true
+ * and the user agent knows how to handle the content type, will probably not
+ * cause the popup window to be shown.
+ *
+ * Returns TRUE on success or FALSE on failure.
+ */
+PHP_METHOD(HttpResponse, setContentDisposition)
+{
+ char *file, *cd;
+ int file_len;
+ size_t cd_len;
+ zend_bool send_inline = 0;
+
+ if (SUCCESS != zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "s|b", &file, &file_len, &send_inline)) {
+ RETURN_FALSE;
+ }
+
+ cd_len = spprintf(&cd, 0, "%s; filename=\"%s\"", send_inline ? "inline" : "attachment", file);
+ RETVAL_SUCCESS(UPD_STATIC_STRL(contentDisposition, cd, cd_len));
+ efree(cd);
+}
+/* }}} */
+
+/* {{{ proto static string HttpResponse::getContentDisposition()
+ *
+ * Get current Content-Disposition setting.
+ *
+ * Returns the current content disposition as string like sent in a header.
+ */
+PHP_METHOD(HttpResponse, getContentDisposition)
+{
+ NO_ARGS;
+
+ IF_RETVAL_USED {
+ zval *cd = convert_to_type_ex(IS_STRING, GET_STATIC_PROP(contentDisposition));
+
+ RETURN_ZVAL(cd, 1, 0);
+ }
+}
+/* }}} */
+
+/* {{{ proto static bool HttpResponse::setETag(string etag)
+ *
+ * Set a custom ETag. Use this only if you know what you're doing.
+ *
+ * Expects an unquoted string as parameter containing the ETag.
+ *
+ * Returns TRUE on success, or FALSE on failure.
+ */
+PHP_METHOD(HttpResponse, setETag)
+{
+ char *etag;
+ int etag_len;