6.27.8 oci_bind_by_name() Associe une variable PHP à une variable SQL Oracle

oci_bind_by_name relie la variable PHP variable à l'emplacement Oracle ph_name , dans la commande préparée stmt . Son utilisation (comme entrée ou comme sortie) sera définie à l'exécution, et l'espace nécessaire sera alloué. Le paramètre de longueur length fixe la taille maximum pour la liaison. Si vous affectez une longueur length de -1, oci_bind_by_name utilisera la longueur de variable comme maximum maxlength .

Si vous devez lier des types abstraits de données (LOB/ROWID/BFILE), vous devrez l'allouer dans un premier temps, avec ocinewdescriptor . La longueur length ne sert pas pour ces types et devrait être fixée à -1. La variable type indique au serveur Oracle, quel type de pointeur va être utilisé. Les valeurs possibles sont :

• OCI_B_FILE - Pour BFILEs;
• OCI_B_CFILE - Pour CFILEs;
• OCI_B_CLOB - Pour CLOBs;
• OCI_B_BLOB - Pour BLOBs;
• OCI_B_ROWID - Pour ROWIDs;
• OCI_B_NTY - Pour les types de données nommés.
• OCI_B_CURSOR - Pour les curseurs qui ont été créés auparavant, avec oci_new_cursor .

Exemple avec oci_bind_by_name

<?php /* Exemple ociBindByPos par thies@thieso.net (980221)   Insère 3 lignes dans emp, et utilise ROWID pour mettre à jour   les lignes, juste après l'insertion. */ $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); ?>

N'oubliez pas que cette fonction supprime les caractères d'espace terminaux. Par exemple :

oci_bind_by_name et les caractères d'espace terminaux

<?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);     /*      Ce code va insérer la chaîne 'trailing spaces follow',      sans les espaces terminaux.     */ ?>

oci_bind_by_name et les caractères d'espace terminaux (2)

<?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);     /*      Ce code va insérer la chaîne 'trailing spaces follow      ',      avec les espaces terminaux.     */ ?>

Cette fonction retourne TRUE en cas de succès, FALSE en cas d'échec.