DBA函数库

在柏克莱的 bsd 系列操作系统中，有个简单的
[url=javascript:;]数据库[/url]
结构，它以数个文件组成超小型的数据库系统，架构成抽象层 (abstraction layer) 的 dba 数据库。
目前 php 支持的 dba 数据库包括

dbm：柏克莱发展的最早期 dba 数据库。

• ndbm：较新且较有弹性的 dba。
  
• gdbm：gnu 发展的 dba，
  ftp://ftp.gnu.org/pub/gnu/gdbm/
  
• db2：由 sleepycat 软件开发的 db2 (非 ibm 的 db2)，
  http://www.sleepycat.com
  
• cdb：这是 qmail 作者开发快速可靠的 dba，
  http://pobox.com/~djb/cdb.html
  以下是简单的使用范例，当然在使用前，必须先装好 dba。
  
  dba_close :
  关闭数据库。
  dba_delete :
  删除指定资料。
  dba_exists :
  检查键是否存在。
  dba_fetch :
  取回指定资料。
  dba_firstkey :
  取回首笔键值。
  dba_insert :
  加入资料。
  dba_nextkey :
  取回下笔键值。
  dba_popen :
  打开并保持数据库链接。
  dba_open :
  打开数据库链接。
  dba_optimize :
  最佳化数据库。
  dba_replace :
  改动或加入资料。
  dba_sync :
  数据库同步化。
  dba_close
  关闭数据库。
  语法: void dba_close(int handle);
  返回值: 无
  函数种类: 数据库功能
  内容说明 本函数用来将已打开的数据库关闭。参数 handle 为打开数据库时所返回来的代号 id。
  参考 dba_popen() dba_open()
  dba_delete
  删除指定资料。
  语法: int dba_delete(string key, int handle);
  返回值: 整数
  函数种类: 数据库功能
  内容说明 本函数将删除指定的资料。参数 key 为欲删除的键值 (key)。参数 handle 为打开数据库时所返回来的代号 id。删除成功则返回 true 值。
  参考 dba_exists() dba_fetch() dba_insert() dba_replace()
  dba_exists
  检查键是否存在。
  语法: boolean dba_exists(string key, int handle);
  返回值: 布尔值
  函数种类: 数据库功能
  内容说明 本函数用来检查指定的键是否存在。参数 key 为待检查的键值 (key)。参数 handle 为打开数据库时所返回来的代号 id。若键存在则返回 true 值。
  参考 dba_delete() dba_fetch() dba_insert() dba_replace()
  dba_fetch
  取回指定资料。
  语法: string dba_fetch(string key, int handle);
  返回值: 字符串
  函数种类: 数据库功能
  内容说明 本函数取得指定的资料。参数 key 为欲取出资料的键值 (key)。参数 handle 为打开数据库时所返回来的代号 id。返回值即为资料字符串，若取出失败则返回 false。
  参考 dba_exists() dba_delete() dba_insert() dba_replace()
  dba_firstkey
  取回首笔键值。
  语法: string dba_firstkey(int handle);
  返回值: 字符串
  函数种类: 数据库功能
  内容说明 本函数取得数据库的第一笔键值 (key)。参数 handle 为打开数据库时所返回来的代号 id。返回值即为键值，若取出失败则返回 false。
  参考 dba_nextkey()
  dba_insert
  加入资料。
  语法: boolean dba_insert(string key, string value, int handle);
  返回值: 布尔值
  函数种类: 数据库功能
  内容说明 本函数将加入资料至数据库中。参数 key 为键值 (key) 字符串。参数 value 为欲加入的资料内容。参数 handle 为打开数据库时所返回来的代号 id。成功则返回 true 值。
  参考 dba_exists() dba_fetch() dba_delete() dba_replace()
  dba_nextkey
  取回下笔键值。
  语法: string dba_nextkey(int handle);
  返回值: 字符串
  函数种类: 数据库功能
  内容说明 本函数取得数据库的下一笔键值 (key)。参数 handle 为打开数据库时所返回来的代号 id。返回值即为键值，若取出失败则返回 false。
  参考 dba_firstkey()
  dba_popen
  打开并保持数据库链接。
  语法: int dba_popen(string path, string mode, string handler);
  返回值: 整数
  函数种类: 数据库功能
  内容说明 本函数用来打开指定的数据库，并保持与数据库连接的状态。参数 path 为数据库的路径及数据库名称，例如 "/tmp/mysite/wahaha.db"。参数 mode 值如下表
  r打开只读既有数据库w打开可读写既有数据库c打开可读写数据库，若不存在则建立n删去现有数据库，若不存在则建立，之后可读写
  属性
  说明
  参数 handler 为打开数据库的种类，有 dbm、ndbm、gdbm、db2 或 cdb 等种类。返回值为数据库的代号 id，若失败则返回 false。 参考 dba_close() dba_open()
  dba_open
  打开数据库链接。
  语法: int dba_open(string path, string mode, string handler);
  返回值: 整数
  函数种类: 数据库功能
  内容说明 本函数用来打开指定的数据库。参数 path 为数据库的路径及数据库名称，例如 "/tmp/mysite/wahaha.db"。参数 mode 值如下表
  r打开只读既有数据库w打开可读写既有数据库c打开可读写数据库，若不存在则建立n删去现有数据库，若不存在则建立，之后可读写
  属性
  说明
  参数 handler 为打开数据库的种类，有 dbm、ndbm、gdbm、db2 或 cdb 等种类。返回值为数据库的代号 id，若失败则返回 false。本函数和 dba_popen() 不同的地方在于本函数打开的数据库在 php 程序结束后即关闭，dba_popen() 会保持与数据库连接，待下次再执行，则不必再打开与数据库的链接。
  参考 dba_close() dba_popen()
  dba_optimize
  最佳化数据库。
  语法: boolean dba_optimize(int handle);
  返回值: 布尔值
  函数种类: 数据库功能
  内容说明 本函数将数据库最佳化。参数 handle 为打开数据库时所返回来的代号 id。最佳化成功则返回 true 值，反之则返回 false。
  参考 dba_sync()
  dba_replace
  改动或加入资料。
  语法: boolean dba_replace(string key, string value, int handle);
  返回值: 布尔值
  函数种类: 数据库功能
  内容说明 本函数改动数据库中的资料，若资料不存在则加入。参数 key 为键值 (key) 字符串。参数 value 为欲改动的资料内容。参数 handle 为打开数据库时所返回来的代号 id。成功则返回 true 值。
  参考 dba_exists() dba_fetch() dba_delete() dba_insert()
  dba_sync
  数据库同步化。
  语法: boolean dba_sync(int handle);
  返回值: 布尔值
  函数种类: 数据库功能
  内容说明 本函数使系统在更新数据库时，能同时写入实体的数据库储存装置 (如硬碟) 之中。参数 handle 为打开数据库时所返回来的代号 id。同步成功则返回 true 值，反之则返回 false。
  参考 dba_optimize()