当前浏览:首页 / WordPress函数 / remove_query_arg()

remove_query_arg( string|string[] $key, false|string $query = false ): string

从查询字符串中删除一个或多个项

arg

querymore...

removemore...


参数

$keystring|string[]必填
查询键或要删除的键。
$queryfalse|string可选
当为false时,使用当前URL。

默认:false


返回

string 新的URL查询字符串。



源码

查看源码 官方文档


更新日志

版本描述
1.5.0开始引入

使用示例

  • 示例1

    假设我们在WordPress URL “http://www.example.com/client/?details=value1&type=value2&date=value3〃…

    请注意在输出链接之前使用esc_url()

    // This would output '/client/?type=value2&date=value3'
    echo esc_url( remove_query_arg( 'details' ) );
    
    // This would output '/client/'
    $arr_params = array( 'details', 'type', 'date');
    echo esc_url( remove_query_arg( $arr_params ) );
  • 示例2

    当您想要操纵不属于脚本所在页面的URL时,请在第二个参数中添加目标URL,如下所示。这里不需要使用esc_url()(尽管鼓励使用),因为已知该值是安全的:

    // This would output 'http://www.example.com/2014/03/11/'
    echo esc_url( remove_query_arg( 'details',  'http://www.example.com/2014/03/11/?details=value1' ) );
    
    // This would output 'http://www.example.com/2014/03/11/?type=value2&date=value3'
    echo esc_url( remove_query_arg( 'details',  'http://www.example.com/2014/03/11/?details=value1&type=value2&date=value3' ) );
    
    // This would output 'http://www.example.com/2014/03/11/'
    $arr_params = array( 'details', 'type', 'date');
    echo esc_url( remove_query_arg( $arr_params, 'http://www.example.com/2014/03/11/?details=value1&type=value2&date=value3' ) );