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

# db2_conn_errormsg

(PECL ibm_db2 >= 1.0.0)

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

### Описание

function 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

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

- db2_conn_error() - Возвращает строку, содержащую значение SQLSTATE, возвращённое последней попыткой подключения
- db2_connect() - Возвращает соединение с базой данных
- db2_stmt_error() - Возвращает строку, содержащую SQLSTATE, возвращённую SQL-оператором
- db2_stmt_errormsg() - Возвращает строку, содержащую последнее сообщение об ошибке SQL-выражения

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open