+ IF_RETVAL_USED {
+ zval *etag_p, *etag = convert_to_type_ex(IS_STRING, GET_STATIC_PROP(eTag), &etag_p);
+
+ RETVAL_ZVAL(etag, 1, 0);
+
+ if (etag_p) {
+ zval_ptr_dtor(&etag_p);
+ }
+ }
+}
+/* }}} */
+
+/* {{{ proto static bool HttpResponse::setLastModified(int timestamp)
+ *
+ * Set a custom Last-Modified date.
+ *
+ * Expects an unix timestamp as parameter representing the last modification
+ * time of the sent entity.
+ *
+ * Returns TRUE on success, or FALSE on failure.
+ */
+PHP_METHOD(HttpResponse, setLastModified)
+{
+ long lm;
+
+ if (SUCCESS != zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "l", &lm)) {
+ RETURN_FALSE;
+ }
+
+ RETURN_SUCCESS(UPD_STATIC_PROP(long, lastModified, lm));
+}
+/* }}} */
+
+/* {{{ proto static int HttpResponse::getLastModified()
+ *
+ * Get calculated or previously set custom Last-Modified date.
+ *
+ * Returns the calculated or previously set unix timestamp.
+ */
+PHP_METHOD(HttpResponse, getLastModified)
+{
+ NO_ARGS;
+
+ IF_RETVAL_USED {
+ zval *lm_p, *lm = convert_to_type_ex(IS_LONG, GET_STATIC_PROP(lastModified), &lm_p);
+
+ RETVAL_ZVAL(lm, 1, 0);
+
+ if (lm_p) {
+ zval_ptr_dtor(&lm_p);
+ }
+ }
+}
+/* }}} */
+
+/* {{{ proto static bool HttpResponse::setThrottleDelay(double seconds)
+ *
+ * Sets the throttle delay for use with HttpResponse::setBufferSize().
+ *
+ * Provides a basic throttling mechanism, which will yield the current process
+ * resp. thread until the entity has been completely sent, though.
+ *
+ * Note: This doesn't really work with the FastCGI SAPI.
+ *
+ * Expects a double parameter specifying the seconds too sleep() after
+ * each chunk sent.
+ *
+ * Returns TRUE on success, or FALSE on failure.
+ */
+PHP_METHOD(HttpResponse, setThrottleDelay)
+{
+ double seconds;
+
+ if (SUCCESS != zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "d", &seconds)) {
+ RETURN_FALSE;
+ }
+ RETURN_SUCCESS(UPD_STATIC_PROP(double, throttleDelay, seconds));
+}
+/* }}} */
+
+/* {{{ proto static double HttpResponse::getThrottleDelay()
+ *
+ * Get the current throttle delay.
+ *
+ * Returns a double representing the throttle delay in seconds.
+ */
+PHP_METHOD(HttpResponse, getThrottleDelay)
+{
+ NO_ARGS;
+
+ IF_RETVAL_USED {
+ zval *delay_p, *delay = convert_to_type_ex(IS_DOUBLE, GET_STATIC_PROP(throttleDelay), &delay_p);
+
+ RETVAL_ZVAL(delay, 1, 0);
+
+ if (delay_p) {
+ zval_ptr_dtor(&delay_p);
+ }
+ }
+}
+/* }}} */
+
+/* {{{ proto static bool HttpResponse::setBufferSize(int bytes)
+ *
+ * Sets the send buffer size for use with HttpResponse::setThrottleDelay().
+ *
+ * Provides a basic throttling mechanism, which will yield the current process
+ * resp. thread until the entity has been completely sent, though.
+ *
+ * Note: This doesn't really work with the FastCGI SAPI.
+ *
+ * Expects an int parameter representing the chunk size in bytes.
+ *
+ * Returns TRUE on success, or FALSE on failure.
+ */
+PHP_METHOD(HttpResponse, setBufferSize)
+{
+ long bytes;
+
+ if (SUCCESS != zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "l", &bytes)) {
+ RETURN_FALSE;
+ }
+ RETURN_SUCCESS(UPD_STATIC_PROP(long, bufferSize, bytes));
+}
+/* }}} */
+
+/* {{{ proto static int HttpResponse::getBufferSize()
+ *
+ * Get current buffer size.
+ *
+ * Returns an int representing the current buffer size in bytes.
+ */
+PHP_METHOD(HttpResponse, getBufferSize)
+{
+ NO_ARGS;
+
+ IF_RETVAL_USED {
+ zval *size_p, *size = convert_to_type_ex(IS_LONG, GET_STATIC_PROP(bufferSize), &size_p);
+
+ RETVAL_ZVAL(size, 1, 0);
+
+ if (size_p) {
+ zval_ptr_dtor(&size_p);
+ }
+ }
+}
+/* }}} */
+
+/* {{{ proto static bool HttpResponse::setData(mixed data)
+ *
+ * Set the data to be sent.
+ *
+ * Expects one parameter, which will be converted to a string and contains
+ * the data to send.
+ *
+ * Returns TRUE on success, or FALSE on failure.
+ */
+PHP_METHOD(HttpResponse, setData)
+{
+ char *etag;
+ zval *the_data;
+
+ if (SUCCESS != zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "z", &the_data)) {
+ RETURN_FALSE;
+ }
+ if (Z_TYPE_P(the_data) != IS_STRING) {
+ convert_to_string_ex(&the_data);
+ }
+
+ if ( (SUCCESS != SET_STATIC_PROP(data, the_data)) ||
+ (SUCCESS != UPD_STATIC_PROP(long, mode, SEND_DATA))) {
+ RETURN_FALSE;
+ }
+
+ UPD_STATIC_PROP(long, lastModified, http_last_modified(the_data, SEND_DATA));
+ if ((etag = http_etag(Z_STRVAL_P(the_data), Z_STRLEN_P(the_data), SEND_DATA))) {
+ UPD_STATIC_PROP(string, eTag, etag);
+ efree(etag);
+ }
+
+ RETURN_TRUE;
+}
+/* }}} */
+
+/* {{{ proto static string HttpResponse::getData()
+ *
+ * Get the previously set data to be sent.
+ *
+ * Returns a string containing the previously set data to send.
+ */
+PHP_METHOD(HttpResponse, getData)
+{
+ NO_ARGS;
+
+ IF_RETVAL_USED {
+ zval *the_data = GET_STATIC_PROP(data);
+
+ RETURN_ZVAL(the_data, 1, 0);
+ }
+}
+/* }}} */
+
+/* {{{ proto static bool HttpResponse::setStream(resource stream)
+ *
+ * Set the resource to be sent.
+ *
+ * Expects a resource parameter referencing an already opened stream from
+ * which the data to send will be read.
+ *
+ * Returns TRUE on success, or FALSE on failure.
+ */
+PHP_METHOD(HttpResponse, setStream)
+{
+ char *etag;
+ zval *the_stream;
+ php_stream *the_real_stream;
+ php_stream_statbuf ssb;
+
+ if (SUCCESS != zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "r", &the_stream)) {
+ RETURN_FALSE;
+ }
+
+ php_stream_from_zval(the_real_stream, &the_stream);
+ if (php_stream_stat(the_real_stream, &ssb)) {
+ RETURN_FALSE;
+ }
+
+ if ( (SUCCESS != UPD_STATIC_PROP(long, stream, Z_LVAL_P(the_stream))) ||
+ (SUCCESS != UPD_STATIC_PROP(long, mode, SEND_RSRC))) {
+ RETURN_FALSE;
+ }
+ zend_list_addref(Z_LVAL_P(the_stream));
+
+ UPD_STATIC_PROP(long, lastModified, http_last_modified(the_real_stream, SEND_RSRC));
+ if ((etag = http_etag(the_real_stream, 0, SEND_RSRC))) {
+ UPD_STATIC_PROP(string, eTag, etag);
+ efree(etag);
+ }
+
+ RETURN_TRUE;
+}
+/* }}} */
+
+/* {{{ proto static resource HttpResponse::getStream()
+ *
+ * Get the previously set resource to be sent.
+ *
+ * Returns the previously set resource.
+ */
+PHP_METHOD(HttpResponse, getStream)
+{
+ NO_ARGS;
+
+ IF_RETVAL_USED {
+ zval *stream_p;
+
+ RETVAL_RESOURCE(Z_LVAL_P(convert_to_type_ex(IS_LONG, GET_STATIC_PROP(stream), &stream_p)));
+
+ if (stream_p) {
+ zval_ptr_dtor(&stream_p);
+ }
+ }
+}
+/* }}} */
+
+/* {{{ proto static bool HttpResponse::setFile(string file)
+ *
+ * Set the file to be sent.
+ *
+ * Expects a string as parameter, specifying the path to the file to send.
+ *
+ * Returns TRUE on success, or FALSE on failure.
+ */
+PHP_METHOD(HttpResponse, setFile)
+{
+ char *the_file, *etag;
+ int file_len;
+ php_stream_statbuf ssb;
+
+ if (SUCCESS != zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "s", &the_file, &file_len)) {
+ RETURN_FALSE;
+ }
+
+ if (php_stream_stat_path(the_file, &ssb)) {
+ RETURN_FALSE;
+ }
+
+ if ( (SUCCESS != UPD_STATIC_STRL(file, the_file, file_len)) ||
+ (SUCCESS != UPD_STATIC_PROP(long, mode, -1))) {
+ RETURN_FALSE;
+ }
+
+ UPD_STATIC_PROP(long, lastModified, http_last_modified(the_file, -1));
+ if ((etag = http_etag(the_file, 0, -1))) {
+ UPD_STATIC_PROP(string, eTag, etag);
+ efree(etag);
+ }
+
+ RETURN_TRUE;
+}
+/* }}} */
+
+/* {{{ proto static string HttpResponse::getFile()
+ *
+ * Get the previously set file to be sent.
+ *
+ * Returns the previously set path to the file to send as string.
+ */
+PHP_METHOD(HttpResponse, getFile)
+{
+ NO_ARGS;
+
+ IF_RETVAL_USED {
+ zval *the_file_p, *the_file = convert_to_type_ex(IS_STRING, GET_STATIC_PROP(file), &the_file_p);
+
+ RETVAL_ZVAL(the_file, 1, 0);
+
+ if (the_file_p) {
+ zval_ptr_dtor(&the_file_p);
+ }
+ }
+}
+/* }}} */
+
+/* {{{ proto static bool HttpResponse::send([bool clean_ob = true])
+ *
+ * Finally send the entity.
+ *
+ * Accepts an optional boolean parameter, specifying whether the output
+ * buffers should be discarded prior sending. A successful caching attempt
+ * will cause a script termination, and write a log entry if the INI setting
+ * http.cache_log is set.
+ *
+ * Returns TRUE on success, or FALSE on failure.
+ *
+ * Throws HttpHeaderException, HttpResponseException if http.only_exceptions is TRUE.
+ *
+ * Example:
+ * <pre>
+ * <?php
+ * HttpResponse::setCache(true);
+ * HttpResponse::setContentType('application/pdf');
+ * HttpResponse::setContentDisposition("$user.pdf", false);
+ * HttpResponse::setFile('sheet.pdf');
+ * HttpResponse::send();
+ * ?>
+ * </pre>
+ */
+PHP_METHOD(HttpResponse, send)
+{
+ zval *sent;
+ zend_bool clean_ob = 1;
+
+ if (SUCCESS != zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "|b", &clean_ob)) {
+ RETURN_FALSE;
+ }
+
+ HTTP_CHECK_HEADERS_SENT(RETURN_FALSE);
+
+ sent = GET_STATIC_PROP(sent);
+ if (Z_LVAL_P(sent)) {
+ http_error(HE_WARNING, HTTP_E_RESPONSE, "Cannot send HttpResponse, response has already been sent");
+ RETURN_FALSE;
+ } else {
+ Z_LVAL_P(sent) = 1;
+ }
+
+ /* capture mode */
+ if (zval_is_true(GET_STATIC_PROP(catch))) {
+ zval *etag_p, *the_data;
+
+ MAKE_STD_ZVAL(the_data);
+ php_ob_get_buffer(the_data TSRMLS_CC);
+ SET_STATIC_PROP(data, the_data);
+ ZVAL_LONG(GET_STATIC_PROP(mode), SEND_DATA);
+
+ if (!Z_STRLEN_P(convert_to_type_ex(IS_STRING, GET_STATIC_PROP(eTag), &etag_p))) {
+ char *etag = http_etag(Z_STRVAL_P(the_data), Z_STRLEN_P(the_data), SEND_DATA);
+ if (etag) {
+ UPD_STATIC_PROP(string, eTag, etag);
+ efree(etag);
+ }
+ }
+ zval_ptr_dtor(&the_data);
+
+ if (etag_p) {
+ zval_ptr_dtor(&etag_p);
+ }
+
+ clean_ob = 1;
+ }