PHPFUI/InstaDoc
 
Copied!

Resolves a URI reference in the context of a base URI and the opposite way.

Cloneable Final
Methods
public static relativize ( Psr\Http\Message\UriInterface $base , Psr\Http\Message\UriInterface $target )
 

Returns the target URI as a relative reference from the base URI.

This method is the counterpart to resolve():

(string) $target === (string) UriResolver::resolve($base, UriResolver::relativize($base, $target))

One use-case is to use the current request URI as base URI and then generate relative links in your documents
to reduce the document size or offer self-contained downloadable document archives.

$base = new Uri('http://example.com/a/b/');
echo UriResolver::relativize($base, new Uri('http://example.com/a/b/c')); // prints 'c'.
echo UriResolver::relativize($base, new Uri('http://example.com/a/x/y')); // prints '../x/y'.
echo UriResolver::relativize($base, new Uri('http://example.com/a/b/?q')); // prints '?q'.
echo UriResolver::relativize($base, new Uri('http://example.org/a/b/')); // prints '//example.org/a/b/'.

This method also accepts a target that is already relative and will try to relativize it further. Only a
relative-path reference will be returned as-is.

echo UriResolver::relativize($base, new Uri('/a/b/c')); // prints 'c' as well

  • return UriInterface The relative URI reference
public static removeDotSegments ( $path )
 

Removes dot segments from a path and returns the new path.

public static resolve ( Psr\Http\Message\UriInterface $base , Psr\Http\Message\UriInterface $rel )
 

Converts the relative URI into a new URI that is resolved against the base URI.
Methods
private __construct ()
private static getRelativePath ( Psr\Http\Message\UriInterface $base , Psr\Http\Message\UriInterface $target )
Methods
private static getRelativePath ( Psr\Http\Message\UriInterface $base , Psr\Http\Message\UriInterface $target )
public static relativize ( Psr\Http\Message\UriInterface $base , Psr\Http\Message\UriInterface $target )
 

Returns the target URI as a relative reference from the base URI.

This method is the counterpart to resolve():

(string) $target === (string) UriResolver::resolve($base, UriResolver::relativize($base, $target))

One use-case is to use the current request URI as base URI and then generate relative links in your documents
to reduce the document size or offer self-contained downloadable document archives.

$base = new Uri('http://example.com/a/b/');
echo UriResolver::relativize($base, new Uri('http://example.com/a/b/c')); // prints 'c'.
echo UriResolver::relativize($base, new Uri('http://example.com/a/x/y')); // prints '../x/y'.
echo UriResolver::relativize($base, new Uri('http://example.com/a/b/?q')); // prints '?q'.
echo UriResolver::relativize($base, new Uri('http://example.org/a/b/')); // prints '//example.org/a/b/'.

This method also accepts a target that is already relative and will try to relativize it further. Only a
relative-path reference will be returned as-is.

echo UriResolver::relativize($base, new Uri('/a/b/c')); // prints 'c' as well

  • return UriInterface The relative URI reference
public static removeDotSegments ( $path )
 

Removes dot segments from a path and returns the new path.

public static resolve ( Psr\Http\Message\UriInterface $base , Psr\Http\Message\UriInterface $rel )
 

Converts the relative URI into a new URI that is resolved against the base URI.
© 2021 Bruce Wells
Search Namespaces \ Classes
Configuration