WebSVN – lars-tiefland.laravel_shop – Diff – /trunk/vendor/psr/http-message/src/UriInterface.php



<?php

 
 
 

namespace Psr\Http\Message;
 
/**

     * added.
     *
     * @see https://tools.ietf.org/html/rfc3986#section-3.1
     * @return string The URI scheme.
     */
    public function getScheme(): string;

 
    /**
     * Retrieve the authority component of the URI.
     *

     * scheme, it SHOULD NOT be included.
     *
     * @see https://tools.ietf.org/html/rfc3986#section-3.2
     * @return string The URI authority, in "[user-info@]host[:port]" format.
     */
    public function getAuthority(): string;

 
    /**
     * Retrieve the user information component of the URI.
     *

     * The trailing "@" character is not part of the user information and MUST
     * NOT be added.
     *
     * @return string The URI user information, in "username[:password]" format.
     */
    public function getUserInfo(): string;

 
    /**
     * Retrieve the host component of the URI.
     *

     * Section 3.2.2.
     *
     * @see http://tools.ietf.org/html/rfc3986#section-3.2.2
     * @return string The URI host.
     */
    public function getHost(): string;

 
    /**
     * Retrieve the port component of the URI.
     *

     * If no port is present, but a scheme is present, this method MAY return
     * the standard port for that scheme, but SHOULD return null.
     *
     * @return null|int The URI port.
     */
    public function getPort(): ?int;

 
    /**
     * Retrieve the path component of the URI.
     *

     *
     * @see https://tools.ietf.org/html/rfc3986#section-2
     * @see https://tools.ietf.org/html/rfc3986#section-3.3
     * @return string The URI path.
     */
    public function getPath(): string;

 
    /**
     * Retrieve the query string of the URI.
     *

     *
     * @see https://tools.ietf.org/html/rfc3986#section-2
     * @see https://tools.ietf.org/html/rfc3986#section-3.4
     * @return string The URI query string.
     */
    public function getQuery(): string;

 
    /**
     * Retrieve the fragment component of the URI.
     *

     *
     * @see https://tools.ietf.org/html/rfc3986#section-2
     * @see https://tools.ietf.org/html/rfc3986#section-3.5
     * @return string The URI fragment.
     */
    public function getFragment(): string;

 
    /**
     * Return an instance with the specified scheme.
     *

     *
     * @param string $scheme The scheme to use with the new instance.
     * @return static A new instance with the specified scheme.
     * @throws \InvalidArgumentException for invalid or unsupported schemes.
     */
    public function withScheme(string $scheme): UriInterface;

 
    /**
     * Return an instance with the specified user information.
     *

     *
     * @param string $user The user name to use for authority.
     * @param null|string $password The password associated with $user.
     * @return static A new instance with the specified user information.
     */
    public function withUserInfo(string $user, ?string $password = null): UriInterface;

 
    /**
     * Return an instance with the specified host.
     *

     *
     * @param string $host The hostname to use with the new instance.
     * @return static A new instance with the specified host.
     * @throws \InvalidArgumentException for invalid hostnames.
     */
    public function withHost(string $host): UriInterface;

 
    /**
     * Return an instance with the specified port.
     *

     * @param null|int $port The port to use with the new instance; a null value
     *     removes the port information.
     * @return static A new instance with the specified port.
     * @throws \InvalidArgumentException for invalid ports.
     */
    public function withPort(?int $port): UriInterface;

 
    /**
     * Return an instance with the specified path.
     *

     *
     * @param string $path The path to use with the new instance.
     * @return static A new instance with the specified path.
     * @throws \InvalidArgumentException for invalid paths.
     */
    public function withPath(string $path): UriInterface;

 
    /**
     * Return an instance with the specified query string.
     *

     *
     * @param string $query The query string to use with the new instance.
     * @return static A new instance with the specified query string.
     * @throws \InvalidArgumentException for invalid query strings.
     */
    public function withQuery(string $query): UriInterface;

 
    /**
     * Return an instance with the specified URI fragment.
     *

     * An empty fragment value is equivalent to removing the fragment.
     *
     * @param string $fragment The fragment to use with the new instance.
     * @return static A new instance with the specified fragment.
     */
    public function withFragment(string $fragment): UriInterface;

 
    /**
     * Return the string representation as a URI reference.
     *

     * - If a fragment is present, it MUST be prefixed by "#".
     *
     * @see http://tools.ietf.org/html/rfc3986#section-4.1
     * @return string
     */
    public function __toString(): string;
}

