PEAR MDB 数据库抽象层 —— 一次编写—随处运行

在支持的数据类型中还有 LOB （大对象），它使得我们能够在数据库中储存文件。二进制文件储存在 BLOB （二进制大对象）中而且普通文本文件储存在 CLOB （字符大对象）中。在 MDB 中你仅仅能够使用预准备的 INSERT 和 UPDATE 查询储存 LOB。使用 MDBA::setParamBlob() 或者 MDB::setParamClob() 你能够设置预准备查询的 LOB 域的值。两个函数都预期传递一个 LOB 对象，而它能够使用 MDB::createLob() 创建。

$binary_lob = array( 'Type' => 'inputfile', 'FileName' => './myfile.gif' ); $blob = $mdb->createLob($binary_lob); $character_lob = array( 'Type' => 'data', 'Data' => 'this would be a very long string container the CLOB data' ); $clob = $mdb->createLob($character_lob);

如你能看到的，MDB::createLob() 被传递一个关系数组。Type 键的值可能是以下中的一个：data, inputfile 或者 outputfile。前两个用于你想要把 LOB 写入数据库的时候。如果你有一个储存在变量中的 LOB，你应当在 需要使用 inputfile 时从文件直接读取 LOB。最后，outpufile 应当在你想要从数据库中读取 LOB 时使用。取决于你是否使用数据或者 inputfile 你需要给 Filename 键或者 Data 键指定一个值，像上面的例子那样。现在，我们将把前面的 LOB 储存到数据库中去。

$p_query = $mdb->prepareQuery('INSERT INTO files (id, b_data, c_data) VALUES (1, ?, ?)'); $mdb->setParamBlob($p_query, 1 , $blob, 'b_data'); $mdb->setParamClob($p_query, 2 , $clob, 'c_data'); $result = $mdb->executeQuery($p_query);

为了从数据库中获取上面的文件，我们需要首先从数据库中选择数据并且使用 MDB::createLob() 创建 LOB 对象。这次我们将设置 'Type' 为 'outputfile'

$mdb->query('SELECT b_data FROM files WHERE id = 1'); $binary_lob = array( 'Type' => 'outputfile', 'Result' => $result, 'Row' => 0, 'Field' => 'b_data', 'Binary' => 1, 'FileName' => './myfile2.gif' ); $blob = $mdb->createLob($binary_lob);

现在我们能够使用 MDB::readLob() 从结果集中读取 LOB。传递长度 0 给 MDB::readLob() 意味着整个 LOB 被读取和储存在我们前面指定的文件中。一旦任务完成了，我们可以把资源释放了。你也可以设置任何大于零的长度并且使用一个 while 循环检查 MDB::endofLob() 来读取 LOB。

$mdb->readLob($blob, $data, 0);

注意你不要把这个获取函数和 bulk 获取函数像 MDB::fetchAll()搞混了，因为这将在大部分 PHP 数据库扩展中导致问题。在一些时候，MDB 可能能够使用 bulk 获取函数获得 LOB。

如我们在这节所见，MDB 特性本身的原生数据类型集自动映射于数据库中的原生数据类型。这保证了无论我们发送和从数据库接收什么样的数据，它都能与使用的 RDBMS 无关的使用相同的格式。如我在本节开篇已经提到的，这明显需要数据库使用的数据类型是 MDB 预期的。这种需要被用于确保映射所耗费的代价很小。下一节将教给我们 MDB 如何辅助在数据库中使用正确的数据类型。

使用 XML schema 文件

利用在上个段落中描述的特性，你能编写真正的数据库独立的程序。但是 MDB 尝试向前更加迈出一步：它允许你用 XML 定义你的 schema。一个管理器把这种 schema 转换为给每种 RDBMS 的必要的 SQL 语句。这意味着你能对所有支持的 RDBMS 使用相同的 schema。本节的例子能够在 xml_schema 目录中找到。

我们现在将从头编写一个 XML schema 文件。首先，我们必须定义一个 XML 文档。数据库定义是包含在一个 database 标签之中的。数据库的名字是使用 name 标签定义的。create 标签告诉管理器数据库是否需要在它不存在的时候被创建。如果你把你的 schema 文件分割成好几个文件你你首先提交给管理器的那个文件中把 create 设置为 1。

<?xml version="1.0" encoding="ISO-8859-1" ?> <database> <name>auth</name> <create>1</create> </database>

