yaffs.net Git - yaffs-website/blob - vendor/webmozart/path-util/src/Url.php

   1 <?php
   2
   3 /*
   4  * This file is part of the webmozart/path-util package.
   5  *
   6  * (c) Bernhard Schussek <bschussek@gmail.com>
   7  *
   8  * For the full copyright and license information, please view the LICENSE
   9  * file that was distributed with this source code.
  10  */
  11
  12 namespace Webmozart\PathUtil;
  13
  14 use InvalidArgumentException;
  15 use Webmozart\Assert\Assert;
  16
  17 /**
  18  * Contains utility methods for handling URL strings.
  19  *
  20  * The methods in this class are able to deal with URLs.
  21  *
  22  * @since  2.3
  23  *
  24  * @author Bernhard Schussek <bschussek@gmail.com>
  25  * @author Claudio Zizza <claudio@budgegeria.de>
  26  */
  27 final class Url
  28 {
  29     /**
  30      * Turns a URL into a relative path.
  31      *
  32      * The result is a canonical path. This class is using functionality of Path class.
  33      *
  34      * @see Path
  35      *
  36      * @param string $url     A URL to make relative.
  37      * @param string $baseUrl A base URL.
  38      *
  39      * @return string
  40      *
  41      * @throws InvalidArgumentException If the URL and base URL does
  42      *                                  not match.
  43      */
  44     public static function makeRelative($url, $baseUrl)
  45     {
  46         Assert::string($url, 'The URL must be a string. Got: %s');
  47         Assert::string($baseUrl, 'The base URL must be a string. Got: %s');
  48         Assert::contains($baseUrl, '://', '%s is not an absolute Url.');
  49
  50         list($baseHost, $basePath) = self::split($baseUrl);
  51
  52         if (false === strpos($url, '://')) {
  53             if (0 === strpos($url, '/')) {
  54                 $host = $baseHost;
  55             } else {
  56                 $host = '';
  57             }
  58             $path = $url;
  59         } else {
  60             list($host, $path) = self::split($url);
  61         }
  62
  63         if ('' !== $host && $host !== $baseHost) {
  64             throw new InvalidArgumentException(sprintf(
  65                 'The URL "%s" cannot be made relative to "%s" since their host names are different.',
  66                 $host,
  67                 $baseHost
  68             ));
  69         }
  70
  71         return Path::makeRelative($path, $basePath);
  72     }
  73
  74     /**
  75      * Splits a URL into its host and the path.
  76      *
  77      * ```php
  78      * list ($root, $path) = Path::split("http://example.com/webmozart")
  79      * // => array("http://example.com", "/webmozart")
  80      *
  81      * list ($root, $path) = Path::split("http://example.com")
  82      * // => array("http://example.com", "")
  83      * ```
  84      *
  85      * @param string $url The URL to split.
  86      *
  87      * @return string[] An array with the host and the path of the URL.
  88      *
  89      * @throws InvalidArgumentException If $url is not a URL.
  90      */
  91     private static function split($url)
  92     {
  93         $pos = strpos($url, '://');
  94         $scheme = substr($url, 0, $pos + 3);
  95         $url = substr($url, $pos + 3);
  96
  97         if (false !== ($pos = strpos($url, '/'))) {
  98             $host = substr($url, 0, $pos);
  99             $url = substr($url, $pos);
 100         } else {
 101             // No path, only host
 102             $host = $url;
 103             $url = '/';
 104         }
 105
 106         // At this point, we have $scheme, $host and $path
 107         $root = $scheme.$host;
 108
 109         return array($root, $url);
 110     }
 111 }