<?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:----F6h/hx2b7X06CKvIyX+tWM6JXd3oJGa0yj6Acba4Gqs+PrNMW1rurBVjZZAft8Fs+YYVsGORObGL/o1cr++GUBcxp1GDxcDoI5rFYoNN+l+dpFyTBNl2c4D8TT/u4/Y5NxR9u4oh8IKaol0dNFrURgNKxLjskNcSTCqejxsbJ9bIkRvU0kwdvwWPGTnbOQbiewVNskCrIzP2VhbGpYU6LOdZBHhi3QBEoKBpv9Oi5Pcdt0Ew0ndxUOJOxEc4M7ne5RGEmwwvhnrt7sL1J7EosYGTtLyrL1tV8wl56GwA9BlfPvIHPxQyIYoDLkEWB6a+VwsBPn1aL0fZemVEgX3lrM0kVkwjL2luaTVMyZMVSBzeZ0W7TbY/GTM01VdR+GMr/KnQ6GuCxrK/erVlsy+ACE2mRTrYKy+U7fGoV9O70bbpH/aYf3nUyMKr44ZzUtMJpqONx3d33FUJHPQppSsz0jFpfzjLNcG1qCeTHfTpVYNquGGpCfu/2lX2e+SEjzjVqHHx6J0HKrxrimifm1kscM/+nXTdK0/x0Bn0wQHYk0Weef8JKKH07Wxt+FI1BF2FYWWPLlEQ/uHY4vo4c6yTLrrBKuzNOyJaKrG+Q6Asy2yi53Yr32gMd8j0RgxHbuq17I5cbOw2xICt4Ne+rrcp8NcGklyBzXXv/S94VHRWdck=----ATTACHMENT:----ODM3MDY2MTg5NzA1NjMwOCA0NDgzNTQ3MTUzMjUxNzg1IDQ3MTA5NjIxNTExMTcyMjc=