Constantes predefinidas

As constantes abaixo são definidas por esta extensão e só estarão disponíveis quando a extensão tiver sido compilada no PHP ou tiver sido carregada dinamicamente em tempo de execução.

PGSQL_LIBPQ_VERSION (string)

Versão curta da libpq, contendo apenas números e pontos.

PGSQL_LIBPQ_VERSION_STR (string)

Antes do PHP 8.0.0, a versão longa da libpq que incluía informação de compilação. A partir do PHP 8.0.0, o valor é idêntico a PGSQL_LIBPQ_VERSION, e usar PGSQL_LIBPQ_VERSION_STR foi descontinuado.

PGSQL_ASSOC (int)

Usada em pg_fetch_array(). Retorna um array associativo contendo nomes dos campos e valores.

PGSQL_NUM (int)

Usada em pg_fetch_array(). Retorna um array com índice numérico contendo números dos campos e valores.

PGSQL_BOTH (int)

Usada em pg_fetch_array(). Retorna um array dos valores do campos com índice numérico (por número do campo) e associativo (por nome do campo).

PGSQL_CONNECT_FORCE_NEW (int)

Usado em pg_connect() para forçar a criação de nova conexão, ao invés de reutilizar uma conexão idêntica existente.

PGSQL_CONNECT_ASYNC (int)

Passada para pg_connect() para criar uma conexão assíncrona.

PGSQL_CONNECTION_AUTH_OK (int)

PGSQL_CONNECTION_AWAITING_RESPONSE (int)

PGSQL_CONNECTION_BAD (int)

Retornado pela pg_connection_status() indicando que a conexão com o banco de dados está em um estado inválido.

PGSQL_CONNECTION_MADE (int)

PGSQL_CONNECTION_OK (int)

Retornado pela pg_connection_status() indicando que a conexão com o banco de dados está em um estado válido.

PGSQL_CONNECTION_SETENV (int)

PGSQL_CONNECTION_SSL_STARTUP (int)

PGSQL_CONNECTION_STARTED (int)

PGSQL_SEEK_SET (int)

Passada para pg_lo_seek(). Operação de pesquisa deve iniciar a partir do início do objeto.

PGSQL_SEEK_CUR (int)

Passada para pg_lo_seek(). Operação de pesquisa deve iniciar a partir da posição atual.

PGSQL_SEEK_END (int)

Passada para pg_lo_seek(). Operação de pesquisa deve iniciar a partir do final do objeto.

PGSQL_EMPTY_QUERY (int)

Retornado pela pg_result_status(). A string enviada para o servidor estava vazia.

PGSQL_COMMAND_OK (int)

Retornado pela pg_result_status(). Conclusão bem sucedida de um comando que não retornou dados.

PGSQL_TUPLES_OK (int)

Retornado pela pg_result_status().Conclusão bem sucedida de um retornando dados (como um SELECT ou SHOW).

PGSQL_TUPLES_CHUNK (int)

Retornada por pg_result_status(). Indica o término bem sucedido de um comando que retorna dados em modo fragmentado. Retornada para instruções SELECT quando pg_set_chunked_rows_size() está definida. O conjunto de resultados é dividido em múltiplos fragmentos, cada um contendo um número predefinido de linhas. Disponível a partir do PHP 8.4.0 e libpq 17.

PGSQL_COPY_OUT (int)

Retornado pela pg_result_status(). Transferência de dados "Copy Out" (do servidor) iniciada.

PGSQL_COPY_IN (int)

Retornado pela pg_result_status(). Transferência de dados "Copy In" (para o servidor) iniciada.

PGSQL_BAD_RESPONSE (int)

Retornado pela pg_result_status(). A resposta do servidor não foi entendida.

PGSQL_NONFATAL_ERROR (int)

Retornado pela pg_result_status(). Um erro não fatal (uma nota ou alerta) ocorreu.

PGSQL_FATAL_ERROR (int)

Retornado pela pg_result_status(). Um erro fatal ocorreu.

PGSQL_TRANSACTION_IDLE (int)

Retornado pela pg_transaction_status(). Conexão está atualmente ociosa, não em uma transação.

PGSQL_TRANSACTION_ACTIVE (int)

Retornado pela pg_transaction_status(). Um comando está em progresso na conexão. Uma consulta foi enviada pela conexão e ainda não foi concluída.

PGSQL_TRANSACTION_INTRANS (int)

Retornado pela pg_transaction_status(). A conexão está ociosa, em um bloco de transação.

PGSQL_TRANSACTION_INERROR (int)

Retornado pela pg_transaction_status(). A conexão está ociosa, em um bloco de transação com falha.

PGSQL_TRANSACTION_UNKNOWN (int)

