免费注册 查看新帖 |

Chinaunix

  平台 论坛 博客 文库
› 论坛 › 程序设计 › PHP › [pear 数据库]PEAR::MDB2模块调用机制
最近访问板块 发新帖
查看: 2795 | 回复: 3
打印 上一主题 下一主题

[pear 数据库]PEAR::MDB2模块调用机制 [复制链接]

夜猫子

论坛徽章:
1
荣誉版主 日期:2011-11-23 16:44:17
跳转到指定楼层
1楼 [收藏(0)] [报告]
发表于 2006-07-12 01:42 |只看该作者 |倒序浏览
从使用PEAR以来，使用得最多的是PEAR::DB，但是这么几年来，PEAR::DB一直没有什么新的变化。在最新的一个项目里，我开始尝试使用 PEAR::MDB2，这个包现在已经替代了PEAR::DB，而且提供了丰富的特性，从它的结构上来看，也提供了更多的扩展可能。
可能是作者忙于开发或者这个包太新，相关的文档没有跟上，所以只能自己阅读代码来搞清楚它提供的各种方法。
如何使用最基本的连接、查询等，在PEAR手册中（http://pear.php.net/manual/en/package.database.mdb2.php）已经提供了简单的说明，在此我只讨论MDB2如何调用各种模块的机制。
除了基本的sql查询功能外，MDB2还提供了几个扩展模块，比如Manager（操纵数据库对象），这个模块可以添加、删除数据库，添加、修改、删除表。要使用这个模块提供的方法有三种方式：
$mdb->loadModule('Manager');
$mdb->manager->createTable($name, $fields);   // PHP4
或者
$mdb->loadModule('Manager');
$mdb->create($name, $fields);                 // PHP5
或者
$mdb->mgCreateTable($name, $fields);          // PHP5
前两种方式必须事先用loadModule('Manager')载入模块，否则无法调用。
先来研究一下loadModule()

  2. function &loadModule($module, $property = null, $phptype_specific = null)
  3. {
  4.     if (!$property) {
  5.         $property = strtolower($module);
  6.     }

  8.     if (!isset($this->{$property})) {
  9.         $version = $phptype_specific;
  10.         if ($phptype_specific !== false) {
  11.             $version = true;
  12.             $class_name = 'MDB2_Driver_'.$module.'_'.$this->phptype;
  13.             $file_name = str_replace('_', DIRECTORY_SEPARATOR, $class_name).'.php';
  14.         }
  15.         if ($phptype_specific === false
  16.             || (!MDB2::classExists($class_name) && !MDB2::fileExists($file_name))
  17.         ) {
  18.             $version = false;
  19.             $class_name = 'MDB2_'.$module;
  20.             $file_name = str_replace('_', DIRECTORY_SEPARATOR, $class_name).'.php';
  21.         }

  23.         $err = MDB2::loadClass($class_name, $this->getOption('debug'));
  24.         if (PEAR::isError($err)) {
  25.             return $err;
  26.         }

  28.         // load modul in a specific version
  29.         if ($version) {
  30.             if (method_exists($class_name, 'getClassName')) {
  31.                 $class_name_new = call_user_func(array($class_name, 'getClassName'), $this->db_index);
  32.                 if ($class_name != $class_name_new) {
  33.                     $class_name = $class_name_new;
  34.                     $err = MDB2::loadClass($class_name, $this->getOption('debug'));
  35.                     if (PEAR::isError($err)) {
  36.                         return $err;
  37.                     }
  38.                 }
  39.             }
  40.         }

  42.         if (!class_exists($class_name)) {
  43.             $err =& $this->raiseError(MDB2_ERROR_LOADMODULE, null, null,
  44.                 "unable to load module '$module' into property '$property'");
  45.             return $err;
  46.         }
  47.         $this->{$property} =& new $class_name($this->db_index);
  48.         $this->modules[$module] =& $this->{$property};
  49.         if ($version) {
  50.             // this will be used in the connect method to determine if the module
  51.             // needs to be loaded with a different version if the server
  52.             // version changed in between connects
  53.             $this->loaded_version_modules[] = $property;
  54.         }
  55.     }

  57.     return $this->{$property};
  58. }
复制代码

