[ 永遠的UNIX > PHP4手冊:函數庫及函數(三十六) ODBC 資料庫連結函式庫 ]

[ 永遠的UNIX::UNIX技術資料的寶庫 ] GB | BIG5

首頁 > 編程技術 > Php > 正文

PHP4手冊:函數庫及函數(三十六) ODBC 資料庫連結函式庫

http://netleader.126.com 星空浪子 (2001-04-18 15:36:41)

--------------------------------------------------------------------------------
　ODBC　資料庫連結函式庫　
--------------------------------------------------------------------------------
　

本函式庫共有　25　個函式
開放資料連結　(Open　Database　Connectivity,　ODBC)　是連結資料庫的共通介面。ODBC　是由微軟主導的資料庫連結標準，實作環境也以微軟的系統最成熟。在　UNIX　系統中，通常要使用其它廠商所提供的　ODBC　介面，有些　UNIX　廠商會自己提供　ODBC　介面　(如　SUN　有為　Solaris　提供　ODBC)。
ODBC　和資料庫的查詢採用　SQL　語言，這和大部份的資料庫查詢方式一樣，這使得系統可以很容易和各種資料庫溝通。當然，透過　ODBC　介面，端的資料庫不一定要　DBMS　這種大型資料庫系統，亦可以是資料表　(如　Microsoft　Access)、或者是試算表　(如　Microsoft　Excel)。　
　

odbc_autocommit:　開關自動更動功能。　
odbc_binmode:　設定二進位資料處理方式。　
odbc_close:　關閉　ODBC　連結。　
odbc_close_all:　關閉所有　ODBC　連結。　
odbc_commit:　更動　ODBC　資料庫。　
odbc_connect:　連結至　ODBC　資料庫。　
odbc_cursor:　取得遊標名。　
odbc_do:　執行　SQL　指令。　
odbc_exec:　執行　SQL　指令。　
odbc_execute:　執行預置　SQL　指令。　
odbc_fetch_into:　取得傳回的指定列。　
odbc_fetch_row:　取得傳回一列。　
odbc_field_name:　取得欄位名稱。　
odbc_field_type:　取得欄位資料形態。　
odbc_field_len:　取得欄位資料長度。　
odbc_free_result:　釋出傳回資料的記憶體。　
odbc_longreadlen:　設定傳回欄的最大值。　
odbc_num_fields:　取得欄位數目。　
odbc_pconnect:　長期連結至　ODBC　資料庫。　
odbc_prepare:　預置　SQL　指令。　
odbc_num_rows:　取得傳回列數目。　
odbc_result:　取得傳回資料。　
odbc_result_all:　傳回　HTML　表格資料。　
odbc_rollback:　撤消當前交易。　
odbc_setoption:　調整　ODBC　設定。　

--------------------------------------------------------------------------------
　函式:odbc_autocommit()　
--------------------------------------------------------------------------------
　

ODBC　資料庫連結函式庫

odbc_autocommit
開關自動更動功能。

語法:　int　odbc_autocommit(int　connection_id,　int　[OnOff]);

傳回值:　整數

函式種類:　資料庫功能

　
　
內容說明　

本函式用來開啟或關閉自動更新　(auto-commit)　功能。參數　connection_id　為　ODBC　連結的　ID　值。參數　OnOff　可省略，表開啟或關閉自動更動功能，內定值為　on，欲關閉則設　off。傳回值為目前的自動更新狀態，若開啟自動更新功能則傳回　true；若關閉自動更新功能則傳回　false。

　
　
參考　

odbc_commit()　　odbc_rollback()　　

--------------------------------------------------------------------------------
　函式:odbc_binmode()　
--------------------------------------------------------------------------------
　

ODBC　資料庫連結函式庫

odbc_binmode
設定二進位資料處理方式。

語法:　int　odbc_binmode(int　result_id,　int　mode);

傳回值:　整數

函式種類:　資料庫功能

　
　
內容說明　

本函式用來設定二進位資料傳回時的處理方式。受到本函式影響的資料形態有　BINARY、VARBINARY　及　LONGVARBINARY。參數　result_id　為傳回的　ID　值，若設為　0，則程式將設定一個新的　ID　值。參數　mode　為設定的二進位處理方式，有下列的值

