lomatus 发表于 2007-12-24 15:47:44

URI 类 翻译

第一次翻译,请大家指正:
URI 类
URI类提供了帮助你分割URI字符串的函数集合。如果你使用URI路由功能,那么你就可以通过分段来重新分发地址栏信息。

注意: URI类会被系统自动初始化,不必手动启用该功能。

$this->uri->segment(n)
它允许你重新分割一个详细的URI分段。 n 为你想要得到的段数。分割数按照从左至右的顺序编排。 例如,如果你完整的URL的地址如下:

http://www.your-site.com/index.php/news/local/metro/crime_is_up

每个URI分段的数字编号为:

news
local
metro
crime_is_up
默认情况下URI没有分段那么该函数返回 FALSE(布尔值)。如果分段信息丢失,Segment函数还有第二个参数用来设置你的默认值。例如,这样设置后,当发生错误时,函数就会返回数字“0”。

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

如果没有该参数你的代码必须得像下面这样写:

if ($this->uri->segment(3) === FALSE)
{
    $product_id = 0;
}
else
{
    $product_id = $this->uri->segment(3);
}

$this->uri->rsegment(n)
这个函数和上面的函数基本功能一样,不同点在于它允许你在开启CodeIgniter的URI路由功能时进行详细分割并重新分发URI信息

$this->uri->slash_segment(n)
这个函数几乎和$this->uri->segment()一模一样,不过它可以通过第二个参数(" ","leading","both")给返回的URI参数加上“/”线,如果不使用该参数,就会在后面增加斜画线。例如:

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

返回:

segment/
/segment
/segment/
$this->uri->slash_rsegment(n)
这个函数功能同上面的函数,不同点在于它允许你在开启CodeIgniter的URI路由功能时进行详细分割并重新分发URI信息并可以增加斜线“/”。

$this->uri->uri_to_assoc(n)
你可以使用这个函数把每个分段信息以"标识字"=>"具体值"的形式存放在一个联合数组Array()里。注意这个URI:

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

使用这个函数你可以把URI以如下原型翻转到联合数组中:


(
    'name' => 'joe'
    'location' => 'UK'
    'gender' => 'male'
)

函数第一个参数可以设置偏移量,默认设置为3,因为一般情况下你的URI包含 控制器名 / 函数名 作为第一个和第二个分段。例如:

$array = $this->uri->uri_to_assoc(3);

echo $array['name'];
第二个参数可以用来设置"标识字",这样返回的数组总会包含索引里的标识字,甚至在丢失URI的情况下也是如此。例如:

$default = array('name', 'gender', 'location', 'type', 'sort');

$array = $this->uri->uri_to_assoc(3, $default);

如果URI不包含对应你所给标识字的具体值时,该索引的值会被设置为"FALSE"。

最后,如果相应的具体值找不到给定的标识字时(若URI段数为是一个单数时)具体值也会被设置为"FALSE"(布尔值)

$this->uri->ruri_to_assoc(n)
这个函数和上面的函数基本功能一样,不同点在于它允许你在开启CodeIgniter的URI路由功能时把URI信息分割并翻转到联合数组中去。

$this->uri->assoc_to_uri()
这个函数的功能和uri_to_assoc的功能找相反,它把数组里的信息翻转成URI地址,例如:

$array = array('product' => 'shoes', 'size' => 'large', 'color' => 'red');

$str = $this->uri->assoc_to_uri($array);

// 输出: product/shoes/size/large/color/red
$this->uri->uri_string()
返回一个包含完整URI信息的字符串。例如,假设以下为你的完整URL:

http://www.your-site.com/index.php/news/local/345

函数将返回如下字符串:

news/local/345

$this->uri->ruri_string(n)
这个函数和上面的函数基本功能一样,不同点在于它允许你在开启CodeIgniter的URI路由功能时把URI转换成对应的字符串。

$this->uri->total_segments()
返回总的URI的段数

$this->uri->total_rsegments(n)
这个函数和上面的函数基本功能一样,不同点在于它允许你在开启CodeIgniter的URI路由功能时返回URI的段数。

$this->uri->segment_array()
返回一个包含URI分段的数组。例如:

$segs = $this->uri->segment_array();

foreach ($segs as $segment)
{
    echo $segment;
    echo '<br />';
}

$this->uri->rsegment_array(n)
这个函数和上面的函数基本功能一样,不同点在于它允许你在开启CodeIgniter的URI路由功能时返回URI的数组。

lomatus 发表于 2007-12-24 15:51:35

比较关注开源框架,只是希望做点贡献
翻译有误的请大大指正,免得误人子弟

Hex 发表于 2007-12-24 18:36:14

非常感谢你作出的贡献!!
并希望你能把翻译发到 Wiki 中文手册中!
http://codeigniter.org.cn/user_guide/

sam 发表于 2007-12-26 10:41:47

顶。。。。。。。:D

lomatus 发表于 2007-12-26 15:36:20

已经转移到WIKI
我工作是Detailer 不是 Coder,所以翻译的肯定有不到位的地方,请大家指正
感激不尽!

Hex 发表于 2007-12-26 17:03:02

没关系,我们大家都会记住你作出的贡献的!
我们不会忘记你!
页: [1]
查看完整版本: URI 类 翻译