db2_conn_error
(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
Смотрите также
- db2_conn_errormsg() - Возвращает последнее сообщение об ошибке подключения и значение SQLCODE
- db2_connect() - Возвращает соединение с базой данных
- db2_stmt_error() - Возвращает строку, содержащую SQLSTATE, возвращённую SQL-оператором
- db2_stmt_errormsg() - Возвращает строку, содержащую последнее сообщение об ошибке SQL-выражения
add a note