前边一部分是根据模块的名字载入对应的文件，并且检查文件中是否包含了正确的类，稍微有点点搅，不过熟悉目录结构之后就可以看懂。（看不明白也无所谓，只要不自己写模块）

关键在于实例化的部分：
$this->{$property} =& new $class_name($this->db_index);
$this->modules[$module] =& $this->{$property};
在实例化了Manager模块包含的类之后，把这个实例作为当前MDB2实例的同名属性，另外再添加为modules属性数组的元素。

所以在PHP4下，可以用$mdb->manager->createTable($name, $fields);调用模块的方法。
调用的时候注意用模块名字的小写，因为$property = strtolower($module);

如果是PHP5的话，就可以使用另外两种更加方便的调用方式，原因是PHP5的新特性__call()方法。

  2. function __call($method, $params)
  3. {
  4.     $module = null;
  5.     if (preg_match('/^([a-z]+)([A-Z])(.*)$/', $method, $match)
  6.         && isset($this->options['modules'][$match[1]])
  7.     ) {
  8.         $module = $this->options['modules'][$match[1]];
  9.         $method = strtolower($match[2]).$match[3];
  10.         if (!isset($this->modules[$module]) || !is_object($this->modules[$module])) {
  11.             $result =& $this->loadModule($module);
  12.             if (PEAR::isError($result)) {
  13.                 return $result;
  14.             }
  15.         }
  16.     } else {
  17.         foreach ($this->modules as $key => $foo) {
  18.             if (is_object($this->modules[$key])
  19.                 && method_exists($this->modules[$key], $method)
  20.             ) {
  21.                 $module = $key;
  22.                 break;
  23.             }
  24.         }
  25.     }
  26.     if (!is_null($module)) {
  27.         return call_user_func_array(array(&$this->modules[$module], $method), $params);
  28.     }
  29.     trigger_error(sprintf('Call to undefined function: %s::%s().', get_class($this), $method), E_USER_ERROR);
  30. }
复制代码

当调用不存在的mgCreateTable()和createTable()方法时，__call()方法会被调用。

preg_match('/^([a-z]+)([A-Z])(.*)$/', $method, $match)
试图把调用的方法名拆分成为"mg C reateTable"(mgCreateTable)三段
所以使用这种方法要注意大小写，不然无法正确的拆分

isset($this->options['modules'][$match[1]])
第一段是模块名的缩写，把这个缩写拿到$mdb->options属性中去比较

默认的，options属性的内容是

  2. $mdb->options['modules'] = array(
  3.     'ex' => 'Extended',
  4.     'dt' => 'Datatype',
  5.     'mg' => 'Manager',
  6.     'rv' => 'Reverse',
  7.     'na' => 'Native',
  8.     'fc' => 'Function',
  9. );
复制代码

$module = $this->options['modules'][$match[1]];
当第一段的内容是mg时，对应的模块就是Manager了

$method = strtolower($match[2]).$match[3];
那么方法就是createTable了

if (!isset($this->modules[$module]) || !is_object($this->modules[$module]))
$result =& $this->loadModule($module);
在modules属性中查看是否已经有被调用模块的实例，modules属性是用来存放模块实例的数组，刚才在loadModule()部分已经有说明
如果没有对应的实例则loadModule()来创建实例，所以这种调用方式不用事先loadModule()

foreach ($this->modules as $key => $foo)
当三段法无效的时候，遍历当前所有的模块实例

