Controller.php

<?php
/**
 * File defining the Core Controller
 *
 * PHP Version 5.3
 *
 * @category  Backend
 * @package   Core
 * @author    J Jurgens du Toit <jrgns@backend-php.net>
 * @copyright 2011 - 2012 Jade IT (cc)
 * @license   http://www.opensource.org/licenses/mit-license.php MIT License
 * @link      http://backend-php.net
 */
namespace Backend\Core;

use Backend\Interfaces\ControllerInterface;
use Backend\Interfaces\RequestInterface;
use Backend\Interfaces\DependencyInjectionContainerInterface;
use Backend\Core\Exception as CoreException;

/**
 * Controller that acts as the connection between Models and Views.
 *
 * @category Backend
 * @package  Core
 * @author   J Jurgens du Toit <jrgns@backend-php.net>
 * @license  http://www.opensource.org/licenses/mit-license.php MIT License
 * @link     http://backend-php.net
 */
class Controller implements ControllerInterface
{
    /**
     * The Dependency Injection Container to be used when getting services.
     *
     * @var \Backend\nterfaces\DependencyInjectionContainerInterface
     */
    protected $container = null;

    /**
     * This contains the Request that's being actioned.
     *
     * @var \Backend\nterfaces\RequestInterface
     */
    protected $request = null;

    /**
     * The constructor for the object
     */
    public function __construct(
        DependencyInjectionContainerInterface $container = null,
        RequestInterface $request = null
    ) {
        $this->container = $container;
        $this->request = $request;
    }

    /**
     * Set the Request for the Controller.
     *
     * @param \Backend\Interfaces\RequestInterface $request The request for the
     * Controller.
     *
     * @return \Backend\Interfaces\ControllerInterface The current object.
     */
    public function setRequest(RequestInterface $request)
    {
        $this->request = $request;

        return $this;
    }

    /**
     * Get the Controller's Request
     *
     * @return \Backend\Interfaces\RequestInterface The Controller's Request
     */
    public function getRequest()
    {
        return $this->request;
    }

    /**
     * Set the Controller's DI Container.
     *
     * @param \Backend\Interfaces\DependencyInjectionContainerInterface $container
     * The DI Container for the Controller.
     *
     * @return \Backend\Interfaces\ControllerInterface The current object.
     */
    public function setContainer(DependencyInjectionContainerInterface $container)
    {
        $this->container = $container;

        return $this;
    }

    /**
     * Get the Controller's DI Container
     *
     * @return \Backend\Interfaces\DependencyInjectionContainerInterface The
     * Controller's DI Container
     */
    public function getContainer()
    {
        return $this->container;
    }

    /**
     * Create a redirection Response
     *
     * @param string $location     The location to redirect to
     * @param int    $responseCode The HTTP status code to use
     *
     * @return \Backend\Core\Response The Response object
     */
    public function redirect($location, $responseCode = 302)
    {
        if (substr($responseCode, 0, 1) !== '3') {
            throw new CoreException('Invalid Redirection Response Code');
        }
        if ($location[0] === '/' && (empty($location[1]) || $location[1] !== '/')) {
            // Relative Redirect
            $location = $this->container->get('request_context')->getLink() . $location;
        }
        $responseClass = $this->container->getParameter('response.class');
        $response = new $responseClass('Redirecting to ' . $location, $responseCode);
        $response->setHeader('Location', $location);

        return $response;
    }
}