PDOStatement::execute

    (PHP 5 >= 5.1.0, PHP 7, PHP 8, PECL pdo >= 0.1.0)

    PDOStatement::execute — Ejecuta una sentencia preparada

    Descripción

    publicPDOStatement::execute(array$input_parameters = ?): bool

    Ejecuta la sentencia preparada. Si ésta incluía marcadores de parámetros, se debe:

    • llamar a PDOStatement::bindParam() y/o PDOStatement::bindValue() para vincular variables o valores (respectivamente) a los marcadores de parámetros. Las variables vinculadas pasan su valor como entrada y reciben el valor de salida, si lo hubiera, de sus marcadores de parámetros asociados

    • o pasar un array de valores de parámetros de sólo entrada

    Parámetros

    input_parameters

    Un array de valores con tantos elementos como parámetros vinculados en la sentencia SQL que va a ser ejecutada. Todos los valores son tratados como PDO::PARAM_STR.

    No es posible vincular múltiples valores a un único parámetro; por ejemplo, no se puede vincular dos valores a un único parámetro con nombre en una cláusula IN().

    Tampoco es posible vincular más valores que los especificados; si existen más claves en input_parameters que en la sentencia SQL especificada en PDO::prepare(), entonces la sentencia fallará y se emitirá un error.

    Valores devueltos

    Devuelve true en caso de éxito o false en caso de error.

    Historial de cambios

    VersiónDescripción
    5.2.0 Las claves de input_parameters deben coincidir con aquellas declaradas en la sentencia SQL. Antes de PHP 5.2.0 esto se ignoraba silenciosamente.

    Ejemplos

    Ejemplo #1 Ejecutar una sentencia preparada con una variable y valor vinculados

    <?php

    $calorías = 150;
    $color = 'gre';
    $gsent = $gbd->prepare('SELECT name, colour, calories
    FROM fruit
    WHERE calories < :calorías AND colour LIKE :color'    );
    $gsent->bindParam(':calories', $calorías, PDO::PARAM_INT);
    $sth->bindValue(':colour', "%{$color}%");
    $gsent->execute();
    ?>

    Ejemplo #2 Ejecutar una sentencia preparada con un array de valores de inserción (parámetros con nombre)

    <?php

    $calorías = 150;
    $color = 'red';
    $gsent = $gbd->prepare('SELECT name, colour, calories
    FROM fruit
    WHERE calories < :calories AND colour = :colour'    );
    $gsent->execute(array(':calories' => $calorías, ':colour' => $color));
    ?>

    Ejemplo #3 Ejecutar una sentencia preparada con un array de valores de inserción (parámetros de sustitución)

    <?php

    $calorías = 150;
    $color = 'red';
    $gsent = $gbd->prepare('SELECT name, colour, calories
    FROM fruit
    WHERE calories < ? AND colour = ?'    );
    $gsent->execute(array($calorías, $color));
    ?>

    Ejemplo #4 Ejecutar una sentencia preparada con parámetros de sustitución de signos de interrogación

    <?php

    $calorías = 150;
    $color = 'red';
    $gsent = $gbd->prepare('SELECT name, colour, calories
    FROM fruit
    WHERE calories < ? AND colour = ?'    );
    $gsent->bindParam(1, $calorías, PDO::PARAM_INT);
    $gsent->bindParam(2, $color, PDO::PARAM_STR, 12);
    $gsent->execute();
    ?>

    Ejemplo #5 Ejecutar una sentencia preparada usando un array para la cláusula IN

    <?php

    $parámetros = array(1, 21, 63, 171);

    $place_holders = implode(',', array_fill(0, count($parámetros), '?'));


    $gsent = $gbd->prepare("SELECT id, name FROM contacts WHERE id IN ($place_holders)");
    $gsent->execute($parámetros);
    ?>

    Notas

    Nota:

    Algunos controladores necesitan cerrar los cursores antes de poder ejecutar la siguiente sentencia.

    Ver también

    To Top