2012-11-22 03:25:06 +00:00
|
|
|
<?php defined('SYSPATH') OR die('No direct script access.');
|
2011-05-16 12:47:16 +00:00
|
|
|
/**
|
|
|
|
* A HTTP Request specific interface that adds the methods required
|
|
|
|
* by HTTP requests. Over and above [Kohana_HTTP_Interaction], this
|
|
|
|
* interface provides method, uri, get and post methods.
|
|
|
|
*
|
|
|
|
* @package Kohana
|
|
|
|
* @category HTTP
|
|
|
|
* @author Kohana Team
|
|
|
|
* @since 3.1.0
|
2012-11-22 03:25:06 +00:00
|
|
|
* @copyright (c) 2008-2012 Kohana Team
|
2011-05-16 12:47:16 +00:00
|
|
|
* @license http://kohanaphp.com/license
|
|
|
|
*/
|
2012-11-22 03:25:06 +00:00
|
|
|
interface Kohana_HTTP_Request extends HTTP_Message {
|
2011-05-16 12:47:16 +00:00
|
|
|
|
|
|
|
// HTTP Methods
|
|
|
|
const GET = 'GET';
|
|
|
|
const POST = 'POST';
|
|
|
|
const PUT = 'PUT';
|
|
|
|
const DELETE = 'DELETE';
|
|
|
|
const HEAD = 'HEAD';
|
|
|
|
const OPTIONS = 'OPTIONS';
|
|
|
|
const TRACE = 'TRACE';
|
|
|
|
const CONNECT = 'CONNECT';
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Gets or sets the HTTP method. Usually GET, POST, PUT or DELETE in
|
|
|
|
* traditional CRUD applications.
|
|
|
|
*
|
|
|
|
* @param string $method Method to use for this request
|
|
|
|
* @return mixed
|
|
|
|
*/
|
|
|
|
public function method($method = NULL);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Gets the URI of this request, optionally allows setting
|
|
|
|
* of [Route] specific parameters during the URI generation.
|
|
|
|
* If no parameters are passed, the request will use the
|
|
|
|
* default values defined in the Route.
|
|
|
|
*
|
|
|
|
* @param array $params Optional parameters to include in uri generation
|
|
|
|
* @return string
|
|
|
|
*/
|
2012-11-22 03:25:06 +00:00
|
|
|
public function uri();
|
2011-05-16 12:47:16 +00:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Gets or sets HTTP query string.
|
|
|
|
*
|
|
|
|
* @param mixed $key Key or key value pairs to set
|
|
|
|
* @param string $value Value to set to a key
|
|
|
|
* @return mixed
|
|
|
|
*/
|
|
|
|
public function query($key = NULL, $value = NULL);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Gets or sets HTTP POST parameters to the request.
|
|
|
|
*
|
|
|
|
* @param mixed $key Key or key value pairs to set
|
|
|
|
* @param string $value Value to set to a key
|
|
|
|
* @return mixed
|
|
|
|
*/
|
|
|
|
public function post($key = NULL, $value = NULL);
|
|
|
|
|
|
|
|
}
|