PDOStatement::rowCount

PHP PDO 参考手册Manuel de référence PHP PDO

PDOStatement::rowCount — Renvoie le nombre de lignes affectées par la dernière instruction SQL (PHP 5 >= 5.1.0, PECL pdo >= 0.1.0)


Description

Syntaxe

int PDOStatement::rowCount ( void )

PDOStatement::rowCount() renvoie le nombre de lignes affectées par la dernière instruction DELETE, INSERT ou UPDATE exécutée par l'objet PDOStatement correspondant.

Si la dernière instruction SQL exécutée par le PDOStatement associé était une instruction SELECT, certaines bases de données peuvent renvoyer le nombre de lignes renvoyées par cette instruction. Toutefois, ce comportement n'est pas garanti pour toutes les bases de données et il ne faut pas s'y fier pour des applications portables.


Valeurs de retour

Renvoie le nombre de lignes.


Exemples

Renvoie le nombre de lignes supprimées

PDOStatement::rowCount() renvoie le nombre de lignes affectées par une instruction DELETE, INSERT ou UPDATE.

<?php
/*  从 FRUIT 数据表中删除所有行 */
$del = $dbh->prepare('DELETE FROM fruit');
$del->execute();

/*  返回被删除的行数 */
print("Return number of rows that were deleted:\n");
$count = $del->rowCount();
print("Deleted $count rows.\n");
?>

L'exemple ci-dessus produit :

Return number of rows that were deleted:
Deleted 9 rows.

Calculer le nombre de lignes renvoyées par une instruction SELECT

Pour la plupart des bases de données, PDOStatement::rowCount() ne renvoie pas le nombre de lignes affectées par une instruction SELECT. À la place, utilisez PDO::query() pour émettre une instruction SELECT COUNT(*) avec les mêmes conditions que l'instruction SELECT prévue, puis utilisez PDOStatement::fetchColumn() pour récupérer la ligne suivante. Cela permet à l'application de fonctionner correctement.

<?php
$sql = "SELECT COUNT(*) FROM fruit WHERE calories > 100";
if ($res = $conn->query($sql)) {

    /* 检查符合 SELECT 语句的行数 */
  if ($res->fetchColumn() > 0) {

        /* 发出一条真正的 SELECT 语句并操作返回的结果 */
         $sql = "SELECT name FROM fruit WHERE calories > 100";
       foreach ($conn->query($sql) as $row) {
           print "Name: " .  $row['NAME'] . "\n";
         }
    }
    /* 没有匹配的行 -- 执行其他 */
  else {
      print "No rows matched the query.";
    }
}

$res = null;
$conn = null;
?>

L'exemple ci-dessus produit :

apple
banana
orange
pear

PHP PDO 参考手册Manuel de référence PHP PDO

Autres extensions