PHP新手上路（十二）

使用PHP來操作Oracle資料庫

11. 資料庫連接

　　在上一節裡，我們已經介紹了PHP與MySQL資料庫的一些基本操作知識，在互連網中有關PHP與MySQL的教程也最多。MySQL是免費的，這一點也許就吸引了不少人。由於其廣泛應用，我就不想在這裡贅述MySQL的使用方法了。Oracle被大量在公司專屬應用程式中採用，因此我們就利用Oracle來進一步介紹PHP與資料庫的串連。我們當然不會提及Oracle資料庫的設計原理，原因是這已經超出了我們的討論範圍。

　　PHP提供了兩套函數與Oracle串連，分別是ORA_和OCI函數。其中ORA_函數略顯陳舊。OCI函數更新據說更好一些。兩者的使用文法幾乎相差無幾。如前所述，你的PHP安裝選項應該可以支援兩者的使用。
　　想獲得更多有關在Microsoft Windows平台上安裝支援PHP3的Apache伺服器的知識以及更多有關Oracle資料庫的知識，請查閱以下URL：www.csoft.net/~vsbabu/articles/oraphp.html。

11.1 串連

<?
if ($conn=Ora_Logon("user@TNSNAME","password"))
{
echo "<B>SUCCESS ! Connected to database<B>n";
}
else
{
echo "<B>Failed Could not connect to database<B>n";
}
Ora_Logoff($conn);
phpinfo();
?>
以上代碼使用TNSNAME（在你的tnsnames.ora檔案中指明）定義的Oracle資料庫名稱、使用者名稱稱和密碼串連資料庫。在成功串連的基礎上，ora_logon函數返回一個非零的串連ID並儲存在變數$conn中。

11.2 查詢

假設與資料庫已經串連就緒，下面我們就來實際的應用對資料庫的查詢。下面的代碼示範了一個串連並查詢的典型例子：
<?
/*
* 串連資料庫並執行查詢
*/
function printoraerr($in_cur)
{
// 檢查Oracle是否出錯
// 如果存在錯誤則顯示
// 當指標被啟用時每次請求Oracle後調用該函數
if(ora_errorcode($in_cur))
echo "Oracle code - ".ora_error($in_cur)."n";
return;
}
/** 主程式 */
if (!($conn=ora_logon("user@TNSNAME","password")))
{
echo "Connection to database failedn";
exit;
}
echo "Connected as connection - <b>$conn</b><br>n";
echo "Opening cursor ...<br>n";
$cursor=ora_open($conn); printoraerr($cursor);
echo "Opened cursor - <b>$cursor</b><br>n";
$qry="select user,sysdate from dual";
echo "Parsing the query <b>$qry</b> ...<br>n";
ora_parse($cursor,$qry,0); printoraerr($cursor);
echo "Query parsed <br>n";
echo "Executing cursor ...<br>n";
ora_exec($cursor); printoraerr($cursor);
echo "Executed cursor<br>n";
echo "Fetching cursor ...<br>n";
while(ora_fetch($cursor))
{
$user=ora_getcolumn($cursor,0); printoraerr($cursor);
$sysdate=ora_getcolumn($cursor,1); printoraerr($cursor);
echo " row = <B>$user, $sysdate </B><br>n";
}
echo "Fetched all records<br>n";
echo "Closing cursor ...<br>n";
ora_close($cursor);
echo "Closed cursor<br>n";
echo "Logging off from oracle... <br>n";
ora_logoff($conn);
echo "Logged off from oracle <br>n";
?>
（譯者註：以上程式碼片段缺少注釋，請讀者參考PHP Manual的Oracle資料庫函數部分）

11.3 顯示結果

以下代碼示範了怎樣查詢資料庫並將結果輸出：
<?
function printoraerr($in_cur, $conn)
{
// 檢查Oracle是否出錯
// 如果存在錯誤則顯示
// 當指標被啟用時每次請求Oracle後調用該函數
// If it encountered an error, we exit immediately
if(ora_errorcode($in_cur))
{
echo "Oracle code - ".ora_error($in_cur)."<br>n";
ora_logoff($conn);
exit;
}
return;
}

function exequery($w_qry,$conn)
{
$cursor=ora_open($conn); printoraerr($cursor,$conn);
ora_parse($cursor,$w_qry,0); printoraerr($cursor,$conn);
ora_exec($cursor); printoraerr($cursor,$conn);
$numrows=0;
$w_numcols=ora_numcols($cursor);
// 顯示頭部
echo "
<TABLE WIDTH="100%" BORDER="0" CELLSPACING="1" CELLPADDING="2">
<TR>n";
for ($i=0;$i<$w_numcols;$i++)
{
$align=(ora_columntype($cursor,$i)=="NUMBER")?"RIGHT":"LEFT";
echo "t<TH VALIGN=TOP ALIGN=$align>".ora_columnname($cursor,$i)."</TH>n";
}
echo "</TR>n";
while(ora_fetch($cursor))
{
echo "<TR>n";
for ($i=0;$i<$w_numcols;$i++)
{
$align=(ora_columntype($cursor,$i)=="NUMBER")?"RIGHT":"LEFT";
if(ora_columntype($cursor,$i)=="LONG")
echo "<TD VALIGN=TOP ALIGN=$align><PRE>".
ora_getcolumn($cursor,$i)."</PRE></TD>n";
else
echo "<TD VALIGN=TOP ALIGN=$align>".ora_getcolumn($cursor,$i)."</TD>n";
printoraerr($cursor,$conn);
}
$numrows++;
echo "</TR>n";
}
if ($numrows==0)
echo "<TR><TD COLSPAN="$w_numcols"><B>Query returned no records
</B></TD></TR>n";
else
{
echo "<TR>n";
echo "<TH COLSPAN="".($w_numcols-1)."" ALIGN=RIGHT>Count</TH>n";
echo "<TH ALIGN=RIGHT>$numrows</TH>n";
echo "</TR>n";
}
echo "</TABLE>n";
ora_close($cursor);
return;
}

// 主程式
if(!($conn=ora_logon("user@SID","password")))
{
echo "Error: Cannot connect to databasen";
exit;
}
$qry="SELECT
deptno "Dept"
,empno "Emp"
,empnm "Name"
,salary "Salary"
FROM
employee
ORDER BY 1,2";
exequery($qry);
ora_logoff($conn);
?>
（譯者註：以上程式碼片段缺少注釋，請讀者參考PHP Manual的Oracle資料庫函數部分）

11.4 基於HTTP的Oracle登入

將以下代碼加在PHP頁面代碼之前以確認Oracle登入。注意你必須正確設定$ SID。
<?
if(!isset($PHP_AUTH_USER))
{
Header("WWW-authenticate: basic realm="$SID"");
Header("HTTP/1.0 401 Unauthorized");
$title="Login Instructions";
echo "<blockquote>
You are not authorized to enter the site
</blockquote> n";
exit;
}
else
{
if (!($conn=ora_logon("$PHP_AUTH_USER@$SID",$PHP_AUTH_PW)))
{
Header("WWW-authenticate: basic realm="$SID"");
Header("HTTP/1.0 401 Unauthorized");
$title="Login Instructions";
echo "<blockquote>
You are not authorised to enter the site
</blockquote> n";
exit;
}
}
?>