Retornado pela pg_transaction_status(). A conexão está ruim.

PGSQL_DIAG_SEVERITY (int)

Passada para pg_result_error_field(). A severidade; os conteúdos dos campos são ERROR, FATAL ou PANIC (em uma mensagem de erro); ou WARNING, NOTICE, DEBUG, INFO ou LOG (em uma nota), ou uma tradução de um desses. Sempre presente.

PGSQL_DIAG_SQLSTATE (int)

Passada para pg_result_error_field(). O código SQLSTATE do erro. O código SQLSTATE identifica o tipo do erro ocorrido; ele pode ser usado por aplicações front-end para executar operações específicas (como manipulação de erro) em resposta a um erro particular do banco de dados. Esta campo não muda com a localidade, e está sempre presente.

PGSQL_DIAG_MESSAGE_PRIMARY (int)

Passada para pg_result_error_field(). A mensagem de erro legível primária (tipicamente uma linha). Sempre presente.

PGSQL_DIAG_MESSAGE_DETAIL (int)

Passada para pg_result_error_field(). Detalhe: uma mensagem de erro secundária trazendo mais detalhes sobre o problema. Pode conter múltiplas linhas.

PGSQL_DIAG_MESSAGE_HINT (int)

Passada para pg_result_error_field(). Dica: um sugestão opcional sobre o que fazer em relação ao problema. Tem a intenção de ser diferente da mensagem detalhada de forma a oferecer conselhos (potencialmente inapropriados) ao invés de fatos concretos. Pode conter múltiplas linhas.

PGSQL_DIAG_STATEMENT_POSITION (int)

Passada para pg_result_error_field(). Uma string contendo um inteiro decimal indicando uma posição de cursor de erro como um índice da string da declaração original. O primeiro caractere tem índice 1, e as posições são medidas em caracteres, não em bytes.

PGSQL_DIAG_INTERNAL_POSITION (int)

Passada para pg_result_error_field(). Esta é definida da mesma forma que o campo PG_DIAG_STATEMENT_POSITION, mas ela é usado quando a posição do cursor refere-se a um comando gerado internamente ao invés do enviado pelo cliente. O campo PG_DIAG_INTERNAL_QUERY irá sempre aparecer quando este campo aparecer.

PGSQL_DIAG_INTERNAL_QUERY (int)

Passada para pg_result_error_field(). O texto do comando gerado internamente que falhou. Poderá ser, por exemplo, uma consulta SQL emitida por uma função PL/pgSQL.

PGSQL_DIAG_CONTEXT (int)

Passada para pg_result_error_field(). Um indicador de contexto no qual o erro ocorreu. Atualmente isto inclui um restreamento de pilha de chamadas de funções de linguagem procedural ativas e consultas geradas internamente. O rastreamento é uma entrada por linha, a mais recente primeiro.

PGSQL_DIAG_SOURCE_FILE (int)

Passada para pg_result_error_field(). O nome do arquivo da localização do código-fonte PostgreSQL onde o erro foi reportado.

PGSQL_DIAG_SOURCE_LINE (int)

Passada para pg_result_error_field(). O número da linha da localização do código-fonte PostgreSQL onde o erro foi reportado.

PGSQL_DIAG_SOURCE_FUNCTION (int)

Passada para pg_result_error_field(). O nome da função do código-fonte PostgreSQL que reportou o erro.

PGSQL_DIAG_SCHEMA_NAME (int)

Disponível desde o PHP 7.3.0.

PGSQL_DIAG_TABLE_NAME (int)

Disponível desde o PHP 7.3.0.

PGSQL_DIAG_COLUMN_NAME (int)

Disponível desde o PHP 7.3.0.

PGSQL_DIAG_DATATYPE_NAME (int)

Disponível desde o PHP 7.3.0.

PGSQL_DIAG_CONSTRAINT_NAME (int)

Disponível desde o PHP 7.3.0.

PGSQL_ERRORS_TERSE (int)

Passada para pg_set_error_verbosity(). Especifica que a mensagem retornada inclui severidade, texto primário e posição somente; normalmente em uma única linha.

PGSQL_ERRORS_DEFAULT (int)

Passada para pg_set_error_verbosity(). O modo padrão produz mensagens que incluem as informações do campo acima mais algum detalhe, dica, ou campos de contexto (estes podem ter múltiplas linhas).

PGSQL_ERRORS_VERBOSE (int)

Passada para pg_set_error_verbosity(). Este modo prolixo inclui todos os campos disponíveis.

PGSQL_ERRORS_SQLSTATE (int)

