(PECL ibm_db2 >= 1.0.0)
db2_conn_error — Возвращает строку, содержащую значение SQLSTATE, возвращённое последней попыткой подключения
Возвращает значение SQLSTATE, представляющее причину, по которой последняя
попытка подключения к базе данных завершилась неудачей. Поскольку
db2_connect() возвращает false
в случае неудачной
попытки подключения, не нужно передавать никаких параметров в
db2_conn_error() для получения значения SQLSTATE.
Однако, если соединение было успешным, но со временем стало
недействительным, можно передать параметр
connection
, чтобы получить значение SQLSTATE для
конкретного соединения.
Чтобы узнать, что означает значение SQLSTATE, вы можете ввести следующую
команду в командной строке DB2 Command Line Processor:
db2 '?
. Также
можно вызвать db2_conn_errormsg(), чтобы получить явное
сообщение об ошибке и соответствующее значение SQLCODE.
sqlstate-value
'
connection
Ресурс подключения, связанный с подключением, которое изначально было успешным, но со временем стало недействительным.
Возвращает значение SQLSTATE, полученное в результате неудачной попытки подключения. Возвращает пустую строку, если при последней попытке подключения ошибок не возникло.
Пример #1 Получение значения SQLSTATE для неудачной попытки подключения
В данном примере показано, как вернуть значение SQLSTATE после преднамеренной передачи недопустимых параметров в db2_connect().
<?php
$conn = db2_connect('badname', 'baduser', 'badpassword');
if (!$conn) {
print "SQLSTATE value: " . db2_conn_error();
}
?>
Результат выполнения приведённого примера:
SQLSTATE value: 08001