mysqli_prepare
Manual de PHP
AnteriorSiguiente

mysqli_prepare

(PHP 5)

mysqli_prepare

(no version information, might be only in CVS)

mysqli->prepare --  Prepara una sentencia SQL para su ejecuci贸n

Descripci贸n

Estilo por procedimientos:

mixto mysqli_prepare ( mysqli identificador_de_enlace, cadena query )

Estilo orientado a objetos (m茅todo)

class mysqli {

mixto prepare ( cadena query )

}

mysqli_prepare() prepara la consulta SQL acentuada por la terminaci贸n en caracter nulo, y regresa un manejador para ser usado para las operaciones en la sentencia. La consulta debe consistir de un solo enunciado SQL.

Nota: No debe agregar el punto y coma al fina o \g al enunciado.

El par谩metro query puede incluir uno o m谩s marcadores de par谩metros en la sentencia SQL, incluyendo el caracter (?) en las posiciones apropiadas.

Nota: Los marcadores son legales solo en ciertos lugares de la sentencia SQL. Por ejemplo, son permitidos en la lista de VALUES() de una sentencia INSERT (para espec铆ficar los valores de las columnas en la fila), o en una comparaci贸n con una columna en una clausula WHERE para especificar un valor de comparaci贸n.

Sin embargo, no son permitidos para identificadores (tales como nombres de tablas y columnas), en la selecci贸n de los nombres de las columnas a ser regresadas por la sentencia SELECT, o para especificar operadores binarios tales como = el signo de igual. La 煤ltima restricci贸n es necesaria porque ser铆a imposible determinar el tipo del par谩metro. No es permitido comparar los marcadores con NULL al poner ? IS NULL. En general, los par谩metros son legales solo en las sentencias del lenguaje de manipulaci贸n de datos (DML), y no en las sentencias del lenguaje de definici贸n de datos (DDL).

Los marcadores de par谩metros deben estar ligados a variables de la aplicaci贸n usando mysqli_stmt_bind_param() y/o mysqli_stmt_bind_result() antes de ejecutar la sentencia SQL u obtener las filas.

Valores retornados

mysqli_prepare() regresa un objeto o FALSE si ocurre un erro.

Ver tambi茅n

mysqli_stmt_execute(), mysqli_stmt_fetch(), mysqli_stmt_bind_param(), mysqli_stmt_bind_result()>, y mysqli_stmt_close().

Ejemplos

Ejemplo 1. Estilo orientado a objetos

<?php
$mysqli = new mysqli("localhost", "my_user", "my_password", "world");

/* check connection */
if (mysqli_connect_errno()) {
    printf("Connect failed: %s\n", mysqli_connect_error());
    exit();
}

$city = "Amersfoort";

/* create a prepared statement */
if ($stmt = $mysqli->prepare("SELECT District FROM City WHERE Name=?")) {

    /* bind parameters for markers */
    $stmt->bind_param("s", $city);

    /* execute query */
    $stmt->execute();

    /* bind result variables */
    $stmt->bind_result($district);

    /* fetch value */
    $stmt->fetch();

    printf("%s is in district %s\n", $city, $district);

    /* close statement */
    $stmt->close();
}

/* close connection */
$mysqli->close();
?>

Ejemplo 2. Estilo por procedimientos

<?php
$link = mysqli_connect("localhost", "my_user", "my_password", "world");

/* check connection */
if (mysqli_connect_errno()) {
    printf("Connect failed: %s\n", mysqli_connect_error());
    exit();
}

$city = "Amersfoort";

/* create a prepared statement */
if ($stmt = mysqli_prepare($link, "SELECT District FROM City WHERE Name=?")) {

    /* bind parameters for markers */
    mysqli_stmt_bind_param($stmt, "s", $city);

    /* execute query */
    mysqli_stmt_execute($stmt);

    /* bind result variables */
    mysqli_stmt_bind_result($stmt, $district);

    /* fetch value */
    mysqli_stmt_fetch($stmt);

    printf("%s is in district %s\n", $city, $district);

    /* close statement */
    mysqli_stmt_close($stmt);
}

/* close connection */
mysqli_close($link);
?>

El resultado del ejemplo seria:

Amersfoort is in district Utrecht
AnteriorInicioSiguiente
mysqli_pingSubirmysqli_query