PHP 8.4.0 RC2 available for testing

pg_result_error_field

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

pg_result_error_fieldRetorna um campo individual de um relatório de erros

Descrição

pg_result_error_field(PgSql\Result $result, int $field_code): string|false|null

pg_result_error_field() retorna um dos campos de mensagem de erro detalhados associados à instância de result. Ele está disponível apenas em um servidor PostgreSQL 7.4 ou superior. O campo de erro é especificado pelo field_code.

Porque pg_query() e pg_query_params() retornam false se a consulta falhar, você deverá usar pg_send_query() e pg_get_result() para obter o identificador do resultado.

Se você precisar obter informações adicionais sobre erros de consultas pg_query() com falha, use pg_set_error_verbosity() e pg_last_error() e então analise o resultado.

Valor Retornado

Uma string contendo o conteúdo do campo de erro, null se o campo não existir ou false em caso de falha.

Registro de Alterações

Versão Descrição
8.1.0 O parâmetro result agora espera uma instância de PgSql\Result; anteriormente, um resource era esperado.

Exemplos

Exemplo #1 Exemplo de pg_result_error_field()

<?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;");
}

$res1 = pg_get_result($dbconn);
echo
pg_result_error_field($res1, PGSQL_DIAG_SQLSTATE);
?>

Veja Também

add a note

User Contributed Notes 1 note

up
0
dev at gwouite dot fr
1 year ago
Complete list of field codes from libpq documentation...

Warning : they are prefixed with "PG_", just change to "PGSQL_" and they'll be available as defined PHP values.

For me, most importants fields are suffixed with a star ;)

PG_DIAG_SEVERITY
PG_DIAG_SEVERITY_NONLOCALIZED *
PG_DIAG_SQLSTATE *
PG_DIAG_MESSAGE_PRIMARY
PG_DIAG_MESSAGE_DETAIL
PG_DIAG_MESSAGE_HINT
PG_DIAG_STATEMENT_POSITION
PG_DIAG_INTERNAL_POSITION
PG_DIAG_INTERNAL_QUERY
PG_DIAG_CONTEXT
PG_DIAG_SCHEMA_NAME *
PG_DIAG_TABLE_NAME *
PG_DIAG_COLUMN_NAME *
PG_DIAG_DATATYPE_NAME *
PG_DIAG_CONSTRAINT_NAME
PG_DIAG_SOURCE_FILE
PG_DIAG_SOURCE_LINE
PG_DIAG_SOURCE_FUNCTION

Source and field codes details : https://www.postgresql.org/docs/current/libpq-exec.html
To Top