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

# 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

function 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.

> Nota:

> 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().

  Aviso

  A partir do PHP 8.1.0, usar a conexão padrão foi descontinuado.

### 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

Exemplo #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

- pg_result_error() - Obtém mensagem de erro associada ao resultado
- pg_result_error_field() - Retorna um campo individual de um relatório de erros

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open