Возвращает следующую строку из результата запроса в виде объекта

# oci_fetch_object

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

oci_fetch_object — Возвращает следующую строку из результата запроса в виде объекта

### Описание

function oci_fetch_object(resource `$statement`, int `$mode` = OCI_ASSOC | OCI_RETURN_NULLS): stdClass|false

Возвращает объект, содержащий следующую строку из результата запроса. Имена свойств объекта соответствуют именам столбцов в строке. Эта функция обычно вызывается в цикле пока не возвращает `false` когда больше нет рядов.

За подробностями по операции отображения типов данных, осуществляемой модулем OCI8, обратитесь к типам данных, поддерживаемых драйвером

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

`statement`
  Корректный идентификатор выражения OCI8, полученный из функции oci_parse() и исполненный функцией oci_execute(), или идентификатор выражения `REF CURSOR`.

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

Возвращает объект. Каждое свойство объекта соответствуют именам столбцов в строке. Если в результате `запроса` больше нет рядов, то возвращает `false`.

Любой столбец `LOB` возвращается как дескриптор LOB.

Столбцы `DATE` возвращаются в виде строк, форматированных в соответствии с текущим форматов даты. Стандартный формат может быть изменён с помощью переменных окружения Oracle, таких как `NLS_LANG` или с помощью предварительно запущенной `ALTER SESSION SET NLS_DATE_FORMAT` команды.

Вам не следует забывать о том, что Oracle возвращает имена полей в ВЕРХНЕМ регистре, поэтому имена атрибутов объекта будут также в ВЕРХНЕМ регистре. Используйте функцию var_dump() по отношению к полученному объекту для доступа к атрибутам.

Значения атрибутов соответствуют `null` для любых `NULL` полей.

### Примеры

Пример #1 Пример использования oci_fetch_object()

    <?php

    /*
      Перед запуском создайте таблицу:
        CREATE TABLE mytab (id NUMBER, description VARCHAR2(30));
        INSERT INTO mytab (id, description) values (1, 'Fish and Chips');
        COMMIT;
    */

    $conn = oci_connect('hr', 'welcome', 'localhost/XE');
    if (!$conn) {
        $e = oci_error();
        trigger_error(htmlentities($e['message'], ENT_QUOTES), E_USER_ERROR);
    }

    $stid = oci_parse($conn, 'SELECT id, description FROM mytab');
    oci_execute($stid);

    while (($row = oci_fetch_object($stid)) != false) {
        // Используйте имена атрибутов в верхнем регистре для каждого столбца Oracle
        echo $row->ID . "<br>\n";
        echo $row->DESCRIPTION . "<br>\n";
    }

    // Выведет:
    //    1
    //    Fish and Chips

    oci_free_statement($stid);
    oci_close($conn);

    ?>

Пример #2 Пример использования oci_fetch_object() с названиями столбцов в различных регистрах

    <?php

    /*
    Перед запуском создайте таблицу с именем столбца в различных регистрах:
        CREATE TABLE mytab (id NUMBER, "MyDescription" VARCHAR2(30));
        INSERT INTO mytab (id, "MyDescription") values (1, 'Iced Coffee');
        COMMIT;
    */

    $conn = oci_connect('hr', 'welcome', 'localhost/XE');
    if (!$conn) {
        $e = oci_error();
        trigger_error(htmlentities($e['message'], ENT_QUOTES), E_USER_ERROR);
    }

    $stid = oci_parse($conn, 'SELECT id, "MyDescription" FROM mytab');
    oci_execute($stid);

    while (($row = oci_fetch_object($stid)) != false) {
        // Использование имён атрибутов в верхнем регистре для каждого столбца Oracle
        echo $row->ID . "<br>\n";
        // Использование точного написания для имени столбца с различными регистрами
        echo $row->MyDescription . "<br>\n";
    }

    // Выведет:
    //    1
    //    Iced Coffee

    oci_free_statement($stid);
    oci_close($conn);

    ?>

Пример #3 Пример использования oci_fetch_object() с LOB

    <?php

    /*
      Перед запуском создайте таблицу
        CREATE TABLE mytab (id NUMBER, description CLOB);
        INSERT INTO mytab (id, description) values (1, 'A very long string');
        COMMIT;
    */

    $conn = oci_connect('hr', 'welcome', 'localhost/XE');
    if (!$conn) {
        $e = oci_error();
        trigger_error(htmlentities($e['message'], ENT_QUOTES), E_USER_ERROR);
    }

    $stid = oci_parse($conn, 'SELECT id, description FROM mytab');
    oci_execute($stid);

    while (($row = oci_fetch_object($stid)) != false) {
        echo $row->ID . "<br>\n";
        // Таким образом будет выведено первые 11 байт из DESCRIPTION
        echo $row->DESCRIPTION->read(11) . "<br>\n";
    }

    // Выведет:
    //    1
    //    A very long

    oci_free_statement($stid);
    oci_close($conn);

    ?>

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

- oci_fetch() - Выбирает следующую строку из результата в буфер
- oci_fetch_all() - Выбирает все строки из результата запроса в двумерный массив
- oci_fetch_assoc() - Возвращает следующую строку из результата запроса в виде ассоциативного массива
- oci_fetch_array() - Возвращает следующую строку из результата запроса в виде ассоциативного или нумерованного массива
- oci_fetch_row() - Возвращает следующую строку из результата запроса в виде нумерованного массива

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