首页 > 代码库 > ThinkPHP函数详解:U方法

ThinkPHP函数详解:U方法

U方法用于完成对URL地址的组装,特点在于可以自动根据当前的URL模式和设置生成对应的URL地址,格式为:
U(‘地址‘,‘参数‘,‘伪静态‘,‘是否跳转‘,‘显示域名‘);
在模板中使用U方法而不是固定写死URL地址的好处在于,一旦你的环境变化或者参数设置改变,你不需要更改模板中的任何代码。
在模板中的调用格式需要采用 {:U(‘地址‘, ‘参数‘…)} 的方式

基本用法

U方法的用法示例:

  1. U(‘User/add‘) // 生成User模块的add操作地址
复制代码

也可以支持分组调用:

  1. U(‘Home/User/add‘) // 生成Home分组的User模块的add操作地址
复制代码

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

  1. U(‘add‘) // 生成当前访问模块的add操作地址
复制代码

除了分组、模块和操作名之外,我们也可以传入一些参数:

  1. U(‘Blog/read?id=1‘) // 生成Blog模块的read操作 并且id为1的URL地址
复制代码

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

  1. U(‘Blog/cate‘,array(‘cate_id‘=>1,‘status‘=>1))
  2. U(‘Blog/cate‘,‘cate_id=1&status=1‘)
  3. U(‘Blog/cate?cate_id=1&status=1‘)
复制代码

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

  1. U(‘Blog/cate/cate_id/1/status/1‘)
复制代码

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

  1. U(‘Blog/read?id=1‘)
复制代码

这个定义为例。
如果当前URL设置为普通模式的话,最后生成的URL地址是:

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

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

  1. http://serverName/index.php/Blog/read/id/1
复制代码

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

  1. http://serverName/Blog/read/id/1
复制代码

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

  1. ‘URL_PATHINFO_DEPR‘=>‘_‘
复制代码

就会生成

  1. http://serverName/Blog_read_id_1
复制代码

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

  1. http://serverName/Blog/read/id/1.html
复制代码

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

  1. U(‘Blog/read‘,‘id=1‘,‘xml‘)
复制代码

就会生成

  1. http://serverName/Blog/read/id/1.xml
复制代码

路由支持

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

  1. ‘news/:id\d‘=>‘News/read‘
复制代码

那么可以使用

  1. U(‘/news/1‘)
复制代码

最终生成的URL地址是:

  1. http://serverName/index.php/news/1
复制代码

域名支持

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

  1. U(‘Blog/read@blog.thinkphp.cn‘,‘id=1‘);
复制代码

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

此外,U方法的第5个参数如果设置为true,表示自动识别当前的域名,并且会自动根据子域名部署设置APP_SUB_DOMAIN_DEPLOY和APP_SUB_DOMAIN_RULES自动匹配生成当前地址的子域名。
如果开启了URL_CASE_INSENSITIVE,则会统一生成小写的URL地址。

锚点支持

3.1.2版本开始,U方法还可以支持生成URL地址中的锚点,例如:

  1. U(‘Blog/read#comment‘,‘id=1‘,‘html‘)
复制代码

就会生成

  1. http://serverName/Blog/read/id/1.html#comment
复制代码

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

    1. U(‘Blog/read#comment@blog‘,‘id=1‘);

ThinkPHP函数详解:U方法