ci框架源码阅读---------uri.php
config =& load_class('config', 'core'); log_message('debug', uri class initialized); } // -------------------------------- /** * get the uri string * * @access private * @return string */ function _fetch_uri_string() { // 下面的uri_protocol是在config.php里面的一个配置项， // 其实是问你用哪种方式去检测uri的信息的意思， // 默认是auto，自动检测，也就是通过各种方式检测，直至检测到，或者全部方式都检测完。。 if (strtoupper($this->config->item('uri_protocol')) == 'auto') { // is the request coming from the command line? // 开始尝试各种方式,主要有：命令行，request_uri, path_info, query_string. // 下面会多次出现$this->_set_uri_string($str)这个方法，这个方法没别的，就是把$str经过 // 过滤和修剪后值给$this->uri_string属性，在这里暂时可以理解为就是赋值。 // 如果脚本是在命令行模式下运行的话，那么参数就是通过$_server['argv']来传递。下面的 // $this->_parse_cli_args();就是拿到符合我们需要的路由相关的一些参数 // 如果你没用命令行执行脚本的话，下面这个if暂时可以不用管。 // 这时候我们发现uri类用函数php_sapi_name()来测试不同的环境 // 在apache环境下面输出的结果是“apache2handler”； // 在cgi模式下输出的结果是“cgi-fcgi” // 要是在命令行模式下面运行的话，那么输出的结果是：”cli” if (php_sapi_name() == 'cli' or defined('stdin')) { $this->_set_uri_string($this->_parse_cli_args()); return; } // let's try the request_uri first, this will work in most situations // 查找uri if ($uri = $this->_detect_uri()) { // 如果找到uri 设置$this->uri_string $this->_set_uri_string($uri); return; } // is there a path_info variable? // note: some servers seem 似乎 to have trouble 麻烦 with getenv() so we'll test it two ways // 获取path $_server['path_info'] 并不是每次请求都会有的所以当没有的时候使用getenv('path_info') $path = (isset($_server['path_info'])) ? $_server['path_info'] : @getenv('path_info'); if (trim($path, '/') != '' && $path != /.self) { $this->_set_uri_string($path); return; } // no path_info?... what about query_string? // 如果没有找到$_server['path_info'] 我们使用query_string $path = (isset($_server['query_string'])) ? $_server['query_string'] : @getenv('query_string'); if (trim($path, '/') != '') { $this->_set_uri_string($path); return; } // as a last ditch effort lets try using the $_get array // 如果path_info和query_string都没找到我们只能使用$_get if (is_array($_get) && count($_get) == 1 && trim(key($_get), '/') != '') { $this->_set_uri_string(key($_get)); return; } // we've exhausted all our options... // 经过以上的努力我们还没有找到uri那么我们就真的找不到了 $this->uri_string = ''; return; } // 这里重新写了一遍获取uri_protocol 其实我觉得完全可以只获取一次嘛。。。 $uri = strtoupper($this->config->item('uri_protocol')); // 下面就是根据不同的方式来选择不同的办法获取uri了 if ($uri == 'request_uri') { $this->_set_uri_string($this->_detect_uri()); return; } elseif ($uri == 'cli') { $this->_set_uri_string($this->_parse_cli_args()); return; } // 如果你定义的uri_protocol是在auto request_uri cli这三种方式之外的就执行下面这段了。 $path = (isset($_server[$uri])) ? $_server[$uri] : @getenv($uri); $this->_set_uri_string($path); } // -------------------------------- /** * set the uri string * * @access public * @param string * @return string */ function _set_uri_string($str) { // filter out control characters // 过滤字符串 remove_invisible_characters 函数式在common.php中 $str = remove_invisible_characters($str, false); // if the uri contains only a slash we'll kill it // 如果字符串只包含一个/则清空 $this->uri_string = ($str == '/') ? '' : $str; } // -------------------------------- /** * detects the uri * 查找uri * this function will detect the uri automatically and fix the query string * if necessary. 必需品 * 如果有必要的话，这个函数将自动查找uri并且固定查询字符串。 * * @access private * @return string */ private function _detect_uri() { // 如果两个值有一个没有则返回（两个变量是从web server那边来的,碰到一些特别的server程序, 这个是有可能为空的.） if ( ! isset($_server['request_uri']) or ! isset($_server['script_name'])) { return ''; } // 获取uri $uri = $_server['request_uri']; // 如果script_name 在$uri 中第一次出现的位置是0 if (strpos($uri, $_server['script_name']) === 0) { // 去掉uri 和 script_name 相同的部分 $uri = substr($uri, strlen($_server['script_name'])); } // 这里作用同上 只是将$_server['script_name']换成了 // dirname($_server['script_name']) elseif (strpos($uri, dirname($_server['script_name'])) === 0) { $uri = substr($uri, strlen(dirname($_server['script_name']))); } // this section ensures 保证 that even on servers that require the uri // to be in the query string (nginx) a correct 正确的 // uri is found, and also fixes 修理 the query_string server var and $_get array. // 这部分保证，uri可以被正确的找到即使是在nginx服务器上，并且还修复了的query_string服务器和$ _get数组。 // 判断$uri的前两个字符是不是?/ if (strncmp($uri, '?/', 2) === 0) { // 去掉前两个字符 $uri = substr($uri, 2); } // 用正册对字符串进行分割 $parts = preg_split('#\?#i', $uri, 2); $uri = $parts[0]; // 如果是能通过上述的正则分割出两段，那么，是通过query_string即？的形式进行路由访问 if (isset($parts[1])) { $_server['query_string'] = $parts[1]; // 函数把查询字符串解析到$_get变量中。 parse_str($_server['query_string'], $_get); } else { $_server['query_string'] = ''; $_get = array(); } // 如果为/，或者为空，有两种情况，要么就是通过query_string即？的形式进行路由访问， // 所以此时$parts[0]就是等于下面两种可能，同时我们 // 已经通过$parts[1]拿到要拿的信息，则可以返回。 // 要么就是以段的形式，但是段的信息为空，即直接访问入口文件而没有 // 任何路由信息的传递，也可以直接返回。 if ($uri == '/' || empty($uri)) { return '/'; } //返回这个url的path部分。 $uri = parse_url($uri, php_url_path); // do some final cleaning of the uri and return it // 将uri中的// ../替换成 / 返回 return str_replace(array('//', '../'), '/', trim($uri, '/')); } // -------------------------------- /** * parse cli arguments * 解析cli参数 * take each command line argument and assume it is a uri segment. * 如果你在命令行中这么操作 * php d:/wamp/www/codeigniter/index.php welcome index * _parse_cli_args() 返回一个 /welcome/index的字符串 * * @access private * @return string */ private function _parse_cli_args() { // 返回在命令行模式下运行时传递的参数。 // 因为第一个参数是当前文件名，所以从第二个开始才是我们要获取的。 $args = array_slice($_server['argv'], 1); //返回一个由'/'字符串拼接的字符串，因为$this->uri_string是一个字符串。 return $args ? '/' . implode('/', $args) : ''; } // -------------------------------- /** * filter segments 段 for malicious 恶意 characters * 过滤不合法字符 * @access private * @param string * @return string */ function _filter_uri($str) { if ($str != '' && $this->config->item('permitted_uri_chars') != '' && $this->config->item('enable_query_strings') == false) { // preg_quote() in php 5.3 escapes -, so the str_replace() and addition of - to preg_quote() is to maintain 维持 backwards 向后 // compatibility 兼容性 as many are unaware 不知道的 of how characters in the permitted_uri_chars will be parsed as a regex pattern // 大概意思是 由于php5.3.0 字符 - 被增加为需要转义的。 所以这里在使用str_replace()要添加preg_quote()来对-进行转义 if ( ! preg_match(|^[.str_replace(array('\\-', '\-'), '-', preg_quote($this->config->item('permitted_uri_chars'), '-')).]+$|i, $str)) { show_error('the uri you submitted has disallowed characters.', 400); } } // convert programatic characters to entities // 转换字符实体 $bad = array('$', '(', ')', '%28', '%29'); $good = array('$', '(', ')', '(', ')'); return str_replace($bad, $good, $str); } // -------------------------------- /** * remove the suffix from the url if needed * // 去掉url的我们自定义的后缀。 * @access private * @return void */ function _remove_url_suffix() { if ($this->config->item('url_suffix') != ) { $this->uri_string = preg_replace(|.preg_quote($this->config->item('url_suffix')).$|, , $this->uri_string); } } // -------------------------------- /** * explode the uri segments. the individual segments will * be stored in the $this->segments array. * 将uri拆分正段同时对每个段进行过滤，并存入$this->segments[]中 * @access private * @return void */ function _explode_segments() { foreach (explode(/, preg_replace(|/*(.+?)/*$|, \\1, $this->uri_string)) as $val) { // filter segments for security $val = trim($this->_filter_uri($val)); if ($val != '') { $this->segments[] = $val; } } } // -------------------------------- /** * re-index segments 重新索引段 * 使得出来的段以下标1开始保存。这样做可以更简单的使用使用因为段数组和真实的段有个1:1的关系 * this function re-indexes the $this->segment array so that it * starts at 1 rather than 0. doing so makes it simpler to * use functions like $this->uri->segment(n) since there is * a 1:1 relationship 关系 between the segment array and the actual 真实的 segments. * * @access private * @return void */ function _reindex_segments() { array_unshift($this->segments, null); array_unshift($this->rsegments, null); unset($this->segments[0]); unset($this->rsegments[0]); } // -------------------------------- /** * fetch a uri segment * 获取一个uri段 * this function returns the uri segment based on the number provided.提供 * 这个函数返回一个基于提供的数字uri段 * @access public * @param integer * @param bool * @return string */ function segment($n, $no_result = false) { return ( ! isset($this->segments[$n])) ? $no_result : $this->segments[$n]; } // -------------------------------- /** * fetch a uri routed segment * 返回确定路由后的某一段 * this function returns the re-routed uri segment (assuming 假设 routing rules 规则 are used) * based on the number provided. if there is no routing this function returns the * same result as $this->segment() * 这个函数返回一个已经路由的基于提供的数字的uri段（假设路由规则已经使用的） * 如果还没与路由这个函数将和$this->segment()是一样的 * * @access public * @param integer * @param bool * @return string */ function rsegment($n, $no_result = false) { return ( ! isset($this->rsegments[$n])) ? $no_result : $this->rsegments[$n]; } // -------------------------------- /** * generate 产生 a key value pair 一对 from the uri string * 根据uri字符串产生一个键值对的数组 * * this function generates and associative 关联的 array of uri data starting * at the supplied 由。。。提供 segment. for example, if this is your uri: * * example.com/user/search/name/joe/location/uk/gender/male * * you can use this function to generate an array with this prototype: * * array ( * name => joe * location => uk * gender => male * ) * 这个函数由uri段产生一个关联数组 * 例子：如果你的uri是这样的 * example.com/user/search/name/joe/location/uk/gender/male * 那么将产生一个这样的原型 * array ( * name => joe * location => uk * gender => male * ) * @access public * @param integer the starting segment number * @param array an array of default values * @return array */ function uri_to_assoc($n = 3, $default = array()) { return $this->_uri_to_assoc($n, $default, 'segment'); } /** * identical 完全相同的事物 to above only it uses the re-routed segment array * 跟上一个函数是完全相同的只是它冲洗路由了段数组 （注意看第三个参数） * @access public * @param integer the starting segment number * @param array an array of default values * @return array * */ function ruri_to_assoc($n = 3, $default = array()) { return $this->_uri_to_assoc($n, $default, 'rsegment'); } // -------------------------------- /** * generate a key value pair from the uri string or re-routed uri string * 根据uri字符串或者重新路由的uri字符串产生一个键值对数组 * @access private * @param integer the starting segment number 起始段号 * @param array an array of default values * @param string which array we should use * @return array */ function _uri_to_assoc($n = 3, $default = array(), $which = 'segment') { // 区分段数组是不是重新路由的。 if ($which == 'segment') { $total_segments = 'total_segments'; $segment_array = 'segment_array'; } else { $total_segments = 'total_rsegments'; $segment_array = 'rsegment_array'; } // $n 是不是一个数字 if ( ! is_numeric($n)) { return $default; } // 缓存uri段列表中是够存在$n这个key if (isset($this->keyval[$n])) { return $this->keyval[$n]; } // 总段数小于$n if ($this->$total_segments() $segment_array(), ($n - 1)); $i = 0; $lastval = ''; $retval = array(); foreach ($segments as $seg) { if ($i % 2) { $retval[$lastval] = $seg; } else { $retval[$seg] = false; $lastval = $seg; } $i++; } if (count($default) > 0) { foreach ($default as $val) { if ( ! array_key_exists($val, $retval)) { $retval[$val] = false; } } } // cache the array for reuse // 缓存数组一遍重用 $this->keyval[$n] = $retval; return $retval; } // -------------------------------- /** * generate a uri string from an associative 关联数组 array * 根据一个关联数组产生一个uri字符串 * * @access public * @param array an associative array of key/values * @return array */ function assoc_to_uri($array) { $temp = array(); foreach ((array)$array as $key => $val) { $temp[] = $key; $temp[] = $val; } return implode('/', $temp); } // -------------------------------- /** * fetch a uri segment and add a trailing 后面的，尾随 slash * 获取一个uri段并且添加一个/ * * @access public * @param integer * @param string * @return string */ function slash_segment($n, $where = 'trailing') { return $this->_slash_segment($n, $where, 'segment'); } // -------------------------------- /** * fetch a uri segment and add a trailing slash * 获取一个已经路由的uri段并且添加/ * @access public * @param integer * @param string * @return string */ function slash_rsegment($n, $where = 'trailing') { return $this->_slash_segment($n, $where, 'rsegment'); } // -------------------------------- /** * fetch a uri segment and add a trailing slash - helper function * * @access private * @param integer * @param string * @param string * @return string */ function _slash_segment($n, $where = 'trailing', $which = 'segment') { $leading = '/'; $trailing = '/'; if ($where == 'trailing') { $leading = ''; } elseif ($where == 'leading') { $trailing = ''; } return $leading.$this->$which($n).$trailing; } // -------------------------------- /** * segment array * 获取段数组 * @access public * @return array */ function segment_array() { return $this->segments; } // -------------------------------- /** * routed segment array * 获取已经路由的段数组 * @access public * @return array */ function rsegment_array() { return $this->rsegments; } // -------------------------------- /** * total number of segments * 获取段总数 * @access public * @return integer */ function total_segments() { return count($this->segments); } // -------------------------------- /** * total number of routed segments * 获取已经路由的段的总数 * @access public * @return integer */ function total_rsegments() { return count($this->rsegments); } // -------------------------------- /** * fetch the entire uri string * * @access public * @return string */ function uri_string() { return $this->uri_string; } // -------------------------------- /** * fetch the entire re-routed uri string * * @access public * @return string */ function ruri_string() { return '/'.implode('/', $this->rsegment_array()); }}// end uri class/* end of file uri.php *//* location: ./system/core/uri.php */