array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ru', ), 'this' => array ( 0 => 'mysqli.execute-query.php', 1 => 'mysqli::execute_query', 2 => 'Подготавливает, связывает параметры и выполняет SQL-запрос', ), 'up' => array ( 0 => 'class.mysqli.php', 1 => 'mysqli', ), 'prev' => array ( 0 => 'mysqli.error-list.php', 1 => 'mysqli::$error_list', ), 'next' => array ( 0 => 'mysqli.field-count.php', 1 => 'mysqli::$field_count', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ru', 'path' => 'reference/mysqli/mysqli/execute-query.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

mysqli::execute_query

mysqli_execute_query

(PHP 8 >= 8.2.0)

mysqli::execute_query -- mysqli_execute_query — Подготавливает, связывает параметры и выполняет SQL-запрос

Описание

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

public mysqli::execute_query(string $query, ?array $params = null): mysqli_result|bool

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

mysqli_execute_query(mysqli $mysql, string $query, ?array $params = null): mysqli_result|bool

Подготавливает SQL-запрос, связывает параметры и выполняет его. Метод mysqli::execute_query() является сокращением для mysqli::prepare(), mysqli_stmt::bind_param(), mysqli_stmt::execute() и mysqli_stmt::get_result().

У шаблона запроса может быть ноль или более маркеров параметров со знаком вопроса (?), которые также называются заполнителями. Значения параметров должны быть представлены в виде массива (array), переданного в параметр params.

Подготовленный запрос создаётся под капотом, но он никогда не выводится за пределы функции. Невозможно получить доступ к свойствам запроса, как это можно сделать с объектом mysqli_stmt. Из-за этого ограничения информация о состоянии копируется в объект mysqli и доступна с помощью его методов, например, mysqli_affected_rows() или mysqli_error().

Замечание:

В случае, когда функции mysqli_execute_query() передаётся запрос, длина которого превышает max_allowed_packet сервера, возвращаемые коды ошибок различаются в зависимости от операционной системы. Поведение следующее:

  • В Linux возвращается код ошибки 1153. Сообщение об ошибке означает, что получен пакет размером более max_allowed_packet (got a packet bigger than max_allowed_packet bytes).

  • В Windows возвращается код ошибки 2006. Сообщение об ошибке означает, что сервер недоступен (server has gone away).

Список параметров

mysql

Только для процедурного стиля: объект mysqli, который вернула функция mysqli_connect() или функция mysqli_init().

query

Запрос в виде строки. Он должен состоять из одного SQL-запроса.

SQL-запрос может содержать ноль или более маркеров параметров, представленных символами вопросительного знака (?) в соответствующих позициях.

Замечание:

Эти метки можно встраивать только в определённые места в выражении. Например, они разрешены в списке VALUES() выражения INSERT (чтобы задать значения столбцов для строки), или в операциях сравнения предложения WHERE для задания сравниваемого значения. Однако они не разрешены в качестве идентификаторов (таких как имена таблиц или столбцов).

params

Необязательный список в виде массива (array) с таким количеством элементов, сколько связанных параметров в выполняемом SQL-запросе. Каждое значение рассматривается как строка (string).

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

Возвращает false в случае возникновения ошибки. Для успешных запросов, создающих набор результатов, таких как SELECT, SHOW, DESCRIBE или EXPLAIN, возвращает объект mysqli_result. Для других успешных запросов возвращается true.

Примеры

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

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

<?php

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

$query = 'SELECT Name, District FROM City WHERE CountryCode=? ORDER BY Name LIMIT 5';
$result = $mysqli->execute_query($query, ['DEU']);
foreach ($result as $row) {
printf("%s (%s)\n", $row["Name"], $row["District"]);
}

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

<?php

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

$query = 'SELECT Name, District FROM City WHERE CountryCode=? ORDER BY Name LIMIT 5';
$result = mysqli_execute_query($link, $query, ['DEU']);
foreach ($result as $row) {
printf("%s (%s)\n", $row["Name"], $row["District"]);
}

Вывод приведённых примеров будет похож на: 

Aachen (Nordrhein-Westfalen)
Augsburg (Baijeri)
Bergisch Gladbach (Nordrhein-Westfalen)
Berlin (Berliini)
Bielefeld (Nordrhein-Westfalen)

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