可能你已经从数据库名 auth 猜出了这个数据库的目的是用于储存简单的验证程序的用户数据。Listing 2 定义了在其中我们能储存用户数据的表。

Listing 2

<table> <name>users</name> <declaration> <field> <name>user_id</name> <type>integer</type> <notnull>1</notnull> <unsigned>1</unsigned> <default>0</default> </field> <field> <name>handle</name> <type>text</type> <length>20</length> <notnull>1</notnull> <default></default> </field> <field> <name>is_active</name> <type>boolean</type> <notnull>1</notnull> <default>N</default> </field> </declaration> </table>

如你能看到的，如使用 XML 时可以预期的，东西变得有一些冗长。不用担心：我们有一个基于浏览器的工具称为 MDB_frontend 使得这个过程更加简单。我将在这篇文章的后面谈论这个工程。可能这极其详细地表格描述的优点是非常明显。前面例子中的表格被称为 users 并且我们定义了 3 个域：类型为整数的 user_id，类型为文本的 handle 和类型为逻辑型的 is_active。记住如果你如前一节那样传递了必要的元数据 MDB 为你处理类型抽象。你还不需要 MDB 把这些类型映射为你的 RDBMS 中的什么。在每个域声明中还能使用的其他标签是可选的：length，notnull，unsigned 和 default。

下一件我们现在需要做的事情是通过在 user_id 域放置恰当的索引确保 user_id 是唯一的。索引定义就在声明标签之内（Listing 3）。

Listing 3:

<table> <name>users</name> <declaration> <index> <unique>1</unique> <name>user_id_index</name> <field> <name>user_id</name> <sorting>ascending</sorting> </field> </index> </declaration> </table>

在 listing 3 中的定义在域 user_id 中创建一个唯一的上升排序的名为 user_id_index 的索引。当然，我们可以简单地添加另外一个域标签在索引定义中指定多于一个的域。我们现在仍然没有提到的是为我们产生唯一的用户 id 的序列。

<sequence> <name>users_user_id</name> <start>1</start> <on> <table>users</table> <field>user_id</field> </on> </sequence>

上一个例子非常的绕弯。一行行看过来，我们看到首先打开一个 sequence 标签，跟着一个指定序列名字的 name 标签。这之后跟着一个定义序列初始值的 start 标签。现在，我们打开一个可选的 on标签。这儿我们需要设置一个表中的指定域。这个信息是管理器用来把序列的值设置为 users 表的 user_id 域的最大值。如果 users 表是空的，作为替代使用的是 start 标签中指定的值。请注意在 start 标签中指定的值是我们调用 MDB::nextId() 返回的第一个值。

当然，你也能使用任何值初始化表。例如你可能想要用你总是想要包含在你的程序中的管理用户来初始化前面的表格。为了这么做，我们需要把一个 initialization 标签添加给 table 标签。Listing 4 定义了一在另外一用 insert 标签包括的行之后的行。

Listing 4

<table> <name>users</name> <initialization> <insert> <field> <name>user_id</name> <value>1</value> </field> <field> <name>handle</name> <value>default</value> </field> <field> <name>is_active</name> <value>Y</value> </field> </insert> </initialization> </table>

如你从上个例子中能看到的那样，所有我们需要做的就是给表的每个域设定值。我们现在已经知道了必要的基础知识来创建一个 MDB 的 XML schema。下一步是把这个 schema 文件传递给 MDB 管理器。

$manager = new MDB_Manager; $input_file = 'auth.schema'; // we do not have to connect to a specify a specific database at this time $dsn = "mysql://$user:$pass@$host"; $manager->connect($dsn); $manager->updateDatabase($input_file, $input_file. '.before');

我们现在有了一个新的名字叫 auth 的数据库，它有一个表叫 users。在域 user_id 有一个索引。而且在表中还有一行。我们还有一个序列称为 users_user_id，它将被初始化为 1。因此序列中的下一个值就是 2。最后，schema 的一个拷贝以名字auth.schema.before 被创建。这是因为我们给 MDB_Manger::updateDatabase() 传递了可选的第二个参数。在下一节我们将看到为什么要创建这个拷贝。

所有这些都非常令人惊奇但是它变得更好。许多情况下程序需要在某些地方作出改变。例如我们可能决定需要把表的名字从 users 变成 people。我们可能还需要增加一个域 pwd 来储存密码域（请检查 textbox 的保留字）。