mysqli_stmt::bind_param

    mysqli_stmt_bind_param

    (PHP 5, PHP 7, PHP 8)

    mysqli_stmt::bind_param -- mysqli_stmt_bind_param — Привязка переменных к параметрам подготавливаемого запроса

    Описание

    Объектно-ориентированный стиль

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

    Процедурный стиль

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

    Привязывает переменные к меткам параметров в SQL-выражении, которое было подготовлено функцией mysqli_prepare() или mysqli_stmt_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, который вернула функция mysqli_stmt_init().

    types

    Строка, содержащая один или более символов, каждый из которых задаёт тип значения привязываемой переменной:

    Символы задающие тип
    СимволОписание
    iу соответствующей переменной тип int
    dу соответствующей переменной тип float
    sу соответствующей переменной тип string
    b соответствующая переменная является большим двоичным объектом (blob) и будет пересылаться пакетами
    var
    vars

    Количество переменных и длина строки types должны в точности соответствовать количеству параметров в запросе.

    Возвращаемые значения

    Возвращает true в случае успешного выполнения или false, если возникла ошибка.

    Ошибки

    Если уведомления об ошибках mysqli включены (MYSQLI_REPORT_ERROR) и запрошенная операция не удалась, выдаётся предупреждение. Если, кроме того, установлен режим MYSQLI_REPORT_STRICT, вместо этого будет выброшено исключение mysqli_sql_exception.

    Примеры

    Пример #1 Пример использования mysqli_stmt::bind_param()

    Объектно-ориентированный стиль

    <?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.\n", $stmt->affected_rows);


    $mysqli->query("DELETE FROM CountryLanguage WHERE Language='Bavarian'");
    printf("строк удалено: %d.\n", $mysqli->affected_rows);

    Процедурный стиль

    <?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.\n", mysqli_stmt_affected_rows($stmt));


    mysqli_query($link, "DELETE FROM CountryLanguage WHERE Language='Bavarian'");
    printf("строк удалено: %d.\n", mysqli_affected_rows($link));

    Результат выполнения приведённых примеров: 

    строк добавлено: 1. 1 row deleted.

    Пример #2 Пример использования ... для предоставления аргументов

    Оператор ... может использоваться для предоставления списка аргументов переменной длины, например в конструкции 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 (?, ?)");

    $stmt->bind_param('ss', ...['DEU', 'POL']);
    $stmt->execute();
    $stmt->store_result();

    printf("найдено строк: %d.\n", $stmt->num_rows());

    Результат выполнения приведённых примеров: 

    найдено строк: 10.

    Смотрите также

    • mysqli_stmt_bind_result() - Привязка переменных к подготовленному запросу для размещения результата
    • mysqli_stmt_execute() - Выполняет подготовленное утверждение
    • mysqli_stmt_fetch() - Связывает результаты подготовленного выражения с переменными
    • mysqli_prepare() - Подготавливает SQL выражение к выполнению
    • mysqli_stmt_send_long_data() - Отправка данных блоками
    • mysqli_stmt_errno() - Возвращает код ошибки выполнения последнего запроса
    • mysqli_stmt_error() - Возвращает строку с пояснением последней ошибки при выполнении запроса
    To Top