URI 类

URI 类用于帮助你从 URI 字符串中获取信息，如果你使用 URI 路由，你也可以从路由后的 URI 中获取信息。

注解

该类由系统自己加载，无需手工加载。

类参考

  • _class _CI_URI
    • segment($n[, $no_result = NULL])

参数:

  1. - **$n** (_int_) -- Segment index number
  2. - **$no_result** (_mixed_) -- What to return if the searched segment is not found返回:

Segment value or $no_result value if not found返回类型:mixed

用于从 URI 中获取指定段。参数 n 为你希望获取的段序号，URI 的段从左到右进行编号。例如，如果你的完整 URL 是这样的:

  1. http://example.com/index.php/news/local/metro/crime_is_up

那么你的每个分段如下:

  1. #. news
  2. #. local
  3. #. metro
  4. #. crime_is_up

第二个参数为可选的，默认为 NULL ，它用于设置当所请求的段不存在时的返回值。例如，如下代码在失败时将返回数字 0

  1. $product_id = $this->uri->segment(3, 0);

它可以避免你写出类似于下面这样的代码:

  1. if ($this->uri->segment(3) === FALSE)
  2. {
  3.     $product_id = 0;
  4. }
  5. else
  6. {
  7.     $product_id = $this->uri->segment(3);
  8. }
  • rsegment($n[, $no_result = NULL])

参数:

  1. - **$n** (_int_) -- Segment index number
  2. - **$no_result** (_mixed_) -- What to return if the searched segment is not found返回:

Routed segment value or $no_result value if not found返回类型:mixed

当你使用 CodeIgniter 的 URI 路由 功能时，该方法和 segment() 类似，只是它用于从路由后的 URI 中获取指定段。

  • slashsegment($n[, $where = 'trailing'_])

参数:

  1. - **$n** (_int_) -- Segment index number
  2. - **$where** (_string_) -- Where to add the slash ('trailing' or 'leading')返回:

Segment value, prepended/suffixed with a forward slash, or a slash if not found返回类型:string

该方法和 segment() 类似，只是它会根据第二个参数在返回结果的前面或/和后面添加斜线。如果第二个参数未设置，斜线会添加到后面。例如:

  1. $this->uri->slash_segment(3);
  2. $this->uri->slash_segment(3, 'leading');
  3. $this->uri->slash_segment(3, 'both');

返回结果：

  1. - segment/
  2. - /segment
  3. - /segment/
  • slashrsegment($n[, $where = 'trailing'_])

参数:

  1. - **$n** (_int_) -- Segment index number
  2. - **$where** (_string_) -- Where to add the slash ('trailing' or 'leading')返回:

Routed segment value, prepended/suffixed with a forward slash, or a slash if not found返回类型:string

当你使用 CodeIgniter 的 URI 路由 功能时，该方法和 slash_segment() 类似，只是它用于从路由后的 URI 返回结果的前面或/和后面添加斜线。

  • urito_assoc([$n = 3[, $default = array()_]])

参数:

  1. - **$n** (_int_) -- Segment index number
  2. - **$default** (_array_) -- Default values返回:

Associative URI segments array返回类型:array

该方法用于将 URI 的段转换为一个包含键值对的关联数组。如下 URI:

  1. index.php/user/search/name/joe/location/UK/gender/male

使用这个方法你可以将 URI 转为如下的数组原型:

  1. [array]
  2. (
  3.     'name'      => 'joe'
  4.     'location'  => 'UK'
  5.     'gender'    => 'male'
  6. )

你可以通过第一个参数设置一个位移，默认值为 3 ，这是因为你的 URI 的前两段通常都是控制器和方法。例如:

  1. $array = $this->uri->uri_to_assoc(3);
  2. echo $array['name'];

第二个参数用于设置默认的键名，这样即使 URI 中缺少某个键名，也能保证返回的数组中包含该索引。例如:

  1. $default = array('name', 'gender', 'location', 'type', 'sort');
  2. $array = $this->uri->uri_to_assoc(3, $default);

如果某个你设置的默认键名在 URI 中不存在，数组中的该索引值将设置为 NULL 。

另外，如果 URI 中的某个键没有相应的值与之对应（例如 URI 的段数为奇数），数组中的该索引值也将设置为 NULL 。

  • rurito_assoc([$n = 3[, $default = array()_]])

参数:

  1. - **$n** (_int_) -- Segment index number
  2. - **$default** (_array_) -- Default values返回:

Associative routed URI segments array返回类型:array

当你使用 CodeIgniter 的 URI 路由 功能时，该方法和 uri_to_assoc() 类似，只是它用于将路由后的 URI 的段转换为一个包含键值对的关联数组。

  • assocto_uri($array_)

参数:

  1. - **$array** (_array_) -- Input array of key/value pairs返回:

URI string返回类型:string

根据输入的关联数组生成一个 URI 字符串，数组的键将包含在 URI 的字符串中。例如:

  1. $array = array('product' => 'shoes', 'size' => 'large', 'color' => 'red');
  2. $str = $this->uri->assoc_to_uri($array);
  3.  
  4. // Produces: product/shoes/size/large/color/red
  • uri_string()

返回:URI string返回类型:string

返回一个相对的 URI 字符串，例如，如果你的完整 URL 为:

  1. http://example.com/index.php/news/local/345

该方法返回:

  1. news/local/345
  • ruri_string()

返回:Routed URI string返回类型:string

当你使用 CodeIgniter 的 URI 路由 功能时，该方法和 uri_string() 类似，只是它用于返回路由后的 URI 。

  • total_segments()

返回:Count of URI segments返回类型:int

返回 URI 的总段数。

  • total_rsegments()

返回:Count of routed URI segments返回类型:int

当你使用 CodeIgniter 的 URI 路由 功能时，该方法和 total_segments() 类似，只是它用于返回路由后的 URI 的总段数。

  • segment_array()

返回:URI segments array返回类型:array

返回 URI 所有的段组成的数组。例如:

  1. $segs = $this->uri->segment_array();
  2.  
  3. foreach ($segs as $segment)
  4. {
  5.     echo $segment;
  6.     echo '<br />';
  7. }
  • rsegment_array()

返回:Routed URI segments array返回类型:array

当你使用 CodeIgniter 的 URI 路由 功能时，该方法和 segment_array() 类似，只是它用于返回路由后的 URI 的所有的段组成的数组。