<?php namespace Laravel;

class URI {

	/**
	 * The URI for the current request.
	 * 当前请求的URI。
	 * @var string
	 */
	public static $uri;

	/**
	 * The URI segments for the current request.
	 * 当前请求的 URI 段。
	 * @var array
	 */
	public static $segments = array();

	/**
	 * The server variables to check for the URI.
	 * The server variables to check for the URI.
	 * @var array
	 */
	protected static $attempt = array(
		'PATH_INFO', 'REQUEST_URI',
		'PHP_SELF', 'REDIRECT_URL'
	);

	/**
	 * Get the full URI including the query string.
	 * 获取包含查询字符串的完整 URI。
	 * @return string
	 */
	public static function full()
	{
		return static::current().static::query();
	}

	/**
	 * Get the URI for the current request.
	 * 获取当前请求的 URI。
	 * @return string
	 */
	public static function current()
	{
		if ( ! is_null(static::$uri)) return static::$uri;

		// To get the URI, we'll first call the detect method which will spin
		// through each of the server variables that we check for the URI in
		// and use the first one we encounter for the URI.
        // 要获取 URI，我们将首先调用检测方法，该方法将遍历我们检查 URI 的每个服务器变量，并使用我们遇到的第一个作为 URI。
		static::$uri = static::detect();

		// If you ever encounter this error, please inform the nerdy Laravel
		// dev team with information about your server. We want to support
		// Laravel an as many servers as we possibly can!
        // 如果您遇到此错误，请告知 Laravel 开发团队有关您的服务器的信息。 我们希望支持 Laravel 尽可能多的服务器！
		if (is_null(static::$uri))
		{
			throw new \Exception("Could not detect request URI.");
		}

		static::segments(static::$uri);

		return static::$uri;
	}

	/**
	 * Detect the URI from the server variables.
	 * 从服务器变量中检测 URI。
	 * @return string|null
	 */
	protected static function detect()
	{
		foreach (static::$attempt as $variable)
		{
			// Each variable we search for the URI has its own parser function
			// which is responsible for doing any formatting before the value
			// is fed into the main formatting function.
            // 我们搜索 URI 的每个变量都有自己的解析器函数，该函数负责在将值输入主格式化函数之前进行任何格式化。
			$method = "parse_{$variable}";

			if (isset($_SERVER[$variable]))
			{
				$uri = static::$method($_SERVER[$variable]);

				return static::format($uri);
			}
		}		
	}

	/**
	 * Format a given URI.
	 * 格式化给定的 URI。
	 * @param  string  $uri
	 * @return string
	 */
	protected static function format($uri)
	{
		// First we want to remove the application's base URL from the URI if it is
		// in the string. It is possible for some of the parsed server variables to
		// include the entire document root in the string.
        // 首先，我们要从 URI 中删除应用程序的基本 URL（如果它在字符串中）。 一些解析的服务器变量可能在字符串中包含整个文档根。
		$uri = static::remove_base($uri);

		$index = '/'.Config::get('application.index');

		// Next we'll remove the index file from the URI if it is there and then
		// finally trim down the URI. If the URI is left with spaces, we'll use
		// a single slash for the root URI.
        // 接下来，我们将从 URI 中删除索引文件（如果它在那里），然后最后修剪 URI。
        // 如果 URI 留有空格，我们将对根 URI 使用一个斜杠
		if ($index !== '/')
		{
			$uri = static::remove($uri, $index);
		}

		return trim($uri, '/') ?: '/';
	}

	/**
	 * Determine if the current URI matches a given pattern.
	 * 确定当前 URI 是否与给定模式匹配。
	 * @param  string  $pattern
	 * @return bool
	 */
	public static function is($pattern)
	{
		// Asterisks are translated into zero-or-more regular expression wildcards
		// to make it convenient to check if the URI starts with a given pattern
		// such as "library/*". This is only done when not root.
        // 星号被翻译成零个或多个正则表达式通配符，以便于检查 URI 是否以给定的模式（例如“library/*”）开头。 这仅在非 root 时完成。
		if ($pattern !== '/')
		{
			$pattern = str_replace('*', '(.*)', $pattern).'\z';
		}
		else
		{
			$pattern = '^/$';
		}

		return preg_match('#'.$pattern.'#', static::current());
	}

	/**
	 * Parse the PATH_INFO server variable.
	 * 解析 PATH_INFO 服务器变量。
	 * @param  string  $value
	 * @return string
	 */
	protected static function parse_path_info($value)
	{
		return $value;
	}

	/**
	 * Parse the REQUEST_URI server variable.
	 * 解析 REQUEST_URI 服务器变量。
	 * @param  string  $value
	 * @return string
	 */
	protected static function parse_request_uri($value)
	{
		return parse_url($value, PHP_URL_PATH);
	}

	/**
	 * Parse the PHP_SELF server variable.
	 * 解析 PHP_SELF 服务器变量。
	 * @param  string  $value
	 * @return string
	 */
	protected static function parse_php_self($value)
	{
		return $value;
	}

	/**
	 * Parse the REDIRECT_URL server variable.
	 * 解析 REDIRECT_URL 服务器变量。
	 * @param  string  $value
	 * @return string
	 */
	protected static function parse_redirect_url($value)
	{
		return $value;
	}

	/**
	 * Remove the base URL off of the request URI.
	 * 从请求 URI 中删除基本 URL。
	 * @param  string  $uri
	 * @return string
	 */
	protected static function remove_base($uri)
	{
		return static::remove($uri, parse_url(URL::base(), PHP_URL_PATH));
	}

	/**
	 * Get a specific segment of the request URI via an one-based index.
	 * 通过基于的索引获取请求 URI 的特定段。
	 * <code>
	 *		// Get the first segment of the request URI
	 *		$segment = URI::segment(1);
	 *
	 *		// Get the second segment of the URI, or return a default value
	 *		$segment = URI::segment(2, 'Taylor');
	 * </code>
	 *
	 * @param  int     $index
	 * @param  mixed   $default
	 * @return string
	 */
	public static function segment($index, $default = null)
	{
		static::current();

		return array_get(static::$segments, $index - 1, $default);
	}

	/**
	 * Set the URI segments for the request.
	 * 设置请求的 URI 段。
	 * @param  string  $uri
	 * @return void
	 */
	protected static function segments($uri)
	{
		$segments = explode('/', trim($uri, '/'));
        // array_diff-计算数组的差集
		static::$segments = array_diff($segments, array(''));
	}

	/**
	 * Remove a given value from the URI.
	 * 从 URI 中删除给定值。
	 * @param  string  $uri
	 * @param  string  $value
	 * @return string
	 */
	protected static function remove($uri, $value)
	{
		return (strpos($uri, $value) === 0) ? substr($uri, strlen($value)) : $uri;
	}

	/**
	 * Get the query string for the current request.
	 * 获取当前请求的查询字符串。
	 * @return string
	 */
	protected static function query()
	{
	    // http_build_query-生成 URL-encode 之后的请求字符串
		return (count((array) $_GET) > 0) ? '?'.http_build_query($_GET) : '';
	}

}

github地址： https://github.com/liu-shilong/laravel3-scr