Constantes pré-definidas
As contantes 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
tornou-se defasado. 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_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_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.3.0.
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.