array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ru', ), 'this' => array ( 0 => 'function.db2-conn-error.php', 1 => 'db2_conn_error', ), 'up' => array ( 0 => 'ref.ibm-db2.php', 1 => 'Функции IBM DB2', ), 'prev' => array ( 0 => 'function.db2-commit.php', 1 => 'db2_commit', ), 'next' => array ( 0 => 'function.db2-conn-errormsg.php', 1 => 'db2_conn_errormsg', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ru', 'path' => 'reference/ibm_db2/functions/db2-conn-error.xml', ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); ?>
(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