ocinlogon()函式—用法及示例

函式名稱：ocinlogon()

適用版本：PHP 4 >= 4.0.7, PHP 5, PHP 7, PHP 8

函式描述：ocinlogon() 函式用於在 Oracle 資料庫上建立一個連線，該連線將用於執行後續的資料庫操作。

語法：resource ocinlogon(string $username, string $password [, string $connection_string [, string $character_set [, int $session_mode]]])

引數：

• $username：連線 Oracle 資料庫所需的使用者名稱。
• $password：連線 Oracle 資料庫所需的密碼。
• $connection_string（可選）：連線到資料庫的字串。如果未提供，則將使用預設的連線字串。
• $character_set（可選）：指定連線使用的字符集。
• $session_mode（可選）：指定會話模式。

返回值：返回一個連線識別符號（resource），該識別符號用於後續的資料庫操作。

示例：

// 連線到 Oracle 資料庫
$conn = ocinlogon("my_username", "my_password", "my_connection_string", "UTF8", OCI_DEFAULT);

if (!$conn) {
    $error = oci_error();
    die("連線失敗: " . $error['message']);
}

// 執行查詢
$sql = "SELECT * FROM my_table";
$stmt = oci_parse($conn, $sql);
oci_execute($stmt);

// 獲取查詢結果
while ($row = oci_fetch_assoc($stmt)) {
    echo $row['COLUMN_NAME'] . "<br>";
}

// 關閉連線
oci_close($conn);

注意事項：

1. 需要安裝 Oracle 擴充套件才能使用該函式。在 PHP 7.0.0 版本之後，Oracle 擴充套件已經成為一個 PECL 擴充套件，需要手動安裝。
2. 如果連線失敗，可以使用 oci_error() 函式獲取錯誤資訊。
3. 在執行完資料庫操作後，應該使用 oci_close() 函式關閉連線，以釋放資源和避免連線洩漏。