pg_last_error

(PHP 4 >= 4.2.0, PHP 5, PHP 7, PHP 8)

pg_last_error — Obtém a última string da mensagem de erro de uma conexão

Descrição

pg_last_error(?PgSql\Connection $connection = null): string

pg_last_error() retorna a última mensagem de erro para uma determinada connection.

As mensagens de erro podem ser substituídas por chamadas de função internas do PostgreSQL (libpq). Pode não retornar uma mensagem de erro apropriada se ocorrerem vários erros dentro de uma função do módulo PostgreSQL.

Use pg_result_error(), pg_result_error_field(), pg_result_status() e pg_connection_status() para melhor tratamento de erros.

Note:

Esta função costumava ser chamada de pg_errormessage().

Parâmetros

connection

Uma instância de PgSql\Connection. Quando o parâmetro connection for null, a conexão padrão será usada. A conexão padrão é a última conexão feita por pg_connect() ou pg_pconnect().

Warning

A partir do PHP 8.1.0, usar a conexão padrão tornou-se defasado.

Valor Retornado

Uma string contendo a última mensagem de erro na connection fornecida.

Registro de Alterações

Versão Descrição
8.1.0 O parâmetro connection agora espera uma instância de PgSql\Connection; anteriormente, um resource era esperado.
8.0.0 connection agora é anulável.

Exemplos

Example #1 Exemplo de pg_last_error()

<?php
  $dbconn = pg_connect("dbname=publisher") or die("Não foi possível conectar");

  // Consulta que falha
  $res = pg_query($dbconn, "select * from doesnotexist");

  echo pg_last_error($dbconn);
?>

Veja Também