WordPress中PHP函数外包异常：数据库表创建函数移至外部文件失效

核心问题根源 #

你把代码移到install-plugin.php后，激活钩子失效的关键原因是register_activation_hook(__FILE__, 'install_tables')中的__FILE__变量。

在PHP中，__FILE__代表当前执行代码的文件路径。当这段代码在install-plugin.php里时，__FILE__指向的是这个子文件，而WordPress的激活钩子是基于插件主文件（你的main.php）的路径来绑定和触发的。插件激活时，WordPress只会扫描主文件里的激活钩子注册，子文件里用__FILE__绑定的钩子不会被识别，自然不会执行表创建逻辑。

修复方案 #

方案一：修改激活钩子的路径参数 #

在install-plugin.php里，把激活钩子的路径改成插件主文件的路径：

function install_tables()
{
  global $wpdb;
  $table_name = $wpdb->prefix . 'test';
  $charset_collate = $wpdb->get_charset_collate();
  // 修复SQL语句里的多余逗号
  $sql = "CREATE TABLE $table_name (
      id mediumint(9) NOT NULL AUTO_INCREMENT,
      test varchar(50) NOT NULL,
      UNIQUE KEY id (id)
    ) $charset_collate;";
  require_once(ABSPATH . 'wp-admin/includes/upgrade.php');
  dbDelta($sql);
}

// 指向插件主文件main.php的路径
$plugin_main_file = plugin_dir_path(__FILE__) . 'main.php';
register_activation_hook($plugin_main_file, 'install_tables');

方案二：在主文件中注册激活钩子 #

更规范的做法是把激活钩子的注册留在主文件，函数定义放在子文件：

1. 在main.php中引入子文件并注册钩子：

require_once plugin_dir_path(__FILE__) . 'install-plugin.php';
register_activation_hook(__FILE__, 'install_tables');

2. install-plugin.php中只保留函数定义：

function install_tables()
{
  global $wpdb;
  $table_name = $wpdb->prefix . 'test';
  $charset_collate = $wpdb->get_charset_collate();
  // 修复SQL语句里的多余逗号
  $sql = "CREATE TABLE $table_name (
      id mediumint(9) NOT NULL AUTO_INCREMENT,
      test varchar(50) NOT NULL,
      UNIQUE KEY id (id)
    ) $charset_collate;";
  require_once(ABSPATH . 'wp-admin/includes/upgrade.php');
  dbDelta($sql);
}

额外注意点 #

原SQL语句中UNIQUE KEY id (id),末尾多了一个逗号，虽然之前在主文件可能侥幸运行，但这属于SQL语法错误，会导致dbDelta执行失败，必须去掉这个逗号。

内容的提问来源于stack exchange，提问作者Ted Logan