oci_field_type(3) [php man page]
OCI_FIELD_TYPE(3) OCI_FIELD_TYPE(3) oci_field_type - Returns a field's data type name SYNOPSIS
mixed oci_field_type (resource $statement, mixed $field) DESCRIPTION
Returns a field's data type name. PARAMETERS
o $statement - A valid OCI statement identifier. o $field - Can be the field's index (1-based) or name. RETURN VALUES
Returns the field data type as a string, or FALSE on errors. EXAMPLES
Example #1 oci_field_type(3) example <?php // Create the table with: // CREATE TABLE mytab (number_col NUMBER, varchar2_col varchar2(1), // clob_col CLOB, date_col DATE); $conn = oci_connect("hr", "hrpwd", "localhost/XE"); if (!$conn) { $m = oci_error(); trigger_error(htmlentities($m['message']), E_USER_ERROR); } $stid = oci_parse($conn, "SELECT * FROM mytab"); oci_execute($stid, OCI_DESCRIBE_ONLY); // Use OCI_DESCRIBE_ONLY if not fetching rows echo "<table border="1"> "; echo "<tr>"; echo "<th>Name</th>"; echo "<th>Type</th>"; echo "<th>Length</th>"; echo "</tr> "; $ncols = oci_num_fields($stid); for ($i = 1; $i <= $ncols; $i++) { $column_name = oci_field_name($stid, $i); $column_type = oci_field_type($stid, $i); $column_size = oci_field_size($stid, $i); echo "<tr>"; echo "<td>$column_name</td>"; echo "<td>$column_type</td>"; echo "<td>$column_size</td>"; echo "</tr> "; } echo "</table> "; // Outputs: // Name Type Length // NUMBER_COL NUMBER 22 // VARCHAR2_COL VARCHAR2 1 // CLOB_COL CLOB 4000 // DATE_COL DATE 7 oci_free_statement($stid); oci_close($conn); ?> NOTES
Note In PHP versions before 5.0.0 you must use ocicolumntype(3) instead. This name still can be used, it was left as alias of oci_field_type(3) for downwards compatability. This, however, is deprecated and not recommended. SEE ALSO
oci_num_fields(3), oci_field_name(3), oci_field_size(3). PHP Documentation Group OCI_FIELD_TYPE(3)
Check Out this Related Man Page
OCI_DEFINE_BY_NAME(3) OCI_DEFINE_BY_NAME(3) oci_define_by_name - Associates a PHP variable with a column for query fetches SYNOPSIS
bool oci_define_by_name (resource $statement, string $column_name, mixed &$variable, [int $type = SQLT_CHR]) DESCRIPTION
Associates a PHP variable with a column for query fetches using oci_fetch(3). The oci_define_by_name(3) call must occur before executing oci_execute(3). PARAMETERS
o $statement -A valid OCI8 statement identifier created by oci_parse(3) and executed by oci_execute(3), or a REF CURSOR statement identifier. o $column_name - The column name used in the query. Use uppercase for Oracle's default, non-case sensitive column names. Use the exact column name case for case-sensitive column names. o $variable - The PHP variable that will contain the returned column value. o $type - The data type to be returned. Generally not needed. Note that Oracle-style data conversions are not performed. For example, SQLT_INT will be ignored and the returned data type will still be SQLT_CHR. You can optionally use oci_new_descriptor(3) to allo- cate LOB/ROWID/BFILE descriptors. RETURN VALUES
Returns TRUE on success or FALSE on failure. EXAMPLES
Example #1 oci_define_by_name(3) example <?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); // The defines MUST be done before executing oci_define_by_name($stid, 'LOCATION_ID', $locid); oci_define_by_name($stid, 'CITY', $city); oci_execute($stid); // Each fetch populates the previously defined variables with the next row's data while (oci_fetch($stid)) { echo "Location id $locid is $city<br> "; } // Displays: // Location id 1000 is Roma // Location id 1100 is Venice oci_free_statement($stid); oci_close($conn); ?> Example #2 oci_define_by_name(3) with case sensitive column names <?php /* Before running, create the table with a case sensitive column name: 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 * FROM mytab'); // Use uppercase for non case-sensitive column names oci_define_by_name($stid, 'ID', $id); // Use the exact case for case-sensitive column names oci_define_by_name($stid, 'MyDescription', $mydesc); oci_execute($stid); while (oci_fetch($stid)) { echo "id $id is $mydesc<br> "; } // Displays: // id 1 is Iced Coffee oci_free_statement($stid); oci_close($conn); ?> Example #3 oci_define_by_name(3) with LOB columns <?php /* Before running, create the table: CREATE TABLE mytab (id NUMBER, fruit CLOB); INSERT INTO mytab (id, fruit) values (1, 'apple'); INSERT INTO mytab (id, fruit) values (2, 'orange'); 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 * FROM mytab'); // The defines MUST be done before executing oci_define_by_name($stid, 'ID', $id); oci_define_by_name($stid, 'FRUIT', $fruit); // $fruit will become a LOB descriptor oci_execute($stid); while (oci_fetch($stid)) { echo $id . " is " . $fruit->load(100) . "<br> "; } // Displays: // 1 is apple // 2 is orange $fruit->free(); oci_free_statement($stid); oci_close($conn); ?> Example #4 oci_define_by_name(3) with an explicit type <?php /* Before running, create the table: CREATE TABLE mytab (id NUMBER, fruit CLOB); INSERT INTO mytab (id, fruit) values (1, 'apple'); INSERT INTO mytab (id, fruit) values (2, 'orange'); 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 * FROM mytab'); // The defines MUST be done before executing oci_define_by_name($stid, 'ID', $id); $fruit = oci_new_descriptor($conn, OCI_D_LOB); oci_define_by_name($stid, 'FRUIT', $fruit, OCI_D_CLOB); oci_execute($stid); while (oci_fetch($stid)) { echo $id . " is " . $fruit->load(100) . "<br> "; } // Displays: // 1 is apple // 2 is orange $fruit->free(); oci_free_statement($stid); oci_close($conn); ?> SEE ALSO
oci_fetch(3), oci_new_descriptor(3). PHP Documentation Group OCI_DEFINE_BY_NAME(3)