PDO::query

發行項
06/02/2023

執行 SQL 查詢並以 PDOStatement 物件形式傳回結果集。

語法

  
PDOStatement PDO::query ($statement[, $fetch_style);

參數

$statement：您要執行的 SQL 陳述式。

$fetch_style：有關如何執行查詢的選擇性指示。如需詳細資訊，請參閱＜備註＞一節。可以使用 PDO::fetch 中的 $fetch_style 覆寫 PDO::query 中的 $fetch_style。

傳回值

如果呼叫成功，PDO::query 會傳回 PDOStatement 物件。如果呼叫失敗，PDO::query 會擲回 PDOException 物件或傳回 false (視 PDO::ATTR_ERRMODE 的設定而定)。

例外狀況

PDOException。

備註

使用 PDO::query 執行的查詢可以執行已備妥的陳述式或直接執行 (視 PDO::SQLSRV_ATTR_DIRECT_QUERY 的設定而定)。如需詳細資訊，請參閱 PDO_SQLSRV 驅動程式中的直接陳述式執行和已備妥的陳述式執行。

PDO::SQLSRV_ATTR_QUERY_TIMEOUT 也會影響 PDO::exec 的行為；如需詳細資訊，請參閱 PDO::setAttribute。

您可以為 $fetch_style 指定下列選項。

樣式	描述
PDO::FETCH_COLUMN, num	指定的資料行中資料的查詢。資料表中的第一個資料行是資料行 0。
PDO::FETCH_CLASS, 'classname', array( arglist )	建立類別執行個體並將資料行名稱指派給類別中的屬性。如果類別建構函式採用一或多個參數，您也可以傳遞 arglist。
PDO::FETCH_CLASS, 'classname'	將資料行名稱指派給現有類別中的屬性。

呼叫 PDOStatement::closeCursor，以便於再次呼叫 PDO::query 之前，釋放與 PDOStatement 物件相關聯的資料庫資源。

將 PDOStatement 物件設定為 null，即可關閉該物件。

如果未擷取結果中的所有資料，則下一次 PDO::query 呼叫不會失敗。

PDO 支援已新增至 Microsoft Drivers for PHP for SQL Server 2.0 版。

查詢範例

此範例顯示數個查詢。

<?php  
$database = "AdventureWorks";  
$conn = new PDO( "sqlsrv:server=(local) ; Database = $database", "", "");  
$conn->setAttribute( PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION );  
$conn->setAttribute( PDO::SQLSRV_ATTR_QUERY_TIMEOUT, 1 );  
  
$query = 'select * from Person.ContactType';  
  
// simple query  
$stmt = $conn->query( $query );  
while ( $row = $stmt->fetch( PDO::FETCH_ASSOC ) ){  
   print_r( $row['Name'] ."\n" );  
}  
  
echo "\n........ query for a column ............\n";  
  
// query for one column  
$stmt = $conn->query( $query, PDO::FETCH_COLUMN, 1 );  
while ( $row = $stmt->fetch() ){  
   echo "$row\n";  
}  
  
echo "\n........ query with a new class ............\n";  
$query = 'select * from HumanResources.Department order by GroupName';  
// query with a class  
class cc {  
   function __construct( $arg ) {  
      echo "$arg";  
   }  
  
   function __toString() {  
      return $this->DepartmentID . "; " . $this->Name . "; " . $this->GroupName;  
   }  
}  
  
$stmt = $conn->query( $query, PDO::FETCH_CLASS, 'cc', array( "arg1 " ));  
  
while ( $row = $stmt->fetch() ){  
   echo "$row\n";  
}  
  
echo "\n........ query into an existing class ............\n";  
$c_obj = new cc( '' );  
$stmt = $conn->query( $query, PDO::FETCH_INTO, $c_obj );  
while ( $stmt->fetch() ){  
   echo "$c_obj\n";  
}  
  
$stmt = null;  
?>

Sql_variant 範例

此程式碼範例示範如何建立 sql_variant 類型的資料表，並擷取插入的資料。

<?php
$server = 'serverName';
$dbName = 'databaseName';
$uid = 'yourUserName';
$pwd = 'yourPassword';

$conn = new PDO("sqlsrv:server=$server; database = $dbName", $uid, $pwd);
$conn->setAttribute( PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION );  

try {
    $tableName = 'testTable';
    $query = "CREATE TABLE $tableName ([c1_int] sql_variant, [c2_varchar] sql_variant)";

    $stmt = $conn->query($query);
    unset($stmt);

    $query = "INSERT INTO [$tableName] (c1_int, c2_varchar) VALUES (1, 'test_data')";
    $stmt = $conn->query($query);
    unset($stmt);

    $query = "SELECT * FROM $tableName";
    $stmt = $conn->query($query);

    $result = $stmt->fetch(PDO::FETCH_ASSOC);
    print_r($result);
    
    unset($stmt);
    unset($conn);
} catch (Exception $e) {
    echo $e->getMessage();
}
?>

預期的輸出會是：

Array
(
    [c1_int] => 1
    [c2_varchar] => test_data
)

另請參閱

PDO 類別

PDO