(PHP 4 >= 4.0.6, PHP 5, PHP 7, PHP 8)
pg_last_notice — Devuelve la última nota del servidor PostgreSQL
pg_last_notice() devuelve la última nota del
servidor PostgreSQL en la conexión connection
especificada. El servidor PostgreSQL envía notas en varios casos,
por ejemplo al crear una columna SERIAL
en
una tabla.
Con pg_last_notice(), se pueden evitar consultas innecesarias verificando si las notas están o no relacionadas con la transacción.
El seguimiento de las notas puede ser opcional estableciendo a 1
la directiva de configuración pgsql.ignore_notice
del
archivo php.ini.
El registro de las notas puede ser opcional estableciendo la directiva
de configuración pgsql.log_notice
del php.ini a 0.
A menos que pgsql.ignore_notice
esté a 0, las notas
no serán registradas.
connection
Una instancia PgSql\Connection.
mode
Uno de PGSQL_NOTICE_LAST
(para devolver la última nota),
PGSQL_NOTICE_ALL
(para devolver todas las notas),
o PGSQL_NOTICE_CLEAR
(para borrar las notas).
Un string que contiene la última nota en la conexión
connection
con
PGSQL_NOTICE_LAST
,
un array con PGSQL_NOTICE_ALL
,
un booleano con PGSQL_NOTICE_CLEAR
.
Versión | Descripción |
---|---|
8.1.0 |
El parámetro connection ahora espera una instancia de
PgSql\Connection ; anteriormente, se esperaba un resource.
|
7.1.0 |
Se añadió el parámetro mode .
|
Ejemplo #1 Ejemplo con pg_last_notice()
<?php
$pgsql_conn = pg_connect("dbname=mark host=localhost");
$res = pg_query("CREATE TABLE test (id SERIAL)");
$notice = pg_last_notice($pgsql_conn);
echo $notice;
?>
El ejemplo anterior mostrará :
CREATE TABLE will create implicit sequence "test_id_seq" for "serial" column "test.id"