Encapsulates request information for easy and secure access from application controllers.
* *The request object is a simple value object that is passed between the dispatcher and controller classes. * It packages the HTTP request environment.
* *
* $request = new Phalcon\Http\Request();
* if ($request->isPost() == true) {
* if ($request->isAjax() == true) {
* echo 'Request was made using POST and AJAX';
* }
* }
*
*
*/
class Request implements \Phalcon\Http\RequestInterface, \Phalcon\DI\InjectionAwareInterface {
protected $_dependencyInjector;
protected $_filter;
protected $_rawBody;
/**
* Sets the dependency injector
*
* @param \Phalcon\DiInterface $dependencyInjector
*/
public function setDI($dependencyInjector){ }
/**
* Returns the internal dependency injector
*
* @return \Phalcon\DiInterface
*/
public function getDI(){ }
/**
* Gets a variable from the $_REQUEST superglobal applying filters if needed.
* If no parameters are given the $_REQUEST superglobal is returned
*
*
* //Returns value from $_REQUEST["user_email"] without sanitizing
* $userEmail = $request->get("user_email");
*
* //Returns value from $_REQUEST["user_email"] with sanitizing
* $userEmail = $request->get("user_email", "email");
*
*
* @param string $name
* @param string|array $filters
* @param mixed $defaultValue
* @return mixed
*/
public function get($name=null, $filters=null, $defaultValue=null){ }
/**
* Gets a variable from the $_POST superglobal applying filters if needed
* If no parameters are given the $_POST superglobal is returned
*
*
* //Returns value from $_POST["user_email"] without sanitizing
* $userEmail = $request->getPost("user_email");
*
* //Returns value from $_POST["user_email"] with sanitizing
* $userEmail = $request->getPost("user_email", "email");
*
*
* @param string $name
* @param string|array $filters
* @param mixed $defaultValue
* @return mixed
*/
public function getPost($name=null, $filters=null, $defaultValue=null){ }
/**
* Gets variable from $_GET superglobal applying filters if needed
* If no parameters are given the $_GET superglobal is returned
*
*
* //Returns value from $_GET["id"] without sanitizing
* $id = $request->getQuery("id");
*
* //Returns value from $_GET["id"] with sanitizing
* $id = $request->getQuery("id", "int");
*
* //Returns value from $_GET["id"] with a default value
* $id = $request->getQuery("id", null, 150);
*
*
* @param string $name
* @param string|array $filters
* @param mixed $defaultValue
* @return mixed
*/
public function getQuery($name=null, $filters=null, $defaultValue=null){ }
/**
* Gets variable from $_SERVER superglobal
*
* @param string $name
* @return mixed
*/
public function getServer($name){ }
/**
* Checks whether $_REQUEST superglobal has certain index
*
* @param string $name
* @return boolean
*/
public function has($name){ }
/**
* Checks whether $_POST superglobal has certain index
*
* @param string $name
* @return boolean
*/
public function hasPost($name){ }
/**
* Checks whether $_GET superglobal has certain index
*
* @param string $name
* @return boolean
*/
public function hasQuery($name){ }
/**
* Checks whether $_SERVER superglobal has certain index
*
* @param string $name
* @return mixed
*/
public function hasServer($name){ }
/**
* Gets HTTP header from request data
*
* @param string $header
* @return string
*/
public function getHeader($header){ }
/**
* Gets HTTP schema (http/https)
*
* @return string
*/
public function getScheme(){ }
/**
* Checks whether request has been made using ajax. Checks if $_SERVER['HTTP_X_REQUESTED_WITH']=='XMLHttpRequest'
*
* @return boolean
*/
public function isAjax(){ }
/**
* Checks whether request has been made using SOAP
*
* @return boolean
*/
public function isSoapRequested(){ }
/**
* Checks whether request has been made using any secure layer
*
* @return boolean
*/
public function isSecureRequest(){ }
/**
* Gets HTTP raw request body
*
* @return string
*/
public function getRawBody(){ }
/**
* Gets decoded JSON HTTP raw request body
*
* @return string
*/
public function getJsonRawBody(){ }
/**
* Gets active server address IP
*
* @return string
*/
public function getServerAddress(){ }
/**
* Gets active server name
*
* @return string
*/
public function getServerName(){ }
/**
* Gets information about schema, host and port used by the request
*
* @return string
*/
public function getHttpHost(){ }
/**
* Gets most possible client IPv4 Address. This method search in $_SERVER['REMOTE_ADDR'] and optionally in $_SERVER['HTTP_X_FORWARDED_FOR']
*
* @param boolean $trustForwardedHeader
* @return string
*/
public function getClientAddress($trustForwardedHeader=null){ }
/**
* Gets HTTP method which request has been made
*
* @return string
*/
public function getMethod(){ }
/**
* Gets HTTP user agent used to made the request
*
* @return string
*/
public function getUserAgent(){ }
/**
* Check if HTTP method match any of the passed methods
*
* @param string|array $methods
* @return boolean
*/
public function isMethod($methods){ }
/**
* Checks whether HTTP method is POST. if $_SERVER['REQUEST_METHOD']=='POST'
*
* @return boolean
*/
public function isPost(){ }
/**
* Checks whether HTTP method is GET. if $_SERVER['REQUEST_METHOD']=='GET'
*
* @return boolean
*/
public function isGet(){ }
/**
* Checks whether HTTP method is PUT. if $_SERVER['REQUEST_METHOD']=='PUT'
*
* @return boolean
*/
public function isPut(){ }
/**
* Checks whether HTTP method is PATCH. if $_SERVER['REQUEST_METHOD']=='PATCH'
*
* @return boolean
*/
public function isPatch(){ }
/**
* Checks whether HTTP method is HEAD. if $_SERVER['REQUEST_METHOD']=='HEAD'
*
* @return boolean
*/
public function isHead(){ }
/**
* Checks whether HTTP method is DELETE. if $_SERVER['REQUEST_METHOD']=='DELETE'
*
* @return boolean
*/
public function isDelete(){ }
/**
* Checks whether HTTP method is OPTIONS. if $_SERVER['REQUEST_METHOD']=='OPTIONS'
*
* @return boolean
*/
public function isOptions(){ }
/**
* Checks whether request includes attached files
*
* @return boolean
*/
public function hasFiles($notErrored=null){ }
/**
* Gets attached files as \Phalcon\Http\Request\File instances
*
* @param boolean $notErrored
* @return \Phalcon\Http\Request\File[]
*/
public function getUploadedFiles($notErrored=null){ }
/**
* Returns the available headers in the request
*
* @return array
*/
public function getHeaders(){ }
/**
* Gets web page that refers active request. ie: http://www.google.com
*
* @return string
*/
public function getHTTPReferer(){ }
/**
* Process a request header and return an array of values with their qualities
*
* @param string $serverIndex
* @param string $name
* @return array
*/
protected function _getQualityHeader(){ }
/**
* Process a request header and return the one with best quality
*
* @param array $qualityParts
* @param string $name
* @return string
*/
protected function _getBestQuality(){ }
/**
* Gets array with mime/types and their quality accepted by the browser/client from $_SERVER['HTTP_ACCEPT']
*
* @return array
*/
public function getAcceptableContent(){ }
/**
* Gets best mime/type accepted by the browser/client from $_SERVER['HTTP_ACCEPT']
*
* @return array
*/
public function getBestAccept(){ }
/**
* Gets charsets array and their quality accepted by the browser/client from $_SERVER['HTTP_ACCEPT_CHARSET']
*
* @return array
*/
public function getClientCharsets(){ }
/**
* Gets best charset accepted by the browser/client from $_SERVER['HTTP_ACCEPT_CHARSET']
*
* @return string
*/
public function getBestCharset(){ }
/**
* Gets languages array and their quality accepted by the browser/client from $_SERVER['HTTP_ACCEPT_LANGUAGE']
*
* @return array
*/
public function getLanguages(){ }
/**
* Gets best language accepted by the browser/client from $_SERVER['HTTP_ACCEPT_LANGUAGE']
*
* @return string
*/
public function getBestLanguage(){ }
}
}