oci_fetch_array

(PHP 5)

oci_fetch_array -- Returns the next row from the result data as an associative or numeric array, or both

Description

array oci_fetch_array ( resource statement [, int mode] )

Returns an array, which corresponds to the next result row or FALSE in case of error or there are no more rows in the result.

oci_fetch_array() returns an array with both associative and numeric indices.

Note: This function sets NULL fields to PHP NULL value.

An optional second parameter can be any combination of the following constants:

OCI_BOTH - return an array with both associative and numeric indices (the same as OCI_ASSOC + OCI_NUM). This is the default behavior.
OCI_ASSOC - return an associative array (as oci_fetch_assoc() works).
OCI_NUM - return a numeric array, (as oci_fetch_row() works).
OCI_RETURN_NULLS - create empty elements for the NULL fields.
OCI_RETURN_LOBS - return the value of a LOB of the descriptor.

Default mode is OCI_BOTH.

It should be mentioned here, that oci_fetch_array() is insignificantly slower, than oci_fetch_row(), but much more handy.

Note: Oracle returns all field names in uppercase and associative indices in the result array will be uppercased too.

Example 1. oci_fetch_array() with OCI_BOTH example

<?php
$connection
= oci_connect("apelsin", "kanistra");

$query = "SELECT id, name FROM fruits";

$statement = oci_parse ($connection, $query);
oci_execute ($statement);

while (
$row = oci_fetch_array ($statement, OCI_BOTH)) {
    echo
$row[0]." and ".$row['ID']." is the same<br>";
    echo
$row[1]." and ".$row['NAME']." is the same<br>";
}
?>

Example 2. oci_fetch_array() with OCI_NUM example

<?php
$connection
= oci_connect("user", "password");

$query = "SELECT id, name, lob_field FROM fruits";

$statement = oci_parse ($connection, $query);
oci_execute ($statement);

while (
$row = oci_fetch_array ($statement, OCI_NUM)) {
    echo
$row[0]."<br>";
    echo
$row[1]."<br>";
    echo
$row[2]->read(100)."<br>";  //this will output first 100 bytes from LOB
}
?>

Example 3. oci_fetch_array() with OCI_ASSOC example

<?php
$connection
= oci_connect("user", "password");

$query = "SELECT id, name, lob_field FROM fruits";

$statement = oci_parse ($connection, $query);
oci_execute ($statement);

while (
$row = oci_fetch_array ($statement, OCI_NUM)) {
    echo
$row['ID']."<br>";
    echo
$row['NAME']."<br>";
    echo
$row['LOB_FIELD']."<br>";  //this will output "Object id #1"
}
?>

Example 4. oci_fetch_array() with OCI_RETURN_LOBS example

<?php
$connection
= oci_connect("user", "password");

$query = "SELECT id, name, lob_field FROM fruits";

$statement = oci_parse ($connection, $query);
oci_execute ($statement);

while (
$row = oci_fetch_array ($statement, OCI_NUM)) {
    echo
$row[0]."<br>";
    echo
$row[1]."<br>";
    echo
$row['LOB_FIELD']."<br>";  //this will output LOB's content
}
?>

For details on the data type mapping performed by the oci8 driver, see the datatypes supported by the driver

See also oci_fetch_assoc(), oci_fetch_object(), oci_fetch_row() and oci_fetch_all().