# ThinkPHP函数详解：U函数

[TOC]

U函数用于完成对URL地址的组装，特点在于可以自动根据当前的URL模式和设置生成对应的URL地址，格式为：

>[success] **[模块/控制器/操作#锚点@域名]?参数1=值1&参数2=值2...**

在模板中使用U函数而不是固定写死URL地址的好处在于，一旦你的环境变化或者参数设置改变，你不需要更改模板中的任何代码。

在模板中的调用格式需要采用 **{:U('地址', '参数'…)}** 的方式

## 基本用法

U方法的用法示例【当前默认为Home模块】：

~~~

U('User/add') // 生成Home模块User控制器的add操作地址 /Home/User/add.html

~~~

### 支持分模块调用

~~~

U('Admin/User/add') // 生成Admin模块的User控制器的add操作地址 /Admin/User/add.html

~~~

当然，也可以只是写操作名，表示调用当前模块的

~~~

U('add') // 生成当前访问控制器的add操作地址。如访问Article/index 则生成的地址为Article/add.html

~~~

### 传入一些参数

~~~

U('Blog/read?id=1') // 生成Blog模块的read操作 并且id为1的URL地址

~~~

U方法的第二个参数支持传入参数，支持数组和字符串两种定义方式，如果只是字符串方式的参数可以在第一个参数中定义，下面几种方式都是等效的：

~~~

U('Blog/cate',array('cate_id'=>1,'status'=>1))

U('Blog/cate','cate_id=1&status=1')

U('Blog/cate?cate_id=1&status=1')

~~~

但是不允许使用下面的定义方式来传参数：

~~~

U('Blog/cate/cate_id/1/status/1')

~~~

根据项目的不同URL设置，同样的U方法调用可以智能地对应产生不同的URL地址效果，例如针对：

~~~

U('Blog/read?id=1')

~~~

这个定义为例。

如果当前URL设置为普通模式的话，最后生成的URL地址是：

~~~

http://serverName/index.php?m=Blog&a=read&id=1

~~~

如果当前URL设置为PATHINFO模式的话，同样的方法最后生成的URL地址是：

~~~

http://serverName/index.php/Blog/read/id/1

~~~

如果当前URL设置为REWRITE模式的话，同样的方法最后生成的URL地址是：

~~~

http://serverName/Blog/read/id/1

~~~

如果你同时还设置了PATHINFO分隔符的话：

~~~

'URL_PATHINFO_DEPR'=>'-'

~~~

就会生成

~~~

http://serverName/Blog-read-id-1

~~~

如果当前URL设置为REWRITE模式，并且设置了伪静态后缀为html的话，同样的方法最后生成的URL地址是：

~~~

http://serverName/Blog/read/id/1.html

~~~

如果设置了多个伪静态支持，那么会自动取第一个伪静态后缀添加到URL地址后面，当然你也可以手动在U方法里面指定要生成的伪静态后缀，例如：

~~~

U('Blog/read','id=1','xml'); // 生成地址 http://serverName/Blog/read/id/1.xml

~~~

## 路由支持

U方法还可以支持路由，如果我们定义了一个路由规则为：

~~~

'news/:id\d'=>'News/read'

~~~

那么可以使用

~~~

U('/news/1'); //生成地址 http://serverName/index.php/news/1

~~~

## 域名支持

如果你的应用涉及到多个子域名的操作地址，那么也可以在U方法里面指定需要生成地址的域名，例如：

~~~

U('Blog/read@blog.thinkphp.cn','id=1'); // 生成地址 http://blog.thinkphp.cn/Home/Blog/read/id/1.html

~~~

@后面传入需要指定的域名即可。

此外，U方法的第5个参数如果设置为true，表示自动识别当前的域名，并且会自动根据子域名部署设置APP_SUB_DOMAIN_DEPLOY和APP_SUB_DOMAIN_RULES自动匹配生成当前地址的子域名。

如果开启了URL_CASE_INSENSITIVE，则会统一生成小写的URL地址。

锚点支持

U方法还可以支持生成URL地址中的锚点，例如：

~~~

U('Blog/read#comment','id=1','html'); // 生成地址 http://serverName/Blog/read/id/1.html#comment

~~~

如果域名和锚点同时使用的话，注意顺序为先锚点后域名，例如：

~~~

U('Blog/read#comment@blog.thinkphp.cn','id=1'); // 生成地址 http://blog.thinkphp.cn/Home/Blog/read/id/1.html#comment

~~~