PHP 8.0.6 Released!


(PHP 5 >= 5.1.0, PHP 7, PHP 8, PECL pdo >= 0.2.0)

PDO::query SQL ステートメントを実行し、結果セットを PDOStatement オブジェクトとして返す


public PDO::query ( string $query , int|null $fetchMode = null ) : PDOStatement|false
public PDO::query ( string $query , int|null $fetchMode = PDO::FETCH_COLUMN , int $colno ) : PDOStatement|false
public PDO::query ( string $query , int|null $fetchMode = PDO::FETCH_CLASS , string $classname , array $constructorArgs ) : PDOStatement|false
public PDO::query ( string $query , int|null $fetchMode = PDO::FETCH_INTO , object $object ) : PDOStatement|false

PDO::query() は、一回の関数コールの中で SQL ステートメントを実行し、このステートメントにより返された 結果セット (ある場合) を PDOStatement オブジェクトとして返します。

複数回発行する必要があるステートメントの場合、 PDO::prepare() で PDOStatement ステートメントを準備し、 PDOStatement::execute() でそのステートメントを 複数回発行する方がより良いパフォーマンスを得られると実感するでしょう。

PDO::query() を次にコールする前に 結果セット内の全てのデータを取得しない場合、そのコールは失敗します。 PDOStatement::closeCursor() をコールし、 次に PDO::query() をコールする前に PDOStatement オブジェクトに関連付けられたリソースを解放してください。


ひとつ以上の引数をこの関数に渡すと、 ふたつめ以降の引数は、 返されるステートメントオブジェクトに対して PDOStatement::setFetchMode() をコールするのと同じような扱いになります。



準備、発行する SQL ステートメント。

クエリ内のデータは 適切にエスケープ する必要があります。


PDO::query() は、PDOStatement オブジェクトを返します。 失敗した場合は false を返します。

例1 PDO::query の例

PDO::query() の優れた機能は、 実行に成功したSELECTステートメントにより返されたレコードセットで 反復処理が可能であることです。

'SELECT name, color, calories FROM fruit ORDER BY name';
foreach (
$conn->query($sql) as $row) {
$row['name'] . "\t";
$row['color'] . "\t";
$row['calories'] . "\n";


apple   red     150
banana  yellow  250
kiwi    brown   75
lemon   yellow  25
orange  orange  300
pear    green   150
watermelon      pink    90


  • PDO::exec() - SQL ステートメントを実行し、作用した行数を返す
  • PDO::prepare() - 文を実行する準備を行い、文オブジェクトを返す
  • PDOStatement::execute() - プリペアドステートメントを実行する

add a note add a note

User Contributed Notes 7 notes

fredrik at NOSPAM dot rambris dot com
14 years ago
The handling of errors by this function is controlled by the attribute PDO::ATTR_ERRMODE.

Use the following to make it throw an exception:
dozoyousan at gmail dot com
15 years ago
> When query() fails, the boolean false is returned.

I think that is "Silent Mode".
If that set attribute ErrorMode "Exception Mode"
then that throw PDOException.
$pdoObj = new PDO( $dsn, $user, $pass );
marcos at marcosregis dot com
12 years ago
After a lot of hours working with DataLink on Oracle->MySQL and PDO we (me and Adriano Rodrigues, that solve it) discover that PDO (and oci too) need the attribute AUTOCOMMIT set to FALSE to work correctly with.
There's  3 ways to set autocommit to false: On constructor, setting the atribute after construct and before query data or initiating a Transaction (that turns off autocommit mode)

The examples:
// First way - On PDO Constructor
$options = array(PDO::ATTR_AUTOCOMMIT=>FALSE);

$pdo = new PDO($dsn,$user,$pass,$options);

// now we are ready to query DataLinks


// Second Way - Before create statements
$pdo = new PDO($dsn,$user,$pass);

// or

// now we are ready to query DataLinks

To use DataLinks on oci just use OCI_DEFAULT on oci_execute() function;
stefano[dot]bertoli [at] gmail[dot]com
6 years ago
Trying to pass like second argument PDO::FETCH_ASSOC it still work.

So passing FETCH TYPE like argument seems work.

This save you from something like:

= $stmt->setFetchMode(PDO::FETCH_NUM);

= $db->query('SELECT * FROM `mytable` WHERE true', PDO::FETCH_ASSOC);

Ilyas Bakirov
1 month ago
I would like to mention fetching rows from SQL query using PDO:


= new PDO('mysql:host=localhost;dbname=test', $user, $pass);

// use the connection here
$sth = $dbh->query('SELECT * FROM countries');

// fetch all rows into array, by default PDO::FETCH_BOTH is used
$rows = $stm->fetchAll();

// iterate over array by index and by name
foreach($rows as $row) {

printf("$row[0] $row[1] $row[2]\n");
printf("$row['id'] $row['name'] $row['population']\n");

andrea at bhweb dot it
12 years ago
If someone is suffering of the "MySQL server has gone away" problem after executing multiple queries, this is a solution that solved it for me. It's similar to the one needed for the exact same problem in mysqli.

do {
$stmt->fetch(); $stmt->closeCursor(); ++$line; } while($stmt-

I found this only works using prepare and execute this way, not if you
directly execute the query with query().
1 year ago
The Documentation doesn’t mention this, but you can use a fetch style as a second parameter. For example:

$data as $row) {
//    etc
To Top