maxdb_stmt_bind_param
maxdb_stmt::bind_param
(PECL maxdb >= 1.0)
maxdb_stmt_bind_param -- maxdb_stmt::bind_param — Lie les variables à une requête préparée en tant que paramètres
Description
Style procédural
Style orienté objet
Style procédural (syntaxe étendue) :
$stmt
, string $types
, array &$var
) : boolStyle orienté objet (syntaxe étendue) :
$types
, array &$var
) : bool
maxdb_stmt_bind_param() est utilisé pour lier les variables
pour les marqueurs dans la requête SQL qui a été passée à
maxdb_prepare().
La chaîne types contient un ou plusieurs caractères
qui spécifient le(s) type(s) correspondant aux variables liées.
La syntaxe étendue de maxdb_stmt_bind_param() permet de passer les paramètres en tant que tableaux plutôt qu'en tant que listes de variables PHP à la fonction. Si le tableau de variables n'a pas été utilisé avant l'appel à la fonction maxdb_stmt_bind_param(), il doit être initialisé en tant que tableau vide. Voir les exemples sur l'utilisation de la fonction maxdb_stmt_bind_param() avec la syntaxe étendue.
Les variables pour les requêtes SELECT INTO SQL peuvent également
être liées en utilisant la fonction maxdb_stmt_bind_param().
Les paramètres pour les procédures de base de données peuvent être
liés en utilisant la fonction maxdb_stmt_bind_param().
Voir les exemples sur l'utilisation de la fonction maxdb_stmt_bind_param()
dans ce cas.
Si une variable liée comme variable INTO à une requête SQL a
été utilisée avant, le contenu de cette variable sera écrasé par les données de la requête
SELECT INTO.
Une référence sur cette variable sera invalide après un appel à la fonction
maxdb_stmt_bind_param().
Pour les paramètres INOUT des procédures de base de données,
le contenu de la variable liée INOUT sera écrasé par la valeur de
sortie de la procédure de la base de données. Une
référence sur cette variable sera invalide après un appel à la fonction
maxdb_stmt_bind_param().
| Caractères | Description |
|---|---|
| i | correspond à une variable de type entier |
| d | correspond à une variable de type nombre décimal |
| s | correspond à une variable de type chaîne de caractères |
| b | correspond à une variable de type blob et sera envoyée dans le paquet |
Valeurs de retour
Cette fonction retourne TRUE en cas de succès ou FALSE si une erreur survient.
Exemples
Exemple #1 Style orienté objet
<?php
$maxdb = new maxdb('localhost', 'MONA', 'RED', 'DEMODB');
/* Vérification de la connexion */
if (maxdb_connect_errno()) {
printf("Echec de la connexion : %s\n", maxdb_connect_error());
exit();
}
$maxdb->query ("CREATE TABLE temp.mycity LIKE hotel.city");
$maxdb->query ("INSERT INTO temp.mycity SELECT * FROM hotel.city");
$stmt = $maxdb->prepare("INSERT INTO temp.mycity VALUES (?, ?, ?)");
$stmt->bind_param('sss', $zip, $name, $state);
$zip = '11111';
$name = 'Georgetown';
$state = 'NY';
/* Exécution de la requête préparée */
$stmt->execute();
printf("%d ligne insérée.\n", $stmt->affected_rows);
/* Fermeture de la requête */
$stmt->close();
/* Nettoyage de la table CountryLanguage */
$maxdb->query("DELETE FROM temp.mycity WHERE name='Georgetown'");
printf("%d ligne effacée.\n", $maxdb->affected_rows);
/* Fermeture de la connexion */
$maxdb->close();
?>
Exemple #2 Style procédural
<?php
$link = maxdb_connect("localhost", "MONA", "RED", "DEMODB");
/* Vérification de la connexion */
if (!$link) {
printf("Echec de la connexion : %s\n", maxdb_connect_error());
exit();
}
maxdb_query ($link, "CREATE TABLE temp.mycity LIKE hotel.city");
maxdb_query ($link, "INSERT INTO temp.mycity SELECT * FROM hotel.city");
$stmt = maxdb_prepare($link, "INSERT INTO temp.mycity VALUES (?, ?, ?)");
maxdb_stmt_bind_param($stmt, 'sss', $zip, $name, $state);
$zip = '11111';
$name = 'Georgetown';
$state = 'NY';
/* Exécution de la requête préparée */
maxdb_stmt_execute($stmt);
printf("%d ligne insérée.\n", maxdb_stmt_affected_rows($stmt));
/* Fermeture de la requête */
maxdb_stmt_close($stmt);
/* Nettoyage de la table CountryLanguage */
maxdb_query($link, "DELETE FROM temp.mycity WHERE name='Georgetown'");
printf("%d ligne effacée.\n", maxdb_affected_rows($link));
/* Fermeture de la connexion */
maxdb_close($link);
?>
L'exemple ci-dessus va afficher quelque chose de similaire à :
1 ligne insérée. 1 ligne effacée.
Exemple #3 Style procédural (SELECT INTO)
<?php
$link = maxdb_connect("localhost", "MONA", "RED", "DEMODB");
/* Vérification de la connexion */
if (!$link) {
printf("Echec de la connexion : %s\n", maxdb_connect_error());
exit();
}
/* Exécution d'une requête SQL */
$stmt = maxdb_prepare ($link, "SELECT price INTO ? FROM hotel.room where hno = ? and type = ?");
if (!$stmt) {
printf ("Echec de la préparation : %s\n", maxdb_error($link));
}
$hno = "50";
$rtype = "suite";
maxdb_stmt_bind_param($stmt, 'dss', $price, $hno, $rtype);
maxdb_stmt_execute($stmt);
printf ("%f\n", $price);
maxdb_stmt_close ($stmt);
?>
L'exemple ci-dessus va afficher quelque chose de similaire à :
21.600000
Exemple #4 Style procédural (avec procédure de base)
<?php
$link = maxdb_connect("localhost", "MONA", "RED", "DEMODB");
/* Vérification de la connexion */
if (!$link) {
printf("Echec de la connexion : %s\n", maxdb_connect_error());
exit();
}
maxdb_report (MAXDB_REPORT_OFF);
maxdb_query($link,"DROP DBPROC test_proc");
maxdb_report (MAXDB_REPORT_ERROR);
$query = "create dbproc test_proc (INOUT e_text char(72)) AS select * from SYSDBA.DUAL; fetch into :e_text;";
maxdb_query($link, $query);
/* Exécution d'une requête SQL */
$stmt = maxdb_prepare ($link, "CALL test_proc (?)");
if (!$stmt) {
printf ("Echec de la préparation : %s\n", maxdb_error($link));
}
maxdb_stmt_bind_param($stmt, 's', $result);
maxdb_stmt_execute($stmt);
printf ("%s\n", $result);
maxdb_stmt_close ($stmt);
?>
L'exemple ci-dessus va afficher quelque chose de similaire à :
a
Exemple #5 Style orienté objet (syntaxe étendue)
<?php
$maxdb = new maxdb('localhost', 'MONA', 'RED', 'DEMODB');
/* Vérification de la connexion */
if (maxdb_connect_errno()) {
printf("Connect failed: %s\n", maxdb_connect_error());
exit();
}
$maxdb->query ("CREATE TABLE temp.mycity LIKE hotel.city");
$maxdb->query ("INSERT INTO temp.mycity SELECT * FROM hotel.city");
$stmt = $maxdb->prepare("INSERT INTO temp.mycity VALUES (?, ?, ?)");
$arr = array();
$stmt->bind_param('iss', $arr);
$arr[0] = 11111;
$arr[1] = 'Georgetown';
$arr[2] = 'NY';
/* Exécution de la requête préparée */
$stmt->execute();
printf("%d ligne insérée.\n", maxdb_stmt_affected_rows($stmt));
$arr[0] = 22222;
$arr[1] = 'New Orleans';
$arr[2] = 'LA';
/* Exécution de la requête préparée */
$stmt->execute();
printf("%d ligne insérée.\n", $stmt->affected_rows);
/* Fermeture de la requête et de la connexion */
$stmt->close();
$result = $maxdb->query("SELECT * from temp.mycity WHERE zip = '11111' OR zip = '22222'");
if ($result) {
while ($row = $result->fetch_row()) {
printf ("%s %s %s\n", $row[0], $row[1], $row[2]);
}
}
/* Nettoyage de la table CountryLanguage */
$maxdb->query("DELETE FROM temp.mycity WHERE name='Georgetown'");
$maxdb->query("DELETE FROM temp.mycity WHERE name='New Orleans'");
printf("%d lignes effacées.\n", $maxdb->affected_rows);
/* Fermeture de la connexion */
$maxdb->close();
?>
L'exemple ci-dessus va afficher quelque chose de similaire à :
1 ligne insérée. 1 ligne insérée. 11111 Georgetown NY 22222 New Orleans LA 2 lignes effacées.
Voir aussi
- maxdb_stmt_bind_result() - Lie les variables à une requête préparée pour stockage du résultat
- maxdb_stmt_execute() - Exécute une requête préparée
- maxdb_stmt_fetch() - Récupère les résultats depuis la requête préparée dans les variables liées
- maxdb_prepare() - Prépare une requête SQL pour exécution
- maxdb_stmt_send_long_data() - Envoie un bloc de données
- maxdb_stmt_errno() - Retourne le code erreur pour le dernier appel à une fonction de requête
- maxdb_stmt_error() - Retourne une description de la dernière erreur
add a note
