(PHP 5, PHP 7, PHP 8)
mysqli_stmt::bind_param -- mysqli_stmt_bind_param — Vincula variables a una consulta MySQL
Estilo orientado a objetos
Estilo por procedimientos
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ácterb
en el parámetrotypes
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.
stmt
Sólo estilo por procediminetos: Un identificador de declaraciones 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 | 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.
If mysqli error reporting is enabled (MYSQLI_REPORT_ERROR
) and the requested operation fails,
a warning is generated. If, in addition, the mode is set to MYSQLI_REPORT_STRICT
,
a mysqli_sql_exception is thrown instead.
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 por procedimientos
<?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));
El resultado de los ejemplos sería:
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());
El resultado de los ejemplos sería:
10 filas encontradas.