常用函数-add_query_arg()

0条评论

说明

检索修改后的URL查询字符串。

用户可利用该函数重建URL并为URL查询语句添加新的查询变量。还可以用查询数据检索完整URL。

添加单键、单一值或一个关联数组。为空字符串设置键值可移除该键。用$_SERVER['REQUEST_URI']的值来忽略 'oldquery_or_uri' 。

该函数帮助性较强。利用该函数,在添加额外的GET变量时,用户不必担心是否需要将?符号或&符号加入到URL中。

用法

<?php add_query_arg() ?>

参数

如果没有参数,该函数会在处理后返回$_SERVER['REQUEST_URI']。

<?php add_query_arg (newkey, newvalue, oldquery_or_uri) ?> 

为当前页面的URI添加一个新的单键和单一值。

<?php add_query_arg (associative_array, oldquery_or_uri) ?> 

将所有键和值都附加到URI上。

返回的值

(字符串)

新的URL查询字符串

示例

假设现在在某个WordPress网站 "http://blog.example.com/?p=3"...上

 <?php
//  This would output 'http://blog.example.com/?p=3'
echo $_SERVER['REQUEST_URI'].'<br />';

//  This would output the same, but in a much more resource intensive way
echo add_query_arg ().'<br />';

//  This would output 'http://blog.example.com/?p=3&foo=bar'
echo add_query_arg ('foo', 'bar').'<br />';

//  This would output 'http://blog.example.com/?p=3&foo=bar&baz=tiny'
$arr_params = array ('foo' => 'bar',
                     'baz' => 'tiny');
echo add_query_arg ($arr_params)."<br />\";

?>

正如以上代码显示的,用户往往会 发现自己生成了一些不在当前页面上的URL。 这时可以使用自己需要的URL来作为最后一个参数:

 <?php
//  This would output 'http://blog.example.com/2009/04/16/?hello=world'
echo add_query_arg ('hello', 'world', 'http://blog.example.com/2009/04/16/');

?>

get_permalink ()函数返回完整的URL,因此用户需要为某个日志页面添加变量时,就可以使用 get_permalink ()函数。

 <?php
//  This would output whatever the URL to post ID 9 is, with 'hello=there' appended with either ? or &, depending on what's needed
echo add_query_arg ('hello', 'there', get_permalink (9));

?>

注释

该函数可与 wp_redirect ().合作。

修改记录

自1.5.0版本后

源文件

add_query_arg()位于 wp-includesfunctions.php中。 PHPXRef上有关于该函数的介绍。

相关资源