|
|
mysqli_stmt_bind_param (PHP 5) mysqli_stmt_bind_param (no version information, might be only in CVS) stmt->bind_param -- Binds variables to a prepared statement as parameters DescriptionProcedural style: bool mysqli_stmt_bind_param ( mysqli_stmt stmt, string types, mixed &var1 [, mixed &...] ) Object oriented style (method): class mysqli_stmt { bool bind_param ( string types, mixed &var1 [, mixed &...] ) }
mysqli_stmt_bind_param() is used to bind variables for the
parameter markers in the SQL statement that was passed to
mysqli_prepare().
The string types contains one or more characters which specify
the types for the corresponding bind variables
Таблица 1. Type specification chars | Character | Description |
|---|
| i | corresponding variable has type integer | | d | corresponding variable has type double | | s | corresponding variable has type string | | b | corresponding variable is a blob and will be sent in packets |
Замечание:
If data size of a variable exceeds max. allowed packet size
(max_allowed_packet), you have to specify b in
types and use
mysqli_stmt_send_long_data() to send the data in packets.
The number of variables and length of
string types must match the parameters in the statement.
Возвращаемые значения
Возвращает TRUE в случае успешного завершения или FALSE в случае возникновения ошибки.
ПримерыПример 1. Object oriented style |
<?php
$mysqli = new mysqli('localhost', 'my_user', 'my_password', 'world');
if (mysqli_connect_errno()) {
printf("Connect failed: %s\n", mysqli_connect_error());
exit();
}
$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 Row inserted.\n", $stmt->affected_rows);
$stmt->close();
$mysqli->query("DELETE FROM CountryLanguage WHERE Language='Bavarian'");
printf("%d Row deleted.\n", $mysqli->affected_rows);
$mysqli->close();
?>
|
|
Пример 2. Procedural style |
<?php
$link = mysqli_connect('localhost', 'my_user', 'my_password', 'world');
if (!$link) {
printf("Connect failed: %s\n", mysqli_connect_error());
exit();
}
$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 Row inserted.\n", mysqli_stmt_affected_rows($stmt));
mysqli_stmt_close($stmt);
mysqli_query($link, "DELETE FROM CountryLanguage WHERE Language='Bavarian'");
printf("%d Row deleted.\n", mysqli_affected_rows($link));
mysqli_close($link);
?>
|
|
Результат выполнения данного примера: 1 Row inserted.
1 Row deleted. |
 add a note
User Contributed Notes
mysqli_stmt_bind_param
evangun2001 at yahoo dot fr
19-Sep-2007 04:30
About the previous message :
I don't know if it has been fixed or if it always worked, but binding parameters only once works (almost) fine.
Just mind the bug (current version: 5.2.4) I describe here : http://bugs.php.net/bug.php?id=42689
usera at example dot com
20-Jul-2007 08:50
Some examples in the documentation suggest that you can call $stmt->bind_param() once, then call $stmt->execute() several times while altering the bound variables each time, so as to e.g. insert several records into a data base. This is not true.
You need to call $stmt->bind_param() once each time AFTER you altered the set of variables, and BEFORE you call $stmt->execute()
This may be a bug. If it is not, the documentation is flawed, and there is no gain to the programmer using the new mysqli interface at this point.
mixleplix1 at yahoo dot com
19-Jun-2007 01:12
To continue on previous post
Bigints and the 'd' type:
If the digit you insert is longer then 16 digits the last digits will alter. I was noticing this in my inserts.
1111111111111111111 changes to 1111111111111111168
I had to switch to using 's' as type
flame
18-Feb-2007 08:44
Columns with type bigint need to be specified as type 'd' NOT 'i'.
Using 'i' results in large numbers (eg 3000169151) being truncated.
--
flame
|
mysqli_stmt_affected_rows
