(PECL ibm_db2 >= 1.0.0)
db2_conn_error — Retorna uma string contendo o SQLSTATE retornado pela última tentativa de conexão
db2_conn_error() retorna um valor SQLSTATE representando
o motivo da falha da última tentativa de conexão com um banco de dados. Como
db2_connect() retorna false
no caso de uma falha
na tentativa de conexão, não se passa nenhum parâmetro para
db2_conn_error() para recuperar o valor SQLSTATE.
Se, no entanto, a conexão foi bem-sucedida, mas se torna inválida ao longo do tempo,
pode ser passado o parâmetro connection
para recuperar
o valor SQLSTATE para uma conexão específica.
Para saber o que o valor SQLSTATE significa, pode ser emitido o seguinte comando
em um prompt do Processador de Linha de Comando do DB2:
db2 '?
. Também pode
ser chamada a função db2_conn_errormsg() para recuperar uma
mensagem de erro explícita e o valor SQLCODE associado.
sqlstate-value
'
connection
Um recurso de conexão associado a uma conexão que inicialmente foi bem-sucedida, mas que com o tempo se tornou inválida.
Retorna o valor SQLSTATE resultante de uma tentativa de conexão com falha. Retorna uma string vazia se não houver erro associado à última tentativa de conexão.
Exemplo #1 Recuperando um valor SQLSTATE para uma tentativa de conexão com falha
O exemplo a seguir demonstra como retornar um valor SQLSTATE após passar deliberadamente parâmetros inválidos para db2_connect().
<?php
$conn = db2_connect('nome_invalido', 'usuario_invalido', 'senha_invalida');
if (!$conn) {
print "Valor SQLSTATE: " . db2_conn_error();
}
?>
O exemplo acima produzirá:
Valor SQLSTATE: 08001