# 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@','id=1'); // 生成地址 /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@','id=1'); // 生成地址 /Home/Blog/read/id/1.html#comment
~~~
