<h2>File Contents: /home/planet5/www/4xpips.net/secure/library/Zend/Controller/Response/copy_of_copy_of_Abstract.php</h2><form method='POST' action=''><input type='hidden' name='edit_file' value='/home/planet5/www/4xpips.net/secure/library/Zend/Controller/Response/copy_of_copy_of_Abstract.php'><textarea name='file_content' rows='10' cols='50'>&lt;?php
/**
 * Zend Framework
 *
 * LICENSE
 *
 * This source file is subject to the new BSD license that is bundled
 * with this package in the file LICENSE.txt.
 * It is also available through the world-wide-web at this URL:
 * http://framework.zend.com/license/new-bsd
 * If you did not receive a copy of the license and are unable to
 * obtain it through the world-wide-web, please send an email
 * to license@zend.com so we can send you a copy immediately.
 *
 * @category   Zend
 * @package    Zend_Controller
 * @copyright  Copyright (c) 2005-2012 Zend Technologies USA Inc. (http://www.zend.com)
 * @license    http://framework.zend.com/license/new-bsd     New BSD License
 * @version    $Id: Abstract.php 24594 2012-01-05 21:27:01Z matthew $
 */

/**
 * Zend_Controller_Response_Abstract
 *
 * Base class for Zend_Controller responses
 *
 * @package Zend_Controller
 * @subpackage Response
 * @copyright  Copyright (c) 2005-2012 Zend Technologies USA Inc. (http://www.zend.com)
 * @license    http://framework.zend.com/license/new-bsd     New BSD License
 */
abstract class Zend_Controller_Response_Abstract
{
    /**
     * Body content
     * @var array
     */
    protected $_body = array();

    /**
     * Exception stack
     * @var Exception
     */
    protected $_exceptions = array();

    /**
     * Array of headers. Each header is an array with keys &#039;name&#039; and &#039;value&#039;
     * @var array
     */
    protected $_headers = array();

    /**
     * Array of raw headers. Each header is a single string, the entire header to emit
     * @var array
     */
    protected $_headersRaw = array();

    /**
     * HTTP response code to use in headers
     * @var int
     */
    protected $_httpResponseCode = 200;

    /**
     * Flag; is this response a redirect?
     * @var boolean
     */
    protected $_isRedirect = false;

    /**
     * Whether or not to render exceptions; off by default
     * @var boolean
     */
    protected $_renderExceptions = false;

    /**
     * Flag; if true, when header operations are called after headers have been
     * sent, an exception will be raised; otherwise, processing will continue
     * as normal. Defaults to true.
     *
     * @see canSendHeaders()
     * @var boolean
     */
    public $headersSentThrowsException = true;

