PHP Conference Japan 2024

ibase_connect

(PHP 5, PHP 7 < 7.4.0)

ibase_connect開啟與資料庫的連線

說明

ibase_connect(
    字串 $database = ?,
    字串 $username = ?,
    字串 $password = ?,
    字串 $charset = ?,
    整數 (int) $buffers = ?,
    整數 (int) $dialect = ?,
    字串 (string) $role = ?,
    整數 (int) $sync = ?
): 資源 (resource)

建立與 Firebird/InterBase 伺服器的連線。

如果使用相同的參數再次呼叫 ibase_connect(),則不會建立新的連結,而是會傳回已開啟連結的連結識別碼。 指向伺服器的連結將在腳本執行結束後關閉,除非透過明確呼叫 ibase_close() 關閉。

參數

database (資料庫)

database 參數必須是伺服器上資料庫檔案的有效路徑。 如果伺服器不是本機的,則必須根據使用的連線協定,在其前面加上 'hostname:' (TCP/IP)、'hostname/port:' (使用自訂 TCP 連接埠的 Interbase 伺服器之 TCP/IP) 或 '//hostname/' (NetBEUI)。

username (使用者名稱)

使用者名稱。 可以使用 php.ini 中的 ibase.default_user 指令設定。

password (密碼)

username 的密碼。 可以使用 php.ini 中的 ibase.default_password 指令設定。

charset (字元集)

charset 是資料庫的預設字元集。

buffers (緩衝區)

buffers 是要為伺服器端快取配置的資料庫緩衝區數量。 如果為 0 或省略,則伺服器會選擇其自身的預設值。

dialect (方言)

dialect 會選擇在連線中執行的任何陳述式的預設 SQL 方言,其預設值為用戶端程式庫支援的最高版本。

role (角色)

僅適用於 InterBase 5 和更高版本。

sync (同步)

回傳值

成功時傳回 Firebird/InterBase 連結識別碼,錯誤時傳回 false

錯誤/例外

如果在使用此函式以及在使用 ibase_query() 之後,您收到類似「算術例外、數值溢位或字串截斷。 無法在字元集之間轉碼字元」(當您嘗試使用帶有重音符號的字元時會發生這種情況)的錯誤訊息,則必須設定字元集(例如 ISO8859_1 或您目前的字元集)。

範例

範例 #1 ibase_connect() 範例

<?php
$host
= 'localhost:/path/to/your.gdb';

$dbh = ibase_connect($host, $username, $password);
$stmt = 'SELECT * FROM tblname';
$sth = ibase_query($dbh, $stmt);
while (
$row = ibase_fetch_object($sth)) {
echo
$row->email, "\n";
}
ibase_free_result($sth);
ibase_close($dbh);
?>

另請參閱

新增註記

使用者貢獻的註記

此頁面沒有使用者貢獻的註記。
To Top