Manuel PHP
Précédent |  | Suivant

# PDOStatement::execute

(no version information, might be only in CVS)

PDOStatement::execute -- Exécute une requête préparée

## Description

bool PDOStatement::execute ( [array input_parameters] )

PDOStatement::execute() exécute une requête préparée. Si la requête préparée inclut des marqueurs de positionnement, vous pouvez :

- appeler la fonction PDOStatement::bindParam() pour lier les variables PHP aux marqueurs de positionnement : les variables liées pssent leurs valeurs en entrée et recoivent les valeurs de sortie si'il y en a, de leurs marqueurs de positionnement respectifs

- ou passer un tableau de valeurs de paramètres, uniquement en entrée

## Liste de paramètres

input-parameters

  Un tableau de valeurs avec autant d'éléments qu'il y a de paramètres à associer dans la requête SQL qui sera exécutées.

  Vous ne pouvez associer plusieurs valeurs à un seul paramètre; par exemple, vous ne pouvez associer deux valeurs à un paramètre de nom dans une clause IN().

## Valeurs de retour

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

## Exemples

Exemple 1. Exécute une requête préparée avec des variables liées

`<?php /* Exécute une requête préparée en liant des variables PHP */ $calories = 150; $couleur = 'rouge'; $sth = $dbh->prepare('SELECT nom, couleur, calories FROM fruit WHERE calories < :calories AND couleur = :couleur'); $sth->bindParam(':calories', $calories, PDO::PARAM_INT); $sth->bindParam(':couleur', $couleur, PDO::PARAM_STR, 12); $sth->execute(); ?>`

Exemple 2. Exécute une requête préparée avec un tableau de valeurs (paramètres de nom)

`<?php /* Exécute une requête préparée en passant un tableau de valeurs */ $calories = 150; $couleur = 'rouge'; $sth = $dbh->prepare('SELECT nom, couleur, calories FROM fruit WHERE calories < :calories AND couleur = :couleur'); $sth->execute(array(':calories' => $calories, ':couleur' => $couleur)); ?>`

Exemple 3. Exécute une requête préparée avec un tableau de valeurs (marqueurs)

`<?php /* Exécute une requête préparée en passant un tableau de valeurs */ $calories = 150; $colour = 'rouge'; $sth = $dbh->prepare('SELECT nom, couleur, calories FROM fruit WHERE calories < ? AND couleur = ?'); $sth->execute(array($calories, $couleur)); ?>`

Exemple 4. Exécute une requête préparée avec un marqueur de positionnement

`<?php /* Exécute une requête préparée en liant des variables PHP */ $calories = 150; $couleur = 'rouge'; $sth = $dbh->prepare('SELECT nom, couleur, calories FROM fruit WHERE calories < ? AND couleur = ?'); $sth->bindParam(1, $calories, PDO::PARAM_INT); $sth->bindParam(2, $couleur, PDO::PARAM_STR, 12); $sth->execute(); ?>`

## Voir aussi

PDO::prepare()
PDOStatement::bindParam()
PDOStatement::fetch()
PDOStatement::fetchAll()
PDOStatement::fetchColumn()

Précédent | Sommaire | Suivant
PDOStatement::errorInfo | Niveau supérieur | PDOStatement::fetch