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

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

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

    Улучшение страницы

    Инструкция • Исправление • Сообщение об ошибке
    ＋Добавить

    Примечания пользователей 1 note

    up
    0
    nnd100216ibmdb2 at smallcue dot com
    14 years ago
    A word of warning:

    It appears that if you specify an invalid ibm_db2.instance_name in your php.ini file, your cataloged db2_connect() will fail with a returned value of false and when you use db2_conn_error() or db2_conn_errormsg() to check on the reason, those functions will return an empty string.
    ＋Добавить
    To Top