oci_bind_by_name

Description

bool oci_bind_by_name ( resource stmt, string ph_name, mixed &variable [, int maxlength [, int type]] )

oci_bind_by_name() 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. The length parameter sets the maximum length for the bind. If you set length to -1 oci_bind_by_name() will use the current length of variable to set the maximum length.

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().

Example 1. oci_bind_by_name()example <?php /* 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 <?php     $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 <?php     $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     */ ?>

Returns TRUE on success or FALSE on failure.