函式名稱:oci_pconnect()
適用版本:PHP 4 >= 4.0.1, PHP 5, PHP 7, PHP 8
函式描述:oci_pconnect() 函式用於建立一個持久的連線到 Oracle 資料庫。
語法:resource oci_pconnect(string $username, string $password, ?string $connection_string = null, ?string $character_set = null, ?int $session_mode = null)
引數:
- $username: Oracle 使用者名稱。
- $password: Oracle 密碼。
- $connection_string (可選): Oracle 連線字串,用於指定要連線的 Oracle 資料庫和其他連線選項。如果未提供,將使用預設的連線選項。
- $character_set (可選): 字符集名稱,用於指定連線的字符集。如果未提供,將使用預設的字符集。
- $session_mode (可選): 會話模式,用於指定連線的模式。如果未提供,將使用預設的會話模式。
返回值:成功時返回一個表示 Oracle 連線的資源識別符號,失敗時返回 false。
示例:
$conn = oci_pconnect('username', 'password', 'localhost/XE');
if (!$conn) {
$e = oci_error();
trigger_error(htmlentities($e['message'], ENT_QUOTES), E_USER_ERROR);
}
// 執行 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);
以上示例演示了使用 oci_pconnect() 函式建立一個持久的 Oracle 連線,並執行一條查詢語句,然後遍歷結果集並輸出每個員工的姓名。最後,釋放語句和關閉連線。
請注意,示例中的連線字串 'localhost/XE' 是一個示例,實際應根據實際情況修改為正確的連線字串。