Update to Drupal 8.0-dev-2015-11-17. Commits through da81cd220, Tue Nov 17 15:53:49 2015 +0000, Issue #2617224 by Wim Leers: Move around/fix some documentation.
This commit is contained in:
parent
4afb23bbd3
commit
7784f4c23d
929 changed files with 19798 additions and 5304 deletions
102
vendor/symfony/http-foundation/Request.php
vendored
102
vendor/symfony/http-foundation/Request.php
vendored
|
@ -25,8 +25,6 @@ use Symfony\Component\HttpFoundation\Session\SessionInterface;
|
|||
* * getUriForPath
|
||||
*
|
||||
* @author Fabien Potencier <fabien@symfony.com>
|
||||
*
|
||||
* @api
|
||||
*/
|
||||
class Request
|
||||
{
|
||||
|
@ -85,8 +83,6 @@ class Request
|
|||
* Custom parameters.
|
||||
*
|
||||
* @var \Symfony\Component\HttpFoundation\ParameterBag
|
||||
*
|
||||
* @api
|
||||
*/
|
||||
public $attributes;
|
||||
|
||||
|
@ -94,8 +90,6 @@ class Request
|
|||
* Request body parameters ($_POST).
|
||||
*
|
||||
* @var \Symfony\Component\HttpFoundation\ParameterBag
|
||||
*
|
||||
* @api
|
||||
*/
|
||||
public $request;
|
||||
|
||||
|
@ -103,8 +97,6 @@ class Request
|
|||
* Query string parameters ($_GET).
|
||||
*
|
||||
* @var \Symfony\Component\HttpFoundation\ParameterBag
|
||||
*
|
||||
* @api
|
||||
*/
|
||||
public $query;
|
||||
|
||||
|
@ -112,8 +104,6 @@ class Request
|
|||
* Server and execution environment parameters ($_SERVER).
|
||||
*
|
||||
* @var \Symfony\Component\HttpFoundation\ServerBag
|
||||
*
|
||||
* @api
|
||||
*/
|
||||
public $server;
|
||||
|
||||
|
@ -121,8 +111,6 @@ class Request
|
|||
* Uploaded files ($_FILES).
|
||||
*
|
||||
* @var \Symfony\Component\HttpFoundation\FileBag
|
||||
*
|
||||
* @api
|
||||
*/
|
||||
public $files;
|
||||
|
||||
|
@ -130,8 +118,6 @@ class Request
|
|||
* Cookies ($_COOKIE).
|
||||
*
|
||||
* @var \Symfony\Component\HttpFoundation\ParameterBag
|
||||
*
|
||||
* @api
|
||||
*/
|
||||
public $cookies;
|
||||
|
||||
|
@ -139,8 +125,6 @@ class Request
|
|||
* Headers (taken from the $_SERVER).
|
||||
*
|
||||
* @var \Symfony\Component\HttpFoundation\HeaderBag
|
||||
*
|
||||
* @api
|
||||
*/
|
||||
public $headers;
|
||||
|
||||
|
@ -231,8 +215,6 @@ class Request
|
|||
* @param array $files The FILES parameters
|
||||
* @param array $server The SERVER parameters
|
||||
* @param string|resource $content The raw body data
|
||||
*
|
||||
* @api
|
||||
*/
|
||||
public function __construct(array $query = array(), array $request = array(), array $attributes = array(), array $cookies = array(), array $files = array(), array $server = array(), $content = null)
|
||||
{
|
||||
|
@ -251,8 +233,6 @@ class Request
|
|||
* @param array $files The FILES parameters
|
||||
* @param array $server The SERVER parameters
|
||||
* @param string|resource $content The raw body data
|
||||
*
|
||||
* @api
|
||||
*/
|
||||
public function initialize(array $query = array(), array $request = array(), array $attributes = array(), array $cookies = array(), array $files = array(), array $server = array(), $content = null)
|
||||
{
|
||||
|
@ -281,8 +261,6 @@ class Request
|
|||
* Creates a new request with values from PHP's super globals.
|
||||
*
|
||||
* @return Request A new request
|
||||
*
|
||||
* @api
|
||||
*/
|
||||
public static function createFromGlobals()
|
||||
{
|
||||
|
@ -326,8 +304,6 @@ class Request
|
|||
* @param string $content The raw body data
|
||||
*
|
||||
* @return Request A Request instance
|
||||
*
|
||||
* @api
|
||||
*/
|
||||
public static function create($uri, $method = 'GET', $parameters = array(), $cookies = array(), $files = array(), $server = array(), $content = null)
|
||||
{
|
||||
|
@ -446,8 +422,6 @@ class Request
|
|||
* @param array $server The SERVER parameters
|
||||
*
|
||||
* @return Request The duplicated request
|
||||
*
|
||||
* @api
|
||||
*/
|
||||
public function duplicate(array $query = null, array $request = null, array $attributes = null, array $cookies = null, array $files = null, array $server = null)
|
||||
{
|
||||
|
@ -534,8 +508,6 @@ class Request
|
|||
*
|
||||
* It overrides $_GET, $_POST, $_REQUEST, $_SERVER, $_COOKIE.
|
||||
* $_FILES is never overridden, see rfc1867
|
||||
*
|
||||
* @api
|
||||
*/
|
||||
public function overrideGlobals()
|
||||
{
|
||||
|
@ -572,8 +544,6 @@ class Request
|
|||
* You should only list the reverse proxies that you manage directly.
|
||||
*
|
||||
* @param array $proxies A list of trusted proxies
|
||||
*
|
||||
* @api
|
||||
*/
|
||||
public static function setTrustedProxies(array $proxies)
|
||||
{
|
||||
|
@ -771,8 +741,6 @@ class Request
|
|||
* Gets the Session.
|
||||
*
|
||||
* @return SessionInterface|null The session
|
||||
*
|
||||
* @api
|
||||
*/
|
||||
public function getSession()
|
||||
{
|
||||
|
@ -784,8 +752,6 @@ class Request
|
|||
* previous requests.
|
||||
*
|
||||
* @return bool
|
||||
*
|
||||
* @api
|
||||
*/
|
||||
public function hasPreviousSession()
|
||||
{
|
||||
|
@ -801,8 +767,6 @@ class Request
|
|||
* is associated with a Session instance.
|
||||
*
|
||||
* @return bool true when the Request contains a Session object, false otherwise
|
||||
*
|
||||
* @api
|
||||
*/
|
||||
public function hasSession()
|
||||
{
|
||||
|
@ -813,8 +777,6 @@ class Request
|
|||
* Sets the Session.
|
||||
*
|
||||
* @param SessionInterface $session The Session
|
||||
*
|
||||
* @api
|
||||
*/
|
||||
public function setSession(SessionInterface $session)
|
||||
{
|
||||
|
@ -886,8 +848,6 @@ class Request
|
|||
*
|
||||
* @see getClientIps()
|
||||
* @see http://en.wikipedia.org/wiki/X-Forwarded-For
|
||||
*
|
||||
* @api
|
||||
*/
|
||||
public function getClientIp()
|
||||
{
|
||||
|
@ -900,8 +860,6 @@ class Request
|
|||
* Returns current script name.
|
||||
*
|
||||
* @return string
|
||||
*
|
||||
* @api
|
||||
*/
|
||||
public function getScriptName()
|
||||
{
|
||||
|
@ -921,8 +879,6 @@ class Request
|
|||
* * http://localhost/mysite/about?var=1 returns '/about'
|
||||
*
|
||||
* @return string The raw path (i.e. not urldecoded)
|
||||
*
|
||||
* @api
|
||||
*/
|
||||
public function getPathInfo()
|
||||
{
|
||||
|
@ -944,8 +900,6 @@ class Request
|
|||
* * http://localhost/we%20b/index.php returns '/we%20b'
|
||||
*
|
||||
* @return string The raw path (i.e. not urldecoded)
|
||||
*
|
||||
* @api
|
||||
*/
|
||||
public function getBasePath()
|
||||
{
|
||||
|
@ -965,8 +919,6 @@ class Request
|
|||
* script filename (e.g. index.php) if one exists.
|
||||
*
|
||||
* @return string The raw URL (i.e. not urldecoded)
|
||||
*
|
||||
* @api
|
||||
*/
|
||||
public function getBaseUrl()
|
||||
{
|
||||
|
@ -981,8 +933,6 @@ class Request
|
|||
* Gets the request's scheme.
|
||||
*
|
||||
* @return string
|
||||
*
|
||||
* @api
|
||||
*/
|
||||
public function getScheme()
|
||||
{
|
||||
|
@ -1001,8 +951,6 @@ class Request
|
|||
* configure it via "setTrustedHeaderName()" with the "client-port" key.
|
||||
*
|
||||
* @return string
|
||||
*
|
||||
* @api
|
||||
*/
|
||||
public function getPort()
|
||||
{
|
||||
|
@ -1076,8 +1024,6 @@ class Request
|
|||
* The port name will be appended to the host if it's non-standard.
|
||||
*
|
||||
* @return string
|
||||
*
|
||||
* @api
|
||||
*/
|
||||
public function getHttpHost()
|
||||
{
|
||||
|
@ -1095,8 +1041,6 @@ class Request
|
|||
* Returns the requested URI (path and query string).
|
||||
*
|
||||
* @return string The raw URI (i.e. not URI decoded)
|
||||
*
|
||||
* @api
|
||||
*/
|
||||
public function getRequestUri()
|
||||
{
|
||||
|
@ -1126,8 +1070,6 @@ class Request
|
|||
* @return string A normalized URI (URL) for the Request
|
||||
*
|
||||
* @see getQueryString()
|
||||
*
|
||||
* @api
|
||||
*/
|
||||
public function getUri()
|
||||
{
|
||||
|
@ -1144,8 +1086,6 @@ class Request
|
|||
* @param string $path A path to use instead of the current one
|
||||
*
|
||||
* @return string The normalized URI for the path
|
||||
*
|
||||
* @api
|
||||
*/
|
||||
public function getUriForPath($path)
|
||||
{
|
||||
|
@ -1214,8 +1154,6 @@ class Request
|
|||
* and have consistent escaping.
|
||||
*
|
||||
* @return string|null A normalized query string for the Request
|
||||
*
|
||||
* @api
|
||||
*/
|
||||
public function getQueryString()
|
||||
{
|
||||
|
@ -1227,7 +1165,7 @@ class Request
|
|||
/**
|
||||
* Checks whether the request is secure or not.
|
||||
*
|
||||
* This method can read the client port from the "X-Forwarded-Proto" header
|
||||
* This method can read the client protocol from the "X-Forwarded-Proto" header
|
||||
* when trusted proxies were set via "setTrustedProxies()".
|
||||
*
|
||||
* The "X-Forwarded-Proto" header must contain the protocol: "https" or "http".
|
||||
|
@ -1237,8 +1175,6 @@ class Request
|
|||
* the "client-proto" key.
|
||||
*
|
||||
* @return bool
|
||||
*
|
||||
* @api
|
||||
*/
|
||||
public function isSecure()
|
||||
{
|
||||
|
@ -1254,7 +1190,7 @@ class Request
|
|||
/**
|
||||
* Returns the host name.
|
||||
*
|
||||
* This method can read the client port from the "X-Forwarded-Host" header
|
||||
* This method can read the client host name from the "X-Forwarded-Host" header
|
||||
* when trusted proxies were set via "setTrustedProxies()".
|
||||
*
|
||||
* The "X-Forwarded-Host" header must contain the client host name.
|
||||
|
@ -1265,8 +1201,6 @@ class Request
|
|||
* @return string
|
||||
*
|
||||
* @throws \UnexpectedValueException when the host name is invalid
|
||||
*
|
||||
* @api
|
||||
*/
|
||||
public function getHost()
|
||||
{
|
||||
|
@ -1316,8 +1250,6 @@ class Request
|
|||
* Sets the request method.
|
||||
*
|
||||
* @param string $method
|
||||
*
|
||||
* @api
|
||||
*/
|
||||
public function setMethod($method)
|
||||
{
|
||||
|
@ -1338,8 +1270,6 @@ class Request
|
|||
*
|
||||
* @return string The request method
|
||||
*
|
||||
* @api
|
||||
*
|
||||
* @see getRealMethod()
|
||||
*/
|
||||
public function getMethod()
|
||||
|
@ -1377,8 +1307,6 @@ class Request
|
|||
* @param string $format The format
|
||||
*
|
||||
* @return string The associated mime type (null if not found)
|
||||
*
|
||||
* @api
|
||||
*/
|
||||
public function getMimeType($format)
|
||||
{
|
||||
|
@ -1395,8 +1323,6 @@ class Request
|
|||
* @param string $mimeType The associated mime type
|
||||
*
|
||||
* @return string|null The format (null if not found)
|
||||
*
|
||||
* @api
|
||||
*/
|
||||
public function getFormat($mimeType)
|
||||
{
|
||||
|
@ -1420,8 +1346,6 @@ class Request
|
|||
*
|
||||
* @param string $format The format
|
||||
* @param string|array $mimeTypes The associated mime types (the preferred one must be the first as it will be used as the content type)
|
||||
*
|
||||
* @api
|
||||
*/
|
||||
public function setFormat($format, $mimeTypes)
|
||||
{
|
||||
|
@ -1444,8 +1368,6 @@ class Request
|
|||
* @param string $default The default format
|
||||
*
|
||||
* @return string The request format
|
||||
*
|
||||
* @api
|
||||
*/
|
||||
public function getRequestFormat($default = 'html')
|
||||
{
|
||||
|
@ -1460,8 +1382,6 @@ class Request
|
|||
* Sets the request format.
|
||||
*
|
||||
* @param string $format The request format.
|
||||
*
|
||||
* @api
|
||||
*/
|
||||
public function setRequestFormat($format)
|
||||
{
|
||||
|
@ -1472,8 +1392,6 @@ class Request
|
|||
* Gets the format associated with the request.
|
||||
*
|
||||
* @return string|null The format (null if no content type is present)
|
||||
*
|
||||
* @api
|
||||
*/
|
||||
public function getContentType()
|
||||
{
|
||||
|
@ -1484,8 +1402,6 @@ class Request
|
|||
* Sets the default locale.
|
||||
*
|
||||
* @param string $locale
|
||||
*
|
||||
* @api
|
||||
*/
|
||||
public function setDefaultLocale($locale)
|
||||
{
|
||||
|
@ -1510,8 +1426,6 @@ class Request
|
|||
* Sets the locale.
|
||||
*
|
||||
* @param string $locale
|
||||
*
|
||||
* @api
|
||||
*/
|
||||
public function setLocale($locale)
|
||||
{
|
||||
|
@ -1544,8 +1458,6 @@ class Request
|
|||
* Checks whether the method is safe or not.
|
||||
*
|
||||
* @return bool
|
||||
*
|
||||
* @api
|
||||
*/
|
||||
public function isMethodSafe()
|
||||
{
|
||||
|
@ -1626,8 +1538,6 @@ class Request
|
|||
* @param array $locales An array of ordered available locales
|
||||
*
|
||||
* @return string|null The preferred locale
|
||||
*
|
||||
* @api
|
||||
*/
|
||||
public function getPreferredLanguage(array $locales = null)
|
||||
{
|
||||
|
@ -1661,8 +1571,6 @@ class Request
|
|||
* Gets a list of languages acceptable by the client browser.
|
||||
*
|
||||
* @return array Languages ordered in the user browser preferences
|
||||
*
|
||||
* @api
|
||||
*/
|
||||
public function getLanguages()
|
||||
{
|
||||
|
@ -1703,8 +1611,6 @@ class Request
|
|||
* Gets a list of charsets acceptable by the client browser.
|
||||
*
|
||||
* @return array List of charsets in preferable order
|
||||
*
|
||||
* @api
|
||||
*/
|
||||
public function getCharsets()
|
||||
{
|
||||
|
@ -1733,8 +1639,6 @@ class Request
|
|||
* Gets a list of content types acceptable by the client browser.
|
||||
*
|
||||
* @return array List of content types in preferable order
|
||||
*
|
||||
* @api
|
||||
*/
|
||||
public function getAcceptableContentTypes()
|
||||
{
|
||||
|
@ -1754,8 +1658,6 @@ class Request
|
|||
* @link http://en.wikipedia.org/wiki/List_of_Ajax_frameworks#JavaScript
|
||||
*
|
||||
* @return bool true if the request is an XMLHttpRequest, false otherwise
|
||||
*
|
||||
* @api
|
||||
*/
|
||||
public function isXmlHttpRequest()
|
||||
{
|
||||
|
|
Reference in a new issue