build_query()


WordPress関数build_query()は、URLクエリ文字列を生成するために使用されます。この関数は配列を受け取り、それをクエリ形式に変換します。

構文

build_query( array $data );
  • $data (array) — クエリ文字列を生成するためのデータ配列。

例1: 基本的なクエリ文字列の生成

次のコードは、基本的なクエリ文字列を生成します。

<?php echo build_query( array( 'post_type' => 'page', 'status' => 'publish' ) ); ?>

例2: ユーザー定義のパラメータを使用したクエリ文字列

配列にカスタムパラメータを追加してクエリ文字列を作成します。

<?php echo build_query( array( 'user' => get_current_user_id(), 'role' => 'editor' ) ); ?>

例3: ページネーションのクエリ文字列

ページネーション用のパラメータを含むクエリ文字列を生成します。

<?php echo build_query( array( 'paged' => get_query_var( 'paged' ), 'posts_per_page' => 10 ) ); ?>

例4: 日付フィルタを追加したクエリ文字列

日付条件を設定してクエリ文字列を作成します。

<?php echo build_query( array( 'year' => date( 'Y' ), 'monthnum' => date( 'n' ) ) ); ?>

例5: 配列のネストを含むクエリ文字列

配列内のネストされた値をエンコードしたクエリ文字列を生成します。

<?php echo build_query( array( 'filter' => array( 'category' => 'news', 'tag' => 'featured' ) ) ); ?>

注意事項:

  • 関数はエスケープ処理を自動的に行わないため、生成されたクエリ文字列を使用する際は適切なサニタイズを行う必要があります。

関連機能：