array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'es', ), 'this' => array ( 0 => 'mysqli-stmt.bind-param.php', 1 => 'mysqli_stmt::bind_param', 2 => 'Vincula variables a una consulta MySQL', ), 'up' => array ( 0 => 'class.mysqli-stmt.php', 1 => 'mysqli_stmt', ), 'prev' => array ( 0 => 'mysqli-stmt.attr-set.php', 1 => 'mysqli_stmt::attr_set', ), 'next' => array ( 0 => 'mysqli-stmt.bind-result.php', 1 => 'mysqli_stmt::bind_result', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'es', 'path' => 'reference/mysqli/mysqli_stmt/bind-param.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

mysqli_stmt::bind_param

mysqli_stmt_bind_param

(PHP 5, PHP 7, PHP 8)

mysqli_stmt::bind_param -- mysqli_stmt_bind_param — Vincula variables a una consulta MySQL

Descripción

Estilo orientado a objetos

public mysqli_stmt::bind_param(string $types, mixed &$var, mixed &...$vars): bool

Estilo procedimental

mysqli_stmt_bind_param(
    mysqli_stmt $statement,
    string $types,
    mixed &$var,
    mixed &...$vars
): bool

Vincula variables para los marcadores de parámetro en la consulta preparada por mysqli_prepare() o mysqli_stmt_prepare().

Nota:

Si el tamaño de los datos supera el tamaño máximo de un paquete, (max_allowed_packet), se debe especificar el carácter b en el parámetro types y utilizar la función mysqli_stmt_send_long_data() para enviar el mensaje por paquetes.

Nota:

Se debe tener precaución al utilizar mysqli_stmt_bind_param() con la función call_user_func_array(). Tenga en cuenta que mysqli_stmt_bind_param() requiere que sus parámetros sean pasados por referencia, mientras que la función call_user_func_array() puede aceptar como parámetro una lista de variables que pueden representar referencias o valores.

Parámetros

statement

Solo estilo procedimental: Un objeto mysqli_stmt devuelto por mysqli_stmt_init().

types

Una string que contiene uno o más caracteres que especifican el tipo de la variable a vincular:
Carácter de especificación de tipos
Carácter Descripción
i corresponde a una variable de tipo int
d corresponde a una variable de tipo float
s corresponde a una variable de tipo string
b corresponde a una variable de tipo BLOB, que será enviada por paquetes

var
vars

El número de variables y la longitud de la string types deben corresponder a los parámetros de la consulta.

Valores devueltos

Esta función retorna true en caso de éxito o false si ocurre un error.

Errores/Excepciones

Si el informe de errores de mysqli está habilitado (MYSQLI_REPORT_ERROR) y la operación solicitada falla, se genera una advertencia. Si, además, el modo está configurado como MYSQLI_REPORT_STRICT, se lanza una mysqli_sql_exception en su lugar.

Ejemplos

Ejemplo #1 Ejemplo con mysqli_stmt::bind_param()

Estilo orientado a objetos

<?php

mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
$mysqli = new mysqli('localhost', 'my_user', 'my_password', 'world');

$stmt = $mysqli->prepare("INSERT INTO CountryLanguage VALUES (?, ?, ?, ?)");
$stmt->bind_param('sssd', $code, $language, $official, $percent);

$code = 'DEU';
$language = 'Bavarian';
$official = "F";
$percent = 11.2;

$stmt->execute();

printf("%d fila insertada.\n", $stmt->affected_rows);

/* Limpiar tabla CountryLanguage */
$mysqli->query("DELETE FROM CountryLanguage WHERE Language='Bavarian'");
printf("%d fila eliminada.\n", $mysqli->affected_rows);

Estilo procedimental

<?php

mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
$link = mysqli_connect('localhost', 'my_user', 'my_password', 'world');

$stmt = mysqli_prepare($link, "INSERT INTO CountryLanguage VALUES (?, ?, ?, ?)");
mysqli_stmt_bind_param($stmt, 'sssd', $code, $language, $official, $percent);

$code = 'DEU';
$language = 'Bavarian';
$official = "F";
$percent = 11.2;

mysqli_stmt_execute($stmt);

printf("%d fila insertada.\n", mysqli_stmt_affected_rows($stmt));

/* Limpiar tabla CountryLanguage */
mysqli_query($link, "DELETE FROM CountryLanguage WHERE Language='Bavarian'");
printf("%d fila eliminada.\n", mysqli_affected_rows($link));

Los ejemplos anteriores mostrarán:

1 fila insertada.
1 fila eliminada.

Ejemplo #2 Uso de ... para proporcionar argumentos

El operador ... puede ser utilizado para proporcionar una lista de argumentos de longitud variable, por ejemplo, en una cláusula WHERE IN.

<?php

mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
$mysqli = new mysqli('localhost', 'my_user', 'my_password', 'world');

$stmt = $mysqli->prepare("SELECT Language FROM CountryLanguage WHERE CountryCode IN (?, ?)");
/* Usando ... para proporcionar argumentos */
$stmt->bind_param('ss', ...['DEU', 'POL']);
$stmt->execute();
$stmt->store_result();

printf("%d filas encontradas.\n", $stmt->num_rows());

Los ejemplos anteriores mostrarán:

10 filas encontradas.

Ver también