Subversion-Projekte lars-tiefland.laravel_shop

Revision

Revision 991 | Ganze Datei anzeigen | Leerzeichen ignorieren | Details | Blame | Letzte Änderung | Log anzeigen | RSS feed

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
}