ODBC_BINMODE_PASSTHRU　傳回二進位資料　
ODBC_BINMODE_RETURN　轉成十六進位傳回　
ODBC_BINMODE_CONVERT　轉成字串資料傳回　
注意:　若使用　odbc_fetch_into()，ODBC_BINMODE_PASSTHRU　會導至傳回字串值都是空的　(empty)。而傳回資料最大值的內定大小為　4096　位元組，若要傳回更多的資料需使用　odbc_longreadlen()。　

　
　
參考　

odbc_fetch_into()　　odbc_longreadlen()　　

--------------------------------------------------------------------------------
　函式:odbc_close()　
--------------------------------------------------------------------------------
　

ODBC　資料庫連結函式庫

odbc_close
關閉　ODBC　連結。

語法:　void　odbc_close(int　connection_id);

傳回值:　無

函式種類:　資料庫功能

　
　
內容說明　

本函式用來關閉與　ODBC　資料庫之間的連結。參數　connection_id　為　ODBC　連結代號　ID　值。若正在執行　transactions　則無法關閉連結。

--------------------------------------------------------------------------------
　函式:odbc_close_all()　
--------------------------------------------------------------------------------
　

ODBC　資料庫連結函式庫

odbc_close_all
關閉所有　ODBC　連結。

語法:　void　odbc_close_all(void);

傳回值:　無

函式種類:　資料庫功能

　
　
內容說明　

本函式用來關閉與　ODBC　資料庫之間所有的連結。和　odbc_close()　一樣，若正在執行　transactions　則無法關閉連結。使用本函式不需要使用任何參數。

　

--------------------------------------------------------------------------------
　函式:odbc_commit()　
--------------------------------------------------------------------------------
　

ODBC　資料庫連結函式庫

odbc_commit
更動　ODBC　資料庫。

語法:　int　odbc_commit(int　connection_id);

傳回值:　整數

函式種類:　資料庫功能

　
　
內容說明　

本函式用來更動　(commit)　ODBC　資料庫。參數　connection_id　為　ODBC　連結的　ID　值。若有設定　odbc_autocommit()　成自動更動資料庫時，則不需使用本函式
　

--------------------------------------------------------------------------------
　函式:odbc_connect()　
--------------------------------------------------------------------------------
　

ODBC　資料庫連結函式庫

odbc_connect
連結至　ODBC　資料庫。

語法:　int　odbc_connect(string　dsn,　string　user,　string　password,　int　[cursor_type]);

傳回值:　整數

函式種類:　資料庫功能

　
　
內容說明　

本函式用來連結到　ODBC　資料庫，傳回值為連結的代號　ID　值。參數　dsn　為資料來源名稱　(Data　Sources　Name)。參數　user　及　password　分別為連結的帳號及密碼。參數　cursor_type　通常省略，其值有　SQL_CUR_USE_IF_NEEDED、SQL_CUR_USE_ODBC、SQL_CUR_USE_DRIVER　及　SQL_CUR_DEFAULT　等四種。當使用復雜的資料存取時可能會有類似　"Cannot　open　a　cursor　on　a　stored　procedure　that　has　anything　other　than　a　single　select　statement　in　it"　的錯誤訊息字串，此時若將參數　cursor_type　的值設為　SQL_CUR_USE_ODBC　就可以避開了。

　
　
參考　

odbc_pconnect()　　

　

--------------------------------------------------------------------------------
　函式:odbc_cursor()　
--------------------------------------------------------------------------------
　

ODBC　資料庫連結函式庫

odbc_cursor
取得遊標名。

語法:　string　odbc_cursor(int　result_id);

傳回值:　字串

函式種類:　資料庫功能

　
　
內容說明　

本函式用來取得開啟的　ODBC　資料庫遊標　(cursor)。參數　connection_id　為　ODBC　連結代號　ID　值。傳回值為遊標的名稱字串。

　

--------------------------------------------------------------------------------
　函式:odbc_do()　
--------------------------------------------------------------------------------
　

ODBC　資料庫連結函式庫

odbc_do
執行　SQL　指令。

語法:　int　odbc_do(int　connection_id,　string　query);

