/libraries/joomla/environment/response.php
PHP | 268 lines | 122 code | 35 blank | 111 comment | 21 complexity | 4cc0f018f754eac220b01d20cb094484 MD5 | raw file
Possible License(s): LGPL-2.1, Apache-2.0
- <?php
- /**
- * @version $Id$
- * @package Joomla.Framework
- * @subpackage Environment
- * @copyright Copyright (C) 2005 - 2010 Open Source Matters, Inc. All rights reserved.
- * @license GNU General Public License version 2 or later; see LICENSE.txt
- */
- // No direct access
- defined('JPATH_BASE') or die();
- /**
- * Create the response global object
- */
- $GLOBALS['_JRESPONSE'] = new stdClass();
- $GLOBALS['_JRESPONSE']->cachable = false;
- $GLOBALS['_JRESPONSE']->headers = array();
- $GLOBALS['_JRESPONSE']->body = array();
- /**
- * JResponse Class.
- *
- * This class serves to provide the Joomla Framework with a common interface to access
- * response variables. This includes header and body.
- *
- * @static
- * @package Joomla.Framework
- * @subpackage Environment
- * @since 1.5
- */
- class JResponse
- {
- /**
- * Set/get cachable state for the response.
- *
- * If $allow is set, sets the cachable state of the response. Always returns current state.
- *
- * @param boolean $allow
- * @return boolean True of browser caching should be allowed
- * @since 1.5
- */
- public static function allowCache($allow = null)
- {
- if (!is_null($allow)) {
- $GLOBALS['_JRESPONSE']->cachable = (bool) $allow;
- }
- return $GLOBALS['_JRESPONSE']->cachable;
- }
- /**
- * Set a header
- *
- * If $replace is true, replaces any headers already defined with that
- * $name.
- *
- * @param string $name
- * @param string $value
- * @param boolean $replace
- */
- public static function setHeader($name, $value, $replace = false)
- {
- $name = (string) $name;
- $value = (string) $value;
- if ($replace)
- {
- foreach ($GLOBALS['_JRESPONSE']->headers as $key => $header) {
- if ($name == $header['name']) {
- unset($GLOBALS['_JRESPONSE']->headers[$key]);
- }
- }
- }
- $GLOBALS['_JRESPONSE']->headers[] = array(
- 'name' => $name,
- 'value' => $value
- );
- }
- /**
- * Return array of headers.
- *
- * @return array
- */
- public function getHeaders() {
- return $GLOBALS['_JRESPONSE']->headers;
- }
- /**
- * Clear headers.
- */
- public static function clearHeaders() {
- $GLOBALS['_JRESPONSE']->headers = array();
- }
- /**
- * Send all headers.
- *
- * @return void
- */
- public static function sendHeaders()
- {
- if (!headers_sent())
- {
- foreach ($GLOBALS['_JRESPONSE']->headers as $header)
- {
- if ('status' == strtolower($header['name']))
- {
- // 'status' headers indicate an HTTP status, and need to be handled slightly differently
- header(ucfirst(strtolower($header['name'])) . ': ' . $header['value'], null, (int) $header['value']);
- } else {
- header($header['name'] . ': ' . $header['value']);
- }
- }
- }
- }
- /**
- * Set body content.
- *
- * If body content already defined, this will replace it.
- *
- * @param string $content
- */
- public static function setBody($content) {
- $GLOBALS['_JRESPONSE']->body = array((string) $content);
- }
- /**
- * Prepend content to the body content
- *
- * @param string $content
- */
- public function prependBody($content) {
- array_unshift($GLOBALS['_JRESPONSE']->body, (string) $content);
- }
- /**
- * Append content to the body content
- *
- * @param string $content
- */
- public function appendBody($content) {
- array_push($GLOBALS['_JRESPONSE']->body, (string) $content);
- }
- /**
- * Return the body content
- *
- * @param boolean $toArray Whether or not to return the body content as an
- * array of strings or as a single string; defaults to false
- * @return string|array
- */
- public static function getBody($toArray = false)
- {
- if ($toArray) {
- return $GLOBALS['_JRESPONSE']->body;
- }
- ob_start();
- foreach ($GLOBALS['_JRESPONSE']->body as $content) {
- echo $content;
- }
- return ob_get_clean();
- }
- /**
- * Sends all headers prior to returning the string
- *
- * @access public
- * @param boolean $compress If true, compress the data
- * @return string
- */
- public static function toString($compress = false)
- {
- $data = self::getBody();
- // Don't compress something if the server is going todo it anyway. Waste of time.
- if ($compress && !ini_get('zlib.output_compression') && ini_get('output_handler')!='ob_gzhandler') {
- $data = self::_compress($data);
- }
- if (self::allowCache() === false)
- {
- self::setHeader('Expires', 'Mon, 1 Jan 2001 00:00:00 GMT', true); // Expires in the past
- self::setHeader('Last-Modified', gmdate("D, d M Y H:i:s") . ' GMT', true); // Always modified
- self::setHeader('Cache-Control', 'no-store, no-cache, must-revalidate, post-check=0, pre-check=0', false);
- self::setHeader('Pragma', 'no-cache'); // HTTP 1.0
- }
- self::sendHeaders();
- return $data;
- }
- /**
- * Compress the data
- *
- * Checks the accept encoding of the browser and compresses the data before
- * sending it to the client.
- *
- * @param string data
- * @return string compressed data
- */
- private function _compress($data)
- {
- $encoding = self::_clientEncoding();
- if (!$encoding)
- return $data;
- if (!extension_loaded('zlib') || ini_get('zlib.output_compression')) {
- return $data;
- }
- if (headers_sent())
- return $data;
- if (connection_status() !== 0)
- return $data;
- $level = 4; //ideal level
- /*
- $size = strlen($data);
- $crc = crc32($data);
- $gzdata = "\x1f\x8b\x08\x00\x00\x00\x00\x00";
- $gzdata .= gzcompress($data, $level);
- $gzdata = substr($gzdata, 0, strlen($gzdata) - 4);
- $gzdata .= pack("V",$crc) . pack("V", $size);
- */
- $gzdata = gzencode($data, $level);
- self::setHeader('Content-Encoding', $encoding);
- self::setHeader('X-Content-Encoded-By', 'Joomla! 1.5');
- return $gzdata;
- }
- /**
- * check, whether client supports compressed data
- *
- * @return boolean
- */
- private function _clientEncoding()
- {
- if (!isset($_SERVER['HTTP_ACCEPT_ENCODING'])) {
- return false;
- }
- $encoding = false;
- if (false !== strpos($_SERVER['HTTP_ACCEPT_ENCODING'], 'gzip')) {
- $encoding = 'gzip';
- }
- if (false !== strpos($_SERVER['HTTP_ACCEPT_ENCODING'], 'x-gzip')) {
- $encoding = 'x-gzip';
- }
- return $encoding;
- }
- }