Fonctions IBM DB2
PHP Manual

db2_prepare

(PECL ibm_db2 >= 1.0.0)

db2_prepare Prépare une requête SQL à être exécutée

Description

resource db2_prepare ( resource $connection , string $statement [, array $options ] )

db2_prepare() crée une requête SQL préparée qui peut inclure aucun ou plusieurs marqueurs (caractères ?) représentant les paramètres d'entrée, sortie ou d'entrée/sortie. Vous pouvez passer des paramètres à la requête préparée en utilisant la fonction db2_bind_param(), si vous avez que des entrées, vous pouvez utiliser db2_execute().

Il y a trois principaux avantages d'utiliser les requêtes préparées dans votre application :

Liste de paramètres

connection

Une variable ressource de connexion valide retournée par db2_connect() ou db2_pconnect().

statement

Une requête SQL qui peut contenir un ou plusieurs marqueurs.

options

Un tableau associatif contenant les options de la requête. Vous pouvez utiliser ce paramètre pour demander un curseur flottant sur les serveurs de base de données qui supportent cette fonctionnalité.

Pour une description des options valides, reportez-vous à la fonction db2_set_option().

Valeurs de retour

Retourne une variable ressource si la requête SQL était envoyée correctement ou FALSE si le serveur de base de données a retourné une erreur. Vous pouvez déterminer quelle erreur a été retournée en appelant la fonction db2_stmt_error() ou db2_stmt_errormsg().

Exemples

Exemple #1 Préparation et exécution d'une requête SQL avec des marqueurs

L'exemple suivant prépare une requête INSERT qui accepte quatre marqueurs, ensuite itère sur le tableau contenant les valeurs d'entrées qui sera passé à la fonction db2_execute().

<?php
$animaux 
= array(
    array(
0'chat''Pook'3.2),
    array(
1'chien''Peaches'12.3),
    array(
2'cheval''Smarty'350.0),
);

$insert 'INSERT INTO animaux (id, race, nom, poids)
    VALUES (?, ?, ?, ?)'
;
$stmt db2_prepare($conn$insert);
if (
$stmt) {
    foreach (
$animaux as $animal) {
        
$result db2_execute($stmt$animal);
    }
}
?>

Voir aussi


Fonctions IBM DB2
PHP Manual