mysqli::multi_query
Выполняет один или несколько запросов,соединенных точкой с запятой.
Запросы отправляются асинхронно за один вызов базы данных, но база данных обрабатывает их последовательно. mysqli_multi_query () ожидает завершения первого запроса, прежде чем вернуть управление PHP. Затем сервер MySQL обработает следующий запрос в последовательности. Как только следующий результат будет готов, MySQL будет ждать следующего выполнения mysqli_next_result () из PHP.
Для обработки нескольких запросов рекомендуется использовать do-while . Соединение будет занято до тех пор, пока все запросы не будут завершены и их результаты не будут загружены в PHP. Никакой другой оператор не может быть выдан в том же соединении, пока не будут обработаны все запросы. Чтобы перейти к следующему запросу в последовательности, используйте mysqli_next_result () . Если следующий результат еще не готов, mysqli будет ждать ответа от сервера MySQL. Чтобы проверить, есть ли еще результаты, используйте mysqli_more_results () .
Для запросов, которые производят набор результатов, таких как SELECT, SHOW, DESCRIBE или EXPLAIN , для получения набора результатов можно использовать mysqli_use_result () или mysqli_store_result () . Для запросов, которые не производят набор результатов, те же функции могут использоваться для получения информации, такой как количество затронутых строк.
Выполнение операторов CALL для хранимых процедур может дать несколько наборов результатов. Если хранимая процедура содержит SELECT , наборы результатов возвращаются в том порядке, в котором они создаются при выполнении процедуры. Как правило, вызывающий не может знать, сколько наборов результатов вернет процедура, и должен быть готов получить несколько результатов. Конечный результат процедуры — это результат статуса, который не включает набор результатов. Статус показывает, была ли процедура успешной или произошла ошибка.
Parameters
Только процедурный стиль: объект mysqli, возвращаемый mysqli_connect () или mysqli_init ()
Строка,содержащая запросы,которые должны быть выполнены.Несколько запросов должны быть разделены точкой с запятой.
Предупреждение о безопасности:SQL-инъекция
Если запрос содержит какие-либо входные переменные, вместо этого следует использовать параметризованные подготовленные операторы . В качестве альтернативы данные должны быть правильно отформатированы, а все строки должны быть экранированы с помощью функции mysqli_real_escape_string () .
Return Values
Возвращает false , если первая инструкция не удалась. Чтобы получить последующие ошибки из других операторов, вы должны сначала вызвать mysqli_next_result () .
Examples
Пример # 1 MySQLi :: multi_query () Пример
mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT); $mysqli = new mysqli("localhost", "my_user", "my_password", "world"); $query = "SELECT CURRENT_USER();"; $query .= "SELECT Name FROM City ORDER BY ID LIMIT 20, 5"; /* execute multi query */ $mysqli->multi_query($query); do < /* store the result set in PHP */ if ($result = $mysqli->store_result()) < while ($row = $result->fetch_row()) < printf("%s\n", $row[0]); > > /* print divider */ if ($mysqli->more_results()) < printf("-----------------\n"); > > while ($mysqli->next_result()); mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT); $link = mysqli_connect("localhost", "my_user", "my_password", "world"); $query = "SELECT CURRENT_USER();"; $query .= "SELECT Name FROM City ORDER BY ID LIMIT 20, 5"; /* execute multi query */ mysqli_multi_query($link, $query); do < /* store the result set in PHP */ if ($result = mysqli_store_result($link)) < while ($row = mysqli_fetch_row($result)) < printf("%s\n", $row[0]); > > /* print divider */ if (mysqli_more_results($link)) < printf("-----------------\n"); > > while (mysqli_next_result($link)); Из приведенных выше примеров будет выведено нечто похожее:
my_user@localhost ----------------- Amersfoort Maastricht Dordrecht Leiden Haarlemmermeer
See Also
- mysqli_query () — Выполняет запрос к базе данных
- mysqli_use_result () — Инициирует получение набора результатов
- mysqli_store_result () — передает набор результатов из последнего запроса
- mysqli_next_result () — Готовит следующий результат из multi_query
- mysqli_more_results () — Проверяет, есть ли еще результаты запроса из мультизапроса
PHP 8.2
(PHP 5,7,8)mysqli::kill mysqli_kill Запрашивает у сервера поток Объектно-ориентированный стиль Процедурный стиль Эта функция используется для запроса сервера убить MySQL
(PHP 5,7,8)mysqli::more_results mysqli_more_results Проверяет,есть ли запросы из нескольких Объектно-ориентированный стиль Процедурный стиль Указывает,если один
(PHP 5,7,8)mysqli::next_result mysqli_next_result Подготовка из мультизапроса Объектно-ориентированный стиль Процедурный стиль Подготовка следующего набора результатов из предыдущего
(PHP 5,7,8)mysqli::options mysqli_options Set Объектно-ориентированный стиль Процедурный стиль Используется для установки дополнительных опций подключения и влияет на поведение при подключении.
Php множественный запрос mysql
Suggested improvement(s) to example 1.
reasons:
Multi_query only returns a non false response if a data/result set is returned and only checks for the first query entered. Switching the first SELECT query with the INSERT query will result in a premature exit of the example with the message «Multi query failed: (0)».
The example assumes that once the first query doesn’t fail that the other queries have succeeded as well. Or rather it just exits without reporting that one of the queries after the first query failed seeing that if a query fails next_result returns false.
The changes in the example comes after the creation of the string $sql.
$mysqli = new mysqli ( «example.com» , «user» , «password» , «database» );
if ( $mysqli -> connect_errno ) echo «Failed to connect to MySQL: (» . $mysqli -> connect_errno . «) » . $mysqli -> connect_error ;
>
if (! $mysqli -> query ( «DROP TABLE IF EXISTS test» ) || ! $mysqli -> query ( «CREATE TABLE test(id INT)» )) echo «Table creation failed: (» . $mysqli -> errno . «) » . $mysqli -> error ;
>
$sql = «SELECT COUNT(*) AS _num FROM test; » ;
$sql .= «INSERT INTO test(id) VALUES (1); » ;
$sql .= «SELECT COUNT(*) AS _num FROM test; » ;
// changes to example 1 start here
// don’t bother checking the result from multi_query since it will return false
// if the first query does not return data even if the query itself succeeds.
$mysqli -> multi_query ( $sql );
do // while (true); // exit only on error or when there are no more queries to process
// check if query currently being processed hasn’t failed
if ( 0 !== $mysqli -> errno )
echo «Multi query failed: (» . $mysqli -> errno . «) » . $mysqli -> error ;
break;
>
// exit loop if there ar no more queries to process
if ( false === ( $mysqli -> more_results () )
break;
>
// get result of the next query to process
// don’t bother to check for success/failure of the result
// since at the start of the loop there is an error check &
// report block.
$mysqli -> next_result ()
> while ( true ); // exit only on error or when there are no more queries to process
?>
Note that the normal while ($mysqli->more_results() && $mysqli->next_result() has been replaced by two checks and while (true);
This is due to the ‘problem’ that next_result will return false if the query in question failed.
So one either needs to do one last check after the while loop to check if there was an error or one has to split up the different actions.
The changes in the example do the splitting.
Множественные запросы
MySQL поддерживает наличие нескольких SQL предложений в тексте одного запроса. Пересылка на сервер нескольких выражений в одном запроса уменьшает количество клиент-серверных взаимодействий, но требует специальной обработки.
Множественные запросы, или мультизапросы, должны запускаться функцией mysqli_multi_query() . Отдельные SQL предложения в мультизапросе отделяются точкой с запятой. После выполнения мультизапроса все результирующие наборы, которые он вернул, необходимо извлечь.
MySQL сервер поддерживает наличие в одном мультизапросе подзапросов, как возвращающих результирующий набор, так и не возвращающих.
Пример #1 Множественные запросы
$mysqli = new mysqli ( «example.com» , «user» , «password» , «database» );
if ( $mysqli -> connect_errno ) echo «Не удалось подключиться к MySQL: (» . $mysqli -> connect_errno . «) » . $mysqli -> connect_error ;
>
if (! $mysqli -> query ( «DROP TABLE IF EXISTS test» ) || ! $mysqli -> query ( «CREATE TABLE test(id INT)» )) echo «Не удалось создать таблицу: (» . $mysqli -> errno . «) » . $mysqli -> error ;
>
$sql = «SELECT COUNT(*) AS _num FROM test; » ;
$sql .= «INSERT INTO test(id) VALUES (1); » ;
$sql .= «SELECT COUNT(*) AS _num FROM test; » ;
if (! $mysqli -> multi_query ( $sql )) echo «Не удалось выполнить мультизапрос: (» . $mysqli -> errno . «) » . $mysqli -> error ;
>
do if ( $res = $mysqli -> store_result ()) var_dump ( $res -> fetch_all ( MYSQLI_ASSOC ));
$res -> free ();
>
> while ( $mysqli -> more_results () && $mysqli -> next_result ());
?>
Результат выполнения данного примера:
array(1) < [0]=>array(1) < ["_num"]=>string(1) "0" > > array(1) < [0]=>array(1) < ["_num"]=>string(1) "1" > >
Рассмотрение аспектов безопасности
Функции API mysqli_query() и mysqli_real_query() во время работы не устанавливают на сервере специальный флаг, необходимый для выполнения мультизапросов. Отдельная API функция для мультизапросов позволяет снизить вероятность случайных SQL инъекций. Злоумышленник может попытаться добавить в конец запроса выражения, вроде ; DROP DATABASE mysql или ; SELECT SLEEP(999). Если ему это удастся, но не будет использоваться функция mysqli_multi_query, сервер не выполнит второе внедренное и опасное SQL выражение.
Пример #2 SQL инъекция
$mysqli = new mysqli ( «example.com» , «user» , «password» , «database» );
$res = $mysqli -> query ( «SELECT 1; DROP TABLE mysql.user» );
if (! $res ) echo «Ошибка при выполнении запроса: (» . $mysqli -> errno . «) » . $mysqli -> error ;
>
?>
Результат выполнения данного примера:
Ошибка при выполнении запроса: (1064) You have an error in your SQL syntax; check the manual that corresponds to your MySQL server version for the right syntax to use near 'DROP TABLE mysql.user' at line 1
Использование множества выражений в подготавливаемом запросе не поддерживается.
- mysqli::query()
- mysqli::multi_query()
- mysqli_result::next-result()
- mysqli_result::more-results()
Как на php выполнить сразу несколько SQL запросов?
Возникла такая проблема. Необходимо сделать UPDATE запрос для нескольких записей в таблице. Точнее сказать для нескольких десятков записей. К примеру таблица заказов (в интернет-магазине) и нужно обновить статусы сразу нескольких заказов (скажем при выгрузке этих статусов из 1с). Соответственно, нужно сделать несколько UPDATE запросов. Используя php функцию mysql_query это можно сделать только так: вызвать ее в цикле нужное количество раз, передав ей UPDATE запрос. В итоге если нужно обновить статусы 1000 заказов, то будет 1000 запросов к бд, что мне видится не очень хорошим решением. Сформировать один большой запрос из UPDATE-ов, разделив из точкой с запятой нельзя, т.к. mysql_query может выполнить только один запрос за раз. Как быть в данной ситуации? Выполняя запрос описанным выше способом я получаю 504-ую ошибку. Не нравится нашему серверу что идет столько запросов в один момент времени.
UPDATE your_table SET status=new_status WHERE order_id IN (id,ваших,тысячи,заказов,указанные,через,запятую)
В чем проблема-то? Работайте в рамках теории множеств, уходите от циклов при работе с БД и будет вам счастье.
Прочел ваше сообщение и схватился за голову! Какой же я идиот! Ведь действительно, статус то я должен установить всем ОДИНАКОВЫЙ (хотя в вопросе я это не написал, но вы догадались. ), поэтому все 1000 заказов могу через запятую перечислить после WHERE.
Первый способ: сохранить запросы в файл и импортировать этот файл через командную строку. mysql -u user database < /home/username/mysqldump.sql
Второй способ: можно сократить количество запросов немного поменяв логику построения запроса. Вместо
UPDATE `products` SET `status` = 1 WHERE `product_id` = 1; UPDATE `products` SET `status` = 1 WHERE `product_id` = 2; -- UPDATE `products` SET `status` = 1 WHERE `product_id` = 1000;UPDATE `products` SET `status` = 1 WHERE `product_id` IN (1, 2, 3, 4, 5); UPDATE `products` SET `status` = 2 WHERE `product_id` IN (6, 7, 8, 9);Update: оу. я так медленно пишу. Когда начинал писать, ни одного ответа ещё не было. ))