ILIAS  release_5-4 Revision v5.4.26-12-gabc799a52e6
UriResolver.php
Go to the documentation of this file.
1<?php
2namespace GuzzleHttp\Psr7;
3
5
13final class UriResolver
14{
23 public static function removeDotSegments($path)
24 {
25 if ($path === '' || $path === '/') {
26 return $path;
27 }
28
29 $results = [];
30 $segments = explode('/', $path);
31 foreach ($segments as $segment) {
32 if ($segment === '..') {
33 array_pop($results);
34 } elseif ($segment !== '.') {
35 $results[] = $segment;
36 }
37 }
38
39 $newPath = implode('/', $results);
40
41 if ($path[0] === '/' && (!isset($newPath[0]) || $newPath[0] !== '/')) {
42 // Re-add the leading slash if necessary for cases like "/.."
43 $newPath = '/' . $newPath;
44 } elseif ($newPath !== '' && ($segment === '.' || $segment === '..')) {
45 // Add the trailing slash if necessary
46 // If newPath is not empty, then $segment must be set and is the last segment from the foreach
47 $newPath .= '/';
48 }
49
50 return $newPath;
51 }
52
62 public static function resolve(UriInterface $base, UriInterface $rel)
63 {
64 if ((string) $rel === '') {
65 // we can simply return the same base URI instance for this same-document reference
66 return $base;
67 }
68
69 if ($rel->getScheme() != '') {
70 return $rel->withPath(self::removeDotSegments($rel->getPath()));
71 }
72
73 if ($rel->getAuthority() != '') {
74 $targetAuthority = $rel->getAuthority();
75 $targetPath = self::removeDotSegments($rel->getPath());
76 $targetQuery = $rel->getQuery();
77 } else {
78 $targetAuthority = $base->getAuthority();
79 if ($rel->getPath() === '') {
80 $targetPath = $base->getPath();
81 $targetQuery = $rel->getQuery() != '' ? $rel->getQuery() : $base->getQuery();
82 } else {
83 if ($rel->getPath()[0] === '/') {
84 $targetPath = $rel->getPath();
85 } else {
86 if ($targetAuthority != '' && $base->getPath() === '') {
87 $targetPath = '/' . $rel->getPath();
88 } else {
89 $lastSlashPos = strrpos($base->getPath(), '/');
90 if ($lastSlashPos === false) {
91 $targetPath = $rel->getPath();
92 } else {
93 $targetPath = substr($base->getPath(), 0, $lastSlashPos + 1) . $rel->getPath();
94 }
95 }
96 }
97 $targetPath = self::removeDotSegments($targetPath);
98 $targetQuery = $rel->getQuery();
99 }
100 }
101
102 return new Uri(Uri::composeComponents(
103 $base->getScheme(),
104 $targetAuthority,
105 $targetPath,
106 $targetQuery,
107 $rel->getFragment()
108 ));
109 }
110
138 {
139 if ($target->getScheme() !== '' &&
140 ($base->getScheme() !== $target->getScheme() || $target->getAuthority() === '' && $base->getAuthority() !== '')
141 ) {
142 return $target;
143 }
144
146 // As the target is already highly relative we return it as-is. It would be possible to resolve
147 // the target with `$target = self::resolve($base, $target);` and then try make it more relative
148 // by removing a duplicate query. But let's not do that automatically.
149 return $target;
150 }
151
152 if ($target->getAuthority() !== '' && $base->getAuthority() !== $target->getAuthority()) {
153 return $target->withScheme('');
154 }
155
156 // We must remove the path before removing the authority because if the path starts with two slashes, the URI
157 // would turn invalid. And we also cannot set a relative path before removing the authority, as that is also
158 // invalid.
159 $emptyPathUri = $target->withScheme('')->withPath('')->withUserInfo('')->withPort(null)->withHost('');
160
161 if ($base->getPath() !== $target->getPath()) {
162 return $emptyPathUri->withPath(self::getRelativePath($base, $target));
163 }
164
165 if ($base->getQuery() === $target->getQuery()) {
166 // Only the target fragment is left. And it must be returned even if base and target fragment are the same.
167 return $emptyPathUri->withQuery('');
168 }
169
170 // If the base URI has a query but the target has none, we cannot return an empty path reference as it would
171 // inherit the base query component when resolving.
172 if ($target->getQuery() === '') {
173 $segments = explode('/', $target->getPath());
174 $lastSegment = end($segments);
175
176 return $emptyPathUri->withPath($lastSegment === '' ? './' : $lastSegment);
177 }
178
179 return $emptyPathUri;
180 }
181
183 {
184 $sourceSegments = explode('/', $base->getPath());
185 $targetSegments = explode('/', $target->getPath());
186 array_pop($sourceSegments);
187 $targetLastSegment = array_pop($targetSegments);
188 foreach ($sourceSegments as $i => $segment) {
189 if (isset($targetSegments[$i]) && $segment === $targetSegments[$i]) {
190 unset($sourceSegments[$i], $targetSegments[$i]);
191 } else {
192 break;
193 }
194 }
195 $targetSegments[] = $targetLastSegment;
196 $relativePath = str_repeat('../', count($sourceSegments)) . implode('/', $targetSegments);
197
198 // A reference to am empty last segment or an empty first sub-segment must be prefixed with "./".
199 // This also applies to a segment with a colon character (e.g., "file:colon") that cannot be used
200 // as the first segment of a relative-path reference, as it would be mistaken for a scheme name.
201 if ('' === $relativePath || false !== strpos(explode('/', $relativePath, 2)[0], ':')) {
202 $relativePath = "./$relativePath";
203 } elseif ('/' === $relativePath[0]) {
204 if ($base->getAuthority() != '' && $base->getPath() === '') {
205 // In this case an extra slash is added by resolve() automatically. So we must not add one here.
206 $relativePath = ".$relativePath";
207 } else {
208 $relativePath = "./$relativePath";
209 }
210 }
211
212 return $relativePath;
213 }
214
215 private function __construct()
216 {
217 // cannot be instantiated
218 }
219}
$path
Definition: aliased.php:25
An exception for terminatinating execution or to throw for unit testing.
Resolves a URI reference in the context of a base URI and the opposite way.
Definition: UriResolver.php:14
static getRelativePath(UriInterface $base, UriInterface $target)
static relativize(UriInterface $base, UriInterface $target)
Returns the target URI as a relative reference from the base URI.
static removeDotSegments($path)
Removes dot segments from a path and returns the new path.
Definition: UriResolver.php:23
static resolve(UriInterface $base, UriInterface $rel)
Converts the relative URI into a new URI that is resolved against the base URI.
Definition: UriResolver.php:62
PSR-7 URI implementation.
Definition: Uri.php:14
static isRelativePathReference(UriInterface $uri)
Whether the URI is a relative-path reference.
Definition: Uri.php:222
static composeComponents($scheme, $authority, $path, $query, $fragment)
Composes a URI reference string from its various components.
Definition: Uri.php:114
$i
Definition: disco.tpl.php:19
Value object representing a URI.
getScheme()
Retrieve the scheme component of the URI.
getAuthority()
Retrieve the authority component of the URI.
getQuery()
Retrieve the query string of the URI.
getFragment()
Retrieve the fragment component of the URI.
withPath($path)
Return an instance with the specified path.
getPath()
Retrieve the path component of the URI.
$base
Definition: index.php:4
$target
Definition: test.php:19
$results
Definition: svg-scanner.php:47