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

# db2_conn_error

(PECL ibm_db2 >= 1.0.0)

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

### Описание

function db2_conn_error(?resource `$connection` = `null`): 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() - Возвращает строку, содержащую SQLSTATE, возвращённую SQL-оператором
- db2_stmt_errormsg() - Возвращает строку, содержащую последнее сообщение об ошибке SQL-выражения

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