Documentación offline PHP master

PDOStatement::rowCount

master Ver versión oficial en línea Licencia CC-BY-3.0Descargado el 2026-08-02

En esta página

PDOStatement::rowCount

Devuelve el número de filas afectadas por la última llamada a la función PDOStatement::execute()

Descripción#

public PDOStatement::rowCount(): int
```php

PDOStatement::rowCount devuelve el número de filas afectadas por la última consulta DELETE, INSERT o UPDATE ejecutada por el objeto `PDOStatement` correspondiente.

Si la última consulta SQL ejecutada por el objeto `PDOStatement` asociado es una consulta de tipo SELECT, algunas bases de datos devolverán el número de filas devueltas por dicha consulta. No obstante, este comportamiento no está garantizado para todas las bases de datos y no debería ser utilizado para aplicaciones portables.

> [!NOTE]
> Este método siempre devuelve "0" (cero) con el controlador PostgreSQL, cuando el atributo de declaración `PDO::ATTR_CURSOR` está definido como `PDO::CURSOR_SCROLL`.

## Parámetros

Esta función no contiene ningún parámetro.

## Valores devueltos

Devuelve el número de filas.

## Errores/Excepciones

Emite un error de nivel `E_WARNING` si el atributo `PDO::ATTR_ERRMODE` está definido a `PDO::ERRMODE_WARNING`.

Lanza una excepción `PDOException` si el atributo `PDO::ATTR_ERRMODE` está definido a `PDO::ERRMODE_EXCEPTION`.

## Ejemplos

Devuelve el número de filas eliminadas

PDOStatement::rowCount devuelve el número de filas afectadas por una consulta DELETE, INSERT, o UPDATE.
prepare('DELETE FROM fruit'); $del->execute(); /* Devuelve el número de filas eliminadas */ print "Devuelve el número de filas eliminadas :\n"; $count = $del->rowCount(); print "Eliminación de $count filas.\n"; ?>
Resultado del ejemplo anterior es similar a:


    Devuelve el número de filas eliminadas :
    Eliminación de 9 filas.

Conteo de filas devueltas por una consulta SELECT

Para la mayoría de las bases de datos, PDOStatement::rowCount no devuelve el número de filas afectadas por una consulta SELECT. En su lugar, utilice PDO::query para hacer una consulta SELECT COUNT(\*), luego utilice PDOStatement::fetchColumn para recuperar el número de filas correspondientes.
100"; $res = $conn->query($sql); $count = $res->fetchColumn(); print "Hay " . $count . " fila(s) correspondiente(s)."; ?>

```php

Resultado del ejemplo anterior es similar a:

Hay  2 fila(s) correspondiente(s).

Véase también#

PDOStatement::columnCount, PDOStatement::fetchColumn, PDO::query