oci_fetch
(PHP 5, PHP 7, PECL OCI8 >= 1.1.0)
oci_fetch — Выбирает следующую строку из результата в буфер
Описание
$statement
) : boolВыбирает следующую строку из результата запроса во внутренний буфер, доступный с помощью oci_result() или через переменные, заранее определенные с помощью oci_define_by_name().
Смотрите oci_fetch_array() для более детальной информации о выборе данных.
Список параметров
-
statement
-
Корректный идентификатор выражения OCI8, полученный из oci_parse() и исполненный функцией oci_execute(), или идентификатор выражения
REF CURSOR
.
Возвращаемые значения
Возвращает true
в случае успешного выполнения или false
, если в результате
statement
больше нет рядов.
Примеры
Пример #1 Пример использования oci_fetch() с определенными переменными
<?php
$conn = oci_connect('hr', 'welcome', 'localhost/XE');
if (!$conn) {
$e = oci_error();
trigger_error(htmlentities($e['message'], ENT_QUOTES), E_USER_ERROR);
}
$sql = 'SELECT location_id, city FROM locations WHERE location_id < 1200';
$stid = oci_parse($conn, $sql);
// Определение переменных ДОЛЖНО быть произведено до запуска
oci_define_by_name($stid, 'LOCATION_ID', $locid);
oci_define_by_name($stid, 'CITY', $city);
oci_execute($stid);
// С каждой выборкой переменные заполняются данными следующего ряда
while (oci_fetch($stid)) {
echo "Идентификатор местоположения $city = $locid<br>\n";
}
// Выведет:
// Идентификатор местоположения Roma = 1000
// Идентификатор местоположения Venice = 1100
oci_free_statement($stid);
oci_close($conn);
?>
Пример #2 Пример использования oci_fetch() с oci_result()
<?php
$conn = oci_connect('hr', 'welcome', 'localhost/XE');
if (!$conn) {
$e = oci_error();
trigger_error(htmlentities($e['message'], ENT_QUOTES), E_USER_ERROR);
}
$sql = 'SELECT location_id, city FROM locations WHERE location_id < 1200';
$stid = oci_parse($conn, $sql);
oci_execute($stid);
while (oci_fetch($stid)) {
echo oci_result($stid, 'LOCATION_ID') . " = ";
echo oci_result($stid, 'CITY') . "<br>\n";
}
// Выведет:
// 1000 = Roma
// 1100 = Venice
oci_free_statement($stid);
oci_close($conn);
?>
Примечания
Замечание:
Не возвращает строки для неявных результирующих наборов в Oracle Database. Используйте вместо данной функции функцию oci_fetch_array().
Смотрите также
- oci_define_by_name() - Сопоставляет переменную PHP столбцу результата запроса
- oci_fetch_all() - Выбирает все строки из результата запроса в двумерный массив
- oci_fetch_array() - Возвращает следующую строку из результата запроса в виде ассоциативного или нумерованного массива
- oci_fetch_assoc() - Возвращает следующую строку из результата запроса в виде ассоциативного массива
- oci_fetch_object() - Возвращает следующую строку из результата запроса в виде объекта
- oci_fetch_row() - Возвращает следующую строку из результата запроса в виде нумерованного массива
- oci_result() - Возвращает значение поля из результата запроса