傳回值:　整數

函式種類:　資料庫功能

　
　
內容說明　

本函式用來執行　SQL　的　query　指令。參數　connection_id　為　ODBC　連結代號　ID　值。參數　query　則為欲執行的指令。傳回值為　Result　ID　值。

　
　
參考　

odbc_prepare()　　odbc_execute()　　odbc_exec()　　

　

--------------------------------------------------------------------------------
　函式:odbc_exec()　
--------------------------------------------------------------------------------
　

ODBC　資料庫連結函式庫

odbc_exec
執行　SQL　指令。

語法:　int　odbc_exec(int　connection_id,　string　query);

傳回值:　整數

函式種類:　資料庫功能

　
　
內容說明　

本函式用來執行　SQL　的　query　指令。參數connection_id　為　ODBC　連結代號　ID　值。參數　query　則為欲執行的指令。傳回值為　Result　ID　值。

　
　
參考　

odbc_prepare()　　odbc_execute()　　odbc_do()　　

　

--------------------------------------------------------------------------------
　函式:odbc_execute()　
--------------------------------------------------------------------------------
　

ODBC　資料庫連結函式庫

odbc_execute
執行預置　SQL　指令。

語法:　int　odbc_execute(int　result_id,　array　[parameters_array]);

傳回值:　整數

函式種類:　資料庫功能

　
　
內容說明　

本函式用來執行預置在　4.36.20　odbc_prepare()　的　query　指令。參數　result_id　為　ODBC　傳回　ID　值。參數　parameters_array　通常省略。

　
　
使用范例　

這是　tony.wood@revolutionltd.com　(27-May-1999)　所提的范例

$conn=odbc_connect("mydb","","");
$stmt　=　odbc_prepare($conn,　"INSERT　INTO　mytable　(jor_from,　jor_to)　VALUES('$from',　'$to');"　);
if　(!odbc_execute($stmt))　{
　　echo　"錯誤";
}
odbc_close($conn);
?>　

　
　
參考　

odbc_prepare()　　odbc_exec()　　odbc_do()　　

--------------------------------------------------------------------------------
　函式:odbc_fetch_into()　
--------------------------------------------------------------------------------
　

ODBC　資料庫連結函式庫

odbc_fetch_into
取得傳回的指定列。

語法:　int　odbc_fetch_into(int　result_id,　int　[rownumber],　array　result_array);

傳回值:　整數

函式種類:　資料庫功能

　
　
內容說明　

本函式用來取得　Query　的傳回資料列，並放入陣列資料之中。參數　result_id　為　ODBC　傳回　ID　值。參數　rownumber　為指定的取得列　(row)。陣列參數　result_array　為取得列的資料陣列，通常在前面加上　"&"　符號。例如　vbhunt@silverfox.com　所提供的范例　(27-Sep-1998)

$cols　=　odbc_fetch_into($QueryID,　$RowNum,　&$YourArray);

　

--------------------------------------------------------------------------------
　函式:odbc_fetch_row()　
--------------------------------------------------------------------------------
　

ODBC　資料庫連結函式庫

odbc_fetch_row
取得傳回一列。

語法:　int　odbc_fetch_row(int　result_id,　int　[row_number]);

傳回值:　整數

函式種類:　資料庫功能

　
　
內容說明　

本函式用來取得　Query　的傳回資料的一列。參數　result_id　為　ODBC　傳回　ID　值。參數　rownumber　可省略，為指定的取得列　(row)。

　
　
使用范例　

$conn　=　odbc_connect("WebDB",　"",　"");
$query　=　"select　user,　idno　";
$query　.=　"from　userinfo";
$result_id　=　odbc_do($conn,　$query);
while(odbc_fatch_row($result_id))　{
　　$user　=　odbc_result($result_id,　1);
　　$idno　=　odbc_result($result_id,　2);
　　echo　$user."的身份証字號為".$idno."
\n";
}
odbc_close($conn);
?>　

--------------------------------------------------------------------------------
　函式:odbc_field_name()　
--------------------------------------------------------------------------------
　

ODBC　資料庫連結函式庫

odbc_field_name
取得欄位名稱。

語法:　string　odbc_fieldname(int　result_id,　int　field_number);

