(PECL ibm_db2 >= 1.0.0)
db2_conn_errormsg — Возвращает последнее сообщение об ошибке подключения и значение SQLCODE
$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