oci_error

(PHP 5, PHP 7, PECL OCI8 >= 1.1.0)

oci_error — Возвращает последнюю ошибку

Описание

oci_error ( resource $resource = ? ) : array

Возвращает последнюю найденную ошибку.

Функция должна вызваться сразу же после появления ошибки. Ошибки очищаются при произведении правильного запроса.

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

resource

Для большинства ошибок параметром resource является соответствующий идентификатор соединения или выражения. Для ошибок во время выполнения функций oci_connect(), oci_new_connect() и oci_pconnect() параметр resource указывать не следует.

Возвращаемые значения

Если ошибок не найдено, то oci_error() возвращает false. В противном случае, oci_error() возвращает информацию об ошибке в виде ассоциативного массива.

Описание массива вывода oci_error()
Ключ массива Тип Описание
code int Номер ошибки Oracle.
message string Текст ошибки Oracle.
offset int Позиция ошибки в запросе SQL. Если нет запроса, то равна 0
sqltext string Текст запроса SQL. Если нет запроса, то строка пуста.

Примеры

Пример #1 Вывод сообщения об ошибке Oracle после ошибки соединения

<?php
$conn 
= oci_connect("hr", "welcome", "localhost/XE");
if (!
$conn) {
    
$e = oci_error();   // Для обработки ошибок oci_connect
    
trigger_error(htmlentities($e['message']), E_USER_ERROR);
}
?>

Пример #2 Вывод сообщения об ошибке Oracle после ошибки разбора

<?php
$stid 
= oci_parse($conn, "select ' from dual");  // пропущенные кавычки
if (!$stid) {
    
$e = oci_error($conn);  // Для обработки ошибок oci_parse
    
trigger_error(htmlentities($e['message']), E_USER_ERROR);
}
?>

Пример #3 Вывод сообщения об ошибке Oracle, ошибочного запроса и позиции ошибки запуска запроса

<?php
$stid 
= oci_parse($conn, "select does_not_exist from dual");
$r = oci_execute($stid);
if (!
$r) {
    
$e = oci_error($stid);  // Для обработки ошибок oci_execute
    
print htmlentities($e['message']);
    print 
"\n<pre>\n";
    print 
htmlentities($e['sqltext']);
    
printf("\n%".($e['offset']+1)."s", "^");
    print  
"\n</pre>\n";
}
?>