資通電子報-技術交流

Oracle & PHP5 Web 應用程式開發 – Using ADODB with PHP and Oracle (Part II)

文-Dennis

“站在巨人的肩膀上” — 牛頓

引言
在Using ADODB with PHP and Oracle (Part I) 中我們討論了用傳統方式連結到 Oracle Database 的方法和使用 ADODB 連結 Oracle Database 的方式的不同，從 Oracle Database 中取資料的方法 ( GetArray、GetAll、GetRow、GetOne )及模仿 MySQL limit 功能的 SelectLimit()方法。在本文中，我們將討論 ADODB 連 Oracle Database時如何Call Oracle Store Procedure 和 Functions.

開始
在開始之前，我們先列出 Oracle Database 中用 PL/SQL 撰寫的 Procedure 及 Function. 假定 Database Connection Handler 為 $DBConn (在後面的 PHP 代碼中有用到此變數)。

// Procedure 只有 in 參數
Procedure my_proec (p_in_param in varchar2)
Is
Begin
　　// do something here
End;

// Procedure 有 out 參數
Procedure my_proec (p_in_param in varchar2 ,p_out_param out varchar2)
Is
Begin
　　P_out_param :=’This is input data->’|| p_in_param ;
End;

// Function
Function my_func (p_in_param in varchar2 ,p_out_param out varchar2) return number
Is
Begin
　　P_out_param :=’This is input data->’|| p_in_param ;
　　Return 1;
End;

Call Oracle Store Procedure
ADODB 的 Oracle Driver 中專門針對 Oracle Database的特性撰寫了 Call Procedure 的方法。

1）在 Procedure 中如果沒有 out 參數，可以採用如下兩種方法來執行：
1)Execute

//PHP Code
<?php
　$stmt = ‘begin my_proc(:p_in_param); end;’;
　$DBConn->Execute($stmt,array(‘p_in_param’=>’ 這是輸入的資料’));
// 下面是從 eHR系統中摘錄出的程式代碼片段
　$stmt = 'begin
pk_erp.p_set_segment_no(:companyid);pk_department.p_set_base_date(sys
date);pk_erp.p_set_username(:user_seq_no);end;';
　$this->DBConn->Execute($stmt,
　　　　　　　　　　　　array('companyid'=> $this->companyID,
　　　　　　　　　　　　　　　'user_seq_no'=>$user_seqno));
?>

說明：
當用 Execute 方式來執行 Procedure時，在所要執行的 Procedure 前後要加上 “ begin … end; ”如上面的代碼片段。
所有的 PL/SQL Statement 必須在一行（如從eHR系統中摘錄出來的程式版片段），請不要在代碼中回車（也就是說不能有 return code）。
可以執行多個 procedure，中間用分號隔開。

2)Prepare /Bind Variables/Execute

//PHP Code
<?php
　　$stmt1 = ‘begin my_proc(:p_in_param); end;’;
　　$stmt = $DBConn->PrepareSP ( $stmt1 );
　　$ DBConn->InParameter ( $stmt, ‘這是輸入的資料’, ‘p_in_param’, 20 );
　　//$DBConn->Execute($stmt);
　　// 如果在 Procedure中執行了 insert,update,delete，需要 commit 的，要加上
　　// StartTrans()和 CompleteTrans() 的方法, 如下:
　　//$DBConn->StartTrans (); // begin transaction
　　$DBConn->Execute($stmt );
　　//$DBConn->CompleteTrans (); // end transaction
?>

說明：
使用bind variable 的方式來傳參數，用 ADODB 的 InParameter ( $stmt、 $var、 $name、 $maxLen = 4000、 $type = false ) 或 OutParamete r ( $stmt、 $var、 $name、 $maxLen = 4000、 $type = false )方法，參數說明：
$stmt：經過PrepareSP()處理過的 PL/SQL Statement
(1)$var：參數的值
(2)$name：參數名稱
(3)$maxLen：數據長度，default 4000

2）在 Procedure 中如果有 out 參數時，必須使用上述方式的第二種。因為有輸出的值，所以在 PHP 代碼中必須 declare 一個變數來存放輸出的值。如：

//PHP Code
<?php
// 摘錄自 her系統中的代碼片段
$_submit_result = array ("days" => "", "hours" => "", "msg" => "",
"is_success" => "" );
　　$stmt1 = "begin begin pk_erp.p_set_segment_no(:in_company_id1); 　
end; begin pk_erp.p_set_username(:in_user_seqno); end; begin wf.pkg_work_flow.p_submit_absence_apply(pi_seg_segment_no=>:in_compan
yid,pi_absence_flow_sz_id=>:in_workflow_seqno,po_days=>:out_days,po_h
ours=>:out_hours,po_errmsg=>:out_msg,po_success=>:out_issuccess);
end;end;";
　　$stmt = $this->DBConn->PrepareSP ( $stmt1 );
　　$this->DBConn->InParameter ( $stmt, $companyid,
"in_company_id1",10 );
　　$this->DBConn->InParameter ( $stmt, $companyid,
"in_companyid", 10 );
　　$this->DBConn->InParameter ( $stmt, $user_seqno,
"in_user_seqno", 10 );
　　$this->DBConn->InParameter ( $stmt, $workflow_seqno,
"in_workflow_seqno", 10 );
　　$this->DBConn->OutParameter ( $stmt, $_submit_result ["days"],
"out_days", 5 );
　　$this->DBConn->OutParameter ( $stmt, $_submit_result["hours"],
"out_hours", 6 );
$this->DBConn->OutParameter ( $stmt, $_submit_result ["msg"],
"out_msg", 2000 );
$this->DBConn->OutParameter ( $stmt, $_submit_result
["is_success"], "out_issuccess", 2 );
//$this->DBConn->debug = true;
$this->DBConn->StartTrans (); // begin transaction
$this->DBConn->Execute ( $stmt );
$this->DBConn->CompleteTrans (); // end transaction
return $_submit_result;
?>

說明：
其它同上面的說明，值得一提的是，在代碼的開始 declare 了一個 array來存放多個 out 的變數（當你有多個out 參數時可以採用此方法，只有一個 out 參數，直接 declare一個變數賦初值就可以了）。

Call Oracle Store Function
Function 一定會有 return的值，所以跟 Procedure 的方式有所不同。還是分兩種方式來說明：

1）只有 In Parameter
當只有 In Parameter時問題就簡單的多了。因為有 function 有 return value，所以可利用標準的 SQL Select 來解決這個問題。代碼如：

//PHP Code
<?php
　$sql = ‘select my_func(:p_in_param) from dual’;
　$outval = $DBConn->GetOne($sql,array(‘p_in_param’=>’some data’));
　Echo $outval;
?>

說明：
當只有 In Parameter時，可以利用 Oracle Database 的 dual table，用 select 的方式來執行這個 function，然後用 ADODB 的 GetOne()來得到 function 執行的結果。

2）既有 In Parameter 也有 Out Parameter
限於篇幅，本期就介紹到此。既有 In Parameter 也有 Out Parameter 的方支將在下一期電子報中的《Using ADODB with PHP and Oracle （Part III）》中介紹。

>>返回電子報首頁

資通電子報之所有文字及圖片為資通電腦公司所有。未經確認授權，嚴禁轉貼節錄。
還有更多資訊在本公司的網站上，歡迎參觀網址：http://www.ares.com.tw/
對我們有任何問題、建議請來信通知我們e-mail：ouying@ares.com.tw