ocilogon()函式—用法及示例

函式名稱：ocilogon()

適用版本：PHP 4, PHP 5, PHP 7

函式描述：ocilogon()函式用於開啟一個Oracle資料庫連線，並返回一個連線識別符號。

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

引數：

• $username：連線Oracle資料庫所需的使用者名稱。
• $password：連線Oracle資料庫所需的密碼。
• $connection_string：連線Oracle資料庫所需的連線字串，格式為：[//]host[:port][/service_name].
• $character_set（可選）：指定字符集，用於設定客戶端和資料庫之間的字元編碼，預設為資料庫的字符集。
• $session_mode（可選）：指定會話模式，可以是OCI_DEFAULT、OCI_SYSOPER或OCI_SYSDBA，預設為OCI_DEFAULT。

返回值：成功時返回一個Oracle連線識別符號（resource），失敗時返回false。

示例：

// 連線Oracle資料庫
$conn = ocilogon('username', 'password', 'localhost/XE');

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

// 執行SQL查詢
$sql = 'SELECT * FROM employees';
$stmt = oci_parse($conn, $sql);
oci_execute($stmt);

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

// 關閉資料庫連線
oci_free_statement($stmt);
oci_close($conn);

注意事項：

1. 在使用ocilogon()函式之前，需要確保已經安裝了Oracle客戶端，並且在PHP配置檔案中啟用了OCI8擴充套件。
2. 連線字串中的host可以是IP地址或主機名，port為可選項，預設為1521。
3. 如果需要使用特殊字符集，可以透過$character_set引數指定，例如：'UTF8'。
4. $session_mode引數可用於指定特殊的會話模式，一般情況下使用OCI_DEFAULT即可。
5. 在使用完資料庫連線後，需要手動關閉連線，以釋放資源。