Exemples
<<<		 oci_bind_by_name oci_cancel
>>>
6.27 Oracle 8
6 Référence des fonctions
 Manuel PHP
. Introduction
. Pré-requis
. Installation
. Configuration à l'exécution
. Types de ressources
. Constantes prédéfinies
. Exemples
->oci_bind_by_name
. oci_cancel
. oci_close
. OCI-Collection->append
. OCI-Collection->assign
. OCI-Collection->assignElem
. OCI-Collection->getElem
. OCI-Collection->free
. OCI-Collection->max
. OCI-Collection->size
. OCI-Collection->trim
. oci_commit
. oci_connect
. oci_define_by_name
. oci_error
. oci_execute
. oci_fetch_all
. oci_fetch_array
. oci_fetch_assoc
. oci_fetch_object
. oci_fetch_row
. oci_fetch
. oci_field_is_null
. oci_field_name
. oci_field_precision
. oci_field_scale
. oci_field_size
. oci_field_type_raw
. oci_field_type
. descriptor->free
. oci_free_statement
. oci_internal_debug
. lob->append
. lob->close
. oci_lob_copy
. lob->eof
. lob->erase
. lob->export
. lob->flush
. lob->import
. oci_lob_is_equal
. lob->load
. lob->read
. lob->rewind
. lob->save
. lob->seek
. lob->size
. lob->tell
. lob->truncate
. lob->writeTemporary
. lob->write
. oci_new_collection
. oci_new_connect
. oci_new_cursor
. oci_new_descriptor
. oci_num_fields
. oci_num_rows
. oci_parse
. oci_password_change
. oci_pconnect
. oci_result
. oci_rollback
. oci_server_version
. oci_set_prefetch
. oci_statement_type
. ocibindbyname
. ocicancel
. ocicloselob
. ocicollappend
. ocicollassign
. ocicollassignelem
. ocicollgetelem
. ocicollmax
. ocicollsize
. ocicolltrim
. ocicolumnisnull
. ocicolumnname
. ocicolumnprecision
. ocicolumnscale
. ocicolumnsize
. ocicolumntype
. ocicolumntyperaw
. ocicommit
. ocidefinebyname
. ocierror
. ociexecute
. ocifetch
. ocifetchinto
. ocifetchstatement
. ocifreecollection
. ocifreecursor
. ocifreedesc
. ocifreestatement
. lob->getBuffering
. ociinternaldebug
. ociloadlob
. ocilogoff
. ocilogon
. ocinewcollection
. ocinewcursor
. ocinewdescriptor
. ocinlogon
. ocinumcols
. ociparse
. ociplogon
. ociresult
. ocirollback
. ocirowcount
. ocisavelob
. ocisavelobfile
. ociserverversion
. lob->setBuffering
. ocisetprefetch
. ocistatementtype
. ociwritelobtofile
. ociwritetemporarylob

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

[ Exemples avec oci_bind_by_name ]   PHP 5

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

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;

while (list($empno, $ename) = each($data)) {
    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.
    */
?>

Attention

C'est une mauvaise idée que d'utiliser les magic_quotes_gpc et la fonction oci_bind_by_name simultanément, car aucun ajout de guillemets n'est nécessaire sur les variables citées, et tout guillemets magiques sera inscrit dans votre base de données car oci_bind_by_name n'est pas capable de faire la différence entre les guillemets et ceux qui ont été ajoutés dynamiquement.

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

Note

Dans les versions de PHP antérieures à la version 5.0.0, vous devez utiliser la fonction ocibindbyname . Cet ancien nom est toujours utilisable : un alias a été fait vers la fonction oci_bind_by_name , pour assurer la compatibilité ascendante. toutefois, il est recommandé de ne plus l'utiliser.

<< oci_bind_by_name >>
Exemples Oracle 8 oci_cancel