Response.php

Go to the documentation of this file.

<?php
class Slim_Http_Response {

    protected $request;

    protected $httpVersion = '1.1';

    protected $status = 200;

    protected $headers = array();

    protected $body = '';

    protected $length = 0;

    protected static $messages = array(
        //Informational 1xx
        100 => '100 Continue',
        101 => '101 Switching Protocols',
        //Successful 2xx
        200 => '200 OK',
        201 => '201 Created',
        202 => '202 Accepted',
        203 => '203 Non-Authoritative Information',
        204 => '204 No Content',
        205 => '205 Reset Content',
        206 => '206 Partial Content',
        //Redirection 3xx
        300 => '300 Multiple Choices',
        301 => '301 Moved Permanently',
        302 => '302 Found',
        303 => '303 See Other',
        304 => '304 Not Modified',
        305 => '305 Use Proxy',
        306 => '306 (Unused)',
        307 => '307 Temporary Redirect',
        //Client Error 4xx
        400 => '400 Bad Request',
        401 => '401 Unauthorized',
        402 => '402 Payment Required',
        403 => '403 Forbidden',
        404 => '404 Not Found',
        405 => '405 Method Not Allowed',
        406 => '406 Not Acceptable',
        407 => '407 Proxy Authentication Required',
        408 => '408 Request Timeout',
        409 => '409 Conflict',
        410 => '410 Gone',
        411 => '411 Length Required',
        412 => '412 Precondition Failed',
        413 => '413 Request Entity Too Large',
        414 => '414 Request-URI Too Long',
        415 => '415 Unsupported Media Type',
        416 => '416 Requested Range Not Satisfiable',
        417 => '417 Expectation Failed',
        422 => '422 Unprocessable Entity',
        423 => '423 Locked',
        //Server Error 5xx
        500 => '500 Internal Server Error',
        501 => '501 Not Implemented',
        502 => '502 Bad Gateway',
        503 => '503 Service Unavailable',
        504 => '504 Gateway Timeout',
        505 => '505 HTTP Version Not Supported'
    );

    protected $cookieJar;

    public function __construct( Slim_Http_Request $req ) {
        $this->request = $req;
        $this->header('Content-Type', 'text/html');
    }

    public function httpVersion( $version = null ) {
        if ( $version ) {
            $version = (string)$version;
            if ( $version === '1.0' || $version === '1.1' ) {
                $this->httpVersion = $version;
            } else {
                throw new InvalidArgumentException('Invalid HTTP version in Response object');
            }
        }
        return $this->httpVersion;
    }

    public function status( $status = null ) {
        if ( !is_null($status) ) {
            if ( !in_array(intval($status), array_keys(self::$messages)) ) {
                throw new InvalidArgumentException('Cannot set Response status. Provided status code "' . $status . '" is not a valid HTTP response code.');
            }
            $this->status = intval($status);
        }
        return $this->status;
    }

    public function headers() {
        return $this->headers;
    }

    public function header( $key, $value = null ) {
        if ( !is_null($value) ) {
            $this->headers[$key] = $value;
        }
        return isset($this->headers[$key]) ? $this->headers[$key] : null;
    }

    public function body( $body = null ) {
        if ( !is_null($body) ) {
            $this->body = '';
            $this->length = 0;
            $this->write($body);
        }
        return $this->body;
    }

    public function write( $body ) {
        $body = (string)$body;
        $this->length += strlen($body);
        $this->body .= $body;
        $this->header('Content-Length', $this->length);
        return $body;
    }

    public function setCookieJar( Slim_Http_CookieJar $cookieJar ) {
        $this->cookieJar = $cookieJar;
    }

    public function getCookieJar() {
        return $this->cookieJar;
    }

    public function finalize() {
        if ( in_array($this->status, array(204, 304)) ) {
            $this->body('');
            unset($this->headers['Content-Type']);
        }
    }

    public static function getMessageForCode( $status ) {
        return isset(self::$messages[$status]) ? self::$messages[$status] : null;
    }

    public function canHaveBody() {
        return ( $this->status < 100 || $this->status >= 200 ) && $this->status != 204 && $this->status != 304;
    }

    protected function sendHeaders() {
        //Finalize response
        $this->finalize();

        if ( substr(PHP_SAPI, 0, 3) === 'cgi') {
            //Send Status header if running with fastcgi
            header('Status: ' . self::getMessageForCode($this->status()));
        } else {
            //Else send HTTP message
            header(sprintf('HTTP/%s %s', $this->httpVersion, self::getMessageForCode($this->status())));
        }

        //Send headers
        foreach ( $this->headers() as $name => $value ) {
            header("$name: $value");
        }

        //Send cookies
        foreach ( $this->getCookieJar()->getResponseCookies() as $name => $cookie ) {
            /* httponly option is only available for PHP version >= 5.2 */
            if ( version_compare(PHP_VERSION, '5.2.0', '>=') ) {
                setcookie($cookie->getName(), $cookie->getValue(), $cookie->getExpires(), $cookie->getPath(), $cookie->getDomain(), $cookie->getSecure(), $cookie->getHttpOnly());
            } else {
                setcookie($cookie->getName(), $cookie->getValue(), $cookie->getExpires(), $cookie->getPath(), $cookie->getDomain(), $cookie->getSecure());
            }
        }

        //Flush all output to client
        flush();
    }

    public function send() {
        if ( !headers_sent() ) {
            $this->sendHeaders();
        }
        if ( $this->canHaveBody() && $this->request->isHead() === false ) {
            echo $this->body;
        }
    }

}