傳回值:　字串

函式種類:　資料庫功能

　
　
內容說明　

本函式用來取得　Query　的傳回資料的欄位名稱。參數　result_id　為　ODBC　傳回　ID　值。參數　field_number　為指定的欄位，起始值為　1。

　

--------------------------------------------------------------------------------
　函式:odbc_field_type()　
--------------------------------------------------------------------------------
　

ODBC　資料庫連結函式庫

odbc_field_type
取得欄位資料形態。

語法:　string　odbc_field_type(int　result_id,　int　field_number);

傳回值:　字串

函式種類:　資料庫功能

　
　
內容說明　

本函式用來取得　Query　的傳回資料的欄位資料形態。參數　result_id　為　ODBC　傳回　ID　值。參數　field_number　為指定的欄位，起始值為　1。
　

--------------------------------------------------------------------------------
　函式:odbc_field_len()　
--------------------------------------------------------------------------------
　

ODBC　資料庫連結函式庫

odbc_field_len
取得欄位資料長度。

語法:　int　odbc_field_len(int　result_id,　int　field_number);

傳回值:　整數

函式種類:　資料庫功能

　
　
內容說明　

本函式用來取得　Query　的傳回資料的欄位資料長度。參數　result_id　為　ODBC　傳回　ID　值。參數　field_number　為指定的欄位，起始值為　1。
　

--------------------------------------------------------------------------------
　函式:odbc_free_result()　
--------------------------------------------------------------------------------
　

ODBC　資料庫連結函式庫

odbc_free_result
釋出傳回資料的記憶體。

語法:　int　odbc_free_result(int　result_id);

傳回值:　整數

函式種類:　資料庫功能

　
　
內容說明　

本函式可用來釋出傳回資料所使用的記憶體，通常在系統記憶體資源不足的情形下才需要使用。參數　result_id　為　ODBC　傳回　ID　值。傳回值永遠都是　true。

　

--------------------------------------------------------------------------------
　函式:odbc_longreadlen()　
--------------------------------------------------------------------------------
　

ODBC　資料庫連結函式庫

odbc_longreadlen
設定傳回欄的最大值。

語法:　int　odbc_longreadlen(int　result_id,　int　length);

傳回值:　整數

函式種類:　資料庫功能

　
　
內容說明　

本函式用來設定傳回資料欄的最大資料值。參數　result_id　為　ODBC　傳回　ID　值。參數　length　即為欲設定的長度值，本參數若設為　0，表示不限長度。

　

--------------------------------------------------------------------------------
　函式:odbc_num_fields()　
--------------------------------------------------------------------------------
　

ODBC　資料庫連結函式庫

odbc_num_fields
取得欄位數目。

語法:　int　odbc_num_fields(int　result_id);

傳回值:　整數

函式種類:　資料庫功能

　
　
內容說明　

本函式用來取得傳回資料的欄位數目。參數　result_id　為　ODBC　傳回　ID　值。若發生錯誤則傳回　-1。

　

--------------------------------------------------------------------------------
　函式:odbc_pconnect()　
--------------------------------------------------------------------------------
　

ODBC　資料庫連結函式庫

odbc_pconnect
長期連結至　ODBC　資料庫。

語法:　int　odbc_pconnect(string　dsn,　string　user,　string　password,　int　[cursor_type]);

傳回值:　整數

函式種類:　資料庫功能

　
　
內容說明　

本函式用來保持長期連結連結到　ODBC　資料庫，即使　PHP　程式結束，連結仍然存在，傳回值為連結的代號　ID　值。這對連結負責很重的系統可以加快連結的速度。參數　dsn　為資料來源名稱　(Data　Sources　Name)。參數　user　及　password　分別為連結的帳號及密碼。參數　cursor_type　通常省略。

　
　
參考　

odbc_connect()　　

　

--------------------------------------------------------------------------------
　函式:odbc_prepare()　
--------------------------------------------------------------------------------
　

ODBC　資料庫連結函式庫

odbc_prepare
預置　SQL　指令。

語法:　int　odbc_prepare(int　connection_id,　string　query_string);

傳回值:　整數

函式種類:　資料庫功能

　
　
內容說明　