Passada para pg_set_error_verbosity(). Inclui apenas a severidade de erro e o código de erro SQLSTATE. Se não houver código de erro disponível, a saída é similar ao modo PGSQL_ERRORS_TERSE. Antes do PostgreSQL 11.1, a saída era sempre a mesma do modo PGSQL_ERRORS_TERSE.

PGSQL_NOTICE_LAST (int)

Usado por pg_last_notice(). Disponível desde o PHP 7.1.0.

PGSQL_NOTICE_ALL (int)

Usado por pg_last_notice(). Disponível desde o PHP 7.1.0.

PGSQL_NOTICE_CLEAR (int)

Usado por pg_last_notice(). Disponível desde o PHP 7.1.0.

PGSQL_STATUS_LONG (int)

Passada para pg_result_status(). Indica que é desejando um código de resultado numérico.

PGSQL_STATUS_STRING (int)

Passada para pg_result_status(). Indica que é desejado um resultado textual.

PGSQL_CONV_IGNORE_DEFAULT (int)

Passada para pg_convert(). Ignora valores padrão na tabela durante a conversão.

PGSQL_CONV_FORCE_NULL (int)

Passada para pg_convert(). Usa NULL da SQL no lugar de uma string vazia.

PGSQL_CONV_IGNORE_NOT_NULL (int)

Passada para pg_convert(). Ignora conversão de null em colunas SQL NOT NULL.

PGSQL_DML_NO_CONV (int)

Passada para pg_insert(), pg_select(), pg_update() e pg_delete(). Todos os parâmetros passados como são. Escape manual é requeriso se os parâmentros contiverem dados fornecidos pelo usuário. Use pg_escape_string() para isto.

PGSQL_DML_EXEC (int)

Passada para pg_insert(), pg_select(), pg_update() e pg_delete(). Executa consulta através dessas funções.

PGSQL_DML_ASYNC (int)

Passada para pg_insert(), pg_select(), pg_update() e pg_delete(). Executa consulta assíncrona através dessas funções.

PGSQL_DML_STRING (int)

Passada para pg_insert(), pg_select(), pg_update() e pg_delete(). Retorna a string da consulta executada.

PGSQL_DML_ESCAPE (int)

Passada para pg_insert(), pg_select(), pg_update() e pg_delete(). Escapa todos os parâmetros ao invés de chamar pg_convert() internamente. Esta opção omite pesquisa por metadados. A consulta pode ser tão rápida quanto pg_query() e pg_send_query().

PGSQL_POLLING_FAILED (int)

Retornada por pg_connect_poll() para indicar que a tentativa de conexão falhou.

PGSQL_POLLING_READING (int)

Retornada por pg_connect_poll() para indicar que a conexão está esperando que o socket PostgreSQL possa ser lido.

PGSQL_POLLING_WRITING (int)

Retornada por pg_connect_poll() para indicar que a conexão está esperando que o socket PostgreSQL possa ser escrito.

PGSQL_POLLING_OK (int)

Retornada por pg_connect_poll() para indicar que a conexão está pronta para uso.

PGSQL_POLLING_ACTIVE (int)

Retornada por pg_connect_poll() para indicar que a conexão está atualmente ativa.

PGSQL_DIAG_SEVERITY_NONLOCALIZED (int)

A severidade; os conteúdos dos campos são ERROR, FATAL ou PANIC (em uma mensagem de erro); ou WARNING, NOTICE, DEBUG, INFO, ou LOG (em uma nota). Isto é idêntico ao campo PG_DIAG_SEVERITY exceto que o conteúdo nunca é traduzido. Está presente somente em versões 9.6 e posteriores / PHP 7.3.0 e posteriores.

PGSQL_SHOW_CONTEXT_NEVER (int)

Para ser usada com pg_set_error_context_visibility(), o contexto nunca é mostrado. Disponível a partir do PHP 8.3.0.

PGSQL_SHOW_CONTEXT_ERRORS (int)

Para ser usada com pg_set_error_context_visibility(), os campos do contexto são incluídos apenas nas mensagens de erro. Este é o comportamento padrão. Disponível a partir do PHP 8.3.0.

PGSQL_SHOW_CONTEXT_ALWAYS (int)

Para ser usada com pg_set_error_context_visibility(), os campos do contexto são incluídos nas mensagens de erro, notas e alertas. Disponível a partir do PHP 8.3.0.

PGSQL_TRACE_SUPPRESS_TIMESTAMPS (int)

Para ser usada com pg_trace(), o timestamp não é incluído nas mensagens de rastreamento. Disponível a partir do PHP 8.4.20.

PGSQL_TRACE_REGRESS_MODE (int)

Para ser usada com pg_trace(), campos como OIDs são incluídos nas mensagens de rastreamento. Disponível a partir do PHP 8.3.0.