Revision 991	Revision 1464
Zeile 1...	Zeile 1...
1	`<?php`	1	`<?php`
Zeile 2...	Zeile -...
2		-
3	`declare(strict_types=1);`	-
4		2
Zeile 5...	Zeile 3...
5	`namespace Psr\Http\Message;`	3	`namespace Psr\Http\Message;`
6		4
7	`/**`	5	`/**`
Zeile 38...	Zeile 36...
38	`* added.`	36	`* added.`
39	`*`	37	`*`
40	`* @see https://tools.ietf.org/html/rfc3986#section-3.1`	38	`* @see https://tools.ietf.org/html/rfc3986#section-3.1`
41	`* @return string The URI scheme.`	39	`* @return string The URI scheme.`
42	`*/`	40	`*/`
43	`public function getScheme();`	41	`public function getScheme(): string;`
Zeile 44...	Zeile 42...
44		42
45	`/**`	43	`/**`
46	`* Retrieve the authority component of the URI.`	44	`* Retrieve the authority component of the URI.`
47	`*`	45	`*`
Zeile 58...	Zeile 56...
58	`* scheme, it SHOULD NOT be included.`	56	`* scheme, it SHOULD NOT be included.`
59	`*`	57	`*`
60	`* @see https://tools.ietf.org/html/rfc3986#section-3.2`	58	`* @see https://tools.ietf.org/html/rfc3986#section-3.2`
61	`* @return string The URI authority, in "[user-info@]host[:port]" format.`	59	`* @return string The URI authority, in "[user-info@]host[:port]" format.`
62	`*/`	60	`*/`
63	`public function getAuthority();`	61	`public function getAuthority(): string;`
Zeile 64...	Zeile 62...
64		62
65	`/**`	63	`/**`
66	`* Retrieve the user information component of the URI.`	64	`* Retrieve the user information component of the URI.`
67	`*`	65	`*`
Zeile 75...	Zeile 73...
75	`* The trailing "@" character is not part of the user information and MUST`	73	`* The trailing "@" character is not part of the user information and MUST`
76	`* NOT be added.`	74	`* NOT be added.`
77	`*`	75	`*`
78	`* @return string The URI user information, in "username[:password]" format.`	76	`* @return string The URI user information, in "username[:password]" format.`
79	`*/`	77	`*/`
80	`public function getUserInfo();`	78	`public function getUserInfo(): string;`
Zeile 81...	Zeile 79...
81		79
82	`/**`	80	`/**`
83	`* Retrieve the host component of the URI.`	81	`* Retrieve the host component of the URI.`
84	`*`	82	`*`
Zeile 88...	Zeile 86...
88	`* Section 3.2.2.`	86	`* Section 3.2.2.`
89	`*`	87	`*`
90	`* @see http://tools.ietf.org/html/rfc3986#section-3.2.2`	88	`* @see http://tools.ietf.org/html/rfc3986#section-3.2.2`
91	`* @return string The URI host.`	89	`* @return string The URI host.`
92	`*/`	90	`*/`
93	`public function getHost();`	91	`public function getHost(): string;`
Zeile 94...	Zeile 92...
94		92
95	`/**`	93	`/**`
96	`* Retrieve the port component of the URI.`	94	`* Retrieve the port component of the URI.`
97	`*`	95	`*`
Zeile 105...	Zeile 103...
105	`* If no port is present, but a scheme is present, this method MAY return`	103	`* If no port is present, but a scheme is present, this method MAY return`
106	`* the standard port for that scheme, but SHOULD return null.`	104	`* the standard port for that scheme, but SHOULD return null.`
107	`*`	105	`*`
108	`* @return null\|int The URI port.`	106	`* @return null\|int The URI port.`
109	`*/`	107	`*/`
110	`public function getPort();`	108	`public function getPort(): ?int;`
Zeile 111...	Zeile 109...
111		109
112	`/**`	110	`/**`
113	`* Retrieve the path component of the URI.`	111	`* Retrieve the path component of the URI.`
114	`*`	112	`*`
Zeile 132...	Zeile 130...
132	`*`	130	`*`
133	`* @see https://tools.ietf.org/html/rfc3986#section-2`	131	`* @see https://tools.ietf.org/html/rfc3986#section-2`
134	`* @see https://tools.ietf.org/html/rfc3986#section-3.3`	132	`* @see https://tools.ietf.org/html/rfc3986#section-3.3`
135	`* @return string The URI path.`	133	`* @return string The URI path.`
136	`*/`	134	`*/`
137	`public function getPath();`	135	`public function getPath(): string;`
Zeile 138...	Zeile 136...
138		136
139	`/**`	137	`/**`
140	`* Retrieve the query string of the URI.`	138	`* Retrieve the query string of the URI.`
141	`*`	139	`*`
Zeile 154...	Zeile 152...
154	`*`	152	`*`
155	`* @see https://tools.ietf.org/html/rfc3986#section-2`	153	`* @see https://tools.ietf.org/html/rfc3986#section-2`
156	`* @see https://tools.ietf.org/html/rfc3986#section-3.4`	154	`* @see https://tools.ietf.org/html/rfc3986#section-3.4`
157	`* @return string The URI query string.`	155	`* @return string The URI query string.`
158	`*/`	156	`*/`
159	`public function getQuery();`	157	`public function getQuery(): string;`
Zeile 160...	Zeile 158...
160		158
161	`/**`	159	`/**`
162	`* Retrieve the fragment component of the URI.`	160	`* Retrieve the fragment component of the URI.`
163	`*`	161	`*`
Zeile 172...	Zeile 170...
172	`*`	170	`*`
173	`* @see https://tools.ietf.org/html/rfc3986#section-2`	171	`* @see https://tools.ietf.org/html/rfc3986#section-2`
174	`* @see https://tools.ietf.org/html/rfc3986#section-3.5`	172	`* @see https://tools.ietf.org/html/rfc3986#section-3.5`
175	`* @return string The URI fragment.`	173	`* @return string The URI fragment.`
176	`*/`	174	`*/`
177	`public function getFragment();`	175	`public function getFragment(): string;`
Zeile 178...	Zeile 176...
178		176
179	`/**`	177	`/**`
180	`* Return an instance with the specified scheme.`	178	`* Return an instance with the specified scheme.`
181	`*`	179	`*`
Zeile 189...	Zeile 187...
189	`*`	187	`*`
190	`* @param string $scheme The scheme to use with the new instance.`	188	`* @param string $scheme The scheme to use with the new instance.`
191	`* @return static A new instance with the specified scheme.`	189	`* @return static A new instance with the specified scheme.`
192	`* @throws \InvalidArgumentException for invalid or unsupported schemes.`	190	`* @throws \InvalidArgumentException for invalid or unsupported schemes.`
193	`*/`	191	`*/`
194	`public function withScheme(string $scheme);`	192	`public function withScheme(string $scheme): UriInterface;`
Zeile 195...	Zeile 193...
195		193
196	`/**`	194	`/**`
197	`* Return an instance with the specified user information.`	195	`* Return an instance with the specified user information.`
198	`*`	196	`*`
Zeile 205...	Zeile 203...
205	`*`	203	`*`
206	`* @param string $user The user name to use for authority.`	204	`* @param string $user The user name to use for authority.`
207	`* @param null\|string $password The password associated with $user.`	205	`* @param null\|string $password The password associated with $user.`
208	`* @return static A new instance with the specified user information.`	206	`* @return static A new instance with the specified user information.`
209	`*/`	207	`*/`
210	`public function withUserInfo(string $user, ?string $password = null);`	208	`public function withUserInfo(string $user, ?string $password = null): UriInterface;`
Zeile 211...	Zeile 209...
211		209
212	`/**`	210	`/**`
213	`* Return an instance with the specified host.`	211	`* Return an instance with the specified host.`
214	`*`	212	`*`
Zeile 219...	Zeile 217...
219	`*`	217	`*`
220	`* @param string $host The hostname to use with the new instance.`	218	`* @param string $host The hostname to use with the new instance.`
221	`* @return static A new instance with the specified host.`	219	`* @return static A new instance with the specified host.`
222	`* @throws \InvalidArgumentException for invalid hostnames.`	220	`* @throws \InvalidArgumentException for invalid hostnames.`
223	`*/`	221	`*/`
224	`public function withHost(string $host);`	222	`public function withHost(string $host): UriInterface;`
Zeile 225...	Zeile 223...
225		223
226	`/**`	224	`/**`
227	`* Return an instance with the specified port.`	225	`* Return an instance with the specified port.`
228	`*`	226	`*`
Zeile 238...	Zeile 236...
238	`* @param null\|int $port The port to use with the new instance; a null value`	236	`* @param null\|int $port The port to use with the new instance; a null value`
239	`* removes the port information.`	237	`* removes the port information.`
240	`* @return static A new instance with the specified port.`	238	`* @return static A new instance with the specified port.`
241	`* @throws \InvalidArgumentException for invalid ports.`	239	`* @throws \InvalidArgumentException for invalid ports.`
242	`*/`	240	`*/`
243	`public function withPort(?int $port);`	241	`public function withPort(?int $port): UriInterface;`
Zeile 244...	Zeile 242...
244		242
245	`/**`	243	`/**`
246	`* Return an instance with the specified path.`	244	`* Return an instance with the specified path.`
247	`*`	245	`*`
Zeile 262...	Zeile 260...
262	`*`	260	`*`
263	`* @param string $path The path to use with the new instance.`	261	`* @param string $path The path to use with the new instance.`
264	`* @return static A new instance with the specified path.`	262	`* @return static A new instance with the specified path.`
265	`* @throws \InvalidArgumentException for invalid paths.`	263	`* @throws \InvalidArgumentException for invalid paths.`
266	`*/`	264	`*/`
267	`public function withPath(string $path);`	265	`public function withPath(string $path): UriInterface;`
Zeile 268...	Zeile 266...
268		266
269	`/**`	267	`/**`
270	`* Return an instance with the specified query string.`	268	`* Return an instance with the specified query string.`
271	`*`	269	`*`
Zeile 279...	Zeile 277...
279	`*`	277	`*`
280	`* @param string $query The query string to use with the new instance.`	278	`* @param string $query The query string to use with the new instance.`
281	`* @return static A new instance with the specified query string.`	279	`* @return static A new instance with the specified query string.`
282	`* @throws \InvalidArgumentException for invalid query strings.`	280	`* @throws \InvalidArgumentException for invalid query strings.`
283	`*/`	281	`*/`
284	`public function withQuery(string $query);`	282	`public function withQuery(string $query): UriInterface;`
Zeile 285...	Zeile 283...
285		283
286	`/**`	284	`/**`
287	`* Return an instance with the specified URI fragment.`	285	`* Return an instance with the specified URI fragment.`
288	`*`	286	`*`
Zeile 295...	Zeile 293...
295	`* An empty fragment value is equivalent to removing the fragment.`	293	`* An empty fragment value is equivalent to removing the fragment.`
296	`*`	294	`*`
297	`* @param string $fragment The fragment to use with the new instance.`	295	`* @param string $fragment The fragment to use with the new instance.`
298	`* @return static A new instance with the specified fragment.`	296	`* @return static A new instance with the specified fragment.`
299	`*/`	297	`*/`
300	`public function withFragment(string $fragment);`	298	`public function withFragment(string $fragment): UriInterface;`
Zeile 301...	Zeile 299...
301		299
302	`/**`	300	`/**`
303	`* Return the string representation as a URI reference.`	301	`* Return the string representation as a URI reference.`
304	`*`	302	`*`
Zeile 320...	Zeile 318...
320	`* - If a fragment is present, it MUST be prefixed by "#".`	318	`* - If a fragment is present, it MUST be prefixed by "#".`
321	`*`	319	`*`
322	`* @see http://tools.ietf.org/html/rfc3986#section-4.1`	320	`* @see http://tools.ietf.org/html/rfc3986#section-4.1`
323	`* @return string`	321	`* @return string`
324	`*/`	322	`*/`
325	`public function __toString();`	323	`public function __toString(): string;`
326	`}`	324	`}`

Subversion-Projekte lars-tiefland.laravel_shop

(root)/trunk/vendor/psr/http-message/src/UriInterface.php – Revision 991 → 1464