if (is_object($this->modules[$key]) && method_exists($this->modules[$key], $method)
使用method_exists()函数寻找每个实例是否有被调用的方法

return call_user_func_array(array(&$this->modules[$module], $method), $params);
最后调用找到的模块实例的对应方法

从以上分析可以看出MDB2对它的扩展模块的调用方式，只要遵守这些约定，我们也可以自行扩展出自己的模块。
不过$mdb->createTable()这种调用方式有个问题，如果两个模块都具有相同的方法就可能出问题，写自己的模块需要注意这一点。

暂时先写到这里，以后再继续讨论几个内置模块的具体使用。

[ 本帖最后由 夜猫子 于 2006-7-12 02:00 编辑 ]
夜猫子

论坛徽章:
1
荣誉版主 日期:2011-11-23 16:44:17
2楼 [报告]
发表于 2006-07-12 01:44 |只看该作者

用PEAR::MDB2 Manager模块控制表

PEAR::MDB2除了提供PEAR::DB已有的sql处理功能之外，还提供了一个非常强大的扩展功能：添加/删除/修改数据库对象
可以控制的数据库对象有：

    * 库
    * 表
    * 索引（普通索引、主键、唯一索引）

调用Manager模块
$mdb->loadModule('Manager');
或者直接用魔法调用方式
$mdb->mgCreateTable();
$mdb->mgAlterTable();
模块调用机制参看《PEAR::MDB2模块调用机制》

创建数据库
$mdb->createDatabase($dbname);
建立数据库很简单，只要指定数据库名字就好，可惜的是，创建新数据库时不能指定更多的参数，比如postgresql建立数据库时还可以指定encoding、owner等等。

定义字段
MDB2把字段的数据类型抽象为：

    * text   字符类型
    * clob   大对象（文本）
    * blob   大对象（二进制）
    * integer    整数
    * boolean    布尔类型
    * date       日期类型（YY-MM-DD）
    * time       时间类型（HH:MM:SS）
    * timestamp  日期加时间（YYYY-MM-DD HH:MM:SS）
    * float      浮点数类型
    * decimal    任意精度数值类型

字段的参数有：

    * length    长度
    * type      数据类型
    * default   默认值
    * unsigned  无符号
    * notnull   不允许空值
    * fixed     字符类型是否用空格填充不足的长度

例如我想要，创建一个user_info表，包含三个字段：id（编号 整数）、user_name（用户名）、password（MD5密码），字段的描述就是

  2. $fields = array(
  3.     'id' => array(
  4.         'type'      => 'integer',
  5.         'notnull'   => 1
  6.     ),
  7.     'username' => array(
  8.         'type'      => 'text',
  9.         'length'    => 20,
  10.         'notnull'   => 1
  11.     ),
  12.     'password' => array(
  13.         'type'      => 'text',
  14.         'length'    => 32,
  15.         'notnull'   => 1
  16.     )
  17. );
复制代码

如果给text类型指定length，字段会使用varchar或者char，如果fixed为真则为char，fixed为假则为varchar，fixed默认为false
如果没有给text指定length，使用text类型
某些DBMS可以把默认值设置为函数，比如now()，但是在这里无法设置默认值为函数，如果指定函数默认值，默认值实际上设置成函数运行后的值

创建表
创建名字叫user_info的用户信息表
$mdb->createTable('user_info', $fields);

修改表
表的修改使用alterTable()方法，可以对表进行的操作有

    * name    重命名表名
    * add     添加字段
    * remove  删除字段
    * change  修改字段
    * rename  字段重命名

添加字段
给user_info表添加三个字段，realname（真实姓名）、reg_date（注册时间）、login_time（最后一次登录时间）

  2. $change = array(
  3.     'add' => array(
  4.         'realname'  => array(
  5.             'type'      => 'text',
  6.             'length'    => 20
  7.         ),
  8.         'reg_date'  => array(
  9.             'type'      => 'timestamp',
  10.             'notnull'   => 1
  11.         ),
  12.         'login_time' => array(
  13.             'type'      => 'timestamp'
  14.         )
  15.     )
  16. );
  17. $mdb->alterTable('user_info', $change);
复制代码

修改字段
把reg_date字段从timestamp类型改变为date类型，realname不允许为空

  2. $change = array(
  3.     'change' => array(
  4.         'reg_date' => array(
  5.             'type'  => 'timestamp',
  6.             'definition' => array(
  7.                 'type'  => 'date'
  8.             )
  9.         ),
  10.         'realname' => array(
  11.             'notnull' => 1
  12.         )
  13.     )
  14. );
  15. $mdb->alterTable('user_info', $change);
复制代码

删除字段
删除login_time字段

  2. $change = array(
  3.     'remove' => array(
  4.         'login_time' => array()
  5.     )
  6. );
  7. $mdb->alterTable('user_info', $change);
复制代码

字段重命名
重命名realname为real_name

  2. $change = array(
  3.     'rename' => array(
  4.         'realname' => array(
  5.             'name' => 'real_name'
  6.         )
  7.     )
  8. );
  9. $mdb->alterTable('user_info', $change);
复制代码

重命名表
把user_info表重命名为userinfo

  2. $change = array(
  3.     'name' => 'userinfo'
  4. );
  5. $mdb->alterTable('user_info', $change);
复制代码

创建索引
在id字段上创建主键

  2. $con_define = array(        // 主键定义
  3.     'fields' => array('id' => array()),
  4.     'primary' => 1
  5. );
  6. $con_name = 'pk_user_info_id';  // 主键名
  7. $mdb->createConstraint('user_info', $con_name, $con_define);
复制代码

在username字段上创建唯一索引

  2. $con_define = array(        // 唯一索引定义
  3.     'fields' => array('username' => array()),
  4.     'unique' => 1
  5. );
  6. $con_name = 'uk_user_info_username';    // 唯一索引名
  7. $mdb->createConstraint('user_info', $con_name, $con_define);
复制代码

删除刚才建立的约束
$mdb->dropConstraint('user_info', 'pk_user_info_id');
$mdb->dropConstraint('user_info', 'uk_user_info_username');

在username、password上建立双字段索引

  2. $idx_define = array(
  3.     'fields' => array(
  4.         'username' => array(),
  5.         'password' => array()
  6.     )
  7. );
  8. $idx_name = 'idx_user_info_auth';
  9. $mdb->createIndex('user_info', $idx_name, $idx_define);
复制代码

删除idx_user_info_auth索引
$mdb->dropIndex('user_info', 'idx_user_info_auth');

Manager模块对一些通常的操作进行了封装，可以满足大部分常见的需求，但是如果你需要是更加精细的控制，Manager就无法做到了，比如：
// PostgreSQL
CREATE INDEX code_idx ON films(code) TABLESPACE indexspace

最后建议有疑惑的时候看还是看看相关的代码，代码就是最好的文档

[ 本帖最后由 夜猫子 于 2006-7-12 01:49 编辑 ]
实战分享：从技术角度谈机器学习入门| 【大话IT】RadonDB低门槛向MySQL集群下战书 | ChinaUnix打赏功能已上线！ | 新一代分布式关系型数据库RadonDB知多少？
夜猫子

论坛徽章:
1
荣誉版主 日期:2011-11-23 16:44:17
3楼 [报告]
发表于 2006-07-12 01:55 |只看该作者
pear安装方法，参见：http://bbs.chinaunix.net/viewthread.php?tid=22107
pear安装好之后，PHP安装目录下会有一个pear.bat文件，可以在命令行下执行


pear list                 // 显示已经安装的pear包
pear install  packagename    // 安装指定的包，比如 pear install mdb2
pear uninstall packagename // 卸载指定的包
pear list-upgrades      // 显示安装的包里可以升级的包
pear upgrade-all   // 升级所有可以升级的包
pear help         // 显示帮助

[ 本帖最后由 夜猫子 于 2006-7-12 01:58 编辑 ]
实战分享：从技术角度谈机器学习入门| 【大话IT】RadonDB低门槛向MySQL集群下战书 | ChinaUnix打赏功能已上线！ | 新一代分布式关系型数据库RadonDB知多少？
ncnynl

论坛徽章:
0
4楼 [报告]
发表于 2006-07-12 09:35 |只看该作者
好文章，我转到pearchina那去了，应该没有问题八
实战分享：从技术角度谈机器学习入门| 【大话IT】RadonDB低门槛向MySQL集群下战书 | ChinaUnix打赏功能已上线！ | 新一代分布式关系型数据库RadonDB知多少？
返回列表 发新帖
高级模式
B Color Image Link Quote Code Smilies
您需要登录后才可以回帖 登录 | 注册

本版积分规则 发表回复

  

北京盛拓优讯信息技术有限公司. 版权所有 京ICP备16024965号-6 北京市公安局海淀分局网监中心备案编号：11010802020122 niuxiaotong@pcpop.com 17352615567
未成年举报专区
中国互联网协会会员  联系我们：huangweiwei@itpub.net
感谢所有关心和支持过ChinaUnix的朋友们 转载本站内容请注明原作者名及出处

清除 Cookies - ChinaUnix - Archiver - WAP - TOP