array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ru', ), 'this' => array ( 0 => 'function.db2-conn-errormsg.php', 1 => 'db2_conn_errormsg', 2 => 'Возвращает последнее сообщение об ошибке подключения и значение SQLCODE', ), 'up' => array ( 0 => 'ref.ibm-db2.php', 1 => 'Функции IBM DB2', ), 'prev' => array ( 0 => 'function.db2-conn-error.php', 1 => 'db2_conn_error', ), 'next' => array ( 0 => 'function.db2-connect.php', 1 => 'db2_connect', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ru', 'path' => 'reference/ibm_db2/functions/db2-conn-errormsg.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

db2_conn_errormsg

(PECL ibm_db2 >= 1.0.0)

db2_conn_errormsg — Возвращает последнее сообщение об ошибке подключения и значение SQLCODE

Описание

db2_conn_errormsg(?resource $connection = null): string

Возвращает сообщение об ошибке и значение SQLCODE, представляющее причину, по которой последняя попытка подключения к базе данных завершилась неудачей. Поскольку db2_connect() возвращает false в случае неудачной попытки подключения, не нужно передавать никаких параметров в db2_conn_errormsg() для получения соответствующего сообщения об ошибке и значения SQLCODE.

Однако, если соединение было успешным, но со временем стало недействительным, можно передать параметр connection, чтобы получить соответствующее сообщение об ошибке и значение SQLCODE для конкретного соединения.

Список параметров

connection
Ресурс подключения, связанный с подключением, которое изначально было успешным, но со временем стало недействительным.

Возвращаемые значения

Возвращает строку, содержащую сообщение об ошибке и значение SQLCODE, полученное в результате неудачной попытки подключения. Если при последней попытке подключения ошибок не возникло, db2_conn_errormsg() возвращает пустую строку.

Примеры

Пример #1 Получение сообщения об ошибке, возвращённого при неудачной попытке подключения

В данном примере показано, как вернуть сообщение об ошибке и значение SQLCODE после преднамеренной передачи недопустимых параметров в db2_connect().

<?php
$conn = db2_connect('badname', 'baduser', 'badpassword');
if (!$conn) {
print db2_conn_errormsg();
}
?>

Результат выполнения приведённого примера: 

[IBM][CLI Driver] SQL1013N  The database alias name
or database name "BADNAME" could not be found.  SQLSTATE=42705
 SQLCODE=-1013

Смотрите также