What is PhpDig?
PhpDig is a PHP MySQL based
Web Spider & Search Engine.

ocidefinebyname
Prev	XLIII. OCI8 Functions	Next

ocidefinebyname

Name

ocidefinebyname — Define a PHP variable to an Oracle column by name

Synopsis

int ocidefinebyname(stmt, name[, type]); int stmt: Statement handler string name: name explanation goes here int type (optional): type explanation goes here

Returns

TRUE on success or FALSE on error

Description

Fetches columns from a query into into variables defined in PHP. This can be very useful as it negates the use of using ociresult() to display field contents. Unlike a lot of other realtional database systems, Oracle upper-cases all field names which is often a trap for new players. Another common trap is that no error occurs if a column defined in ocidefinebyname() does not exist which can make debugging interesting. Using ociinternaldebug() can help though.

When attempting to bind an abstract datatype such as a BFILE, LOB or ROWID it must be allocated first using ocinewdescriptor() .

Version

Since versions 3.0.7 and 4.0

Example

Example 854. Display using defined columns

if (!$db = @ocinlogon("dev","dev", "ORCL")) {
    $error = ocierror();
    printf("CONNECT error: %s", $error["message"]);
    die();
}

if (!$stmt = @ociparse($db,"SELECT * FROM phone_numbers")) {
    $error = ocierror($db);
    printf("ociparse error: %s", $error["message"]);
} else {
    ocidefinebyname($stmt,"EMAIL",$email);
    ocidefinebyname($stmt,"PHONE_NUMBER",$phone_number);

    if (!@ociexecute($stmt)) {
        $error = ocierror($stmt);
        printf("OCIEXECUTE Failure. Error was: %s\n", $error["message"]);
    } else {
        while (ocifetch($stmt)) {
            echo "$name => $phone_number\n";
        }
    }
}

Prev	Home	Next
ocicommit	Up	ocierror

PHP Functions Essential Reference. Copyright © 2002 by New Riders Publishing (Authors: Zak Greant, Graeme Merrall, Torben Wilson, Brett Michlitsch). This material may be distributed only subject to the terms and conditions set forth in the Open Publication License, v1.0 or later (the latest version is presently available at http://www.opencontent.org/openpub/). The authors of this book have elected not to choose any options under the OPL. This online book was obtained from http://www.fooassociates.com/phpfer/ and is designed to provide information about the PHP programming language, focusing on PHP version 4.0.4 for the most part. The information is provided on an as-is basis, and no warranty or fitness is implied. All persons and entities shall have neither liability nor responsibility to any person or entity with respect to any loss or damage arising from the information contained in this book.