cubrid_query()函式—用法及示例

函式名：cubrid_query()

適用版本：CUBRID 8.3.0+

用法：cubrid_query() 函式用於在 CUBRID 資料庫上執行 SQL 查詢。

語法：

cubrid_query ( resource $conn_identifier , string $query [, bool $async_mode = false ] ) : resource|false

引數：

• $conn_identifier：連線識別符號，使用 cubrid_connect() 或者 cubrid_connect_with_url() 函式返回的 CUBRID 連線資源。
• $query：要執行的 SQL 查詢語句。
• $async_mode（可選）：非同步模式標誌，表示查詢是否以非同步模式執行，預設為 false。

返回值：

• 如果查詢成功，返回一個結果集資源，該資源可用於獲取查詢結果。
• 如果查詢失敗，返回 false。

示例：

// 建立與 CUBRID 資料庫的連線
$conn = cubrid_connect('localhost', 33000, 'testdb', 'username', 'password');

// 檢查連線是否成功
if (!$conn) {
    die('連線失敗: ' . cubrid_error_msg());
}

// 執行查詢
$result = cubrid_query($conn, 'SELECT * FROM customers');

// 檢查查詢是否執行成功
if ($result) {
    // 獲取查詢結果
    while ($row = cubrid_fetch_assoc($result)) {
        echo $row['id'] . ' - ' . $row['name'] . '<br>';
    }

    // 釋放結果集資源
    cubrid_free_result($result);

} else {
    die('查詢失敗: ' . cubrid_error($conn));
}

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

注意事項：

• 在使用前，必須先透過 cubrid_connect() 或者 cubrid_connect_with_url() 函式建立與 CUBRID 資料庫的連線。
• 必須呼叫 cubrid_free_result() 函式釋放結果集資源，以避免記憶體洩漏。
• 可以使用 cubrid_num_rows() 函式獲取結果集中的行數。
• 可以使用 cubrid_affected_rows() 函式獲取最近一次執行的 INSERT、UPDATE 或 DELETE 語句所影響的行數。
• 如果需要執行多條 SQL 查詢，建議使用 cubrid_execute() 函式，該函式支援執行多條 SQL 查詢的批次操作。