WordPress常用函数add query arg
来自站长百科
导航: 上一页 | 首页 | WordPress中文论坛 | WordPress主机 | CMS程序 | 论坛程序 | ECShop | ShopNC | PowerEasy
说明[ ]
检索修改后的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'].'<nowiki><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').'
</nowiki>'; // 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上有关于该函数的介绍。