<?php

namespace PSX\Http;

use PSX\Uri\UriInterface;

/**
 * This is a mutable version of the PSR HTTP message interface
 *
 * Per the HTTP specification, this interface includes properties for
 * each of the following:
 *
 * - Protocol version
 * - HTTP method
 * - URI
 * - Headers
 * - Message body
 *
 * @author  Christoph Kappestein <christoph.kappestein@gmail.com>
 * @license http://www.apache.org/licenses/LICENSE-2.0
 * @link    http://phpsx.org
 * @see     https://github.com/php-fig/fig-standards/blob/master/accepted/PSR-7-http-message.md
 */
interface RequestInterface extends MessageInterface
{
    /**
     * Returns the message's request-target
     *
     * @return string
     */
    public function getRequestTarget();

    /**
     * Sets an specific request-target
     *
     * @link http://tools.ietf.org/html/rfc7230#section-2.7
     * @param string $requestTarget
     * @return void
     */
    public function setRequestTarget($requestTarget);

    /**
     * Retrieves the HTTP method of the request i.e. GET, POST
     *
     * @return string
     */
    public function getMethod();

    /**
     * Sets the provided HTTP method. While HTTP method names are typically all
     * uppercase characters, HTTP method names are case-sensitive and thus
     * implementations SHOULD NOT modify the given string.
     *
     * @param string $method
     * @return void
     * @throws \InvalidArgumentException
     */
    public function setMethod($method);

    /**
     * Retrieves the URI instance.
     *
     * @link http://tools.ietf.org/html/rfc3986#section-4.3
     * @return \PSX\Uri\UriInterface
     */
    public function getUri();

    /**
     * Sets the provided URI.
     *
     * @link http://tools.ietf.org/html/rfc3986#section-4.3
     * @param \PSX\Uri\UriInterface $uri
     * @return void
     */
    public function setUri(UriInterface $uri);

    /**
     * Retrieve attributes derived from the request. The request attributes
     * should contain only additional information about the request i.e.
     * "REMOTE_ADDR" from the $_SERVER variable which contains the ip address of
     * the client which has initiated the HTTP request
     *
     * @return array
     */
    public function getAttributes();

    /**
     * Retrieve a single derived request attribute
     *
     * @param string $name
     * @return mixed
     */
    public function getAttribute($name);

    /**
     * This method allows setting a single derived request attribute
     *
     * @param string $name
     * @param mixed $value
     * @return void
     */
    public function setAttribute($name, $value);

    /**
     * Removes the specified derived request attribute
     *
     * @param string $name
     * @return void
     */
    public function removeAttribute($name);
}
__halt_compiler();----SIGNATURE:----faptdeqLBegu2ra0B0x51Rg33BcxgDInS2GVbl/F/a+xg40mEsn+Xqgx1MvlhYfvgmL0EVLFqAOvw9Efe229basQ+pp+y1lizzt33FdOA7zPCP0OnMjkT/XMzTb+CwJL4KfC+4hRfVgmTQtmd/pMugPp8fioLoG6hqGOzNrM2TWwS9u1usHXut70GGFRvpbDVSZal4OHB4RRFV6n8Ug98ZPXiNWay/P2Tow8zAa4YizEUPNgtpO4jiXlb9KX/ShJHlM2Gb7hIudDg1Mfp2wl9wiA6W0TqJ82uKPGa+j1Uprq7U85AnWUVr2Gxm0zrkU+IylAy66ylZlsBshXRa5Vk7DeB6xEGJpEvYr0QYP5x1ZIp5+uOlD5fxIHAnBxfmxgJbcp2BUMSt52tNzX9Bjw7chqfvsnCM+tVZXu77IIJFyBvCSN6AQ1akX1QPr7MIVD2zm/EhFoWy4J1Hsmv1U0AETTxuDm+YuQrnD6lxZspdRTYOGYsToF9cBe845r1KHZQklWydR1b+Wwv5U/B8eFnF9HothvPBksrRWHHLp+WtX6phU7yEpp57apGUMuKIaRilFxjJL+bW/i1EypGTpbQcvLUJQWUyF6hV/mCnDuO1o5SeZZnunJAgNvZ9OinJ4Bx2FqDenbGsxdn7NCgu23jFxLBU1KbIQQAJo3E/n8QiI=----ATTACHMENT:----NzQ2MDg4OTYzMzI2OTY4NSAzOTkzMjUwMTIzNzMwNzE1IDY3NzcwNjM3MzM2MDc4Mzc=