PHP ADODB 入门教程(7)

要注意，在PHP 4.1.0 以前的版本，当 Interbase的 blob 值被 SELECT 取回值时，它仍需要被译码，请使用 $connection->DecodeBlob($blob); 以还原它的内容。

UpdateClob($table,$column,$val,$where)

允许你以 $where 条件储存一个BLOB(存在 $val里的)值到 $table 里的 $column 字段。类似于 UpdateBlog，但主要针对文字大型档案对象。

例:

       # for oracle
        $conn->Execute('INSERT INTO clobtable (id, clobcol) VALUES (1, empty_clob())');
        $conn->UpdateBlob('clobtable','clobcol',$clobvalue,'id=1');
 
        # non oracle databases
        $conn->Execute('INSERT INTO clobtable (id, clobcol) VALUES (1, null)');
        $conn->UpdateBlob('clobtable','clobcol',$clobvalue,'id=1');
UpdateBlobFile($table,$column,$path,$where,$blobtype='BLOB')

如同 UpdateBlob ，但我们将值改成一个档案路径，将整个档案存入。

成功回传 true 否则为 false。

GetUpdateSQL(&$rs, $arrFields, $forceUpdate=false,$magicq=false)

建立一个 SQL 以更新一个被给予的资料集 $rs ，被修改的字段存放在数组 $arrFields中(这个数组必需是具名数组，字段名为索引，值为修正值)，会与原来的资料集做一个比较，如果 $forceUpdate被设为 true，那么即使 $arrFields与 $rs->fields完全相同，也会产生出更新的SQL指令。资料集必需在连结状态。$magicq 被用于指出魔术引号功能是否被激活。

GetInsertSQL(&$rs, $arrFields,$magicq=false)

建立一个 SQL 以新增一笔记录到被给予的资料集 $rs。这个查询必需是在连结状态。$magicq 被用于指出魔术引号功能是否被激活。

PageExecute($sql, $nrows, $page, $inputarr=false)

使用资料集的页码功能，参数 $page 是以 1 为启使值，请参考范例 8.

CachePageExecute($secs2cache, $sql, $nrows, $page, $inputarr=false)

使用资料集的页码功能，参数 $page 是以 1 为启使值，请参考范例 8.PageExecute 的快取版。

Close( )

关闭数据库的连结。PHP4 以数据库连结结束时不需要特别去清除而享有盛名，因为其参考计数机制会自动帮我们清除掉。

BeginTrans( )

启始一笔交易。会关闭自动结案功能。执行成功会回传 true 。如果不支持交易功能，部份数据库会一直传回 false 值。Interbase,Oracle 及 MSSQL 支持交易机制。请注意，因为 PHP 4.02 版的臭虫，交易支持在微软的 ADO 上是无效的。你必需使用你关连式数据库的原生交易支持功能。当连结结束时，任何开启的交易都会被还原。

CommitTrans( )

成功的结束一次交易。如果成功，回传 true。如果数据库并不支持交易功能，那么就只会传回 true ，以表示资料总是交易成功的。

RollbackTrans( )

结束一次交易，恢复所有改变。执行成功会回传 true 。如果数据库并不支持交易功能，那么就只会传回 false ，以表示资料总是不能恢复。

GetOne($sql)

Executes the SQL and returns the first field of the first row as an array. The recordset and remaining rows are discarded for you automatically. If an error occur, false is returned.

执行SQL指令，并且以数组的方式回传第一笔记录的第一个字段。资料集及其余的记录将会被自动清除，如果发生错误，就回传 false 值。

译者注：这个功能在验证某笔记录在不在特别有用，可以减少系统内存及资源的用量。

GetRow($sql)

执行SQL指令，并且以数组的方式回传第一笔记录。资料集及其余的记录将会被自动清除，如果发生错误，就回传 false 值。

Prepare($sql )

预先编译一个SQL查询，以便于重复执行。如果有任何语法错误，Prepare()不会显示任合错误，但允许 Execute() 去取得及显示错误。内部实作支持 interbase ,oci8 及选择性的 ODBC-based 驱动程序。其余的都是以仿真的方式支持。在仿真的情况下，使用 Prepare() 对效能的增进没有任何效果。

回传一个包含了原始描述为第一个数组元素的数组，其余的元素内容则视驱动程序而定。如果有错误或是仿真方式的 Prepare()，会回传原来的 $sql 字符串。那是因为所有的错误处理都被集中到 Execute() 里去了。

范例 :

$stmt = $DB->Prepare('insert into table (col1,col2) values (?,?)');
for ($i=0; $i < $max; $i++)
 $DB->Execute($stmt,array((string) rand(), $i));
PrepareSP($sql)

在 mssql 驱动程序里，预编译预储程序必需要透过一个特别的函数来呼叫 mssql_init()，这个动作目前由本函数来处理了。PrepareSP() 可以在所有的驱动程序由被呼叫，而且以呼叫 Prepare() 的方式来仿真。使用范例请参考以下的 Parameter() 说明。

和上面的 Prepare() 回传一样的数组或 $sql 字符串。

Parameter($stmt, $var, $name, $isOutput=false, $maxLen = 4000, $type = false )