pg_set_error_verbosity

(PHP 5 >= 5.1.0, PHP 7, PHP 8)

pg_set_error_verbosity — Determina o detalhamento das mensagens retornadas por pg_last_error() e pg_result_error()

Descrição

pg_set_error_verbosity(PgSql\Connection $connection = ?, int $verbosity): int

Determina o detalhamento das mensagens retornadas por pg_last_error() e pg_result_error().

pg_set_error_verbosity() define o modo de verbosidade, retornando a configuração anterior da conexão. No modo PGSQL_ERRORS_TERSE, as mensagens retornadas incluem apenas severidade, texto primário e posição; isso normalmente caberá em uma única linha. O modo padrão (PGSQL_ERRORS_DEFAULT) produz mensagens que incluem o acima, além de quaisquer detalhes, dicas ou campos de contexto (estes podem abranger várias linhas). O modo PGSQL_ERRORS_VERBOSE inclui todos os campos disponíveis. A alteração do detalhamento não afeta as mensagens disponíveis nos objetos de resultado já existentes, apenas nos criados posteriormente.

Parâmetros

connection

Uma instância de PgSql\Connection. Quando o parâmetro connection não for especificado, 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.

verbosity

A verbosidade necessária: PGSQL_ERRORS_TERSE, PGSQL_ERRORS_DEFAULT ou PGSQL_ERRORS_VERBOSE.

Valor Retornado

O nível de verbosidade anterior: PGSQL_ERRORS_TERSE, PGSQL_ERRORS_DEFAULT ou PGSQL_ERRORS_VERBOSE.

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.

Exemplos

Example #1 Exemplo de pg_set_error_verbosity()

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

  if (!pg_connection_busy($dbconn)) {
      pg_send_query($dbconn, "select * from doesnotexist;");
  }

  pg_set_error_verbosity($dbconn, PGSQL_ERRORS_VERBOSE);
  $res1 = pg_get_result($dbconn);
  echo pg_result_error($res1);
?>

Veja Também