get_row()


WordPressの関数get_row()は、特定の行をデータベースから取得するために使用されます。

構文

get_row( string $query, string $output = OBJECT, string $filter = 'raw' );

引数の説明:

  • $query (string) — 取得したい行を特定するためのSQLクエリ
  • $output (string) — 結果を返す形式。オプション値は「ARRAY」、「OBJECT」または「ARRAY_A」
  • $filter (string) — データのフィルタリング方法(デフォルトは「raw」)

例1: 単一の行を取得

次のコードは、データベースから特定の行を取得し、その内容を表示します。

<?php $row = get_row( "SELECT * FROM wp_posts WHERE ID = 1" ); echo $row->post_title; ?>

例2: 配列形式でデータを取得

結果を配列形式で取得するには、$output引数を「ARRAY」に設定します。

<?php $row = get_row( "SELECT * FROM wp_posts WHERE post_status = 'publish'", "ARRAY" ); echo $row['post_title']; ?>

例3: 結果をフィルタリング

次のコードでは、取得したデータをフィルタリングして表示します。

<?php $row = get_row( "SELECT * FROM wp_posts WHERE post_status = 'publish'", "OBJECT", "raw" ); echo $row->post_title; ?>

例4: カスタムクエリでの利用

カスタムSQLクエリを使って、特定の条件に一致する行を取得します。

<?php $row = get_row( "SELECT * FROM wp_posts WHERE post_author = 1", "ARRAY_A" ); print_r( $row ); ?>

例5: 複数の行を取得

複数行を取得するには、get_rows()の使用を考慮しますが、単一の行を取得する場合の例として以下のコードを使用します。

<?php $row = get_row( "SELECT * FROM wp_posts LIMIT 1", "ARRAY" ); echo $row[0]; ?>

警告

データベースクエリを使用する場合は、SQLインジェクションのリスクを避けるため、プレースホルダーを使用して引数を安全に処理するようにしてください。


関連機能: