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上有关于该函数的介绍。


相关条目[ ]

取自“https://www.zzbaike.com/wiki/WordPress常用函数add_query_arg?oldid=52060”