本函式用來設定　SQL　query　指令。參數　result_id　為　ODBC　傳回　ID　值。參數　query_string　即為預設的指令。

　
　
參考　

odbc_execute()　　

　

--------------------------------------------------------------------------------
　函式:odbc_num_rows()　
--------------------------------------------------------------------------------
　

ODBC　資料庫連結函式庫

odbc_num_rows
取得傳回列數目。

語法:　int　odbc_num_rows(int　result_id);

傳回值:　整數

函式種類:　資料庫功能

　
　
內容說明　

本函式用來取得傳回列的數目。參數　result_id　為　ODBC　傳回　ID　值。若有錯誤發生則傳回　-1。

　

--------------------------------------------------------------------------------
　函式:odbc_result()　
--------------------------------------------------------------------------------
　

ODBC　資料庫連結函式庫

odbc_result
取得傳回資料。

語法:　string　odbc_result(int　result_id,　mixed　field);

傳回值:　字串

函式種類:　資料庫功能

　
　
內容說明　

本函式用來取得傳回的資料。參數　result_id　為　ODBC　傳回　ID　值。參數　field　可以是數字形態，代表指定的欄位序號　(從　1　開始)；亦可以是字串形態，為指定的欄位名稱。

　

--------------------------------------------------------------------------------
　函式:odbc_result_all()　
--------------------------------------------------------------------------------
　

ODBC　資料庫連結函式庫

odbc_result_all
傳回　HTML　表格資料。

語法:　int　odbc_result_all(int　result_id,　string　[format]);

傳回值:　整數

函式種類:　資料庫功能

　
　
內容說明　

本函式用來將取得的資料轉成　HTML　的表格　(table)　格式。參數　result_id　為　ODBC　傳回　ID　值。參數　format　可省略，為表格的特殊設定值。傳回值為資料列數。

　
　
使用范例　

$conn　=　odbc_connect("WebDB",　"",　"");
$query　=　"select　item,　price　";
$query　.=　"from　userinfo";
$result_id　=　odbc_do($conn,　$query);
odbc_result_all($result_id,　"border=1　width=50%");
odbc_close($conn);
?>　

　

--------------------------------------------------------------------------------
　函式:odbc_rollback()　
--------------------------------------------------------------------------------
　

ODBC　資料庫連結函式庫

odbc_rollback
撤消當前交易。

語法:　int　odbc_rollback(int　connection_id);

傳回值:　整數

函式種類:　資料庫功能

　
　
內容說明　

本函式取消　ODBC　交易處理　(transaction)　對資料庫所做的修改。若成功則傳回　true，反之傳回　false。

　

--------------------------------------------------------------------------------
　函式:odbc_setoption()　
--------------------------------------------------------------------------------
　

ODBC　資料庫連結函式庫

odbc_setoption
調整　ODBC　設定。

語法:　int　odbc_setoption(int　id,　int　function,　int　option,　int　param);

傳回值:　整數

函式種類:　資料庫功能

　
　
內容說明　

本函式用來調整　ODBC　的設定值。參數　id　不一定指　connection_id，SQLSetConnectOption()　則為　connection_id；若為　SQLSetStmtOption()　則為　result_id。參數　function　值為　1　表　SQLSetConnectOption()；若為　2　則為　SQLSetStmtOption()。參數　option　為設定的選項。參數　param　為設定值。

　
　
使用范例　

//　例一:　設定為　autocommit，即與　odbc_autocommit($conn,　true)　相同。
//　　　　　　　第三個參數值　102　表　SQL_AUTOCOMMIT。
//　　　　　　　第四個參數值　1　表　SQL_AUTOCOMMIT_ON。
odbc_setoption　($conn,　1,　102,　1);
//　例二:　設定查詢時間
//　　　　　　　第三個參數　0　表　SQL_QUERY_TIMEOUT
//　　　　　　　第四個參數為最久執行時間，本例設為　30　秒
$result　=　odbc_prepare　($conn,　$sql);
odbc_setoption　($result,　2,　0,　30);
odbc_execute　($result);
?>　
(http://www.fanqiang.com) 進入【UNIX論壇】

===更多相關===

★ 樊強制作歡迎分享 ★