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_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.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.
There are no user contributed notes for this page.