博客 » WordPress » 为插件添加数据表

为插件添加数据表

Denis 2008年08月14日

当你写插件的时候，你可能需要写东西到数据库中去，一般来说，有两种数据要存储，第一种是安装数据，一般存储在 options 表中，使用 WordPress 的 options 机制来实现。第二种是数据，可以存储到 postmeta 表或者 usermeta 表中。如果数据特别多，就需要自己创建数据库了。这篇文章就讲讲如何在写插件时候创建数据库。一般在写插件时候创建数据库有如下三个步骤：

  1. 创建一个添加新数据表的 PHP 函数。
  2. 保证插件启动的时候调用这个插件。
  3. 如果新版本有不同的数据表结构，创建一个升级函数。

今天我就结合我以前写的 Google PageRank for WordPress 讲解下这个过程，其中的第三步，由于没有数据库的升级，不涉及，如果你要了解这个东东，请参考 Codex 文档：Creating Tables with Plugins，这篇也是很多参考这里的。

创建一个添加新数据表的 PHP 函数

我们这个插件的安装函数叫做：google_pagerank_install。

1. 数据库表前缀

默认 WordPress 数据库标签前缀都是 wp_，但是有人如果在一个数据库安装两个及以上 WordPress，就需要在 wp-config.php 设置 WordPress 数据库表前缀来区别，所以我们向 WordPress 数据库添加新表的时候，要先找找到数据库表前缀。我们可以在变量 $wpdb->prefix 找到。代码如下：

function google_pagerank_install () {
    global $wpdb;
    $table_name = $wpdb->prefix . "googlepr";

2. 判断表是否存在

可以通过一条 SHOW TABLES SQL 查询来判断。

      if($wpdb->get_var("SHOW TABLES LIKE '$table_name'") != $table_name) {

3. 创建数据表

这步就是实际来创建一个数据表了。我们这个表有三个字段，post_id 日志的 ID，外键。pr 该日志 ID 对应页面的 PR，time 更新时间。由于 PR 更新不是每天都发生的。所以我们可以设置上次查询 PR 的时间，然后在一段时间间隔内都不去查询，直接在数据库中调用。

这里我不用直接的 SQL 查询来创建，而是使用在 wp-admin/upgrade-functions.php（我们需要导入该文件，默认是不会导入的）中的 dbDelta。dbDelta 函数会检查当前的表结构，和需要的表结构进行比较，所以无论添加或者修改表都会非常方便。关于具体怎样使用 dbDelta，详细可以看 wp-admin/upgrade-schema.php 中的例子。

        $sql = "CREATE TABLE " . $table_name . " (
        post_id bigint(20) NOT NULL,
        pr int(2) NOT NULL default '0',
        time datetime NOT NULL default '0000-00-00 00:00:00',
        UNIQUE KEY post_id  (post_id)
        );";
    
        require_once(ABSPATH . 'wp-admin/includes/upgrade.php');
 
        dbDelta($sql);

最后这个 google_pagerank_install 函数为：

function google_pagerank_install () {   
    global $wpdb;
 
    $table_name = $wpdb->prefix . "googlepr";
    if($wpdb->get_var("show tables like '$table_name'") != $table_name) {
        $sql = "CREATE TABLE " . $table_name . " (
        post_id bigint(20) NOT NULL,
        pr int(2) NOT NULL default '0',
        time datetime NOT NULL default '0000-00-00 00:00:00',
        UNIQUE KEY post_id  (post_id)
        );";
    
        require_once(ABSPATH . 'wp-admin/includes/upgrade.php');
 
        dbDelta($sql);
    }
}

保证插件启动的时候调用这个插件

我们使用 register_activation_hook 调用上面创建数据表的函数。

register_activation_hook( __FILE__,'google_pagerank_install');

参考：Creating Tables with Plugins

最后欢迎大家使用我的 Google PageRank for WordPress，它能够获取每篇日志的 PR 值。并在文章结尾显示。

标签：
作者：Denis
原文链接：为插件添加数据表
我爱水煮鱼版权所有，请勿转载本博客日志到任何博客或论坛。

24 条评论 添加你的评论 →

发表评论

你必须 登陆 之后才能留言。你可以使用以下方式快速登陆我爱水煮鱼：

你也可选择直接在本站 注册。


赞助商