Documentación offline PHP master

pg_transaction_status

master Documentación oficial Licencia CC-BY-3.0Descargado el 2026-08-02

En esta página

pg_transaction_status

Retorna el estado de la transacción en curso del servidor

Descripción#

pg_transaction_status(PgSql\Connection $connection): int
```php

Retorna el estado de la transacción en curso del servidor.

> [!CAUTION]
> `pg_transaction_status` proporcionará resultados incorrectos cuando se utilice con un servidor PostgreSQL 7.3 que tenga el parámetro `autocommit` desactivado. La funcionalidad de autocommit está obsoleta y ya no existe en las versiones más recientes del servidor.

## Parámetros

`connection`  
Una instancia `PgSql\Connection`.

## Valores devueltos

El estado puede ser `PGSQL_TRANSACTION_IDLE` (actualmente inactivo), `PGSQL_TRANSACTION_ACTIVE` (una orden está en curso), `PGSQL_TRANSACTION_INTRANS` (inactivo, dentro de un bloque de transacción válido), o `PGSQL_TRANSACTION_INERROR` (inactivo, dentro de un bloque de transacción fallido). `PGSQL_TRANSACTION_UNKNOWN` se retorna si la conexión es incorrecta. `PGSQL_TRANSACTION_ACTIVE` se retorna solo si la consulta ha sido enviada al servidor y esta aún no ha sido completada.

## Historial de cambios

| Versión | Descripción |
|----|----|
| 8.1.0 | El parámetro `connection` ahora espera una instancia de `PgSql\Connection` ; anteriormente, se esperaba un `resource`. |

## Ejemplos

Ejemplo con `pg_transaction_status`

```php