PHP 8.1.0 RC 2 available for testing

db2_conn_error

(PECL ibm_db2 >= 1.0.0)

db2_conn_error Возвращает строку, содержащую значение SQLSTATE, возвращённое последней попыткой подключения

Описание

db2_conn_error(resource $connection = ?): string

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

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

Чтобы узнать, что означает значение SQLSTATE, вы можете ввести следующую команду в командной строке DB2 Command Line Processor: db2 '? sqlstate-value'. Также можно вызвать db2_conn_errormsg(), чтобы получить явное сообщение об ошибке и соответствующее значение SQLCODE.

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

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() - Returns a string containing the SQLSTATE returned by an SQL statement
  • db2_stmt_errormsg() - Возвращает строку, содержащую последнее сообщение об ошибке SQL-выражения

add a note add a note

User Contributed Notes

There are no user contributed notes for this page.
To Top