acf_request_arg()


WordPressのacf_request_arg()関数は、リクエストされたURLパラメータを取得するために使用されます。この関数は、指定されたキーに対応する値を返します。

構文

acf_request_arg( string $key, mixed $default = false );

引数の説明:

  • $key(string) — 取得したいURLパラメータのキー。
  • $default(mixed) — 指定されたキーが存在しない場合に返されるデフォルト値。

例1: 基本的な使用法

URLパラメータidの値を取得します。

<?php $id = acf_request_arg( 'id' ); ?>

例2: デフォルト値の設定

URLパラメータpageが存在しない場合、デフォルト値として1を返します。

<?php $page = acf_request_arg( 'page', 1 ); ?>

例3: 条件付きで値を取得

URLパラメータcategoryが存在する場合にのみ、その値を取得します。

<?php if ( acf_request_arg( 'category' ) ) { $category = acf_request_arg( 'category' ); } ?>

例4: 複数のパラメータを取得

複数のURLパラメータを取得し、変数に代入します。

<?php $id = acf_request_arg( 'id' ); $page = acf_request_arg( 'page', 1 ); ?>

例5: パラメータの存在確認

URLパラメータsearchが存在するかどうかを確認します。

<?php if ( acf_request_arg( 'search' ) !== false ) { echo '検索パラメータが存在します。'; } ?>

注意点

  • この関数は、GETリクエストのパラメータを取得するために使用されますが、POSTリクエストのパラメータには対応していません。
  • URLパラメータが存在しない場合、デフォルト値を設定しておくことを推奨します。