自分が見やすいようにWordPress Codexから抜粋
#codeprettify{{ $wpdb->query('query') }}
引数 | 説明 |
query | 実行したいSQL |
戻り値
成功すると、選択された行数、または影響を受けた行数。
失敗すると、false
#codeprettify{{ $wpdb->get_var('query',column_offset,row_offset) }}
引数 | 説明 |
query | 実行したいSQL |
column_offset | 必要としている列のオフセット (一つ目は 0)。初期値は 0。 |
row_offset | 必要としている行のオフセット (一つ目は 0)。初期値は 0。 |
#codeprettify{{ $wpdb->get_row('query', output_type, row_offset) }}
引数 | 説明 |
query | 実行したいSQL |
output_type | OBJECT - 結果をオブジェクトとして出力。初期値 |
ARRAY_A - 結果を連想配列として出力。 | |
ARRAY_N - 結果をインデックス配列として出力。 | |
row_offset | 必要としている行のオフセット (一つ目は 0)。初期値は 0。 |
#codeprettify{{ $wpdb->get_col('query',column_offset) }}
引数 | 説明 |
query | 実行したいSQL |
column_offset | 必要としている列のオフセット (一つ目は 0)。初期値は 0。 |
#codeprettify{{ $wpdb->get_results('query', output_type) }}
引数 | 説明 |
query | 実行したいSQL |
output_type | OBJECT - 結果をオブジェクトとして出力。 |
ARRAY_A - 結果を連想配列として出力。 | |
ARRAY_N - 結果をインデックス配列として出力。 |
#codeprettify{{ $wpdb->insert( 'table', array( 'column1' => 'value1', 'column2' => 123 ), array( '%s', '%d' ) ) }}
引数 | 説明 |
table | |
array(...) |
#codeprettify{{ $wpdb->update( 'table', array( 'column1' => 'value1', 'column2' => 'value2' ), array( 'ID' => 1 ), array( '%s', '%d' ), array( '%d' ) ) }}
引数 | 説明 |
table | |
array(...) |
#codeprettify{{ $wpdb->prepare( 'query'[, value_parameter, value_parameter ... ] ) }}
引数 | 説明 |
query | 実行したいSQL |
value_parameter | プレースホルダーに代入する値。すでに SQL エスケープされている値は使えない。 |
#codeprettify{{ $wpdb->show_errors() $wpdb->hide_errors() $wpdb->print_error() }}
#codeprettify{{ $wpdb->get_col_info('type', offset) }}
引数 | 説明 |
type | name - カラム名 (初期値)。 |
table - 列が含まれるテーブル名。 | |
max_length - 列の最長値。 | |
not_null - 列が NULL の値をとれない場合は1。 | |
primary_key - 列がプライマリーキーの場合は1。 | |
unique_key - 列がユニークキーの場合は1。 | |
multiple_key - 列がユニークキーでない場合は1。 | |
numeric - 列が numeric の場合は1。 | |
blob - 列が BLOB の場合は1。 | |
type - 列の type。 | |
unsigned - 列が unsigned の場合は1。 | |
zerofill - 列が zero-filled の場合は1。 | |
offset | 情報を取得するカラムを指定する (0 が最初のカラム)。初期値は -1。 |
#codeprettify{{ $wpdb->flush() }}
$show_errors | エラーの echo が有効化されているかどうか。デフォルトは TRUE 。 |
$num_queries | 実行されたクエリの数。 |
$last_query | 最後に実行されたクエリ。 |
$queries | SAVEQUERIES 定数を TRUE に設定することで (定数の初期値は FALSE)、データベースで実行するクエリおよに停止時間を保存できる。SAVEQUERIES が TRUE の場合、クエリはこの変数に配列として保存される。 |
$last_result | 最後に実行されたクエリの結果。 |
$col_info | 最後に実行されたクエリの列情報。列情報の取得セクションを参照。 |
$insert_id | 最後に実行された INSERT クエリで、AUTO_INCREMENT によって生成された ID。 |
$num_rows | 最後に実行されたクエリで返された行の数。 |
wpdb を使って簡単に WordPress データベーステーブルを参照できます。
$posts | posts (投稿・固定ページ) テーブル。 |
$users | The table of users (ユーザー) テーブル。 |
$comments | The comments (コメント) テーブル。 |
$links | The table of links (リンク情報) テーブル。 |
$options | The options (設定情報) テーブル。 |
$postmeta | The postmeta (= メタコンテンツ、カスタムフィールド) テーブル。 |
$usermeta | The usermeta (ユーザーメタ情報) テーブル。ニックネーム、説明、パーミッションなどユーザーに関する追加情報を含む。 |
$terms | terms (キーワード情報) テーブル。カテゴリーの説明、リンクカテゴリー、タグなどの情報を含む。 |
$term_taxonomy | The term_taxonomy テーブル。キーワード (terms) のクラスであるタクソノミーの情報を含む。タクソノミーとは、投稿カテゴリー、リンクカテゴリー、タグ、その他のカスタムタクソノミーを指す。 |
$term_relationships | The term_relationships テーブル。キーワード (terms) と、そのキーワードを使っているオブジェクトの関係性を示す情報を含む。投稿カテゴリーがどの投稿に適用されているか、など。 |