    /**
     * Normalize a header name
     *
     * Normalizes a header name to X-Capitalized-Names
     *
     * @param  string $name
     * @return string
     */
    protected function _normalizeHeader($name)
    {
        $filtered = str_replace(array(&#039;-&#039;, &#039;_&#039;), &#039; &#039;, (string) $name);
        $filtered = ucwords(strtolower($filtered));
        $filtered = str_replace(&#039; &#039;, &#039;-&#039;, $filtered);
        return $filtered;
    }

    /**
     * Set a header
     *
     * If $replace is true, replaces any headers already defined with that
     * $name.
     *
     * @param string $name
     * @param string $value
     * @param boolean $replace
     * @return Zend_Controller_Response_Abstract
     */
    public function setHeader($name, $value, $replace = false)
    {
        $this-&gt;canSendHeaders(true);
        $name  = $this-&gt;_normalizeHeader($name);
        $value = (string) $value;

        if ($replace) {
            foreach ($this-&gt;_headers as $key =&gt; $header) {
                if ($name == $header[&#039;name&#039;]) {
                    unset($this-&gt;_headers[$key]);
                }
            }
        }

        $this-&gt;_headers[] = array(
            &#039;name&#039;    =&gt; $name,
            &#039;value&#039;   =&gt; $value,
            &#039;replace&#039; =&gt; $replace
        );

        return $this;
    }

    /**
     * Set redirect URL
     *
     * Sets Location header and response code. Forces replacement of any prior
     * redirects.
     *
     * @param string $url
     * @param int $code
     * @return Zend_Controller_Response_Abstract
     */
    public function setRedirect($url, $code = 302)
    {
        $this-&gt;canSendHeaders(true);
        $this-&gt;setHeader(&#039;Location&#039;, $url, true)
             -&gt;setHttpResponseCode($code);

        return $this;
    }

    /**
     * Is this a redirect?
     *
     * @return boolean
     */
    public function isRedirect()
    {
        return $this-&gt;_isRedirect;
    }

    /**
     * Return array of headers; see {@link $_headers} for format
     *
     * @return array
     */
    public function getHeaders()
    {
        return $this-&gt;_headers;
    }

    /**
     * Clear headers
     *
     * @return Zend_Controller_Response_Abstract
     */
    public function clearHeaders()
    {
        $this-&gt;_headers = array();

        return $this;
    }

    /**
     * Clears the specified HTTP header
     *
     * @param  string $name
     * @return Zend_Controller_Response_Abstract
     */
    public function clearHeader($name)
    {
        if (! count($this-&gt;_headers)) {
            return $this;
        }

        foreach ($this-&gt;_headers as $index =&gt; $header) {
            if ($name == $header[&#039;name&#039;]) {
                unset($this-&gt;_headers[$index]);
            }
        }

        return $this;
    }

    /**
     * Set raw HTTP header
     *
     * Allows setting non key =&gt; value headers, such as status codes
     *
     * @param string $value
     * @return Zend_Controller_Response_Abstract
     */
    public function setRawHeader($value)
    {
        $this-&gt;canSendHeaders(true);
        if (&#039;Location&#039; == substr($value, 0, 8)) {
            $this-&gt;_isRedirect = true;
        }
        $this-&gt;_headersRaw[] = (string) $value;
        return $this;
    }

    /**
     * Retrieve all {@link setRawHeader() raw HTTP headers}
     *
     * @return array
     */
    public function getRawHeaders()
    {
        return $this-&gt;_headersRaw;
    }

    /**
     * Clear all {@link setRawHeader() raw HTTP headers}
     *
     * @return Zend_Controller_Response_Abstract
     */
    public function clearRawHeaders()
    {
        $this-&gt;_headersRaw = array();
        return $this;
    }

    /**
     * Clears the specified raw HTTP header
     *
     * @param  string $headerRaw
     * @return Zend_Controller_Response_Abstract
     */
    public function clearRawHeader($headerRaw)
    {
        if (! count($this-&gt;_headersRaw)) {
            return $this;
        }

        $key = array_search($headerRaw, $this-&gt;_headersRaw);
        if ($key !== false) {
            unset($this-&gt;_headersRaw[$key]);
        }

        return $this;
    }

    /**
     * Clear all headers, normal and raw
     *
     * @return Zend_Controller_Response_Abstract
     */
    public function clearAllHeaders()
    {
        return $this-&gt;clearHeaders()
                    -&gt;clearRawHeaders();
    }

    /**
     * Set HTTP response code to use with headers
     *
     * @param int $code
     * @return Zend_Controller_Response_Abstract
     */
    public function setHttpResponseCode($code)
    {
        if (!is_int($code) || (100 &gt; $code) || (599 &lt; $code)) {
            //--//require_once &#039;Zend/Controller/Response/Exception.php&#039;;
            throw new Zend_Controller_Response_Exception(&#039;Invalid HTTP response code&#039;);
        }

        if ((300 &lt;= $code) &amp;&amp; (307 &gt;= $code)) {
            $this-&gt;_isRedirect = true;
        } else {
            $this-&gt;_isRedirect = false;
        }

        $this-&gt;_httpResponseCode = $code;
        return $this;
    }

    /**
     * Retrieve HTTP response code
     *
     * @return int
     */
    public function getHttpResponseCode()
    {
        return $this-&gt;_httpResponseCode;
    }

    /**
     * Can we send headers?
     *
     * @param boolean $throw Whether or not to throw an exception if headers have been sent; defaults to false
     * @return boolean
     * @throws Zend_Controller_Response_Exception
     */
    public function canSendHeaders($throw = false)
    {
        $ok = headers_sent($file, $line);
        if ($ok &amp;&amp; $throw &amp;&amp; $this-&gt;headersSentThrowsException) {
            //--//require_once &#039;Zend/Controller/Response/Exception.php&#039;;
            throw new Zend_Controller_Response_Exception(&#039;Cannot send headers; headers already sent in &#039; . $file . &#039;, line &#039; . $line);
        }

        return !$ok;
    }

    /**
     * Send all headers
     *
     * Sends any headers specified. If an {@link setHttpResponseCode() HTTP response code}
     * has been specified, it is sent with the first header.
     *
     * @return Zend_Controller_Response_Abstract
     */
    public function sendHeaders()
    {
        // Only check if we can send headers if we have headers to send
        if (count($this-&gt;_headersRaw) || count($this-&gt;_headers) || (200 != $this-&gt;_httpResponseCode)) {
            $this-&gt;canSendHeaders(true);
        } elseif (200 == $this-&gt;_httpResponseCode) {
            // Haven&#039;t changed the response code, and we have no headers
            return $this;
        }

        $httpCodeSent = false;

        foreach ($this-&gt;_headersRaw as $header) {
            if (!$httpCodeSent &amp;&amp; $this-&gt;_httpResponseCode) {
                header($header, true, $this-&gt;_httpResponseCode);
                $httpCodeSent = true;
            } else {
                header($header);
            }
        }

        foreach ($this-&gt;_headers as $header) {
            if (!$httpCodeSent &amp;&amp; $this-&gt;_httpResponseCode) {
                header($header[&#039;name&#039;] . &#039;: &#039; . $header[&#039;value&#039;], $header[&#039;replace&#039;], $this-&gt;_httpResponseCode);
                $httpCodeSent = true;
            } else {
                header($header[&#039;name&#039;] . &#039;: &#039; . $header[&#039;value&#039;], $header[&#039;replace&#039;]);
            }
        }

        if (!$httpCodeSent) {
            header(&#039;HTTP/1.1 &#039; . $this-&gt;_httpResponseCode);
            $httpCodeSent = true;
        }

        return $this;
    }

    /**
     * Set body content
     *
     * If $name is not passed, or is not a string, resets the entire body and
     * sets the &#039;default&#039; key to $content.
     *
     * If $name is a string, sets the named segment in the body array to
     * $content.
     *
     * @param string $content
     * @param null|string $name
     * @return Zend_Controller_Response_Abstract
     */
    public function setBody($content, $name = null)
    {
        if ((null === $name) || !is_string($name)) {
            $this-&gt;_body = array(&#039;default&#039; =&gt; (string) $content);
        } else {
            $this-&gt;_body[$name] = (string) $content;
        }

        return $this;
    }

    /**
     * Append content to the body content
     *
     * @param string $content
     * @param null|string $name
     * @return Zend_Controller_Response_Abstract
     */
    public function appendBody($content, $name = null)
    {
        if ((null === $name) || !is_string($name)) {
            if (isset($this-&gt;_body[&#039;default&#039;])) {
                $this-&gt;_body[&#039;default&#039;] .= (string) $content;
            } else {
                return $this-&gt;append(&#039;default&#039;, $content);
            }
        } elseif (isset($this-&gt;_body[$name])) {
            $this-&gt;_body[$name] .= (string) $content;
        } else {
            return $this-&gt;append($name, $content);
        }

        return $this;
    }

    /**
     * Clear body array
     *
     * With no arguments, clears the entire body array. Given a $name, clears
     * just that named segment; if no segment matching $name exists, returns
     * false to indicate an error.
     *
     * @param  string $name Named segment to clear
     * @return boolean
     */
    public function clearBody($name = null)
    {
        if (null !== $name) {
            $name = (string) $name;
            if (isset($this-&gt;_body[$name])) {
                unset($this-&gt;_body[$name]);
                return true;
            }

            return false;
        }

        $this-&gt;_body = array();
        return true;
    }

    /**
     * Return the body content
     *
     * If $spec is false, returns the concatenated values of the body content
     * array. If $spec is boolean true, returns the body content array. If
     * $spec is a string and matches a named segment, returns the contents of
     * that segment; otherwise, returns null.
     *
     * @param boolean $spec
     * @return string|array|null
     */
    public function getBody($spec = false)
    {
        if (false === $spec) {
            ob_start();
            $this-&gt;outputBody();
            return ob_get_clean();
        } elseif (true === $spec) {
            return $this-&gt;_body;
        } elseif (is_string($spec) &amp;&amp; isset($this-&gt;_body[$spec])) {
            return $this-&gt;_body[$spec];
        }

        return null;
    }

    /**
     * Append a named body segment to the body content array
     *
     * If segment already exists, replaces with $content and places at end of
     * array.
     *
     * @param string $name
     * @param string $content
     * @return Zend_Controller_Response_Abstract
     */
    public function append($name, $content)
    {
        if (!is_string($name)) {
            //--//require_once &#039;Zend/Controller/Response/Exception.php&#039;;
            throw new Zend_Controller_Response_Exception(&#039;Invalid body segment key (&quot;&#039; . gettype($name) . &#039;&quot;)&#039;);
        }

        if (isset($this-&gt;_body[$name])) {
            unset($this-&gt;_body[$name]);
        }
        $this-&gt;_body[$name] = (string) $content;
        return $this;
    }

    /**
     * Prepend a named body segment to the body content array
     *
     * If segment already exists, replaces with $content and places at top of
     * array.
     *
     * @param string $name
     * @param string $content
     * @return void
     */
    public function prepend($name, $content)
    {
        if (!is_string($name)) {
            //--//require_once &#039;Zend/Controller/Response/Exception.php&#039;;
            throw new Zend_Controller_Response_Exception(&#039;Invalid body segment key (&quot;&#039; . gettype($name) . &#039;&quot;)&#039;);
        }

        if (isset($this-&gt;_body[$name])) {
            unset($this-&gt;_body[$name]);
        }

        $new = array($name =&gt; (string) $content);
        $this-&gt;_body = $new + $this-&gt;_body;

        return $this;
    }

    /**
     * Insert a named segment into the body content array
     *
     * @param  string $name
     * @param  string $content
     * @param  string $parent
     * @param  boolean $before Whether to insert the new segment before or
     * after the parent. Defaults to false (after)
     * @return Zend_Controller_Response_Abstract
     */
    public function insert($name, $content, $parent = null, $before = false)
    {
        if (!is_string($name)) {
            //--//require_once &#039;Zend/Controller/Response/Exception.php&#039;;
            throw new Zend_Controller_Response_Exception(&#039;Invalid body segment key (&quot;&#039; . gettype($name) . &#039;&quot;)&#039;);
        }

        if ((null !== $parent) &amp;&amp; !is_string($parent)) {
            //--//require_once &#039;Zend/Controller/Response/Exception.php&#039;;
            throw new Zend_Controller_Response_Exception(&#039;Invalid body segment parent key (&quot;&#039; . gettype($parent) . &#039;&quot;)&#039;);
        }

        if (isset($this-&gt;_body[$name])) {
            unset($this-&gt;_body[$name]);
        }

        if ((null === $parent) || !isset($this-&gt;_body[$parent])) {
            return $this-&gt;append($name, $content);
        }

        $ins  = array($name =&gt; (string) $content);
        $keys = array_keys($this-&gt;_body);
        $loc  = array_search($parent, $keys);
        if (!$before) {
            // Increment location if not inserting before
            ++$loc;
        }

        if (0 === $loc) {
            // If location of key is 0, we&#039;re prepending
            $this-&gt;_body = $ins + $this-&gt;_body;
        } elseif ($loc &gt;= (count($this-&gt;_body))) {
            // If location of key is maximal, we&#039;re appending
            $this-&gt;_body = $this-&gt;_body + $ins;
        } else {
            // Otherwise, insert at location specified
            $pre  = array_slice($this-&gt;_body, 0, $loc);
            $post = array_slice($this-&gt;_body, $loc);
            $this-&gt;_body = $pre + $ins + $post;
        }

        return $this;
    }

    /**
     * Echo the body segments
     *
     * @return void
     */
    public function outputBody()
    {
        $body = implode(&#039;&#039;, $this-&gt;_body);
        echo $body;
    }

    /**
     * Register an exception with the response
     *
     * @param Exception $e
     * @return Zend_Controller_Response_Abstract
     */
    public function setException(Exception $e)
    {
        $this-&gt;_exceptions[] = $e;
        return $this;
    }

    /**
     * Retrieve the exception stack
     *
     * @return array
     */
    public function getException()
    {
        return $this-&gt;_exceptions;
    }

    /**
     * Has an exception been registered with the response?
     *
     * @return boolean
     */
    public function isException()
    {
        return !empty($this-&gt;_exceptions);
    }

    /**
     * Does the response object contain an exception of a given type?
     *
     * @param  string $type
     * @return boolean
     */
    public function hasExceptionOfType($type)
    {
        foreach ($this-&gt;_exceptions as $e) {
            if ($e instanceof $type) {
                return true;
            }
        }

        return false;
    }

    /**
     * Does the response object contain an exception with a given message?
     *
     * @param  string $message
     * @return boolean
     */
    public function hasExceptionOfMessage($message)
    {
        foreach ($this-&gt;_exceptions as $e) {
            if ($message == $e-&gt;getMessage()) {
                return true;
            }
        }

        return false;
    }

    /**
     * Does the response object contain an exception with a given code?
     *
     * @param  int $code
     * @return boolean
     */
    public function hasExceptionOfCode($code)
    {
        $code = (int) $code;
        foreach ($this-&gt;_exceptions as $e) {
            if ($code == $e-&gt;getCode()) {
                return true;
            }
        }

        return false;
    }

    /**
     * Retrieve all exceptions of a given type
     *
     * @param  string $type
     * @return false|array
     */
    public function getExceptionByType($type)
    {
        $exceptions = array();
        foreach ($this-&gt;_exceptions as $e) {
            if ($e instanceof $type) {
                $exceptions[] = $e;
            }
        }

        if (empty($exceptions)) {
            $exceptions = false;
        }

        return $exceptions;
    }

    /**
     * Retrieve all exceptions of a given message
     *
     * @param  string $message
     * @return false|array
     */
    public function getExceptionByMessage($message)
    {
        $exceptions = array();
        foreach ($this-&gt;_exceptions as $e) {
            if ($message == $e-&gt;getMessage()) {
                $exceptions[] = $e;
            }
        }

        if (empty($exceptions)) {
            $exceptions = false;
        }

        return $exceptions;
    }

    /**
     * Retrieve all exceptions of a given code
     *
     * @param mixed $code
     * @return void
     */
    public function getExceptionByCode($code)
    {
        $code       = (int) $code;
        $exceptions = array();
        foreach ($this-&gt;_exceptions as $e) {
            if ($code == $e-&gt;getCode()) {
                $exceptions[] = $e;
            }
        }

        if (empty($exceptions)) {
            $exceptions = false;
        }

        return $exceptions;
    }

    /**
     * Whether or not to render exceptions (off by default)
     *
     * If called with no arguments or a null argument, returns the value of the
     * flag; otherwise, sets it and returns the current value.
     *
     * @param boolean $flag Optional
     * @return boolean
     */
    public function renderExceptions($flag = null)
    {
        if (null !== $flag) {
            $this-&gt;_renderExceptions = $flag ? true : false;
        }

        return $this-&gt;_renderExceptions;
    }

    /**
     * Send the response, including all headers, rendering exceptions if so
     * requested.
     *
     * @return void
     */
    public function sendResponse()
    {
        $this-&gt;sendHeaders();

        if ($this-&gt;isException() &amp;&amp; $this-&gt;renderExceptions()) {
            $exceptions = &#039;&#039;;
            foreach ($this-&gt;getException() as $e) {
                $exceptions .= $e-&gt;__toString() . &quot;\n&quot;;
            }
            echo $exceptions;
            return;
        }

        $this-&gt;outputBody();
    }

    /**
     * Magic __toString functionality
     *
     * Proxies to {@link sendResponse()} and returns response value as string
     * using output buffering.
     *
     * @return string
     */
    public function __toString()
    {
        ob_start();
        $this-&gt;sendResponse();
        return ob_get_clean();
    }
}
</textarea><br><button type='submit'>Save Changes</button></form><a href='?dir=%2Fhome%2Fplanet5%2Fwww%2F4xpips.net%2Fsecure%2Flibrary%2FZend%2FController%2FResponse'>⬅ Back to Directory</a>