PHP oci_bind_by_name function

Like this blog? Consider exploring one of our sponsored banner ads...

oci_bind_by_name

(PHP 5)

oci_bind_by_name — Binds the PHP variable to the Oracle placeholderDescriptionbool oci_bind_by_name ( resource statement, string ph_name, mixed &variable [, int maxlength [, int type]] )

Binds the PHP variable variable to the Oracle
placeholder ph_name. Whether it will be used for
input or output will be determined at run-time and the necessary
storage space will be allocated.

Parameters

statement

An OCI statement.

ph_name

The placeholder.

variable

The PHP variable.

maxlength

Sets the maximum length for the bind. If you set it to -1, this
function will use the current length of variable
to set the maximum length.

type

If you need to bind an abstract datatype (LOB/ROWID/BFILE) you
need to allocate it first using the
oci_new_descriptor() function. The
length is not used for abstract datatypes
and should be set to -1. The type parameter
tells Oracle which descriptor is used. Possible
values are:

SQLT_FILE – for BFILEs;

SQLT_CFILE – for CFILEs;

SQLT_CLOB – for CLOBs;

SQLT_BLOB – for BLOBs;

SQLT_RDD – for ROWIDs;

SQLT_NTY – for named datatypes;

SQLT_INT – for integers;

SQLT_CHR – for VARCHARs;

SQLT_BIN – for RAW columns;

SQLT_LNG – for LONG columns;

SQLT_LBI – for LONG RAW columns;

SQLT_RSET – for cursors, that were created
before with oci_new_cursor().



Return Values

Returns TRUE on success or FALSE on failure.

Examples

Example 1. oci_bind_by_name()example

/* oci_bind_by_name example thies at thieso dot net (980221)
  inserts 3 records into emp, and uses the ROWID for updating the
  records just after the insert.
*/
 
$conn = oci_connect("scott", "tiger");
 
$stmt = oci_parse($conn, "
                          INSERT INTO
                                     emp (empno, ename)
                               VALUES
                                     (:empno,:ename)
                            RETURNING
                                     ROWID
                                 INTO
                                     :rid
                         ");
 
$data = array(
              1111 => "Larry",
              2222 => "Bill",
              3333 => "Jim"
             );
 
$rowid = oci_new_descriptor($conn, OCI_D_ROWID);
 
oci_bind_by_name($stmt, ":empno", $empno, 32);
oci_bind_by_name($stmt, ":ename", $ename, 32);
oci_bind_by_name($stmt, ":rid",   $rowid, -1, OCI_B_ROWID);
 
$update = oci_parse($conn, "
                            UPDATE
                                  emp
                               SET
                                  sal = :sal
                             WHERE
                                  ROWID = :rid
                           ");
oci_bind_by_name($update, ":rid", $rowid, -1, OCI_B_ROWID);
oci_bind_by_name($update, ":sal", $sal,   32);
 
$sal = 10000;
 
foreach ($data as $empno => $ename) {
    oci_execute($stmt);
    oci_execute($update);
}
 
$rowid->free();
 
oci_free_statement($update);
oci_free_statement($stmt);
 
$stmt = oci_parse($conn, "
                          SELECT
                                *
                            FROM
                                emp
                           WHERE
                                empno
                              IN
                                (1111,2222,3333)
                         ");
oci_execute($stmt);
 
while ($row = oci_fetch_assoc($stmt)) {
    var_dump($row);
}
 
oci_free_statement($stmt);
 
/* delete our "junk" from the emp table.... */
$stmt = oci_parse($conn, "
                          DELETE FROM
                                     emp
                                WHERE
                                     empno
                                   IN
                                     (1111,2222,3333)
                         ");
oci_execute($stmt);
oci_free_statement($stmt);
 
oci_close($conn);

Remember, this function strips trailing whitespaces. See the following
example:

Example 2. oci_bind_by_name() example

    $connection = oci_connect('apelsin','kanistra');
    $query = "INSERT INTO test_table VALUES(:id, :text)";
 
    $statement = oci_parse($query);
    oci_bind_by_name($statement, ":id", 1);
    oci_bind_by_name($statement, ":text", "trailing spaces follow     ");
    oci_execute($statement);
    /*
     This code will insert into DB string 'trailing spaces follow', without
     trailing spaces
    */

Example 3. oci_bind_by_name() example

    $connection = oci_connect('apelsin','kanistra');
    $query = "INSERT INTO test_table VALUES(:id, 'trailing spaces follow      ')";
 
    $statement = oci_parse($query);
    oci_bind_by_name($statement, ":id", 1);
    oci_execute($statement);
    /*
     And this code will add 'trailing spaces follow      ', preserving
     trailing whitespaces
    */

Return Values

Returns TRUE on success or FALSE on failure.

Notes

Warning

Do not use magic_quotes_gpc or
addslashes() and oci_bind_by_name()
simultaneously as no quoting is needed and any magically applied quotes
will be written into your database as oci_bind_by_name()
is not able to distinguish magically added quotings from those added
intentionally.

Note:
In PHP versions before 5.0.0 you must use ocibindbyname() instead.
This name still can be used, it was left as alias of
oci_bind_by_name() for downwards compatability.
This, however, is deprecated and not recommended.

About this entry

You’re currently reading “PHP oci_bind_by_name function,” an entry on BRADINO

Published:
2.26.07 / 12am
Category:
PHP Functions
Tags: