oracle|資料 《PHP+Oracle(OCI) 初步》中講了如何用PHP中的OCI函數來串連Oracle資料庫，執行一些SQL查詢及關閉資料庫連接。本文將講述另一個難度稍大的問題：用PHP的OCI函數來操縱Oracle的LOB欄位。閱讀本文需要《PHP+Oracle(OCI) 初步》一文中的知識。
用過Oracle的人都知道，Oracle有一種資料類型叫VARCHAR2，用來表示不定長的字串。VARCHAR2也是Oracle公司推薦使用的類型。但使用VARCHAR2有個問題：最大隻能表示4000個字元，也就相當於2000個漢字。如果你的程式中某個字元的值要大於20002個漢字，用VARCHAR2就不能滿足要求了。這時候，你有兩個選擇，一是用多個VARCHAR2來表示，二是用LOB欄位。這裡我們來看看第二個辦法。
先來大體瞭解一下Oracle的LOB欄位。Oracle的LOB類型分為三種：BLOB,CLOB和BFILE。CLOB稱為字元LOB，BLOB和BFILE是用來儲存位元據的。CLOB和BLOB的最大長度是4GB，它們把值存放在Oracle資料庫中。BFILE和BLOB類似，但它把資料放在外部的檔案中，所以它又稱為外部BLOB（External BLOB）。
我想，我們對MYSQL應該都不會陌生。MYSQL中也有類似的資料類型，如TEXT和BLOB。在PHP的MYSQL函數中，對TEXT/BLOB的操作是直接的，就象其它類型的資料一樣。但在Oracle中，情況就不一樣了。Oracle把LOB當作一種特殊的資料類型來處理，在操作上不能用常規的方法。比如，不能在INSERT語句中直接把值插入到LOB欄位中，也不能用LIKE進行尋找。
下面就通過幾個例子來說明如何用PHP的OCI函數來插入，取出和查詢LOB資料。
插入
不能直接用INSERT語句向LOB欄位中插入值。一般情況下，有如下的幾步：
1 先分析一個INSERT語句，返回一個LOB的描述符
2 用OCI函數產生一個本地的LOB對象
3 將LOB對象綁定到LOB描述符上
4 執行INSERT語句
5 給LOB對象賦值
6 釋放LOB對象和SQL語句控制代碼
下面的這個例子是把使用者上傳的圖片檔案存放到BLOB（或BFILE中，操作稍有不同）中。
首先要建一個表，結構如下：
CREATE TABLE PICTURES (
ID NUMBER,
DESCRIPTION VARCHAR2(100),
MIME VARCHAR2(128),
PICTURE BLOB
);
如果要實現ID的自動增加，再建一個SEQUENCE:
CREATE SEQUENCE PIC_SEQ;
然後是用來處理資料的PHP程式碼。
<?php
//建立Oracle資料庫連接
$conn = OCILogon($user, $password, $SID);
//提交SQL語句給Oracle
//在這裡要注意的兩點：一是用EMPTY_BLOB()函數。這是Oracle的內建函式，返回一個LOB的定位器。在插入LOB時，只能用這個辦法先產生一個空的LOB定位器，然後對這個定位器進行操作。EMPTY_BLOB()函數是針對BLOB類型的，對應於CLOB的是EMPTY_CLOB()。二是RETURNING後面的部分，把picture返回，讓PHP的OCI函數能夠處理。
$stmt = OCIParse($conn,"INSERT INTO PICTURES (id, description, picture)
VALUES (pic_seq.NEXTVAL, '$description', '$lob_upload_type', EMPTY_BLOB()) RETURNING picture INTO :PICTURE");
//產生一個本地LOB對象的描述符。注意函數的第二個參數：OCI_D_LOB，表示產生一個LOB對象。其它可能的還有OCI_D_FILE和OCI_D_ROWID，分別對應於BFILE和ROWID對象。
$lob = OCINewDescriptor($conn, OCI_D_LOB);
//將產生的LOB對象綁定到前面SQL語句返回的定位器上。
OCIBindByName($stmt, ':PICTURE', &$lob, -1, OCI_B_BLOB);
OCIExecute($stmt);
//向LOB對象中存入資料。因為這裡的來源資料是一個檔案，所以直接用LOB對象的savefile()方法。LOB對象的其它方法還有：save()和load()，分別用來儲存和取出資料。但BFILE類型只有一個方法就是save()
if($lob->savefile($lob_upload)){
OCICommit($conn);
echo "上傳成功<br>";
}else{
echo "上傳失敗<br>";
}
//釋放LOB對象
OCIFreeDesc($lob);
OCIFreeStatement($stmt);
OCILogoff($conn);
?>
還有一個要注意的地方：LOB欄位的值最少要1個字元，所以在save()或savefile()之前，要確保值不可為空。否則,Oracle會出錯。
取出
對一個LOB中取出資料，有兩種辦法。一是產生一個LOB對象，然後綁定到一條SELECT語句返回的定位器上，再用LOB對象的load()方法取出資料；二是直接用PHP的OCIFetch***函數。第一種方法比第二種方法要麻煩得多，所以我直接說說第二種方法。
還是用上面的表。
<?php
$conn = OCILogon($user, $password, $SID);
$stmt = OCIParse($conn,"SELECT * FROM PICTURES WHERE ID=$pictureid");
OCIExecute($stmt);
//秘密就在PCIFetchInfo的第三個參數上：OCI_RETURN_LOBS。第三個參數是FETCH的模式，如果OCI_RETURN_LOBS，就直接把LOB的值放到結果數組中，而不是LOB定位器，也就不用LOB對象的load()方法了。
if (OCIFetchInto($stmt, $result, OCI_ASSOC+OCI_RETURN_LOBS))
{
echo "Content-type: " . StripSlashes($result[MIME]);
echo StripSlashes($result[PICTURE]);
}
OCIFreeStatement($stmt);
OCILogoff($conn);
?>
這個程式用來顯示放在LOB中的資料（圖片）。調用方法（假設指令碼名是getpicture.php）：
<IMG SRC="getpicture.php?pictureid=99" ALT="放在Oracle LOB中的圖片">
查詢
前面已經提了下，對於Oracle的LOB欄位是不能用LIKE進行匹配的。怎麼辦呢？其實並不複雜，Oracle有一個匿名的程式包，叫DBMS_LOB，裡面有所有的操作LOB所需的過程。
假設有象這樣一個表:
CREATE TABLE ARTICLES (
ID NUMBER,
TITLE VARCHAR2(100),
CONTENT CLOB
);
文章的內容放在CONTENT欄位中。
現在我們要找出所以內容中包含"PHP中文使用者"的文章，可以這麼來做：
<?php
$conn = OCILogon($user, $password, $SID);
//WHERE子句中用了DBMS_LOB.INSTR過程。它有四個參數，前面兩個分別表示LOB的定位器（可以直接用欄位表示）和要尋找的字串；後面兩個分別表示開始的位移量和出現的次數。要注意的是必須判斷它的傳回值，也就是要大於0。
$stmt = OCIParse($conn,"SELECT * FROM ARTICLES WHERE DBMS_LOB.INSTR(CONTENT, 'PHP中文使用者', 1, 1) > 0");
OCIExecute($stmt);
if (OCIFetchInto($stmt, $result, OCI_ASSOC+OCI_RETURN_LOBS))
{
...
}
OCIFreeStatement($stmt);
OCILogoff($conn);
?>
Oracle還提供了許多用來操作LOB資料的過程，如LENGTH, SUBSTR等等。至於它們的詳細用法，可以考慮Oracle的開發手冊。
關於對Oracle資料庫中的LOB類型的資料的操作，就說這麼多了。由於我接觸Oracle時間不長，本文中可能還會有錯誤，歡迎大家批評指正。
