remove_query_arg() の使い方｜説明・引数・注意点

HTTP・REST・Ajax

remove_query_arg() は、URLから、指定したクエリパラメーターを取り除く関数です。

2026.10.03

説明

remove_query_arg() は、URLから、指定したクエリパラメーターを取り除く関数です。

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

パラメーターを除いたURL。

$url = remove_query_arg( 'tab', $url );

$query を省略すると、現在のURLが、基準になる。URLに含まれる、入力値が、そのまま出力され、XSSの原因になる。出力するときは、必ず esc_url() を通す。
パラメータを、追加したいのに、これを使っている。追加は、add_query_arg()。

NG例

echo '<a href="' . remove_query_arg( 'sort' ) . '">解除</a>'; // 現在のURLが基準で、エスケープもない

OK例

echo '<a href="' . esc_url( remove_query_arg( 'sort', get_permalink() ) ) . '">解除</a>';