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-выражения
    To Top