PHP Manual
Prev |  | Next

# OCIDefineByName

(PHP 3>= 3.0.7, PHP 4 )

OCIDefineByName -- Use a PHP variable for the define-step during a SELECT

## Description

int OCIDefineByName ( int stmt, string Column-Name, mixed variable [, int type])

OCIDefineByName() binds PHP variables for fetches of SQL-Columns. Be careful that Oracle uses ALL-UPPERCASE column-names, whereby in your select you can also write lowercase. OCIDefineByName() expects the `Column-Name` to be in uppercase. If you define a variable that doesn't exists in you select statement, no error will be given!

If you need to define an abstract datatype (LOB/ROWID/BFILE) you need to allocate it first using OCINewDescriptor() function. See also the OCIBindByName() function.

Example 1. OCIDefineByName
    <?php
    /* OCIDefineByName example - thies@thieso.net (980219) */

    $conn = OCILogon("scott","tiger");

    $stmt = OCIParse($conn,"select empno, ename from emp");

    /* the define MUST be done BEFORE ociexecute! */

    OCIDefineByName($stmt,"EMPNO",$empno);
    OCIDefineByName($stmt,"ENAME",$ename);

    OCIExecute($stmt);

    while (OCIFetch($stmt)) {
        echo "empno:".$empno."\n";
        echo "ename:".$ename."\n";
    }

    OCIFreeStatement($stmt);
    OCILogoff($conn);
    ?>

Prev | Home | Next
OCICommit | Up | OCIError