Manual do PHP
Anterior |  | Próxima

# PDOStatement->execute()

(no version information, might be only in CVS)

PDOStatement->execute() -- Executes a prepared statement

## Descrição

class PDOStatement {
bool execute ( [array input_parameters] )
}

Execute the prepared statement. If the prepared statement included parameter markers, you must either:

- call PDOStatement->bindParam() to bind PHP variables to the parameter markers: bound variables pass their value as input and receive the output value, if any, of their associated parameter markers

- or pass an array of input-only parameter values

## Parâmetros

`input_parameters`

  An array of values with as many elements as there are bound parameters in the SQL statement being executed.

  You cannot bind multiple values to a single parameter; for example, you cannot bind two values to a single named parameter in an IN() clause.

## Valores de retornado

Retorna `TRUE` em caso de sucesso ou `FALSE` em falhas.

## Exemplos

Exemplo 1. Execute a prepared statement with bound variables
`<?php /* Execute a prepared statement by binding PHP variables */ $calories = 150; $colour = 'red'; $sth = $dbh->prepare('SELECT name, colour, calories FROM fruit WHERE calories < :calories AND colour = :colour'); $sth->bindParam(':calories', $calories, PDO::PARAM_INT); $sth->bindParam(':colour', $colour, PDO::PARAM_STR, 12); $sth->execute(); ?>`

Exemplo 2. Execute a prepared statement with an array of insert values (named parameters)
`<?php /* Execute a prepared statement by passing an array of insert values */ $calories = 150; $colour = 'red'; $sth = $dbh->prepare('SELECT name, colour, calories FROM fruit WHERE calories < :calories AND colour = :colour'); $sth->execute(array(':calories' => $calories, ':colour' => $colour)); ?>`

Exemplo 3. Execute a prepared statement with an array of insert values (placeholders)
`<?php /* Execute a prepared statement by passing an array of insert values */ $calories = 150; $colour = 'red'; $sth = $dbh->prepare('SELECT name, colour, calories FROM fruit WHERE calories < ? AND colour = ?'); $sth->execute(array($calories, $colour)); ?>`

Exemplo 4. Execute a prepared statement with question mark placeholders
`<?php /* Execute a prepared statement by binding PHP variables */ $calories = 150; $colour = 'red'; $sth = $dbh->prepare('SELECT name, colour, calories FROM fruit WHERE calories < ? AND colour = ?'); $sth->bindParam(1, $calories, PDO::PARAM_INT); $sth->bindParam(2, $colour, PDO::PARAM_STR, 12); $sth->execute(); ?>`

## Veja também

PDO->prepare()
PDOStatement->bindParam()
PDOStatement->fetch()
PDOStatement->fetchAll()
PDOStatement->fetchColumn()

Anterior | Principal | Próxima
PDOStatement->errorInfo() | Acima | PDOStatement->fetch()