Edit File by line

Deprecated: str_replace(): Passing null to parameter #2 ($replace) of type array|string is deprecated in /home/sportsfever/public_html/filemanger/function.php on line 93
/home/sportsfe.../httpdocs/wp-conte.../plugins/wordpres.../vendor_p.../psr/http-mes.../src
File: UriInterface.php
<?php
[0] Fix | Delete
[1] Fix | Delete
namespace YoastSEO_Vendor\Psr\Http\Message;
[2] Fix | Delete
[3] Fix | Delete
/**
[4] Fix | Delete
* Value object representing a URI.
[5] Fix | Delete
*
[6] Fix | Delete
* This interface is meant to represent URIs according to RFC 3986 and to
[7] Fix | Delete
* provide methods for most common operations. Additional functionality for
[8] Fix | Delete
* working with URIs can be provided on top of the interface or externally.
[9] Fix | Delete
* Its primary use is for HTTP requests, but may also be used in other
[10] Fix | Delete
* contexts.
[11] Fix | Delete
*
[12] Fix | Delete
* Instances of this interface are considered immutable; all methods that
[13] Fix | Delete
* might change state MUST be implemented such that they retain the internal
[14] Fix | Delete
* state of the current instance and return an instance that contains the
[15] Fix | Delete
* changed state.
[16] Fix | Delete
*
[17] Fix | Delete
* Typically the Host header will be also be present in the request message.
[18] Fix | Delete
* For server-side requests, the scheme will typically be discoverable in the
[19] Fix | Delete
* server parameters.
[20] Fix | Delete
*
[21] Fix | Delete
* @link http://tools.ietf.org/html/rfc3986 (the URI specification)
[22] Fix | Delete
*/
[23] Fix | Delete
interface UriInterface
[24] Fix | Delete
{
[25] Fix | Delete
/**
[26] Fix | Delete
* Retrieve the scheme component of the URI.
[27] Fix | Delete
*
[28] Fix | Delete
* If no scheme is present, this method MUST return an empty string.
[29] Fix | Delete
*
[30] Fix | Delete
* The value returned MUST be normalized to lowercase, per RFC 3986
[31] Fix | Delete
* Section 3.1.
[32] Fix | Delete
*
[33] Fix | Delete
* The trailing ":" character is not part of the scheme and MUST NOT be
[34] Fix | Delete
* added.
[35] Fix | Delete
*
[36] Fix | Delete
* @see https://tools.ietf.org/html/rfc3986#section-3.1
[37] Fix | Delete
* @return string The URI scheme.
[38] Fix | Delete
*/
[39] Fix | Delete
public function getScheme() : string;
[40] Fix | Delete
/**
[41] Fix | Delete
* Retrieve the authority component of the URI.
[42] Fix | Delete
*
[43] Fix | Delete
* If no authority information is present, this method MUST return an empty
[44] Fix | Delete
* string.
[45] Fix | Delete
*
[46] Fix | Delete
* The authority syntax of the URI is:
[47] Fix | Delete
*
[48] Fix | Delete
* <pre>
[49] Fix | Delete
* [user-info@]host[:port]
[50] Fix | Delete
* </pre>
[51] Fix | Delete
*
[52] Fix | Delete
* If the port component is not set or is the standard port for the current
[53] Fix | Delete
* scheme, it SHOULD NOT be included.
[54] Fix | Delete
*
[55] Fix | Delete
* @see https://tools.ietf.org/html/rfc3986#section-3.2
[56] Fix | Delete
* @return string The URI authority, in "[user-info@]host[:port]" format.
[57] Fix | Delete
*/
[58] Fix | Delete
public function getAuthority() : string;
[59] Fix | Delete
/**
[60] Fix | Delete
* Retrieve the user information component of the URI.
[61] Fix | Delete
*
[62] Fix | Delete
* If no user information is present, this method MUST return an empty
[63] Fix | Delete
* string.
[64] Fix | Delete
*
[65] Fix | Delete
* If a user is present in the URI, this will return that value;
[66] Fix | Delete
* additionally, if the password is also present, it will be appended to the
[67] Fix | Delete
* user value, with a colon (":") separating the values.
[68] Fix | Delete
*
[69] Fix | Delete
* The trailing "@" character is not part of the user information and MUST
[70] Fix | Delete
* NOT be added.
[71] Fix | Delete
*
[72] Fix | Delete
* @return string The URI user information, in "username[:password]" format.
[73] Fix | Delete
*/
[74] Fix | Delete
public function getUserInfo() : string;
[75] Fix | Delete
/**
[76] Fix | Delete
* Retrieve the host component of the URI.
[77] Fix | Delete
*
[78] Fix | Delete
* If no host is present, this method MUST return an empty string.
[79] Fix | Delete
*
[80] Fix | Delete
* The value returned MUST be normalized to lowercase, per RFC 3986
[81] Fix | Delete
* Section 3.2.2.
[82] Fix | Delete
*
[83] Fix | Delete
* @see http://tools.ietf.org/html/rfc3986#section-3.2.2
[84] Fix | Delete
* @return string The URI host.
[85] Fix | Delete
*/
[86] Fix | Delete
public function getHost() : string;
[87] Fix | Delete
/**
[88] Fix | Delete
* Retrieve the port component of the URI.
[89] Fix | Delete
*
[90] Fix | Delete
* If a port is present, and it is non-standard for the current scheme,
[91] Fix | Delete
* this method MUST return it as an integer. If the port is the standard port
[92] Fix | Delete
* used with the current scheme, this method SHOULD return null.
[93] Fix | Delete
*
[94] Fix | Delete
* If no port is present, and no scheme is present, this method MUST return
[95] Fix | Delete
* a null value.
[96] Fix | Delete
*
[97] Fix | Delete
* If no port is present, but a scheme is present, this method MAY return
[98] Fix | Delete
* the standard port for that scheme, but SHOULD return null.
[99] Fix | Delete
*
[100] Fix | Delete
* @return null|int The URI port.
[101] Fix | Delete
*/
[102] Fix | Delete
public function getPort() : ?int;
[103] Fix | Delete
/**
[104] Fix | Delete
* Retrieve the path component of the URI.
[105] Fix | Delete
*
[106] Fix | Delete
* The path can either be empty or absolute (starting with a slash) or
[107] Fix | Delete
* rootless (not starting with a slash). Implementations MUST support all
[108] Fix | Delete
* three syntaxes.
[109] Fix | Delete
*
[110] Fix | Delete
* Normally, the empty path "" and absolute path "/" are considered equal as
[111] Fix | Delete
* defined in RFC 7230 Section 2.7.3. But this method MUST NOT automatically
[112] Fix | Delete
* do this normalization because in contexts with a trimmed base path, e.g.
[113] Fix | Delete
* the front controller, this difference becomes significant. It's the task
[114] Fix | Delete
* of the user to handle both "" and "/".
[115] Fix | Delete
*
[116] Fix | Delete
* The value returned MUST be percent-encoded, but MUST NOT double-encode
[117] Fix | Delete
* any characters. To determine what characters to encode, please refer to
[118] Fix | Delete
* RFC 3986, Sections 2 and 3.3.
[119] Fix | Delete
*
[120] Fix | Delete
* As an example, if the value should include a slash ("/") not intended as
[121] Fix | Delete
* delimiter between path segments, that value MUST be passed in encoded
[122] Fix | Delete
* form (e.g., "%2F") to the instance.
[123] Fix | Delete
*
[124] Fix | Delete
* @see https://tools.ietf.org/html/rfc3986#section-2
[125] Fix | Delete
* @see https://tools.ietf.org/html/rfc3986#section-3.3
[126] Fix | Delete
* @return string The URI path.
[127] Fix | Delete
*/
[128] Fix | Delete
public function getPath() : string;
[129] Fix | Delete
/**
[130] Fix | Delete
* Retrieve the query string of the URI.
[131] Fix | Delete
*
[132] Fix | Delete
* If no query string is present, this method MUST return an empty string.
[133] Fix | Delete
*
[134] Fix | Delete
* The leading "?" character is not part of the query and MUST NOT be
[135] Fix | Delete
* added.
[136] Fix | Delete
*
[137] Fix | Delete
* The value returned MUST be percent-encoded, but MUST NOT double-encode
[138] Fix | Delete
* any characters. To determine what characters to encode, please refer to
[139] Fix | Delete
* RFC 3986, Sections 2 and 3.4.
[140] Fix | Delete
*
[141] Fix | Delete
* As an example, if a value in a key/value pair of the query string should
[142] Fix | Delete
* include an ampersand ("&") not intended as a delimiter between values,
[143] Fix | Delete
* that value MUST be passed in encoded form (e.g., "%26") to the instance.
[144] Fix | Delete
*
[145] Fix | Delete
* @see https://tools.ietf.org/html/rfc3986#section-2
[146] Fix | Delete
* @see https://tools.ietf.org/html/rfc3986#section-3.4
[147] Fix | Delete
* @return string The URI query string.
[148] Fix | Delete
*/
[149] Fix | Delete
public function getQuery() : string;
[150] Fix | Delete
/**
[151] Fix | Delete
* Retrieve the fragment component of the URI.
[152] Fix | Delete
*
[153] Fix | Delete
* If no fragment is present, this method MUST return an empty string.
[154] Fix | Delete
*
[155] Fix | Delete
* The leading "#" character is not part of the fragment and MUST NOT be
[156] Fix | Delete
* added.
[157] Fix | Delete
*
[158] Fix | Delete
* The value returned MUST be percent-encoded, but MUST NOT double-encode
[159] Fix | Delete
* any characters. To determine what characters to encode, please refer to
[160] Fix | Delete
* RFC 3986, Sections 2 and 3.5.
[161] Fix | Delete
*
[162] Fix | Delete
* @see https://tools.ietf.org/html/rfc3986#section-2
[163] Fix | Delete
* @see https://tools.ietf.org/html/rfc3986#section-3.5
[164] Fix | Delete
* @return string The URI fragment.
[165] Fix | Delete
*/
[166] Fix | Delete
public function getFragment() : string;
[167] Fix | Delete
/**
[168] Fix | Delete
* Return an instance with the specified scheme.
[169] Fix | Delete
*
[170] Fix | Delete
* This method MUST retain the state of the current instance, and return
[171] Fix | Delete
* an instance that contains the specified scheme.
[172] Fix | Delete
*
[173] Fix | Delete
* Implementations MUST support the schemes "http" and "https" case
[174] Fix | Delete
* insensitively, and MAY accommodate other schemes if required.
[175] Fix | Delete
*
[176] Fix | Delete
* An empty scheme is equivalent to removing the scheme.
[177] Fix | Delete
*
[178] Fix | Delete
* @param string $scheme The scheme to use with the new instance.
[179] Fix | Delete
* @return static A new instance with the specified scheme.
[180] Fix | Delete
* @throws \InvalidArgumentException for invalid or unsupported schemes.
[181] Fix | Delete
*/
[182] Fix | Delete
public function withScheme(string $scheme) : \YoastSEO_Vendor\Psr\Http\Message\UriInterface;
[183] Fix | Delete
/**
[184] Fix | Delete
* Return an instance with the specified user information.
[185] Fix | Delete
*
[186] Fix | Delete
* This method MUST retain the state of the current instance, and return
[187] Fix | Delete
* an instance that contains the specified user information.
[188] Fix | Delete
*
[189] Fix | Delete
* Password is optional, but the user information MUST include the
[190] Fix | Delete
* user; an empty string for the user is equivalent to removing user
[191] Fix | Delete
* information.
[192] Fix | Delete
*
[193] Fix | Delete
* @param string $user The user name to use for authority.
[194] Fix | Delete
* @param null|string $password The password associated with $user.
[195] Fix | Delete
* @return static A new instance with the specified user information.
[196] Fix | Delete
*/
[197] Fix | Delete
public function withUserInfo(string $user, ?string $password = null) : \YoastSEO_Vendor\Psr\Http\Message\UriInterface;
[198] Fix | Delete
/**
[199] Fix | Delete
* Return an instance with the specified host.
[200] Fix | Delete
*
[201] Fix | Delete
* This method MUST retain the state of the current instance, and return
[202] Fix | Delete
* an instance that contains the specified host.
[203] Fix | Delete
*
[204] Fix | Delete
* An empty host value is equivalent to removing the host.
[205] Fix | Delete
*
[206] Fix | Delete
* @param string $host The hostname to use with the new instance.
[207] Fix | Delete
* @return static A new instance with the specified host.
[208] Fix | Delete
* @throws \InvalidArgumentException for invalid hostnames.
[209] Fix | Delete
*/
[210] Fix | Delete
public function withHost(string $host) : \YoastSEO_Vendor\Psr\Http\Message\UriInterface;
[211] Fix | Delete
/**
[212] Fix | Delete
* Return an instance with the specified port.
[213] Fix | Delete
*
[214] Fix | Delete
* This method MUST retain the state of the current instance, and return
[215] Fix | Delete
* an instance that contains the specified port.
[216] Fix | Delete
*
[217] Fix | Delete
* Implementations MUST raise an exception for ports outside the
[218] Fix | Delete
* established TCP and UDP port ranges.
[219] Fix | Delete
*
[220] Fix | Delete
* A null value provided for the port is equivalent to removing the port
[221] Fix | Delete
* information.
[222] Fix | Delete
*
[223] Fix | Delete
* @param null|int $port The port to use with the new instance; a null value
[224] Fix | Delete
* removes the port information.
[225] Fix | Delete
* @return static A new instance with the specified port.
[226] Fix | Delete
* @throws \InvalidArgumentException for invalid ports.
[227] Fix | Delete
*/
[228] Fix | Delete
public function withPort(?int $port) : \YoastSEO_Vendor\Psr\Http\Message\UriInterface;
[229] Fix | Delete
/**
[230] Fix | Delete
* Return an instance with the specified path.
[231] Fix | Delete
*
[232] Fix | Delete
* This method MUST retain the state of the current instance, and return
[233] Fix | Delete
* an instance that contains the specified path.
[234] Fix | Delete
*
[235] Fix | Delete
* The path can either be empty or absolute (starting with a slash) or
[236] Fix | Delete
* rootless (not starting with a slash). Implementations MUST support all
[237] Fix | Delete
* three syntaxes.
[238] Fix | Delete
*
[239] Fix | Delete
* If the path is intended to be domain-relative rather than path relative then
[240] Fix | Delete
* it must begin with a slash ("/"). Paths not starting with a slash ("/")
[241] Fix | Delete
* are assumed to be relative to some base path known to the application or
[242] Fix | Delete
* consumer.
[243] Fix | Delete
*
[244] Fix | Delete
* Users can provide both encoded and decoded path characters.
[245] Fix | Delete
* Implementations ensure the correct encoding as outlined in getPath().
[246] Fix | Delete
*
[247] Fix | Delete
* @param string $path The path to use with the new instance.
[248] Fix | Delete
* @return static A new instance with the specified path.
[249] Fix | Delete
* @throws \InvalidArgumentException for invalid paths.
[250] Fix | Delete
*/
[251] Fix | Delete
public function withPath(string $path) : \YoastSEO_Vendor\Psr\Http\Message\UriInterface;
[252] Fix | Delete
/**
[253] Fix | Delete
* Return an instance with the specified query string.
[254] Fix | Delete
*
[255] Fix | Delete
* This method MUST retain the state of the current instance, and return
[256] Fix | Delete
* an instance that contains the specified query string.
[257] Fix | Delete
*
[258] Fix | Delete
* Users can provide both encoded and decoded query characters.
[259] Fix | Delete
* Implementations ensure the correct encoding as outlined in getQuery().
[260] Fix | Delete
*
[261] Fix | Delete
* An empty query string value is equivalent to removing the query string.
[262] Fix | Delete
*
[263] Fix | Delete
* @param string $query The query string to use with the new instance.
[264] Fix | Delete
* @return static A new instance with the specified query string.
[265] Fix | Delete
* @throws \InvalidArgumentException for invalid query strings.
[266] Fix | Delete
*/
[267] Fix | Delete
public function withQuery(string $query) : \YoastSEO_Vendor\Psr\Http\Message\UriInterface;
[268] Fix | Delete
/**
[269] Fix | Delete
* Return an instance with the specified URI fragment.
[270] Fix | Delete
*
[271] Fix | Delete
* This method MUST retain the state of the current instance, and return
[272] Fix | Delete
* an instance that contains the specified URI fragment.
[273] Fix | Delete
*
[274] Fix | Delete
* Users can provide both encoded and decoded fragment characters.
[275] Fix | Delete
* Implementations ensure the correct encoding as outlined in getFragment().
[276] Fix | Delete
*
[277] Fix | Delete
* An empty fragment value is equivalent to removing the fragment.
[278] Fix | Delete
*
[279] Fix | Delete
* @param string $fragment The fragment to use with the new instance.
[280] Fix | Delete
* @return static A new instance with the specified fragment.
[281] Fix | Delete
*/
[282] Fix | Delete
public function withFragment(string $fragment) : \YoastSEO_Vendor\Psr\Http\Message\UriInterface;
[283] Fix | Delete
/**
[284] Fix | Delete
* Return the string representation as a URI reference.
[285] Fix | Delete
*
[286] Fix | Delete
* Depending on which components of the URI are present, the resulting
[287] Fix | Delete
* string is either a full URI or relative reference according to RFC 3986,
[288] Fix | Delete
* Section 4.1. The method concatenates the various components of the URI,
[289] Fix | Delete
* using the appropriate delimiters:
[290] Fix | Delete
*
[291] Fix | Delete
* - If a scheme is present, it MUST be suffixed by ":".
[292] Fix | Delete
* - If an authority is present, it MUST be prefixed by "//".
[293] Fix | Delete
* - The path can be concatenated without delimiters. But there are two
[294] Fix | Delete
* cases where the path has to be adjusted to make the URI reference
[295] Fix | Delete
* valid as PHP does not allow to throw an exception in __toString():
[296] Fix | Delete
* - If the path is rootless and an authority is present, the path MUST
[297] Fix | Delete
* be prefixed by "/".
[298] Fix | Delete
* - If the path is starting with more than one "/" and no authority is
[299] Fix | Delete
* present, the starting slashes MUST be reduced to one.
[300] Fix | Delete
* - If a query is present, it MUST be prefixed by "?".
[301] Fix | Delete
* - If a fragment is present, it MUST be prefixed by "#".
[302] Fix | Delete
*
[303] Fix | Delete
* @see http://tools.ietf.org/html/rfc3986#section-4.1
[304] Fix | Delete
* @return string
[305] Fix | Delete
*/
[306] Fix | Delete
public function __toString() : string;
[307] Fix | Delete
}
[308] Fix | Delete
[309] Fix | Delete
It is recommended that you Edit text format, this type of Fix handles quite a lot in one request
Function