mysqli_stmt::bind_param - Привязка переменных к параметрам подготавливаемого запроса
Вернуться к: mysqli_stmt
mysqli_stmt::bind_param
mysqli_stmt_bind_param
(PHP 5, PHP 7)
mysqli_stmt::bind_param -- mysqli_stmt_bind_param — Привязка переменных к параметрам подготавливаемого запроса
Описание
Объектно-ориентированный стиль
Процедурный стиль
Привязывает переменные к меткам параметров в SQL выражении, которое было подготовлено фукнцией mysqli_prepare().
Замечание:
Если размер данных переменной превышает максимально допустимый размер пакета (max_allowed_packet), необходимо задать значение b параметру
typesи использовать функцию mysqli_stmt_send_long_data(), которая будет передавать данные пакетами.
Замечание:
При использовании mysqli_stmt_bind_param() совместно с call_user_func_array() необходимо соблюдать особую осторожность. Нужно принимать во внимание, что mysqli_stmt_bind_param() принимает в качестве параметров только ссылки на значения, в то время как call_user_func_array() принимает список параметров, которые могут передаваться как по ссылке, так и по значению.
Список параметров
-
stmt -
Только для процедурного стиля: Идентификатор выражения, полученный с помощью mysqli_stmt_init().
-
types -
Строка содержащая один или более символов, каждый из которых задает тип значения привязываемой переменной:
Символы задающие тип Символ Описание i соответствующая переменная имеет тип integer d соответствующая переменная имеет тип double s соответствующая переменная имеет тип string b соответствующая переменная является большим двоичным объектом (blob) и будет пересылаться пакетами -
var1 -
Количество переменных и длина строки
typesдолжны в точности соответствовать количеству параметров в запросе.
Возвращаемые значения
Возвращает TRUE в случае успешного завершения или FALSE в случае возникновения ошибки.
Примеры
Пример #1 Объектно-ориентированный стиль
<?php
$mysqli = new mysqli('localhost', 'my_user', 'my_password', 'world');
/* проверка подключения */
if (mysqli_connect_errno()) {
printf("Не удалось подключиться: %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 строк вставлено.\n", $stmt->affected_rows);
/* закрываем запрос */
$stmt->close();
/* очищаем таблицу CountryLanguage */
$mysqli->query("DELETE FROM CountryLanguage WHERE Language='Bavarian'");
printf("%d строк удалено.\n", $mysqli->affected_rows);
/* закрываем подключение */
$mysqli->close();
?>
Пример #2 Процедурный стиль
<?php
$link = mysqli_connect('localhost', 'my_user', 'my_password', 'world');
/* проверка подключения */
if (!$link) {
printf("Не удалось подключиться: %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 строк вставлено.\n", mysqli_stmt_affected_rows($stmt));
/* закрываем запрос */
mysqli_stmt_close($stmt);
/* очищаем таблицу CountryLanguage */
mysqli_query($link, "DELETE FROM CountryLanguage WHERE Language='Bavarian'");
printf("%d строк удалено.\n", mysqli_affected_rows($link));
/* закрываем подключение */
mysqli_close($link);
?>
Результат выполнения данных примеров:
1 строк вставлено. 1 Row deleted.
Смотрите также
- mysqli_stmt_bind_result() - Привязка переменных к подготовленному запросу для размещения результата
- mysqli_stmt_execute() - Выполняет подготовленный запрос
- mysqli_stmt_fetch() - Связывает результаты подготовленного выражения с переменными
- mysqli_prepare() - Подготавливает SQL выражение к выполнению
- mysqli_stmt_send_long_data() - Отправка данных блоками
- mysqli_stmt_errno() - Возвращает код ошибки выполнения последнего запроса
- mysqli_stmt_error() - Возвращает строку с пояснением последней ошибки при выполнении запроса
Вернуться к: mysqli_stmt