wordpressのDBにテーブル作成をする処理

Question

wordpressにてプラグイン製作をしています。
そのプラグインを有効化した際に新規でDBにテーブルを作る必要があるのですが、どこにどういう書き方をすれば望んだテーブルを作れるのかを知りたいです。
分かりやすく説明が載っているサイトやヒントになるサイトなどを教えていただくと助かります。
もちろん、直接回答にやり方を記載することも歓迎しますが、理解をしたいので説明をプラスして頂きたいです。

11/30追記
今回プラグイン名はtry(仮)とします。
階層は
plugins/try.php（メニューへの項目追加やショートコードを定義）
plugins/try-function.php（ショートコードの中身の機能部分を記載）
plugins/create_tbl.php（有効化した際に作成するテーブル情報を記載）
としています。
そこでtry.phpに

register_activation_hook( __FILE__, 'dev_install' );

と追記。
create_tbl.phpに

<?php
 function tbl_install() {
  global $wpdb;

  $table_name = $wpdb->prefix . "try";

  $charset_collate = $wpdb->get_charset_collate();

$sql = "CREATE TABLE $table_name (
  post_id bigint(20),
  image_id bigint(20),
  image_url varchar(200) NULL,
  PRIMARY KEY  (post_id,image_id)
) $charset_collate;";

require_once( ABSPATH . 'wp-admin/includes/upgrade.php' );
dbDelta( $sql );
}

と記載しましたが、テーブルの追加はされず、
「プラグインの有効化中に4861文字の予期しない出力が生成されました」
とメッセージが表示されました。
ショートコードを記載した場合の動きは正常なことは確認できています。
そもそも階層の作り方が間違っているのでしょうか？

Comments

[m.ts10806]

既存のテーブルとのリンクなどはするのでしょうか。外部キー貼ったり、同時に更新したり、影響範囲は？

[m.ts10806]

おそらく、単にテーブル作るだけではなく、作りたいプラグインの設計まで加味する必要がありそうに思います。
単にテーブル作るだけなら調べれば幾らでも出てくる範囲ですが、それだけで要件満たせるかどうか、この内容では不明です。

[thinkmad83989]

既存のテーブルが変動すると新規のテーブルの中身も変化する仕様ですが、現状は単にテーブルを作るだけとなっています。
もともと自分でfunctions.phpに書いていたロジックをプラグイン化しようとしています。
そのなかで直接phpmyadminからテーブルを追加していました。
そこで、手作業でテーブルを追加しなくていいようにしたいと思い今回の状況に至りました。
既存のテーブルとリンクさせる処理などは既に記載してあるため、あとはテーブルを作るのみとなっています。
知識不足なため回答を履き違えていたらすいません。

Answer 1

プラグイン有効化時の処理はregister_activation_hookで行い
プラグイン停止時の後片付けの処理をregister_deactivation_hookで登録しておくのがお作法

DBテーブルのALTER CREATE DROPなどの処理は$wpdbではできないようになってます

require_once( ABSPATH.'wp-admin/includes/upgrade.php');

してdbdeltaでやるというのが基本になります

テーブルを作る際にはテーブルの名前には$wpdb->prefixを先頭につけるようにして
同じデータベースを複数のWordPressが使っている場合に
テーブルの名前が被らないようにするというのもお作法です

リレーションの組み方とかモデルクラスの書き方とかに特にルールはないです
あえて言えばテーブルの構造を所定の命名規則に合わせて作れば
$wpdbにいくつかプロパティを設定するだけで
meta_queryの仕組みを流用することが割と簡単にできるようになってるぐらいでしょうか

Comments

[thinkmad83989]

回答ありがとうございます。
参考にして修正したのですが自分のやり方が間違っているのか、テーブルが追加されません。
質問自体を追記したので良ければ見ていただけると助かります。

[KazuhiroHatano]

「プラグインの有効化中に〜文字の予期しない出力が生成されました」
と出るならエラーメッセージが出力されているはずなので
エラーメッセージを確認しましょう

Answer 2

KazuhiroHatanoさんの回答を参考に処理を書き、plugins/try.phpにcreate_tbl.phpの内容を記載することでテーブルが追加されました。