PHP: полный мануал с примерами, функциями и ООП

PHP 5+; изменения отмечены · mysqli; mysqlnd для отмеченных операций

new mysqli(?string $hostname=null, ?string $username=null, ?string $password=null, ?string $database=null, ?int $port=null, ?string $socket=null); mysqli_connect(...): mysqli|false

<?php
mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
$config = require __DIR__ . '/config.php';
$db = new mysqli($config['host'], $config['user'], $config['password'], $config['database'], $config['port']);
$db->set_charset('utf8mb4');
require __DIR__ . '/seed.php';
$result = $db->query('SELECT name, stock FROM products WHERE id = 1');
$row = $result->fetch_assoc();
echo $row['name'], ' — ', $row['stock'], " шт.\n";

Молоток — 8 шт.

Открыть соединение сайта с конкретной базой MySQL.

Процедурная функция получает соединение $db, команду $statement или результат $result первым аргументом. В записи $object->method(...) тот же объект стоит перед стрелкой. Свойство читается без круглых скобок. Эти варианты используют один механизм: выбирать стиль стоит по понятности проекта. аргументы и возврат, объект и его состояние.

new mysqli с аргументами открывает соединение; без аргументов только инициализирует объект для options/real_connect. Конструктор возвращает объект даже при неуспехе в режиме без исключений: тогда проверяют connect_errno. mysqli_connect возвращает mysqli либо false. Метод connect возвращает true/false (до PHP 8.1 null при успехе). С PHP 8.5 повторный вызов __construct на уже сконструированном объекте — Error. Для настроек TLS/timeout сначала создайте пустой объект, задайте options, затем real_connect.

SQL-ошибка при MYSQLI_REPORT_ERROR выдаёт warning, при сочетании с MYSQLI_REPORT_STRICT — mysqli_sql_exception; с PHP 8.1 это сочетание включено по умолчанию. В примерах оно задано явно. Ошибки типов, закрытого объекта и неверных аргументов могут возникать отдельно; сырое сообщение SQL не публикуют посетителю.

Путь данных. Адрес и учётные данные выбирают сервер и базу → Соединение сохраняется в $db → SQL выполняется через это соединение → Результат отдельно читается в PHP.

Как читать этот вариант. Контекстный пример: нужен отдельный учебный MySQL, расширение mysqli, база course_demo и её пользователь course_user с разрешением временных таблиц. Учебные параметры подключения заменяют своими; рабочие базы не используют. Здесь проверен PHP-синтаксис, серверный запрос не выполнялся. new создаёт объект соединения. query выполняет SQL, fetch_assoc превращает строку результата в массив; по ключу answer читаем её значение. Данные доступа здесь учебные.

<?php
mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
$db = new mysqli('127.0.0.1', 'course_user', 'course_password', 'course_demo', 3306);
$db->set_charset('utf8mb4');
$result = $db->query('SELECT 42 AS answer');
echo $result->fetch_assoc()['answer'], "\n";
$db->close();

42

Как читать этот вариант. Контекстный пример: нужен отдельный учебный MySQL, расширение mysqli, база course_demo и её пользователь course_user с разрешением временных таблиц. Учебные параметры подключения заменяют своими; рабочие базы не используют. Здесь проверен PHP-синтаксис, серверный запрос не выполнялся. Объект соединения теперь первый аргумент функции. Процедурный стиль не требует копировать SQL-логику и не имеет существенной разницы скорости с методами.

<?php
mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
$db = mysqli_connect('127.0.0.1', 'course_user', 'course_password', 'course_demo', 3306);
mysqli_set_charset($db, 'utf8mb4');
$result = mysqli_query($db, "SELECT 'Готово' AS status");
$row = mysqli_fetch_assoc($result);
echo $row['status'], "\n";
mysqli_close($db);

Готово

Связанные операции: mysqli_init, mysqli_real_connect, mysqli_set_charset.

Оба входа к этой операции: mysqli_connect, mysqli::__construct.

• PHP: mysqli.construct

PHP 5+; изменения отмечены · mysqli; mysqlnd для отмеченных операций

new mysqli(?string $hostname=null, ?string $username=null, ?string $password=null, ?string $database=null, ?int $port=null, ?string $socket=null); mysqli_connect(...): mysqli|false

<?php
mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
$config = require __DIR__ . '/config.php';
$db = new mysqli($config['host'], $config['user'], $config['password'], $config['database'], $config['port']);
$db->set_charset('utf8mb4');
require __DIR__ . '/seed.php';
$result = $db->query('SELECT name, stock FROM products WHERE id = 1');
$row = $result->fetch_assoc();
echo $row['name'], ' — ', $row['stock'], " шт.\n";

Молоток — 8 шт.

Открыть соединение сайта с конкретной базой MySQL.

Процедурная функция получает соединение $db, команду $statement или результат $result первым аргументом. В записи $object->method(...) тот же объект стоит перед стрелкой. Свойство читается без круглых скобок. Эти варианты используют один механизм: выбирать стиль стоит по понятности проекта. аргументы и возврат, объект и его состояние.

new mysqli с аргументами открывает соединение; без аргументов только инициализирует объект для options/real_connect. Конструктор возвращает объект даже при неуспехе в режиме без исключений: тогда проверяют connect_errno. mysqli_connect возвращает mysqli либо false. Метод connect возвращает true/false (до PHP 8.1 null при успехе). С PHP 8.5 повторный вызов __construct на уже сконструированном объекте — Error. Для настроек TLS/timeout сначала создайте пустой объект, задайте options, затем real_connect.

SQL-ошибка при MYSQLI_REPORT_ERROR выдаёт warning, при сочетании с MYSQLI_REPORT_STRICT — mysqli_sql_exception; с PHP 8.1 это сочетание включено по умолчанию. В примерах оно задано явно. Ошибки типов, закрытого объекта и неверных аргументов могут возникать отдельно; сырое сообщение SQL не публикуют посетителю.

Путь данных. Адрес и учётные данные выбирают сервер и базу → Соединение сохраняется в $db → SQL выполняется через это соединение → Результат отдельно читается в PHP.

Как читать этот вариант. Контекстный пример: нужен отдельный учебный MySQL, расширение mysqli, база course_demo и её пользователь course_user с разрешением временных таблиц. Учебные параметры подключения заменяют своими; рабочие базы не используют. Здесь проверен PHP-синтаксис, серверный запрос не выполнялся. new создаёт объект соединения. query выполняет SQL, fetch_assoc превращает строку результата в массив; по ключу answer читаем её значение. Данные доступа здесь учебные.

<?php
mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
$db = new mysqli('127.0.0.1', 'course_user', 'course_password', 'course_demo', 3306);
$db->set_charset('utf8mb4');
$result = $db->query('SELECT 42 AS answer');
echo $result->fetch_assoc()['answer'], "\n";
$db->close();

42

Как читать этот вариант. Контекстный пример: нужен отдельный учебный MySQL, расширение mysqli, база course_demo и её пользователь course_user с разрешением временных таблиц. Учебные параметры подключения заменяют своими; рабочие базы не используют. Здесь проверен PHP-синтаксис, серверный запрос не выполнялся. Объект соединения теперь первый аргумент функции. Процедурный стиль не требует копировать SQL-логику и не имеет существенной разницы скорости с методами.

<?php
mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
$db = mysqli_connect('127.0.0.1', 'course_user', 'course_password', 'course_demo', 3306);
mysqli_set_charset($db, 'utf8mb4');
$result = mysqli_query($db, "SELECT 'Готово' AS status");
$row = mysqli_fetch_assoc($result);
echo $row['status'], "\n";
mysqli_close($db);

Готово

Связанные операции: mysqli_init, mysqli_real_connect, mysqli_set_charset.

Оба входа к этой операции: mysqli_connect, mysqli::__construct.

• PHP: mysqli.construct

PHP 5+; изменения отмечены · mysqli; mysqlnd для отмеченных операций

mysqli::connect(?string $hostname=null, ?string $username=null, ?string $password=null, ?string $database=null, ?int $port=null, ?string $socket=null): bool

<?php
mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
$config = require __DIR__ . '/config.php';
$db = new mysqli($config['host'], $config['user'], $config['password'], $config['database'], $config['port']);
$db->set_charset('utf8mb4');
require __DIR__ . '/seed.php';
$result = $db->query('SELECT name, stock FROM products WHERE id = 1');
$row = $result->fetch_assoc();
echo $row['name'], ' — ', $row['stock'], " шт.\n";

Молоток — 8 шт.

Соединить уже инициализированный mysqli с сервером.

Процедурная функция получает соединение $db, команду $statement или результат $result первым аргументом. В записи $object->method(...) тот же объект стоит перед стрелкой. Свойство читается без круглых скобок. Эти варианты используют один механизм: выбирать стиль стоит по понятности проекта. аргументы и возврат, объект и его состояние.

new mysqli с аргументами открывает соединение; без аргументов только инициализирует объект для options/real_connect. Конструктор возвращает объект даже при неуспехе в режиме без исключений: тогда проверяют connect_errno. mysqli_connect возвращает mysqli либо false. Метод connect возвращает true/false (до PHP 8.1 null при успехе). С PHP 8.5 повторный вызов __construct на уже сконструированном объекте — Error. Для настроек TLS/timeout сначала создайте пустой объект, задайте options, затем real_connect.

SQL-ошибка при MYSQLI_REPORT_ERROR выдаёт warning, при сочетании с MYSQLI_REPORT_STRICT — mysqli_sql_exception; с PHP 8.1 это сочетание включено по умолчанию. В примерах оно задано явно. Ошибки типов, закрытого объекта и неверных аргументов могут возникать отдельно; сырое сообщение SQL не публикуют посетителю.

Путь данных. new mysqli без аргументов готовит объект → connect получает адрес и учётные данные → true подтверждает открытие; затем можно выполнять SQL.

Как читать этот вариант. Контекстный пример: нужен отдельный учебный MySQL, расширение mysqli, база course_demo и её пользователь course_user с разрешением временных таблиц. Учебные параметры подключения заменяют своими; рабочие базы не используют. Здесь проверен PHP-синтаксис, серверный запрос не выполнялся. Для параметров открытия/флагов используйте real_connect. Метод connect — исторический дополнительный вход, а не повторный ручной запуск конструктора.

<?php
mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
$db = new mysqli();
$ok = $db->connect('127.0.0.1', 'course_user', 'course_password', 'course_demo', 3306);
var_dump($ok);
$db->set_charset('utf8mb4');
echo $db->query('SELECT 7')->fetch_column(), "\n";

bool(true)
7

Как читать этот вариант. Контекстный пример: нужен отдельный учебный MySQL, расширение mysqli, база course_demo и её пользователь course_user с разрешением временных таблиц. Учебные параметры подключения заменяют своими; рабочие базы не используют. Здесь проверен PHP-синтаксис, серверный запрос не выполнялся. Объект соединения теперь первый аргумент функции. Процедурный стиль не требует копировать SQL-логику и не имеет существенной разницы скорости с методами.

<?php
mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
$db = mysqli_connect('127.0.0.1', 'course_user', 'course_password', 'course_demo', 3306);
mysqli_set_charset($db, 'utf8mb4');
$result = mysqli_query($db, "SELECT 'Готово' AS status");
$row = mysqli_fetch_assoc($result);
echo $row['status'], "\n";
mysqli_close($db);

Готово

Связанные операции: mysqli_real_connect, mysqli_connect.

• PHP: mysqli.construct

PHP 5+; изменения отмечены · mysqli; mysqlnd для отмеченных операций

mysqli_init(): mysqli|false; mysqli::init(): ?bool

<?php
mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
$config = require __DIR__ . '/config.php';
$db = mysqli_init();
$db->options(MYSQLI_OPT_CONNECT_TIMEOUT, 3);
$db->real_connect($config['host'], $config['user'], $config['password'], $config['database'], $config['port']);
$db->set_charset('utf8mb4');
require __DIR__ . '/seed.php';
$result = $db->query('SELECT name, stock FROM products WHERE id = 1');
$row = $result->fetch_assoc();
echo $row['name'], ' — ', $row['stock'], " шт.\n";

Молоток — 8 шт.

Отделить настройку будущего соединения от его открытия.

Процедурная функция получает соединение $db, команду $statement или результат $result первым аргументом. В записи $object->method(...) тот же объект стоит перед стрелкой. Свойство читается без круглых скобок. Эти варианты используют один механизм: выбирать стиль стоит по понятности проекта. аргументы и возврат, объект и его состояние.

Процедурный вызов даёт объект либо false. Объектный init даёт null/false и deprecated с PHP 8.1; в наследнике заменяют parent::init() на parent::__construct() без аргументов. До real_connect разрешены подготовительные options/ssl_set, операции запросов ещё невозможны. Это объект состояния, а не работающий сервер.

Путь данных. Инициализировать mysqli → Настроить timeout/TLS → real_connect открывает сервер → query становится доступен.

Как читать этот вариант. Инициализация ещё не доказывает доступность MySQL. Здесь сеть не используется: сохраняется опция для будущего соединения.

<?php
$db = mysqli_init();
var_dump($db instanceof mysqli);
var_dump($db->options(MYSQLI_OPT_CONNECT_TIMEOUT, 3));

bool(true)
bool(true)

Как читать этот вариант. В новом коде new mysqli() заменяет устаревший объектный init. Процедурный mysqli_init по-прежнему поддерживается. READ_TIMEOUT в mysqlnd ограничивает ожидание результата, а не всё бизнес-действие.

<?php
$db = new mysqli();
var_dump($db->options(MYSQLI_OPT_READ_TIMEOUT, 5));
echo "Настройка сохранена, подключения пока нет\n";

bool(true)
Настройка сохранена, подключения пока нет

Связанные операции: mysqli_options, mysqli_ssl_set, mysqli_real_connect.

Оба входа к этой операции: mysqli_init, mysqli::init.

• PHP: mysqli.init

PHP 5+; изменения отмечены · mysqli; mysqlnd для отмеченных операций

mysqli_init(): mysqli|false; mysqli::init(): ?bool

<?php
mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
$config = require __DIR__ . '/config.php';
$db = mysqli_init();
$db->options(MYSQLI_OPT_CONNECT_TIMEOUT, 3);
$db->real_connect($config['host'], $config['user'], $config['password'], $config['database'], $config['port']);
$db->set_charset('utf8mb4');
require __DIR__ . '/seed.php';
$result = $db->query('SELECT name, stock FROM products WHERE id = 1');
$row = $result->fetch_assoc();
echo $row['name'], ' — ', $row['stock'], " шт.\n";

Молоток — 8 шт.

Отделить настройку будущего соединения от его открытия.

Процедурная функция получает соединение $db, команду $statement или результат $result первым аргументом. В записи $object->method(...) тот же объект стоит перед стрелкой. Свойство читается без круглых скобок. Эти варианты используют один механизм: выбирать стиль стоит по понятности проекта. аргументы и возврат, объект и его состояние.

Процедурный вызов даёт объект либо false. Объектный init даёт null/false и deprecated с PHP 8.1; в наследнике заменяют parent::init() на parent::__construct() без аргументов. До real_connect разрешены подготовительные options/ssl_set, операции запросов ещё невозможны. Это объект состояния, а не работающий сервер.

Путь данных. Инициализировать mysqli → Настроить timeout/TLS → real_connect открывает сервер → query становится доступен.

Как читать этот вариант. Инициализация ещё не доказывает доступность MySQL. Здесь сеть не используется: сохраняется опция для будущего соединения.

<?php
$db = mysqli_init();
var_dump($db instanceof mysqli);
var_dump($db->options(MYSQLI_OPT_CONNECT_TIMEOUT, 3));

bool(true)
bool(true)

Как читать этот вариант. В новом коде new mysqli() заменяет устаревший объектный init. Процедурный mysqli_init по-прежнему поддерживается. READ_TIMEOUT в mysqlnd ограничивает ожидание результата, а не всё бизнес-действие.

<?php
$db = new mysqli();
var_dump($db->options(MYSQLI_OPT_READ_TIMEOUT, 5));
echo "Настройка сохранена, подключения пока нет\n";

bool(true)
Настройка сохранена, подключения пока нет

Связанные операции: mysqli_options, mysqli_ssl_set, mysqli_real_connect.

Оба входа к этой операции: mysqli_init, mysqli::init.

• PHP: mysqli.init

PHP 5+; изменения отмечены · mysqli; mysqlnd для отмеченных операций

mysqli_real_connect(mysqli $mysql, ?string $hostname=null, ?string $username=null, ?string $password=null, ?string $database=null, ?int $port=null, ?string $socket=null, int $flags=0): bool; mysqli::real_connect(...): bool

<?php
mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
$config = require __DIR__ . '/config.php';
$db = mysqli_init();
$db->options(MYSQLI_OPT_CONNECT_TIMEOUT, 3);
$db->real_connect($config['host'], $config['user'], $config['password'], $config['database'], $config['port']);
$db->set_charset('utf8mb4');
require __DIR__ . '/seed.php';
$result = $db->query('SELECT name, stock FROM products WHERE id = 1');
$row = $result->fetch_assoc();
echo $row['name'], ' — ', $row['stock'], " шт.\n";

Молоток — 8 шт.

Открыть заранее настроенное соединение, в том числе с флагами протокола.

Процедурная функция получает соединение $db, команду $statement или результат $result первым аргументом. В записи $object->method(...) тот же объект стоит перед стрелкой. Свойство читается без круглых скобок. Эти варианты используют один механизм: выбирать стиль стоит по понятности проекта. аргументы и возврат, объект и его состояние.

true/false. Параметры nullable с PHP 7.4. MULTI_STATEMENT не включают флагом соединения в PHP: для нескольких команд есть отдельный multi_query. SSL_DONT_VERIFY_SERVER_CERT ослабляет проверку и не подходит как исправление неверного сертификата; транспорт/socket определяется hostname. Настройки должны быть сохранены до real_connect.

SQL-ошибка при MYSQLI_REPORT_ERROR выдаёт warning, при сочетании с MYSQLI_REPORT_STRICT — mysqli_sql_exception; с PHP 8.1 это сочетание включено по умолчанию. В примерах оно задано явно. Ошибки типов, закрытого объекта и неверных аргументов могут возникать отдельно; сырое сообщение SQL не публикуют посетителю.

Путь данных. mysqli_init создаёт пустой объект → options выбирает ожидание → real_connect открывает с нужными флагами → Команды используют согласованный режим.

Как читать этот вариант. Контекстный пример: нужен отдельный учебный MySQL, расширение mysqli, база course_demo и её пользователь course_user с разрешением временных таблиц. Учебные параметры подключения заменяют своими; рабочие базы не используют. Здесь проверен PHP-синтаксис, серверный запрос не выполнялся. Timeout выбирают до открытия. После него код не превращается в гарантированно трёхсекундный HTTP-ответ: SQL, обработка данных и сеть имеют другие границы.

<?php
mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
$db = mysqli_init();
$db->options(MYSQLI_OPT_CONNECT_TIMEOUT, 3);
$db->real_connect('127.0.0.1', 'course_user', 'course_password', 'course_demo', 3306);
$db->set_charset('utf8mb4');
echo $db->query('SELECT 42')->fetch_column(), "\n";

42

Как читать этот вариант. Контекстный пример: нужен отдельный учебный MySQL, расширение mysqli, база course_demo и её пользователь course_user с разрешением временных таблиц. Учебные параметры подключения заменяют своими; рабочие базы не используют. Здесь проверен PHP-синтаксис, серверный запрос не выполнялся. FOUND_ROWS считает совпавшую строку, хотя quantity не изменилось. Без флага для этого UPDATE счётчик обычно 0. Флаг выбирается осознанно, он не доказывает новое изменение.

<?php
mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
$db = mysqli_init();
mysqli_real_connect($db, '127.0.0.1', 'course_user', 'course_password', 'course_demo', 3306, null, MYSQLI_CLIENT_FOUND_ROWS);
$db->query('CREATE TEMPORARY TABLE course_stock (id INT PRIMARY KEY, quantity INT)');
$db->query('INSERT INTO course_stock VALUES (1, 2)');
$db->query('UPDATE course_stock SET quantity = 2 WHERE id = 1');
echo $db->affected_rows, "\n";

1

Связанные операции: mysqli_options, mysqli_ssl_set, mysqli_affected_rows.

Оба входа к этой операции: mysqli_real_connect, mysqli::real_connect.

• PHP: mysqli.real-connect

PHP 5+; изменения отмечены · mysqli; mysqlnd для отмеченных операций

mysqli_real_connect(mysqli $mysql, ?string $hostname=null, ?string $username=null, ?string $password=null, ?string $database=null, ?int $port=null, ?string $socket=null, int $flags=0): bool; mysqli::real_connect(...): bool

<?php
mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
$config = require __DIR__ . '/config.php';
$db = mysqli_init();
$db->options(MYSQLI_OPT_CONNECT_TIMEOUT, 3);
$db->real_connect($config['host'], $config['user'], $config['password'], $config['database'], $config['port']);
$db->set_charset('utf8mb4');
require __DIR__ . '/seed.php';
$result = $db->query('SELECT name, stock FROM products WHERE id = 1');
$row = $result->fetch_assoc();
echo $row['name'], ' — ', $row['stock'], " шт.\n";

Молоток — 8 шт.

Открыть заранее настроенное соединение, в том числе с флагами протокола.

Процедурная функция получает соединение $db, команду $statement или результат $result первым аргументом. В записи $object->method(...) тот же объект стоит перед стрелкой. Свойство читается без круглых скобок. Эти варианты используют один механизм: выбирать стиль стоит по понятности проекта. аргументы и возврат, объект и его состояние.

true/false. Параметры nullable с PHP 7.4. MULTI_STATEMENT не включают флагом соединения в PHP: для нескольких команд есть отдельный multi_query. SSL_DONT_VERIFY_SERVER_CERT ослабляет проверку и не подходит как исправление неверного сертификата; транспорт/socket определяется hostname. Настройки должны быть сохранены до real_connect.

SQL-ошибка при MYSQLI_REPORT_ERROR выдаёт warning, при сочетании с MYSQLI_REPORT_STRICT — mysqli_sql_exception; с PHP 8.1 это сочетание включено по умолчанию. В примерах оно задано явно. Ошибки типов, закрытого объекта и неверных аргументов могут возникать отдельно; сырое сообщение SQL не публикуют посетителю.

Путь данных. mysqli_init создаёт пустой объект → options выбирает ожидание → real_connect открывает с нужными флагами → Команды используют согласованный режим.

Как читать этот вариант. Контекстный пример: нужен отдельный учебный MySQL, расширение mysqli, база course_demo и её пользователь course_user с разрешением временных таблиц. Учебные параметры подключения заменяют своими; рабочие базы не используют. Здесь проверен PHP-синтаксис, серверный запрос не выполнялся. Timeout выбирают до открытия. После него код не превращается в гарантированно трёхсекундный HTTP-ответ: SQL, обработка данных и сеть имеют другие границы.

<?php
mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
$db = mysqli_init();
$db->options(MYSQLI_OPT_CONNECT_TIMEOUT, 3);
$db->real_connect('127.0.0.1', 'course_user', 'course_password', 'course_demo', 3306);
$db->set_charset('utf8mb4');
echo $db->query('SELECT 42')->fetch_column(), "\n";

42

Как читать этот вариант. Контекстный пример: нужен отдельный учебный MySQL, расширение mysqli, база course_demo и её пользователь course_user с разрешением временных таблиц. Учебные параметры подключения заменяют своими; рабочие базы не используют. Здесь проверен PHP-синтаксис, серверный запрос не выполнялся. FOUND_ROWS считает совпавшую строку, хотя quantity не изменилось. Без флага для этого UPDATE счётчик обычно 0. Флаг выбирается осознанно, он не доказывает новое изменение.

<?php
mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
$db = mysqli_init();
mysqli_real_connect($db, '127.0.0.1', 'course_user', 'course_password', 'course_demo', 3306, null, MYSQLI_CLIENT_FOUND_ROWS);
$db->query('CREATE TEMPORARY TABLE course_stock (id INT PRIMARY KEY, quantity INT)');
$db->query('INSERT INTO course_stock VALUES (1, 2)');
$db->query('UPDATE course_stock SET quantity = 2 WHERE id = 1');
echo $db->affected_rows, "\n";

1

Связанные операции: mysqli_options, mysqli_ssl_set, mysqli_affected_rows.

Оба входа к этой операции: mysqli_real_connect, mysqli::real_connect.

• PHP: mysqli.real-connect

PHP 5+; изменения отмечены · mysqli; mysqlnd для отмеченных операций

mysqli_options(mysqli $mysql, int $option, string|int $value): bool; mysqli::options(int $option, string|int $value): bool

<?php
mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
$config = require __DIR__ . '/config.php';
$db = mysqli_init();
$db->options(MYSQLI_OPT_CONNECT_TIMEOUT, 3);
$db->real_connect($config['host'], $config['user'], $config['password'], $config['database'], $config['port']);
$db->set_charset('utf8mb4');
require __DIR__ . '/seed.php';
$result = $db->query('SELECT name, stock FROM products WHERE id = 1');
$row = $result->fetch_assoc();
echo $row['name'], ' — ', $row['stock'], " шт.\n";

Молоток — 8 шт.

Задать параметры соединения и mysqlnd до открытия.

Процедурная функция получает соединение $db, команду $statement или результат $result первым аргументом. В записи $object->method(...) тот же объект стоит перед стрелкой. Свойство читается без круглых скобок. Эти варианты используют один механизм: выбирать стиль стоит по понятности проекта. аргументы и возврат, объект и его состояние.

true/false. Можно вызвать несколько раз; после init и до real_connect. READ_DEFAULT_FILE/GROUP относятся к libmysqlclient, mysqlnd не читает my.cnf. OPT_INT_AND_FLOAT_NATIVE, сетевые буферы — mysqlnd. MYSQLI_OPT_READ_TIMEOUT доступен с PHP 7.2: старая заметка общей конфигурационной страницы об отсутствии такого API не описывает современный options. Включение LOCAL INFILE разрешает чтение файлов PHP-процесса и требует отдельной политики доверия.

SQL-ошибка при MYSQLI_REPORT_ERROR выдаёт warning, при сочетании с MYSQLI_REPORT_STRICT — mysqli_sql_exception; с PHP 8.1 это сочетание включено по умолчанию. В примерах оно задано явно. Ошибки типов, закрытого объекта и неверных аргументов могут возникать отдельно; сырое сообщение SQL не публикуют посетителю.

Путь данных. Выбрать смысл настройки → Передать значение с единицами → Сохранить до открытия → real_connect использует подготовленный объект.

Как читать этот вариант. Обе опции сохранены до соединения. Первая касается открытия, вторая ожидания результата команды; это разные участки работы.

<?php
$db = new mysqli();
var_dump($db->options(MYSQLI_OPT_CONNECT_TIMEOUT, 3));
var_dump($db->options(MYSQLI_OPT_READ_TIMEOUT, 10));

bool(true)
bool(true)

Как читать этот вариант. Контекстный пример: нужен отдельный учебный MySQL, расширение mysqli, база course_demo и её пользователь course_user с разрешением временных таблиц. Учебные параметры подключения заменяют своими; рабочие базы не используют. Здесь проверен PHP-синтаксис, серверный запрос не выполнялся. Опция mysqlnd превращает подходящие числовые значения обычного query в PHP-числа. Для больших чисел/DECIMAL сохраняйте точность; опция не является универсальным преобразователем любых денежных строк.

<?php
mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
$db = mysqli_init();
mysqli_options($db, MYSQLI_OPT_INT_AND_FLOAT_NATIVE, 1);
$db->real_connect('127.0.0.1', 'course_user', 'course_password', 'course_demo', 3306);
$row = $db->query('SELECT 42 AS quantity')->fetch_assoc();
var_dump($row['quantity']);

int(42)

Связанные операции: mysqli_real_connect, mysqli_set_charset.

Оба входа к этой операции: mysqli_options, mysqli::options.

• PHP: mysqli.options

PHP 5+; изменения отмечены · mysqli; mysqlnd для отмеченных операций

mysqli_options(mysqli $mysql, int $option, string|int $value): bool; mysqli::options(int $option, string|int $value): bool

<?php
mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
$config = require __DIR__ . '/config.php';
$db = mysqli_init();
$db->options(MYSQLI_OPT_CONNECT_TIMEOUT, 3);
$db->real_connect($config['host'], $config['user'], $config['password'], $config['database'], $config['port']);
$db->set_charset('utf8mb4');
require __DIR__ . '/seed.php';
$result = $db->query('SELECT name, stock FROM products WHERE id = 1');
$row = $result->fetch_assoc();
echo $row['name'], ' — ', $row['stock'], " шт.\n";

Молоток — 8 шт.

Задать параметры соединения и mysqlnd до открытия.

Процедурная функция получает соединение $db, команду $statement или результат $result первым аргументом. В записи $object->method(...) тот же объект стоит перед стрелкой. Свойство читается без круглых скобок. Эти варианты используют один механизм: выбирать стиль стоит по понятности проекта. аргументы и возврат, объект и его состояние.

true/false. Можно вызвать несколько раз; после init и до real_connect. READ_DEFAULT_FILE/GROUP относятся к libmysqlclient, mysqlnd не читает my.cnf. OPT_INT_AND_FLOAT_NATIVE, сетевые буферы — mysqlnd. MYSQLI_OPT_READ_TIMEOUT доступен с PHP 7.2: старая заметка общей конфигурационной страницы об отсутствии такого API не описывает современный options. Включение LOCAL INFILE разрешает чтение файлов PHP-процесса и требует отдельной политики доверия.

SQL-ошибка при MYSQLI_REPORT_ERROR выдаёт warning, при сочетании с MYSQLI_REPORT_STRICT — mysqli_sql_exception; с PHP 8.1 это сочетание включено по умолчанию. В примерах оно задано явно. Ошибки типов, закрытого объекта и неверных аргументов могут возникать отдельно; сырое сообщение SQL не публикуют посетителю.

Путь данных. Выбрать смысл настройки → Передать значение с единицами → Сохранить до открытия → real_connect использует подготовленный объект.

Как читать этот вариант. Обе опции сохранены до соединения. Первая касается открытия, вторая ожидания результата команды; это разные участки работы.

<?php
$db = new mysqli();
var_dump($db->options(MYSQLI_OPT_CONNECT_TIMEOUT, 3));
var_dump($db->options(MYSQLI_OPT_READ_TIMEOUT, 10));

bool(true)
bool(true)

Как читать этот вариант. Контекстный пример: нужен отдельный учебный MySQL, расширение mysqli, база course_demo и её пользователь course_user с разрешением временных таблиц. Учебные параметры подключения заменяют своими; рабочие базы не используют. Здесь проверен PHP-синтаксис, серверный запрос не выполнялся. Опция mysqlnd превращает подходящие числовые значения обычного query в PHP-числа. Для больших чисел/DECIMAL сохраняйте точность; опция не является универсальным преобразователем любых денежных строк.

<?php
mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
$db = mysqli_init();
mysqli_options($db, MYSQLI_OPT_INT_AND_FLOAT_NATIVE, 1);
$db->real_connect('127.0.0.1', 'course_user', 'course_password', 'course_demo', 3306);
$row = $db->query('SELECT 42 AS quantity')->fetch_assoc();
var_dump($row['quantity']);

int(42)

Связанные операции: mysqli_real_connect, mysqli_set_charset.

Оба входа к этой операции: mysqli_options, mysqli::options.

• PHP: mysqli.options

PHP 5+; изменения отмечены · mysqli; mysqlnd для отмеченных операций

mysqli_set_opt(mysqli $mysql, int $option, string|int $value): bool; mysqli::set_opt(int $option, string|int $value): bool

<?php
mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
$config = require __DIR__ . '/config.php';
$db = mysqli_init();
$db->options(MYSQLI_OPT_CONNECT_TIMEOUT, 3);
$db->real_connect($config['host'], $config['user'], $config['password'], $config['database'], $config['port']);
$db->set_charset('utf8mb4');
require __DIR__ . '/seed.php';
$result = $db->query('SELECT name, stock FROM products WHERE id = 1');
$row = $result->fetch_assoc();
echo $row['name'], ' — ', $row['stock'], " шт.\n";

Молоток — 8 шт.

Прочитать старый код с альтернативным именем options.

Процедурная функция получает соединение $db, команду $statement или результат $result первым аргументом. В записи $object->method(...) тот же объект стоит перед стрелкой. Свойство читается без круглых скобок. Эти варианты используют один механизм: выбирать стиль стоит по понятности проекта. аргументы и возврат, объект и его состояние.

Алиас mysqli_options: те же сроки вызова, параметры, return и ошибки. Новому коду удобнее единообразное options; два примера показывают целевую операцию, менять логику при переименовании не нужно.

SQL-ошибка при MYSQLI_REPORT_ERROR выдаёт warning, при сочетании с MYSQLI_REPORT_STRICT — mysqli_sql_exception; с PHP 8.1 это сочетание включено по умолчанию. В примерах оно задано явно. Ошибки типов, закрытого объекта и неверных аргументов могут возникать отдельно; сырое сообщение SQL не публикуют посетителю.

Путь данных. set_opt выбирает ту же операцию options → Параметры сохраняются до соединения → Открытие использует эти настройки.

Как читать этот вариант. Обе опции сохранены до соединения. Первая касается открытия, вторая ожидания результата команды; это разные участки работы.

<?php
$db = new mysqli();
var_dump($db->options(MYSQLI_OPT_CONNECT_TIMEOUT, 3));
var_dump($db->options(MYSQLI_OPT_READ_TIMEOUT, 10));

bool(true)
bool(true)

Как читать этот вариант. Контекстный пример: нужен отдельный учебный MySQL, расширение mysqli, база course_demo и её пользователь course_user с разрешением временных таблиц. Учебные параметры подключения заменяют своими; рабочие базы не используют. Здесь проверен PHP-синтаксис, серверный запрос не выполнялся. Опция mysqlnd превращает подходящие числовые значения обычного query в PHP-числа. Для больших чисел/DECIMAL сохраняйте точность; опция не является универсальным преобразователем любых денежных строк.

<?php
mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
$db = mysqli_init();
mysqli_options($db, MYSQLI_OPT_INT_AND_FLOAT_NATIVE, 1);
$db->real_connect('127.0.0.1', 'course_user', 'course_password', 'course_demo', 3306);
$row = $db->query('SELECT 42 AS quantity')->fetch_assoc();
var_dump($row['quantity']);

int(42)

Связанные операции: mysqli_options.

Оба входа к этой операции: mysqli_set_opt, mysqli::set_opt.

• PHP: mysqli.set-opt

PHP 5+; изменения отмечены · mysqli; mysqlnd для отмеченных операций

mysqli_set_opt(mysqli $mysql, int $option, string|int $value): bool; mysqli::set_opt(int $option, string|int $value): bool

<?php
mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
$config = require __DIR__ . '/config.php';
$db = mysqli_init();
$db->options(MYSQLI_OPT_CONNECT_TIMEOUT, 3);
$db->real_connect($config['host'], $config['user'], $config['password'], $config['database'], $config['port']);
$db->set_charset('utf8mb4');
require __DIR__ . '/seed.php';
$result = $db->query('SELECT name, stock FROM products WHERE id = 1');
$row = $result->fetch_assoc();
echo $row['name'], ' — ', $row['stock'], " шт.\n";

Молоток — 8 шт.

Прочитать старый код с альтернативным именем options.

Процедурная функция получает соединение $db, команду $statement или результат $result первым аргументом. В записи $object->method(...) тот же объект стоит перед стрелкой. Свойство читается без круглых скобок. Эти варианты используют один механизм: выбирать стиль стоит по понятности проекта. аргументы и возврат, объект и его состояние.

Алиас mysqli_options: те же сроки вызова, параметры, return и ошибки. Новому коду удобнее единообразное options; два примера показывают целевую операцию, менять логику при переименовании не нужно.

SQL-ошибка при MYSQLI_REPORT_ERROR выдаёт warning, при сочетании с MYSQLI_REPORT_STRICT — mysqli_sql_exception; с PHP 8.1 это сочетание включено по умолчанию. В примерах оно задано явно. Ошибки типов, закрытого объекта и неверных аргументов могут возникать отдельно; сырое сообщение SQL не публикуют посетителю.

Путь данных. set_opt выбирает ту же операцию options → Параметры сохраняются до соединения → Открытие использует эти настройки.

Как читать этот вариант. Обе опции сохранены до соединения. Первая касается открытия, вторая ожидания результата команды; это разные участки работы.

<?php
$db = new mysqli();
var_dump($db->options(MYSQLI_OPT_CONNECT_TIMEOUT, 3));
var_dump($db->options(MYSQLI_OPT_READ_TIMEOUT, 10));

bool(true)
bool(true)

Как читать этот вариант. Контекстный пример: нужен отдельный учебный MySQL, расширение mysqli, база course_demo и её пользователь course_user с разрешением временных таблиц. Учебные параметры подключения заменяют своими; рабочие базы не используют. Здесь проверен PHP-синтаксис, серверный запрос не выполнялся. Опция mysqlnd превращает подходящие числовые значения обычного query в PHP-числа. Для больших чисел/DECIMAL сохраняйте точность; опция не является универсальным преобразователем любых денежных строк.

<?php
mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
$db = mysqli_init();
mysqli_options($db, MYSQLI_OPT_INT_AND_FLOAT_NATIVE, 1);
$db->real_connect('127.0.0.1', 'course_user', 'course_password', 'course_demo', 3306);
$row = $db->query('SELECT 42 AS quantity')->fetch_assoc();
var_dump($row['quantity']);

int(42)

Связанные операции: mysqli_options.

Оба входа к этой операции: mysqli_set_opt, mysqli::set_opt.

• PHP: mysqli.set-opt

PHP 5+; изменения отмечены · mysqli; mysqlnd для отмеченных операций

mysqli_ssl_set(mysqli $mysql, ?string $key, ?string $certificate, ?string $ca_certificate, ?string $ca_path, ?string $cipher_algos): true; mysqli::ssl_set(?string $key, ?string $certificate, ?string $ca_certificate, ?string $ca_path, ?string $cipher_algos): true

<?php
mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
$config = require __DIR__ . '/config.php';
$ca = __DIR__ . '/certs/ca.pem';
if (!is_file($ca)) { throw new RuntimeException('Добавьте выданный администратором CA в certs/ca.pem'); }
$db = mysqli_init();
$db->ssl_set(null, null, $ca, null, null);
$db->real_connect($config['host'], $config['user'], $config['password'], $config['database'], $config['port'], null, MYSQLI_CLIENT_SSL);
$db->set_charset('utf8mb4');
$ssl = $db->query("SHOW STATUS LIKE 'Ssl_cipher'")->fetch_row();
if (!$ssl || $ssl[1] === '') { throw new RuntimeException('TLS не подтверждён'); }
require __DIR__ . '/seed.php';
$result = $db->query('SELECT name, stock FROM products WHERE id = 1');
$row = $result->fetch_assoc();
echo $row['name'], ' — ', $row['stock'], " шт.\n";

После установки собственного доверенного CA и настройки MySQL TLS: Молоток — 8 шт.

Настроить TLS для передачи запросов и учётных данных.

Процедурная функция получает соединение $db, команду $statement или результат $result первым аргументом. В записи $object->method(...) тот же объект стоит перед стрелкой. Свойство читается без круглых скобок. Эти варианты используют один механизм: выбирать стиль стоит по понятности проекта. аргументы и возврат, объект и его состояние.

Всегда true; неверная конфигурация проявится при real_connect. Вызывается до соединения, без поддержки OpenSSL не выполняет нужной TLS-настройки. null значит отсутствие конкретного параметра, не отключение всех проверок. Закрытый ключ хранится с ограниченными правами и не в публичном каталоге.

Путь данных. ssl_set сохраняет доверенные файлы → real_connect выполняет TLS handshake → Сертификат подтверждает сервер → SQL передаётся по согласованному защищённому соединению.

Как читать этот вариант. ssl_set не открывает соединение и всегда возвращает true. Существование/пригодность CA подтвердится только при real_connect; успешный setter не доказывает шифрование.

<?php
$db = new mysqli();
var_dump($db->ssl_set(null, null, '/etc/course-db/ca.pem', null, null));
echo "Пути заданы; TLS ещё не проверен\n";

bool(true)
Пути заданы; TLS ещё не проверен

Как читать этот вариант. Контекстный пример: нужен отдельный учебный MySQL, расширение mysqli, база course_demo и её пользователь course_user с разрешением временных таблиц. Учебные параметры подключения заменяют своими; рабочие базы не используют. Здесь проверен PHP-синтаксис, серверный запрос не выполнялся. Помимо учебного MySQL нужны сертификаты, совпадающее имя сервера и TLS-политика сервера. Проверка cipher подтверждает согласование шифрования, но доверие строится проверкой сертификата и требований клиента/сервера, а не только этой строкой.

<?php
mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
$db = new mysqli();
$db->ssl_set('/etc/course-db/client-key.pem', '/etc/course-db/client-cert.pem', '/etc/course-db/ca.pem', null, null);
$db->options(MYSQLI_OPT_SSL_VERIFY_SERVER_CERT, 1);
$db->real_connect('db.example.test', 'course_user', 'course_password', 'course_demo', 3306, null, MYSQLI_CLIENT_SSL);
$row = $db->query("SHOW SESSION STATUS LIKE 'Ssl_cipher'")->fetch_assoc();
if ($row['Value'] === '') { throw new RuntimeException('TLS не согласован'); }
echo "TLS согласован\n";

TLS согласован

Связанные операции: mysqli_real_connect, mysqli_options.

Оба входа к этой операции: mysqli_ssl_set, mysqli::ssl_set.

• PHP: mysqli.ssl-set

PHP 5+; изменения отмечены · mysqli; mysqlnd для отмеченных операций

mysqli_ssl_set(mysqli $mysql, ?string $key, ?string $certificate, ?string $ca_certificate, ?string $ca_path, ?string $cipher_algos): true; mysqli::ssl_set(?string $key, ?string $certificate, ?string $ca_certificate, ?string $ca_path, ?string $cipher_algos): true

<?php
mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
$config = require __DIR__ . '/config.php';
$ca = __DIR__ . '/certs/ca.pem';
if (!is_file($ca)) { throw new RuntimeException('Добавьте выданный администратором CA в certs/ca.pem'); }
$db = mysqli_init();
$db->ssl_set(null, null, $ca, null, null);
$db->real_connect($config['host'], $config['user'], $config['password'], $config['database'], $config['port'], null, MYSQLI_CLIENT_SSL);
$db->set_charset('utf8mb4');
$ssl = $db->query("SHOW STATUS LIKE 'Ssl_cipher'")->fetch_row();
if (!$ssl || $ssl[1] === '') { throw new RuntimeException('TLS не подтверждён'); }
require __DIR__ . '/seed.php';
$result = $db->query('SELECT name, stock FROM products WHERE id = 1');
$row = $result->fetch_assoc();
echo $row['name'], ' — ', $row['stock'], " шт.\n";

После установки собственного доверенного CA и настройки MySQL TLS: Молоток — 8 шт.

Настроить TLS для передачи запросов и учётных данных.

Процедурная функция получает соединение $db, команду $statement или результат $result первым аргументом. В записи $object->method(...) тот же объект стоит перед стрелкой. Свойство читается без круглых скобок. Эти варианты используют один механизм: выбирать стиль стоит по понятности проекта. аргументы и возврат, объект и его состояние.

Всегда true; неверная конфигурация проявится при real_connect. Вызывается до соединения, без поддержки OpenSSL не выполняет нужной TLS-настройки. null значит отсутствие конкретного параметра, не отключение всех проверок. Закрытый ключ хранится с ограниченными правами и не в публичном каталоге.

Путь данных. ssl_set сохраняет доверенные файлы → real_connect выполняет TLS handshake → Сертификат подтверждает сервер → SQL передаётся по согласованному защищённому соединению.

Как читать этот вариант. ssl_set не открывает соединение и всегда возвращает true. Существование/пригодность CA подтвердится только при real_connect; успешный setter не доказывает шифрование.

<?php
$db = new mysqli();
var_dump($db->ssl_set(null, null, '/etc/course-db/ca.pem', null, null));
echo "Пути заданы; TLS ещё не проверен\n";

bool(true)
Пути заданы; TLS ещё не проверен

Как читать этот вариант. Контекстный пример: нужен отдельный учебный MySQL, расширение mysqli, база course_demo и её пользователь course_user с разрешением временных таблиц. Учебные параметры подключения заменяют своими; рабочие базы не используют. Здесь проверен PHP-синтаксис, серверный запрос не выполнялся. Помимо учебного MySQL нужны сертификаты, совпадающее имя сервера и TLS-политика сервера. Проверка cipher подтверждает согласование шифрования, но доверие строится проверкой сертификата и требований клиента/сервера, а не только этой строкой.

<?php
mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
$db = new mysqli();
$db->ssl_set('/etc/course-db/client-key.pem', '/etc/course-db/client-cert.pem', '/etc/course-db/ca.pem', null, null);
$db->options(MYSQLI_OPT_SSL_VERIFY_SERVER_CERT, 1);
$db->real_connect('db.example.test', 'course_user', 'course_password', 'course_demo', 3306, null, MYSQLI_CLIENT_SSL);
$row = $db->query("SHOW SESSION STATUS LIKE 'Ssl_cipher'")->fetch_assoc();
if ($row['Value'] === '') { throw new RuntimeException('TLS не согласован'); }
echo "TLS согласован\n";

TLS согласован

Связанные операции: mysqli_real_connect, mysqli_options.

Оба входа к этой операции: mysqli_ssl_set, mysqli::ssl_set.

• PHP: mysqli.ssl-set

PHP 5+; изменения отмечены · mysqli; mysqlnd для отмеченных операций

mysqli_set_charset(mysqli $mysql, string $charset): bool; mysqli::set_charset(string $charset): bool

<?php
require __DIR__ . '/catalog.php';
$db->set_charset('utf8mb4');
$result = $db->query('SELECT name, stock FROM products WHERE id = 1');
$row = $result->fetch_assoc();
echo $row['name'], ' — ', $row['stock'], " шт.\n";

Молоток — 8 шт.

Согласовать кодировку данных между PHP и MySQL.

Процедурная функция получает соединение $db, команду $statement или результат $result первым аргументом. В записи $object->method(...) тот же объект стоит перед стрелкой. Свойство читается без круглых скобок. Эти варианты используют один механизм: выбирать стиль стоит по понятности проекта. аргументы и возврат, объект и его состояние.

true/false. Выбирайте сразу после открытия. Это кодировка соединения, а не перекодировка всех PHP-файлов и столбцов БД; ошибочные байты не исправляются магически. SET NAMES не заменяет вызов API для безопасности escape_string.

SQL-ошибка при MYSQLI_REPORT_ERROR выдаёт warning, при сочетании с MYSQLI_REPORT_STRICT — mysqli_sql_exception; с PHP 8.1 это сочетание включено по умолчанию. В примерах оно задано явно. Ошибки типов, закрытого объекта и неверных аргументов могут возникать отдельно; сырое сообщение SQL не публикуют посетителю.

Путь данных. PHP содержит текст Тетрадь 📘 → Соединение объявляет utf8mb4 → Параметр приходит в SQL без потери emoji → Чтение возвращает тот же текст.

Как читать этот вариант. Контекстный пример: нужен отдельный учебный MySQL, расширение mysqli, база course_demo и её пользователь course_user с разрешением временных таблиц. Учебные параметры подключения заменяют своими; рабочие базы не используют. Здесь проверен PHP-синтаксис, серверный запрос не выполнялся. utf8mb4 может передавать четырёхбайтовые Unicode-символы. Кодировка таблицы/колонки также должна подходить: одна настройка соединения не переделывает старую latin1-схему.

<?php
mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
$db = new mysqli('127.0.0.1', 'course_user', 'course_password', 'course_demo', 3306);
$db->set_charset('utf8mb4');
$s = $db->prepare('SELECT ? AS name');
$s->execute(['Тетрадь 📘']);
echo $s->get_result()->fetch_assoc()['name'], "\n";

Тетрадь 📘

Как читать этот вариант. Контекстный пример: нужен отдельный учебный MySQL, расширение mysqli, база course_demo и её пользователь course_user с разрешением временных таблиц. Учебные параметры подключения заменяют своими; рабочие базы не используют. Здесь проверен PHP-синтаксис, серверный запрос не выполнялся. set_charset предпочтительнее ручного SET NAMES, потому что согласует состояние клиентского API, в том числе экранирования. Collation определяет сравнение/сортировку и не равна имени charset.

<?php
mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
$db = new mysqli('127.0.0.1', 'course_user', 'course_password', 'course_demo', 3306);
$db->set_charset('utf8mb4');
mysqli_set_charset($db, 'utf8mb4');
echo mysqli_character_set_name($db), "\n";

utf8mb4

Связанные операции: mysqli_character_set_name, mysqli_get_charset, mysqli_real_escape_string.

Оба входа к этой операции: mysqli_set_charset, mysqli::set_charset.

• PHP: mysqli.set-charset

PHP 5+; изменения отмечены · mysqli; mysqlnd для отмеченных операций

mysqli_set_charset(mysqli $mysql, string $charset): bool; mysqli::set_charset(string $charset): bool

<?php
require __DIR__ . '/catalog.php';
$db->set_charset('utf8mb4');
$result = $db->query('SELECT name, stock FROM products WHERE id = 1');
$row = $result->fetch_assoc();
echo $row['name'], ' — ', $row['stock'], " шт.\n";

Молоток — 8 шт.

Согласовать кодировку данных между PHP и MySQL.

Процедурная функция получает соединение $db, команду $statement или результат $result первым аргументом. В записи $object->method(...) тот же объект стоит перед стрелкой. Свойство читается без круглых скобок. Эти варианты используют один механизм: выбирать стиль стоит по понятности проекта. аргументы и возврат, объект и его состояние.

true/false. Выбирайте сразу после открытия. Это кодировка соединения, а не перекодировка всех PHP-файлов и столбцов БД; ошибочные байты не исправляются магически. SET NAMES не заменяет вызов API для безопасности escape_string.

SQL-ошибка при MYSQLI_REPORT_ERROR выдаёт warning, при сочетании с MYSQLI_REPORT_STRICT — mysqli_sql_exception; с PHP 8.1 это сочетание включено по умолчанию. В примерах оно задано явно. Ошибки типов, закрытого объекта и неверных аргументов могут возникать отдельно; сырое сообщение SQL не публикуют посетителю.

Путь данных. PHP содержит текст Тетрадь 📘 → Соединение объявляет utf8mb4 → Параметр приходит в SQL без потери emoji → Чтение возвращает тот же текст.

Как читать этот вариант. Контекстный пример: нужен отдельный учебный MySQL, расширение mysqli, база course_demo и её пользователь course_user с разрешением временных таблиц. Учебные параметры подключения заменяют своими; рабочие базы не используют. Здесь проверен PHP-синтаксис, серверный запрос не выполнялся. utf8mb4 может передавать четырёхбайтовые Unicode-символы. Кодировка таблицы/колонки также должна подходить: одна настройка соединения не переделывает старую latin1-схему.

<?php
mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
$db = new mysqli('127.0.0.1', 'course_user', 'course_password', 'course_demo', 3306);
$db->set_charset('utf8mb4');
$s = $db->prepare('SELECT ? AS name');
$s->execute(['Тетрадь 📘']);
echo $s->get_result()->fetch_assoc()['name'], "\n";

Тетрадь 📘

Как читать этот вариант. Контекстный пример: нужен отдельный учебный MySQL, расширение mysqli, база course_demo и её пользователь course_user с разрешением временных таблиц. Учебные параметры подключения заменяют своими; рабочие базы не используют. Здесь проверен PHP-синтаксис, серверный запрос не выполнялся. set_charset предпочтительнее ручного SET NAMES, потому что согласует состояние клиентского API, в том числе экранирования. Collation определяет сравнение/сортировку и не равна имени charset.

<?php
mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
$db = new mysqli('127.0.0.1', 'course_user', 'course_password', 'course_demo', 3306);
$db->set_charset('utf8mb4');
mysqli_set_charset($db, 'utf8mb4');
echo mysqli_character_set_name($db), "\n";

utf8mb4

Связанные операции: mysqli_character_set_name, mysqli_get_charset, mysqli_real_escape_string.

Оба входа к этой операции: mysqli_set_charset, mysqli::set_charset.

• PHP: mysqli.set-charset

PHP 5+; изменения отмечены · mysqli; mysqlnd для отмеченных операций

mysqli_character_set_name(mysqli $mysql): string; mysqli::character_set_name(): string

<?php
require __DIR__ . '/catalog.php';
$charset = $db->character_set_name();
if ($charset !== 'utf8mb4') { throw new RuntimeException('Перед импортом нужен utf8mb4'); }
$result = $db->query('SELECT name, stock FROM products WHERE id = 1');
$row = $result->fetch_assoc();
echo $row['name'], ' — ', $row['stock'], " шт.\n";

Молоток — 8 шт.

Прочитать текущую кодировку соединения при диагностике текста.

Процедурная функция получает соединение $db, команду $statement или результат $result первым аргументом. В записи $object->method(...) тот же объект стоит перед стрелкой. Свойство читается без круглых скобок. Эти варианты используют один механизм: выбирать стиль стоит по понятности проекта. аргументы и возврат, объект и его состояние.

Строка имени текущего charset. Она не сообщает отдельно collation/кодировку всех таблиц и не доказывает, что входной PHP-текст действительно в UTF-8.

Путь данных. set_charset выбирает utf8mb4 → Getter читает имя → Имя сравнивают с договором интеграции.

Как читать этот вариант. Контекстный пример: нужен отдельный учебный MySQL, расширение mysqli, база course_demo и её пользователь course_user с разрешением временных таблиц. Учебные параметры подключения заменяют своими; рабочие базы не используют. Здесь проверен PHP-синтаксис, серверный запрос не выполнялся. set_charset предпочтительнее ручного SET NAMES, потому что согласует состояние клиентского API, в том числе экранирования. Collation определяет сравнение/сортировку и не равна имени charset.

<?php
mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
$db = new mysqli('127.0.0.1', 'course_user', 'course_password', 'course_demo', 3306);
$db->set_charset('utf8mb4');
mysqli_set_charset($db, 'utf8mb4');
echo mysqli_character_set_name($db), "\n";

utf8mb4

Как читать этот вариант. Контекстный пример: нужен отдельный учебный MySQL, расширение mysqli, база course_demo и её пользователь course_user с разрешением временных таблиц. Учебные параметры подключения заменяют своими; рабочие базы не используют. Здесь проверен PHP-синтаксис, серверный запрос не выполнялся. utf8mb4 может передавать четырёхбайтовые Unicode-символы. Кодировка таблицы/колонки также должна подходить: одна настройка соединения не переделывает старую latin1-схему.

<?php
mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
$db = new mysqli('127.0.0.1', 'course_user', 'course_password', 'course_demo', 3306);
$db->set_charset('utf8mb4');
$s = $db->prepare('SELECT ? AS name');
$s->execute(['Тетрадь 📘']);
echo $s->get_result()->fetch_assoc()['name'], "\n";

Тетрадь 📘

Связанные операции: mysqli_set_charset, mysqli_get_charset.

Оба входа к этой операции: mysqli_character_set_name, mysqli::character_set_name.

• PHP: mysqli.character-set-name

PHP 5+; изменения отмечены · mysqli; mysqlnd для отмеченных операций

mysqli_character_set_name(mysqli $mysql): string; mysqli::character_set_name(): string

<?php
require __DIR__ . '/catalog.php';
$charset = $db->character_set_name();
if ($charset !== 'utf8mb4') { throw new RuntimeException('Перед импортом нужен utf8mb4'); }
$result = $db->query('SELECT name, stock FROM products WHERE id = 1');
$row = $result->fetch_assoc();
echo $row['name'], ' — ', $row['stock'], " шт.\n";

Молоток — 8 шт.

Прочитать текущую кодировку соединения при диагностике текста.

Процедурная функция получает соединение $db, команду $statement или результат $result первым аргументом. В записи $object->method(...) тот же объект стоит перед стрелкой. Свойство читается без круглых скобок. Эти варианты используют один механизм: выбирать стиль стоит по понятности проекта. аргументы и возврат, объект и его состояние.

Строка имени текущего charset. Она не сообщает отдельно collation/кодировку всех таблиц и не доказывает, что входной PHP-текст действительно в UTF-8.

Путь данных. set_charset выбирает utf8mb4 → Getter читает имя → Имя сравнивают с договором интеграции.

Как читать этот вариант. Контекстный пример: нужен отдельный учебный MySQL, расширение mysqli, база course_demo и её пользователь course_user с разрешением временных таблиц. Учебные параметры подключения заменяют своими; рабочие базы не используют. Здесь проверен PHP-синтаксис, серверный запрос не выполнялся. set_charset предпочтительнее ручного SET NAMES, потому что согласует состояние клиентского API, в том числе экранирования. Collation определяет сравнение/сортировку и не равна имени charset.

<?php
mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
$db = new mysqli('127.0.0.1', 'course_user', 'course_password', 'course_demo', 3306);
$db->set_charset('utf8mb4');
mysqli_set_charset($db, 'utf8mb4');
echo mysqli_character_set_name($db), "\n";

utf8mb4

Как читать этот вариант. Контекстный пример: нужен отдельный учебный MySQL, расширение mysqli, база course_demo и её пользователь course_user с разрешением временных таблиц. Учебные параметры подключения заменяют своими; рабочие базы не используют. Здесь проверен PHP-синтаксис, серверный запрос не выполнялся. utf8mb4 может передавать четырёхбайтовые Unicode-символы. Кодировка таблицы/колонки также должна подходить: одна настройка соединения не переделывает старую latin1-схему.

<?php
mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
$db = new mysqli('127.0.0.1', 'course_user', 'course_password', 'course_demo', 3306);
$db->set_charset('utf8mb4');
$s = $db->prepare('SELECT ? AS name');
$s->execute(['Тетрадь 📘']);
echo $s->get_result()->fetch_assoc()['name'], "\n";

Тетрадь 📘

Связанные операции: mysqli_set_charset, mysqli_get_charset.

Оба входа к этой операции: mysqli_character_set_name, mysqli::character_set_name.

• PHP: mysqli.character-set-name

PHP 5+; изменения отмечены · mysqli; mysqlnd для отмеченных операций

mysqli_get_charset(mysqli $mysql): ?object; mysqli::get_charset(): ?object

<?php
require __DIR__ . '/catalog.php';
$charset = $db->get_charset()->charset;
if ($charset !== 'utf8mb4') { throw new RuntimeException('Перед импортом нужен utf8mb4'); }
$result = $db->query('SELECT name, stock FROM products WHERE id = 1');
$row = $result->fetch_assoc();
echo $row['name'], ' — ', $row['stock'], " шт.\n";

Молоток — 8 шт.

Получить подробности текущего набора символов.

Процедурная функция получает соединение $db, команду $statement или результат $result первым аргументом. В записи $object->method(...) тот же объект стоит перед стрелкой. Свойство читается без круглых скобок. Эти варианты используют один механизм: выбирать стиль стоит по понятности проекта. аргументы и возврат, объект и его состояние.

Объект (сигнатура допускает null): charset, collation, dir (путь описания или пусто для встроенного), min_length/max_length в байтах, number (внутренний номер), state (с 8.2 всегда 1). Названия свойств важнее их порядка. Для байтовых лимитов API это справка, а для числа букв нужны строковые функции Unicode.

Путь данных. Getter читает описание charset → PHP получает объект с min/max_length → Диагностика понимает границу байты/символы.

Как читать этот вариант. Контекстный пример: нужен отдельный учебный MySQL, расширение mysqli, база course_demo и её пользователь course_user с разрешением временных таблиц. Учебные параметры подключения заменяют своими; рабочие базы не используют. Здесь проверен PHP-синтаксис, серверный запрос не выполнялся. Размер указан в байтах, один символ может занимать несколько. strlen считает байты, а не обещанное число видимых букв.

<?php
mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
$db = new mysqli('127.0.0.1', 'course_user', 'course_password', 'course_demo', 3306);
$db->set_charset('utf8mb4');
$charset = $db->get_charset();
echo $charset->charset, ':', $charset->min_length, ':', $charset->max_length, "\n";

utf8mb4:1:4

Как читать этот вариант. Контекстный пример: нужен отдельный учебный MySQL, расширение mysqli, база course_demo и её пользователь course_user с разрешением временных таблиц. Учебные параметры подключения заменяют своими; рабочие базы не используют. Здесь проверен PHP-синтаксис, серверный запрос не выполнялся. Точное имя collation зависит от сервера/клиента. С PHP 8.2 state всегда 1; номер не предназначен для бизнес-логики.

<?php
mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
$db = new mysqli('127.0.0.1', 'course_user', 'course_password', 'course_demo', 3306);
$db->set_charset('utf8mb4');
$charset = mysqli_get_charset($db);
echo 'charset=', $charset->charset, "\n";
echo 'collation=', $charset->collation, "\n";
echo 'state=', $charset->state, "\n";

charset=utf8mb4
collation=<активная collation клиента>
state=1

Связанные операции: mysqli_character_set_name, mysqli_set_charset.

Оба входа к этой операции: mysqli_get_charset, mysqli::get_charset.

• PHP: mysqli.get-charset

PHP 5+; изменения отмечены · mysqli; mysqlnd для отмеченных операций

mysqli_get_charset(mysqli $mysql): ?object; mysqli::get_charset(): ?object

<?php
require __DIR__ . '/catalog.php';
$charset = $db->get_charset()->charset;
if ($charset !== 'utf8mb4') { throw new RuntimeException('Перед импортом нужен utf8mb4'); }
$result = $db->query('SELECT name, stock FROM products WHERE id = 1');
$row = $result->fetch_assoc();
echo $row['name'], ' — ', $row['stock'], " шт.\n";

Молоток — 8 шт.

Получить подробности текущего набора символов.

Процедурная функция получает соединение $db, команду $statement или результат $result первым аргументом. В записи $object->method(...) тот же объект стоит перед стрелкой. Свойство читается без круглых скобок. Эти варианты используют один механизм: выбирать стиль стоит по понятности проекта. аргументы и возврат, объект и его состояние.

Объект (сигнатура допускает null): charset, collation, dir (путь описания или пусто для встроенного), min_length/max_length в байтах, number (внутренний номер), state (с 8.2 всегда 1). Названия свойств важнее их порядка. Для байтовых лимитов API это справка, а для числа букв нужны строковые функции Unicode.

Путь данных. Getter читает описание charset → PHP получает объект с min/max_length → Диагностика понимает границу байты/символы.

Как читать этот вариант. Контекстный пример: нужен отдельный учебный MySQL, расширение mysqli, база course_demo и её пользователь course_user с разрешением временных таблиц. Учебные параметры подключения заменяют своими; рабочие базы не используют. Здесь проверен PHP-синтаксис, серверный запрос не выполнялся. Размер указан в байтах, один символ может занимать несколько. strlen считает байты, а не обещанное число видимых букв.

<?php
mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
$db = new mysqli('127.0.0.1', 'course_user', 'course_password', 'course_demo', 3306);
$db->set_charset('utf8mb4');
$charset = $db->get_charset();
echo $charset->charset, ':', $charset->min_length, ':', $charset->max_length, "\n";

utf8mb4:1:4

Как читать этот вариант. Контекстный пример: нужен отдельный учебный MySQL, расширение mysqli, база course_demo и её пользователь course_user с разрешением временных таблиц. Учебные параметры подключения заменяют своими; рабочие базы не используют. Здесь проверен PHP-синтаксис, серверный запрос не выполнялся. Точное имя collation зависит от сервера/клиента. С PHP 8.2 state всегда 1; номер не предназначен для бизнес-логики.

<?php
mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
$db = new mysqli('127.0.0.1', 'course_user', 'course_password', 'course_demo', 3306);
$db->set_charset('utf8mb4');
$charset = mysqli_get_charset($db);
echo 'charset=', $charset->charset, "\n";
echo 'collation=', $charset->collation, "\n";
echo 'state=', $charset->state, "\n";

charset=utf8mb4
collation=<активная collation клиента>
state=1

Связанные операции: mysqli_character_set_name, mysqli_set_charset.

Оба входа к этой операции: mysqli_get_charset, mysqli::get_charset.

• PHP: mysqli.get-charset

PHP 5+; изменения отмечены · mysqli; mysqlnd для отмеченных операций

mysqli_select_db(mysqli $mysql, string $database): bool; mysqli::select_db(string $database): bool

<?php
require __DIR__ . '/catalog.php';
$config = require __DIR__ . '/config.php';
$db->select_db($config['database']);
$result = $db->query('SELECT name, stock FROM products WHERE id = 1');
$row = $result->fetch_assoc();
echo $row['name'], ' — ', $row['stock'], " шт.\n";

Молоток — 8 шт.

Выбрать схему по умолчанию для последующих запросов.

Процедурная функция получает соединение $db, команду $statement или результат $result первым аргументом. В записи $object->method(...) тот же объект стоит перед стрелкой. Свойство читается без круглых скобок. Эти варианты используют один механизм: выбирать стиль стоит по понятности проекта. аргументы и возврат, объект и его состояние.

true/false; действует на соединение и неквалифицированные имена последующих запросов. Если база задана конструктору и не меняется, отдельный вызов не нужен.

SQL-ошибка при MYSQLI_REPORT_ERROR выдаёт warning, при сочетании с MYSQLI_REPORT_STRICT — mysqli_sql_exception; с PHP 8.1 это сочетание включено по умолчанию. В примерах оно задано явно. Ошибки типов, закрытого объекта и неверных аргументов могут возникать отдельно; сырое сообщение SQL не публикуют посетителю.

Путь данных. Открытое соединение выбирает course_demo → DATABASE() подтверждает текущую схему → Следующий неквалифицированный SELECT работает в ней.

Как читать этот вариант. Контекстный пример: нужен отдельный учебный MySQL, расширение mysqli, база course_demo и её пользователь course_user с разрешением временных таблиц. Учебные параметры подключения заменяют своими; рабочие базы не используют. Здесь проверен PHP-синтаксис, серверный запрос не выполнялся. Выбор базы не создаёт её и не выдаёт пользователю дополнительные права. Имя задаёт конфигурация, не произвольный параметр HTTP.

<?php
mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
$db = new mysqli('127.0.0.1', 'course_user', 'course_password', 'course_demo', 3306);
$db->set_charset('utf8mb4');
$db->select_db('course_demo');
echo $db->query('SELECT DATABASE()')->fetch_column(), "\n";

course_demo

Как читать этот вариант. Контекстный пример: нужен отдельный учебный MySQL, расширение mysqli, база course_demo и её пользователь course_user с разрешением временных таблиц. Учебные параметры подключения заменяют своими; рабочие базы не используют. Здесь проверен PHP-синтаксис, серверный запрос не выполнялся. Для разных арендаторов нельзя выбирать любую базу по пользовательскому имени. Пул и состояние соединения требуют явного владения; квалифицированные имена схем остаются доверенными.

<?php
mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
$db = new mysqli('127.0.0.1', 'course_user', 'course_password', 'course_demo', 3306);
$db->set_charset('utf8mb4');
mysqli_select_db($db, 'course_demo');
$result = mysqli_query($db, 'SELECT DATABASE() AS db_name, 42 AS item_id');
$row = mysqli_fetch_assoc($result);
echo $row['db_name'], ':', $row['item_id'], "\n";

course_demo:42

Связанные операции: mysqli_connect, mysqli_change_user.

Оба входа к этой операции: mysqli_select_db, mysqli::select_db.

• PHP: mysqli.select-db

PHP 5+; изменения отмечены · mysqli; mysqlnd для отмеченных операций

mysqli_select_db(mysqli $mysql, string $database): bool; mysqli::select_db(string $database): bool

<?php
require __DIR__ . '/catalog.php';
$config = require __DIR__ . '/config.php';
$db->select_db($config['database']);
$result = $db->query('SELECT name, stock FROM products WHERE id = 1');
$row = $result->fetch_assoc();
echo $row['name'], ' — ', $row['stock'], " шт.\n";

Молоток — 8 шт.

Выбрать схему по умолчанию для последующих запросов.

Процедурная функция получает соединение $db, команду $statement или результат $result первым аргументом. В записи $object->method(...) тот же объект стоит перед стрелкой. Свойство читается без круглых скобок. Эти варианты используют один механизм: выбирать стиль стоит по понятности проекта. аргументы и возврат, объект и его состояние.

true/false; действует на соединение и неквалифицированные имена последующих запросов. Если база задана конструктору и не меняется, отдельный вызов не нужен.

SQL-ошибка при MYSQLI_REPORT_ERROR выдаёт warning, при сочетании с MYSQLI_REPORT_STRICT — mysqli_sql_exception; с PHP 8.1 это сочетание включено по умолчанию. В примерах оно задано явно. Ошибки типов, закрытого объекта и неверных аргументов могут возникать отдельно; сырое сообщение SQL не публикуют посетителю.

Путь данных. Открытое соединение выбирает course_demo → DATABASE() подтверждает текущую схему → Следующий неквалифицированный SELECT работает в ней.

Как читать этот вариант. Контекстный пример: нужен отдельный учебный MySQL, расширение mysqli, база course_demo и её пользователь course_user с разрешением временных таблиц. Учебные параметры подключения заменяют своими; рабочие базы не используют. Здесь проверен PHP-синтаксис, серверный запрос не выполнялся. Выбор базы не создаёт её и не выдаёт пользователю дополнительные права. Имя задаёт конфигурация, не произвольный параметр HTTP.

<?php
mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
$db = new mysqli('127.0.0.1', 'course_user', 'course_password', 'course_demo', 3306);
$db->set_charset('utf8mb4');
$db->select_db('course_demo');
echo $db->query('SELECT DATABASE()')->fetch_column(), "\n";

course_demo

Как читать этот вариант. Контекстный пример: нужен отдельный учебный MySQL, расширение mysqli, база course_demo и её пользователь course_user с разрешением временных таблиц. Учебные параметры подключения заменяют своими; рабочие базы не используют. Здесь проверен PHP-синтаксис, серверный запрос не выполнялся. Для разных арендаторов нельзя выбирать любую базу по пользовательскому имени. Пул и состояние соединения требуют явного владения; квалифицированные имена схем остаются доверенными.

<?php
mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
$db = new mysqli('127.0.0.1', 'course_user', 'course_password', 'course_demo', 3306);
$db->set_charset('utf8mb4');
mysqli_select_db($db, 'course_demo');
$result = mysqli_query($db, 'SELECT DATABASE() AS db_name, 42 AS item_id');
$row = mysqli_fetch_assoc($result);
echo $row['db_name'], ':', $row['item_id'], "\n";

course_demo:42

Связанные операции: mysqli_connect, mysqli_change_user.

Оба входа к этой операции: mysqli_select_db, mysqli::select_db.

• PHP: mysqli.select-db

PHP 5+; изменения отмечены · mysqli; mysqlnd для отмеченных операций

mysqli_change_user(mysqli $mysql, string $username, string $password, ?string $database): bool; mysqli::change_user(string $username, string $password, ?string $database): bool

<?php
require __DIR__ . '/catalog.php';
$config = require __DIR__ . '/config.php';
$db->change_user($config['user'], $config['password'], $config['database']);
$db->set_charset('utf8mb4');
require __DIR__ . '/seed.php';
$result = $db->query('SELECT name, stock FROM products WHERE id = 1');
$row = $result->fetch_assoc();
echo $row['name'], ' — ', $row['stock'], " шт.\n";

Молоток — 8 шт.

Сменить MySQL-учётную запись и сбросить состояние соединения.

Процедурная функция получает соединение $db, команду $statement или результат $result первым аргументом. В записи $object->method(...) тот же объект стоит перед стрелкой. Свойство читается без круглых скобок. Эти варианты используют один механизм: выбирать стиль стоит по понятности проекта. аргументы и возврат, объект и его состояние.

true/false. При неудачной авторизации прежняя аутентификация сохраняется, в отличие от попытки открыть иное соединение через connect. Смена пользователя имеет эффекты сброса сессии: не вызывайте её посреди бизнес-транзакции. Логин посетителя приложения обычно не должен напрямую становиться пользователем MySQL.

SQL-ошибка при MYSQLI_REPORT_ERROR выдаёт warning, при сочетании с MYSQLI_REPORT_STRICT — mysqli_sql_exception; с PHP 8.1 это сочетание включено по умолчанию. В примерах оно задано явно. Ошибки типов, закрытого объекта и неверных аргументов могут возникать отдельно; сырое сообщение SQL не публикуют посетителю.

Путь данных. Текущая сессия хранит @course_marker → change_user проводит аутентификацию/сброс → Старое состояние больше не используется → Приложение заново задаёт свою политику.

Как читать этот вариант. Контекстный пример: нужен отдельный учебный MySQL, расширение mysqli, база course_demo и её пользователь course_user с разрешением временных таблиц. Учебные параметры подключения заменяют своими; рабочие базы не используют. Здесь проверен PHP-синтаксис, серверный запрос не выполнялся. Даже те же учётные данные запускают сброс состояния сессии. Начатая транзакция откатывается; временные таблицы и привязанные statements нельзя считать действующими после такого перехода.

<?php
mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
$db = new mysqli('127.0.0.1', 'course_user', 'course_password', 'course_demo', 3306);
$db->set_charset('utf8mb4');
$db->query('SET @course_marker = 42');
$db->change_user('course_user', 'course_password', 'course_demo');
$db->set_charset('utf8mb4');
var_dump($db->query('SELECT @course_marker')->fetch_column());

NULL

Как читать этот вариант. Контекстный пример: нужен отдельный учебный MySQL, расширение mysqli, база course_demo и её пользователь course_user с разрешением временных таблиц. Учебные параметры подключения заменяют своими; рабочие базы не используют. Здесь проверен PHP-синтаксис, серверный запрос не выполнялся. null/пустое имя базы оставляет серверное соединение без default database; запрос к неквалифицированной таблице до select_db может отказать.

<?php
mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
$db = new mysqli('127.0.0.1', 'course_user', 'course_password', 'course_demo', 3306);
$db->set_charset('utf8mb4');
mysqli_change_user($db, 'course_user', 'course_password', null);
var_dump($db->query('SELECT DATABASE()')->fetch_column());
$db->select_db('course_demo');
echo $db->query('SELECT DATABASE()')->fetch_column(), "\n";

NULL
course_demo

Связанные операции: mysqli_select_db, mysqli_set_charset, mysqli_rollback.

Оба входа к этой операции: mysqli_change_user, mysqli::change_user.

• PHP: mysqli.change-user

PHP 5+; изменения отмечены · mysqli; mysqlnd для отмеченных операций

mysqli_change_user(mysqli $mysql, string $username, string $password, ?string $database): bool; mysqli::change_user(string $username, string $password, ?string $database): bool

<?php
require __DIR__ . '/catalog.php';
$config = require __DIR__ . '/config.php';
$db->change_user($config['user'], $config['password'], $config['database']);
$db->set_charset('utf8mb4');
require __DIR__ . '/seed.php';
$result = $db->query('SELECT name, stock FROM products WHERE id = 1');
$row = $result->fetch_assoc();
echo $row['name'], ' — ', $row['stock'], " шт.\n";

Молоток — 8 шт.

Сменить MySQL-учётную запись и сбросить состояние соединения.

Процедурная функция получает соединение $db, команду $statement или результат $result первым аргументом. В записи $object->method(...) тот же объект стоит перед стрелкой. Свойство читается без круглых скобок. Эти варианты используют один механизм: выбирать стиль стоит по понятности проекта. аргументы и возврат, объект и его состояние.

true/false. При неудачной авторизации прежняя аутентификация сохраняется, в отличие от попытки открыть иное соединение через connect. Смена пользователя имеет эффекты сброса сессии: не вызывайте её посреди бизнес-транзакции. Логин посетителя приложения обычно не должен напрямую становиться пользователем MySQL.

SQL-ошибка при MYSQLI_REPORT_ERROR выдаёт warning, при сочетании с MYSQLI_REPORT_STRICT — mysqli_sql_exception; с PHP 8.1 это сочетание включено по умолчанию. В примерах оно задано явно. Ошибки типов, закрытого объекта и неверных аргументов могут возникать отдельно; сырое сообщение SQL не публикуют посетителю.

Путь данных. Текущая сессия хранит @course_marker → change_user проводит аутентификацию/сброс → Старое состояние больше не используется → Приложение заново задаёт свою политику.

Как читать этот вариант. Контекстный пример: нужен отдельный учебный MySQL, расширение mysqli, база course_demo и её пользователь course_user с разрешением временных таблиц. Учебные параметры подключения заменяют своими; рабочие базы не используют. Здесь проверен PHP-синтаксис, серверный запрос не выполнялся. Даже те же учётные данные запускают сброс состояния сессии. Начатая транзакция откатывается; временные таблицы и привязанные statements нельзя считать действующими после такого перехода.

<?php
mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
$db = new mysqli('127.0.0.1', 'course_user', 'course_password', 'course_demo', 3306);
$db->set_charset('utf8mb4');
$db->query('SET @course_marker = 42');
$db->change_user('course_user', 'course_password', 'course_demo');
$db->set_charset('utf8mb4');
var_dump($db->query('SELECT @course_marker')->fetch_column());

NULL

Как читать этот вариант. Контекстный пример: нужен отдельный учебный MySQL, расширение mysqli, база course_demo и её пользователь course_user с разрешением временных таблиц. Учебные параметры подключения заменяют своими; рабочие базы не используют. Здесь проверен PHP-синтаксис, серверный запрос не выполнялся. null/пустое имя базы оставляет серверное соединение без default database; запрос к неквалифицированной таблице до select_db может отказать.

<?php
mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
$db = new mysqli('127.0.0.1', 'course_user', 'course_password', 'course_demo', 3306);
$db->set_charset('utf8mb4');
mysqli_change_user($db, 'course_user', 'course_password', null);
var_dump($db->query('SELECT DATABASE()')->fetch_column());
$db->select_db('course_demo');
echo $db->query('SELECT DATABASE()')->fetch_column(), "\n";

NULL
course_demo

Связанные операции: mysqli_select_db, mysqli_set_charset, mysqli_rollback.

Оба входа к этой операции: mysqli_change_user, mysqli::change_user.

• PHP: mysqli.change-user

PHP 5+; изменения отмечены · mysqli; mysqlnd для отмеченных операций

mysqli_close(mysqli $mysql): true; mysqli::close(): true

<?php
require __DIR__ . '/catalog.php';
$result = $db->query('SELECT name, stock FROM products WHERE id = 1');
$row = $result->fetch_assoc();
$result->free();
$db->close();
echo $row['name'], ' — ', $row['stock'], " шт.\n";

Молоток — 8 шт.

Закончить использование соединения, когда запросов больше не будет.

Процедурная функция получает соединение $db, команду $statement или результат $result первым аргументом. В записи $object->method(...) тот же объект стоит перед стрелкой. Свойство читается без круглых скобок. Эти варианты используют один механизм: выбирать стиль стоит по понятности проекта. аргументы и возврат, объект и его состояние.

С PHP 8.0 всегда true при нормальном вызове; закрытый/неподходящий объект — Error. Обычные соединения/результаты освобождаются при уничтожении объектов; явное закрытие полезно до длинной последующей работы. Persistent не закрывается физически: возвращается в пул, поведение очистки описано отдельно.

Путь данных. Запрос получил буфер строк → close завершает использование соединения → PHP обрабатывает свой буфер → free освобождает результат.

Как читать этот вариант. Контекстный пример: нужен отдельный учебный MySQL, расширение mysqli, база course_demo и её пользователь course_user с разрешением временных таблиц. Учебные параметры подключения заменяют своими; рабочие базы не используют. Здесь проверен PHP-синтаксис, серверный запрос не выполнялся. Обычный query буферизовал результат; его можно обработать после закрытия. Для MYSQLI_USE_RESULT нужен живой серверный поток и такой порядок не подходит.

<?php
mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
$db = new mysqli('127.0.0.1', 'course_user', 'course_password', 'course_demo', 3306);
$db->set_charset('utf8mb4');
$db->query('CREATE TEMPORARY TABLE course_products (id INT PRIMARY KEY, name VARCHAR(80) NOT NULL, price INT NOT NULL) ENGINE=InnoDB');
$db->query("INSERT INTO course_products VALUES (1, 'Pen', 120), (2, 'Notebook', 350), (3, 'Box', 200)");
$result = $db->query('SELECT name FROM course_products ORDER BY id');
$db->close();
foreach ($result as $row) { echo $row['name'], "\n"; }
$result->free();

Pen
Notebook
Box

Как читать этот вариант. Контекстный пример: нужен отдельный учебный MySQL, расширение mysqli, база course_demo и её пользователь course_user с разрешением временных таблиц. Учебные параметры подключения заменяют своими; рабочие базы не используют. Здесь проверен PHP-синтаксис, серверный запрос не выполнялся. finally не заменяет rollback незавершённого действия, но делает срок владения ясным. Не вызывайте close повторно у уже закрытого объекта.

<?php
mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
$db = new mysqli('127.0.0.1', 'course_user', 'course_password', 'course_demo', 3306);
$db->set_charset('utf8mb4');
try {
    echo $db->query('SELECT 42')->fetch_column(), "\n";
} finally {
    mysqli_close($db);
}
echo "Дальше работа без БД\n";

42
Дальше работа без БД

Связанные операции: mysqli_free_result, mysqli_connect.

Оба входа к этой операции: mysqli_close, mysqli::close.

• PHP: mysqli.close

PHP 5+; изменения отмечены · mysqli; mysqlnd для отмеченных операций

mysqli_close(mysqli $mysql): true; mysqli::close(): true

<?php
require __DIR__ . '/catalog.php';
$result = $db->query('SELECT name, stock FROM products WHERE id = 1');
$row = $result->fetch_assoc();
$result->free();
$db->close();
echo $row['name'], ' — ', $row['stock'], " шт.\n";

Молоток — 8 шт.

Закончить использование соединения, когда запросов больше не будет.

Процедурная функция получает соединение $db, команду $statement или результат $result первым аргументом. В записи $object->method(...) тот же объект стоит перед стрелкой. Свойство читается без круглых скобок. Эти варианты используют один механизм: выбирать стиль стоит по понятности проекта. аргументы и возврат, объект и его состояние.

С PHP 8.0 всегда true при нормальном вызове; закрытый/неподходящий объект — Error. Обычные соединения/результаты освобождаются при уничтожении объектов; явное закрытие полезно до длинной последующей работы. Persistent не закрывается физически: возвращается в пул, поведение очистки описано отдельно.

Путь данных. Запрос получил буфер строк → close завершает использование соединения → PHP обрабатывает свой буфер → free освобождает результат.

Как читать этот вариант. Контекстный пример: нужен отдельный учебный MySQL, расширение mysqli, база course_demo и её пользователь course_user с разрешением временных таблиц. Учебные параметры подключения заменяют своими; рабочие базы не используют. Здесь проверен PHP-синтаксис, серверный запрос не выполнялся. Обычный query буферизовал результат; его можно обработать после закрытия. Для MYSQLI_USE_RESULT нужен живой серверный поток и такой порядок не подходит.

<?php
mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
$db = new mysqli('127.0.0.1', 'course_user', 'course_password', 'course_demo', 3306);
$db->set_charset('utf8mb4');
$db->query('CREATE TEMPORARY TABLE course_products (id INT PRIMARY KEY, name VARCHAR(80) NOT NULL, price INT NOT NULL) ENGINE=InnoDB');
$db->query("INSERT INTO course_products VALUES (1, 'Pen', 120), (2, 'Notebook', 350), (3, 'Box', 200)");
$result = $db->query('SELECT name FROM course_products ORDER BY id');
$db->close();
foreach ($result as $row) { echo $row['name'], "\n"; }
$result->free();

Pen
Notebook
Box

Как читать этот вариант. Контекстный пример: нужен отдельный учебный MySQL, расширение mysqli, база course_demo и её пользователь course_user с разрешением временных таблиц. Учебные параметры подключения заменяют своими; рабочие базы не используют. Здесь проверен PHP-синтаксис, серверный запрос не выполнялся. finally не заменяет rollback незавершённого действия, но делает срок владения ясным. Не вызывайте close повторно у уже закрытого объекта.

<?php
mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
$db = new mysqli('127.0.0.1', 'course_user', 'course_password', 'course_demo', 3306);
$db->set_charset('utf8mb4');
try {
    echo $db->query('SELECT 42')->fetch_column(), "\n";
} finally {
    mysqli_close($db);
}
echo "Дальше работа без БД\n";

42
Дальше работа без БД

Связанные операции: mysqli_free_result, mysqli_connect.

Оба входа к этой операции: mysqli_close, mysqli::close.

• PHP: mysqli.close

PHP 5+; изменения отмечены · mysqli; mysqlnd для отмеченных операций

mysqli_query(mysqli $mysql, string $query, int $result_mode = MYSQLI_STORE_RESULT): mysqli_result|bool; mysqli::query(string $query, int $result_mode = MYSQLI_STORE_RESULT): mysqli_result|bool

<?php
require __DIR__ . '/catalog.php';
$result = $db->query('SELECT name, stock FROM products ORDER BY id');
while (($row = $result->fetch_assoc()) !== null) {
    if ($row === false) { throw new RuntimeException('Не удалось прочитать строку'); }
    echo $row['name'], ' — ', $row['stock'], " шт.\n";
}
$result->free();

Молоток — 8 шт.
Перчатки — 15 шт.
Кисть — 0 шт.

Выполнить один SQL-запрос и получить строки либо подтверждение действия.

Процедурная функция получает соединение $db, команду $statement или результат $result первым аргументом. В записи $object->method(...) тот же объект стоит перед стрелкой. Свойство читается без круглых скобок. Эти варианты используют один механизм: выбирать стиль стоит по понятности проекта. аргументы и возврат, объект и его состояние.

SELECT/SHOW/DESCRIBE/EXPLAIN дают mysqli_result, успешные команды без набора — true, ошибка — false либо исключение. Буфер удобен для небольшого каталога, но требует памяти; поток держит соединение занятым до полного чтения/освобождения. Размер запроса ограничен max_allowed_packet: превышение может дать 1153 или 2006 в зависимости от клиента/платформы. С PHP 8.4 и MySQL 8.0.24+ истёкший wait_timeout может сообщаться кодом 4031 вместо 2006.

SQL-ошибка при MYSQLI_REPORT_ERROR выдаёт warning, при сочетании с MYSQLI_REPORT_STRICT — mysqli_sql_exception; с PHP 8.1 это сочетание включено по умолчанию. В примерах оно задано явно. Ошибки типов, закрытого объекта и неверных аргументов могут возникать отдельно; сырое сообщение SQL не публикуют посетителю.

Путь данных. PHP отправляет SELECT → MySQL вычисляет строки → query возвращает объект результата → fetch_assoc извлекает значения.

Как читать этот вариант. Контекстный пример: нужен отдельный учебный MySQL, расширение mysqli, база course_demo и её пользователь course_user с разрешением временных таблиц. Учебные параметры подключения заменяют своими; рабочие базы не используют. Здесь проверен PHP-синтаксис, серверный запрос не выполнялся. SELECT просит сервер вычислить значение. AS подписывает колонку, query возвращает объект набора строк, fetch_assoc читает одну строку в массив, ключ item_id берётся из AS. Это четыре разных действия, а не возврат числа непосредственно из query.

<?php
mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
$db = new mysqli('127.0.0.1', 'course_user', 'course_password', 'course_demo', 3306);
$db->set_charset('utf8mb4');
$result = $db->query('SELECT 42 AS item_id');
$row = $result->fetch_assoc();
echo $row['item_id'], "\n";

42

Как читать этот вариант. Контекстный пример: нужен отдельный учебный MySQL, расширение mysqli, база course_demo и её пользователь course_user с разрешением временных таблиц. Учебные параметры подключения заменяют своими; рабочие базы не используют. Здесь проверен PHP-синтаксис, серверный запрос не выполнялся. while повторяет чтение до null. Без ORDER BY порядок строк не обещан. SQL здесь целиком постоянный; пользовательские значения передаются через prepare или execute_query.

<?php
mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
$db = new mysqli('127.0.0.1', 'course_user', 'course_password', 'course_demo', 3306);
$db->set_charset('utf8mb4');
$db->query('CREATE TEMPORARY TABLE course_products (id INT PRIMARY KEY, name VARCHAR(80) NOT NULL, price INT NOT NULL) ENGINE=InnoDB');
$db->query("INSERT INTO course_products VALUES (1, 'Pen', 120), (2, 'Notebook', 350), (3, 'Box', 200)");
$result = mysqli_query($db, 'SELECT name, price FROM course_products ORDER BY price, id');
while ($row = mysqli_fetch_assoc($result)) {
    echo $row['name'], ':', $row['price'], "\n";
}

Pen:120
Box:200
Notebook:350

Связанные операции: mysqli_execute_query, mysqli_prepare, mysqli_real_query, mysqli_fetch_assoc.

Оба входа к этой операции: mysqli_query, mysqli::query.

• PHP: mysqli.query

PHP 5+; изменения отмечены · mysqli; mysqlnd для отмеченных операций

mysqli_query(mysqli $mysql, string $query, int $result_mode = MYSQLI_STORE_RESULT): mysqli_result|bool; mysqli::query(string $query, int $result_mode = MYSQLI_STORE_RESULT): mysqli_result|bool

<?php
require __DIR__ . '/catalog.php';
$result = $db->query('SELECT name, stock FROM products ORDER BY id');
while (($row = $result->fetch_assoc()) !== null) {
    if ($row === false) { throw new RuntimeException('Не удалось прочитать строку'); }
    echo $row['name'], ' — ', $row['stock'], " шт.\n";
}
$result->free();

Молоток — 8 шт.
Перчатки — 15 шт.
Кисть — 0 шт.

Выполнить один SQL-запрос и получить строки либо подтверждение действия.

Процедурная функция получает соединение $db, команду $statement или результат $result первым аргументом. В записи $object->method(...) тот же объект стоит перед стрелкой. Свойство читается без круглых скобок. Эти варианты используют один механизм: выбирать стиль стоит по понятности проекта. аргументы и возврат, объект и его состояние.

SELECT/SHOW/DESCRIBE/EXPLAIN дают mysqli_result, успешные команды без набора — true, ошибка — false либо исключение. Буфер удобен для небольшого каталога, но требует памяти; поток держит соединение занятым до полного чтения/освобождения. Размер запроса ограничен max_allowed_packet: превышение может дать 1153 или 2006 в зависимости от клиента/платформы. С PHP 8.4 и MySQL 8.0.24+ истёкший wait_timeout может сообщаться кодом 4031 вместо 2006.

SQL-ошибка при MYSQLI_REPORT_ERROR выдаёт warning, при сочетании с MYSQLI_REPORT_STRICT — mysqli_sql_exception; с PHP 8.1 это сочетание включено по умолчанию. В примерах оно задано явно. Ошибки типов, закрытого объекта и неверных аргументов могут возникать отдельно; сырое сообщение SQL не публикуют посетителю.

Путь данных. PHP отправляет SELECT → MySQL вычисляет строки → query возвращает объект результата → fetch_assoc извлекает значения.

Как читать этот вариант. Контекстный пример: нужен отдельный учебный MySQL, расширение mysqli, база course_demo и её пользователь course_user с разрешением временных таблиц. Учебные параметры подключения заменяют своими; рабочие базы не используют. Здесь проверен PHP-синтаксис, серверный запрос не выполнялся. SELECT просит сервер вычислить значение. AS подписывает колонку, query возвращает объект набора строк, fetch_assoc читает одну строку в массив, ключ item_id берётся из AS. Это четыре разных действия, а не возврат числа непосредственно из query.

<?php
mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
$db = new mysqli('127.0.0.1', 'course_user', 'course_password', 'course_demo', 3306);
$db->set_charset('utf8mb4');
$result = $db->query('SELECT 42 AS item_id');
$row = $result->fetch_assoc();
echo $row['item_id'], "\n";

42

Как читать этот вариант. Контекстный пример: нужен отдельный учебный MySQL, расширение mysqli, база course_demo и её пользователь course_user с разрешением временных таблиц. Учебные параметры подключения заменяют своими; рабочие базы не используют. Здесь проверен PHP-синтаксис, серверный запрос не выполнялся. while повторяет чтение до null. Без ORDER BY порядок строк не обещан. SQL здесь целиком постоянный; пользовательские значения передаются через prepare или execute_query.

<?php
mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
$db = new mysqli('127.0.0.1', 'course_user', 'course_password', 'course_demo', 3306);
$db->set_charset('utf8mb4');
$db->query('CREATE TEMPORARY TABLE course_products (id INT PRIMARY KEY, name VARCHAR(80) NOT NULL, price INT NOT NULL) ENGINE=InnoDB');
$db->query("INSERT INTO course_products VALUES (1, 'Pen', 120), (2, 'Notebook', 350), (3, 'Box', 200)");
$result = mysqli_query($db, 'SELECT name, price FROM course_products ORDER BY price, id');
while ($row = mysqli_fetch_assoc($result)) {
    echo $row['name'], ':', $row['price'], "\n";
}

Pen:120
Box:200
Notebook:350

Связанные операции: mysqli_execute_query, mysqli_prepare, mysqli_real_query, mysqli_fetch_assoc.

Оба входа к этой операции: mysqli_query, mysqli::query.

• PHP: mysqli.query

PHP 5+; изменения отмечены · mysqli; mysqlnd для отмеченных операций

mysqli_real_query(mysqli $mysql, string $query): bool; mysqli::real_query(string $query): bool

<?php
require __DIR__ . '/catalog.php';
$db->real_query('SELECT name, stock FROM products ORDER BY id');
$result = $db->store_result();
if ($result === false) { throw new RuntimeException('Ответ каталога не получен'); }
while (($row = $result->fetch_assoc()) !== null) {
    if ($row === false) { throw new RuntimeException('Не удалось прочитать строку'); }
    echo $row['name'], ' — ', $row['stock'], " шт.\n";
}
$result->free();

Молоток — 8 шт.
Перчатки — 15 шт.
Кисть — 0 шт.

Отправить один запрос, оставив выбор буферизации следующему шагу.

Процедурная функция получает соединение $db, команду $statement или результат $result первым аргументом. В записи $object->method(...) тот же объект стоит перед стрелкой. Свойство читается без круглых скобок. Эти варианты используют один механизм: выбирать стиль стоит по понятности проекта. аргументы и возврат, объект и его состояние.

true означает успешное выполнение, а не сами данные; false/исключение — отказ. До следующего запроса обработайте ожидаемый результат через store_result/use_result. Несколько команд через точку с запятой относятся к multi_query и иной политике безопасности.

SQL-ошибка при MYSQLI_REPORT_ERROR выдаёт warning, при сочетании с MYSQLI_REPORT_STRICT — mysqli_sql_exception; с PHP 8.1 это сочетание включено по умолчанию. В примерах оно задано явно. Ошибки типов, закрытого объекта и неверных аргументов могут возникать отдельно; сырое сообщение SQL не публикуют посетителю.

Путь данных. real_query отправляет SQL → field_count показывает наличие колонок → store_result/use_result забирает данные.

Как читать этот вариант. Контекстный пример: нужен отдельный учебный MySQL, расширение mysqli, база course_demo и её пользователь course_user с разрешением временных таблиц. Учебные параметры подключения заменяют своими; рабочие базы не используют. Здесь проверен PHP-синтаксис, серверный запрос не выполнялся. real_query подтверждает выполнение; строки отдельно забирает store_result или use_result. Это полезно, когда обёртка выбирает способ чтения после отправки.

<?php
mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
$db = new mysqli('127.0.0.1', 'course_user', 'course_password', 'course_demo', 3306);
$db->set_charset('utf8mb4');
$db->real_query('SELECT 12 AS quantity');
$result = $db->store_result();
echo $result->fetch_assoc()['quantity'], "\n";

12

Как читать этот вариант. Контекстный пример: нужен отдельный учебный MySQL, расширение mysqli, база course_demo и её пользователь course_user с разрешением временных таблиц. Учебные параметры подключения заменяют своими; рабочие базы не используют. Здесь проверен PHP-синтаксис, серверный запрос не выполнялся. field_count описывает количество колонок последнего запроса. У UPDATE нет строк результата, но есть affected_rows; false от store_result в этом случае не означает автоматически SQL-ошибку.

<?php
mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
$db = new mysqli('127.0.0.1', 'course_user', 'course_password', 'course_demo', 3306);
$db->set_charset('utf8mb4');
$db->query('CREATE TEMPORARY TABLE course_products (id INT PRIMARY KEY, name VARCHAR(80) NOT NULL, price INT NOT NULL) ENGINE=InnoDB');
$db->query("INSERT INTO course_products VALUES (1, 'Pen', 120), (2, 'Notebook', 350), (3, 'Box', 200)");
mysqli_real_query($db, 'UPDATE course_products SET price = 130 WHERE id = 1');
if (mysqli_field_count($db) === 0) {
    echo 'Изменено:', mysqli_affected_rows($db), "\n";
}

Изменено:1

Связанные операции: mysqli_store_result, mysqli_use_result, mysqli_field_count.

Оба входа к этой операции: mysqli_real_query, mysqli::real_query.

• PHP: mysqli.real-query

PHP 5+; изменения отмечены · mysqli; mysqlnd для отмеченных операций

mysqli_real_query(mysqli $mysql, string $query): bool; mysqli::real_query(string $query): bool

<?php
require __DIR__ . '/catalog.php';
$db->real_query('SELECT name, stock FROM products ORDER BY id');
$result = $db->store_result();
if ($result === false) { throw new RuntimeException('Ответ каталога не получен'); }
while (($row = $result->fetch_assoc()) !== null) {
    if ($row === false) { throw new RuntimeException('Не удалось прочитать строку'); }
    echo $row['name'], ' — ', $row['stock'], " шт.\n";
}
$result->free();

Молоток — 8 шт.
Перчатки — 15 шт.
Кисть — 0 шт.

Отправить один запрос, оставив выбор буферизации следующему шагу.

Процедурная функция получает соединение $db, команду $statement или результат $result первым аргументом. В записи $object->method(...) тот же объект стоит перед стрелкой. Свойство читается без круглых скобок. Эти варианты используют один механизм: выбирать стиль стоит по понятности проекта. аргументы и возврат, объект и его состояние.

true означает успешное выполнение, а не сами данные; false/исключение — отказ. До следующего запроса обработайте ожидаемый результат через store_result/use_result. Несколько команд через точку с запятой относятся к multi_query и иной политике безопасности.

SQL-ошибка при MYSQLI_REPORT_ERROR выдаёт warning, при сочетании с MYSQLI_REPORT_STRICT — mysqli_sql_exception; с PHP 8.1 это сочетание включено по умолчанию. В примерах оно задано явно. Ошибки типов, закрытого объекта и неверных аргументов могут возникать отдельно; сырое сообщение SQL не публикуют посетителю.

Путь данных. real_query отправляет SQL → field_count показывает наличие колонок → store_result/use_result забирает данные.

Как читать этот вариант. Контекстный пример: нужен отдельный учебный MySQL, расширение mysqli, база course_demo и её пользователь course_user с разрешением временных таблиц. Учебные параметры подключения заменяют своими; рабочие базы не используют. Здесь проверен PHP-синтаксис, серверный запрос не выполнялся. real_query подтверждает выполнение; строки отдельно забирает store_result или use_result. Это полезно, когда обёртка выбирает способ чтения после отправки.

<?php
mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
$db = new mysqli('127.0.0.1', 'course_user', 'course_password', 'course_demo', 3306);
$db->set_charset('utf8mb4');
$db->real_query('SELECT 12 AS quantity');
$result = $db->store_result();
echo $result->fetch_assoc()['quantity'], "\n";

12

Как читать этот вариант. Контекстный пример: нужен отдельный учебный MySQL, расширение mysqli, база course_demo и её пользователь course_user с разрешением временных таблиц. Учебные параметры подключения заменяют своими; рабочие базы не используют. Здесь проверен PHP-синтаксис, серверный запрос не выполнялся. field_count описывает количество колонок последнего запроса. У UPDATE нет строк результата, но есть affected_rows; false от store_result в этом случае не означает автоматически SQL-ошибку.

<?php
mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
$db = new mysqli('127.0.0.1', 'course_user', 'course_password', 'course_demo', 3306);
$db->set_charset('utf8mb4');
$db->query('CREATE TEMPORARY TABLE course_products (id INT PRIMARY KEY, name VARCHAR(80) NOT NULL, price INT NOT NULL) ENGINE=InnoDB');
$db->query("INSERT INTO course_products VALUES (1, 'Pen', 120), (2, 'Notebook', 350), (3, 'Box', 200)");
mysqli_real_query($db, 'UPDATE course_products SET price = 130 WHERE id = 1');
if (mysqli_field_count($db) === 0) {
    echo 'Изменено:', mysqli_affected_rows($db), "\n";
}

Изменено:1

Связанные операции: mysqli_store_result, mysqli_use_result, mysqli_field_count.

Оба входа к этой операции: mysqli_real_query, mysqli::real_query.

• PHP: mysqli.real-query

PHP 8.2+ · mysqli; mysqlnd для отмеченных операций

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

<?php
require __DIR__ . '/catalog.php';
$result = $db->execute_query('SELECT name, stock FROM products WHERE id = ?', [2]);
$row = $result->fetch_assoc();
echo $row['name'], ' — ', $row['stock'], " шт.\n";

Перчатки — 15 шт.

Кратко выполнить подготовленный запрос с отдельным списком значений.

Процедурная функция получает соединение $db, команду $statement или результат $result первым аргументом. В записи $object->method(...) тот же объект стоит перед стрелкой. Свойство читается без круглых скобок. Эти варианты используют один механизм: выбирать стиль стоит по понятности проекта. аргументы и возврат, объект и его состояние.

Доступно с PHP 8.2: сокращение prepare → bind/execute → get_result. Объект statement наружу не возвращается; сведения affected_rows/ошибки копируются на соединение. Для набора строк возвращает mysqli_result, иначе true; отказ false/исключение. Нельзя заменить ? именем столбца или частью кавычек. Учитывайте серверный max_allowed_packet, включая платформенные различия кодов ошибки.

SQL-ошибка при MYSQLI_REPORT_ERROR выдаёт warning, при сочетании с MYSQLI_REPORT_STRICT — mysqli_sql_exception; с PHP 8.1 это сочетание включено по умолчанию. В примерах оно задано явно. Ошибки типов, закрытого объекта и неверных аргументов могут возникать отдельно; сырое сообщение SQL не публикуют посетителю.

Путь данных. ? фиксирует место цены → Массив поставляет 390 и 2 → Сервер выполняет подготовленную команду → Результат/статус возвращается вызывающему коду.

Как читать этот вариант. Контекстный пример: нужен отдельный учебный MySQL, расширение mysqli, база course_demo и её пользователь course_user с разрешением временных таблиц. Учебные параметры подключения заменяют своими; рабочие базы не используют. Здесь проверен PHP-синтаксис, серверный запрос не выполнялся. ? — место одного значения. SQL-шаблон и список значений передаются отдельно: строка посетителя не становится частью синтаксиса SQL. Метод сам готовит statement и возвращает результат.

<?php
mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
$db = new mysqli('127.0.0.1', 'course_user', 'course_password', 'course_demo', 3306);
$db->set_charset('utf8mb4');
$db->query('CREATE TEMPORARY TABLE course_products (id INT PRIMARY KEY, name VARCHAR(80) NOT NULL, price INT NOT NULL) ENGINE=InnoDB');
$db->query("INSERT INTO course_products VALUES (1, 'Pen', 120), (2, 'Notebook', 350), (3, 'Box', 200)");
$result = $db->execute_query('SELECT name FROM course_products WHERE id = ?', [2]);
echo $result->fetch_column(), "\n";

Notebook

Как читать этот вариант. Контекстный пример: нужен отдельный учебный MySQL, расширение mysqli, база course_demo и её пользователь course_user с разрешением временных таблиц. Учебные параметры подключения заменяют своими; рабочие базы не используют. Здесь проверен PHP-синтаксис, серверный запрос не выполнялся. Порядок параметров совпадает с порядком вопросов: сначала новая цена, затем ID. Имена таблиц/колонок таким способом не подставляются. Для многократных выполнений одного шаблона выгоднее сохранить prepare-объект.

<?php
mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
$db = new mysqli('127.0.0.1', 'course_user', 'course_password', 'course_demo', 3306);
$db->set_charset('utf8mb4');
$db->query('CREATE TEMPORARY TABLE course_products (id INT PRIMARY KEY, name VARCHAR(80) NOT NULL, price INT NOT NULL) ENGINE=InnoDB');
$db->query("INSERT INTO course_products VALUES (1, 'Pen', 120), (2, 'Notebook', 350), (3, 'Box', 200)");
mysqli_execute_query($db, 'UPDATE course_products SET price = ? WHERE id = ?', [390, 2]);
echo mysqli_affected_rows($db), "\n";
echo $db->query('SELECT price FROM course_products WHERE id = 2')->fetch_column(), "\n";

1
390

Связанные операции: mysqli_prepare, mysqli_stmt_execute, mysqli_stmt_get_result.

Оба входа к этой операции: mysqli_execute_query, mysqli::execute_query.

• PHP: mysqli.execute-query

PHP 8.2+ · mysqli; mysqlnd для отмеченных операций

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

<?php
require __DIR__ . '/catalog.php';
$result = $db->execute_query('SELECT name, stock FROM products WHERE id = ?', [2]);
$row = $result->fetch_assoc();
echo $row['name'], ' — ', $row['stock'], " шт.\n";

Перчатки — 15 шт.

Кратко выполнить подготовленный запрос с отдельным списком значений.

Процедурная функция получает соединение $db, команду $statement или результат $result первым аргументом. В записи $object->method(...) тот же объект стоит перед стрелкой. Свойство читается без круглых скобок. Эти варианты используют один механизм: выбирать стиль стоит по понятности проекта. аргументы и возврат, объект и его состояние.

Доступно с PHP 8.2: сокращение prepare → bind/execute → get_result. Объект statement наружу не возвращается; сведения affected_rows/ошибки копируются на соединение. Для набора строк возвращает mysqli_result, иначе true; отказ false/исключение. Нельзя заменить ? именем столбца или частью кавычек. Учитывайте серверный max_allowed_packet, включая платформенные различия кодов ошибки.

SQL-ошибка при MYSQLI_REPORT_ERROR выдаёт warning, при сочетании с MYSQLI_REPORT_STRICT — mysqli_sql_exception; с PHP 8.1 это сочетание включено по умолчанию. В примерах оно задано явно. Ошибки типов, закрытого объекта и неверных аргументов могут возникать отдельно; сырое сообщение SQL не публикуют посетителю.

Путь данных. ? фиксирует место цены → Массив поставляет 390 и 2 → Сервер выполняет подготовленную команду → Результат/статус возвращается вызывающему коду.

Как читать этот вариант. Контекстный пример: нужен отдельный учебный MySQL, расширение mysqli, база course_demo и её пользователь course_user с разрешением временных таблиц. Учебные параметры подключения заменяют своими; рабочие базы не используют. Здесь проверен PHP-синтаксис, серверный запрос не выполнялся. ? — место одного значения. SQL-шаблон и список значений передаются отдельно: строка посетителя не становится частью синтаксиса SQL. Метод сам готовит statement и возвращает результат.

<?php
mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
$db = new mysqli('127.0.0.1', 'course_user', 'course_password', 'course_demo', 3306);
$db->set_charset('utf8mb4');
$db->query('CREATE TEMPORARY TABLE course_products (id INT PRIMARY KEY, name VARCHAR(80) NOT NULL, price INT NOT NULL) ENGINE=InnoDB');
$db->query("INSERT INTO course_products VALUES (1, 'Pen', 120), (2, 'Notebook', 350), (3, 'Box', 200)");
$result = $db->execute_query('SELECT name FROM course_products WHERE id = ?', [2]);
echo $result->fetch_column(), "\n";

Notebook

Как читать этот вариант. Контекстный пример: нужен отдельный учебный MySQL, расширение mysqli, база course_demo и её пользователь course_user с разрешением временных таблиц. Учебные параметры подключения заменяют своими; рабочие базы не используют. Здесь проверен PHP-синтаксис, серверный запрос не выполнялся. Порядок параметров совпадает с порядком вопросов: сначала новая цена, затем ID. Имена таблиц/колонок таким способом не подставляются. Для многократных выполнений одного шаблона выгоднее сохранить prepare-объект.

<?php
mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
$db = new mysqli('127.0.0.1', 'course_user', 'course_password', 'course_demo', 3306);
$db->set_charset('utf8mb4');
$db->query('CREATE TEMPORARY TABLE course_products (id INT PRIMARY KEY, name VARCHAR(80) NOT NULL, price INT NOT NULL) ENGINE=InnoDB');
$db->query("INSERT INTO course_products VALUES (1, 'Pen', 120), (2, 'Notebook', 350), (3, 'Box', 200)");
mysqli_execute_query($db, 'UPDATE course_products SET price = ? WHERE id = ?', [390, 2]);
echo mysqli_affected_rows($db), "\n";
echo $db->query('SELECT price FROM course_products WHERE id = 2')->fetch_column(), "\n";

1
390

Связанные операции: mysqli_prepare, mysqli_stmt_execute, mysqli_stmt_get_result.

Оба входа к этой операции: mysqli_execute_query, mysqli::execute_query.

• PHP: mysqli.execute-query

PHP 5+; изменения отмечены · mysqli; mysqlnd для отмеченных операций

mysqli_prepare(mysqli $mysql, string $query): mysqli_stmt|false; mysqli::prepare(string $query): mysqli_stmt|false

<?php
require __DIR__ . '/catalog.php';
$stmt = $db->prepare('SELECT name, stock FROM products WHERE id = ?');
$stmt->execute([2]);
$result = $stmt->get_result();
$row = $result->fetch_assoc();
echo $row['name'], ' — ', $row['stock'], " шт.\n";
$result->free();
$stmt->close();

Перчатки — 15 шт.

Получить команду, которую можно безопасно выполнять с разными данными.

Процедурная функция получает соединение $db, команду $statement или результат $result первым аргументом. В записи $object->method(...) тот же объект стоит перед стрелкой. Свойство читается без круглых скобок. Эти варианты используют один механизм: выбирать стиль стоит по понятности проекта. аргументы и возврат, объект и его состояние.

Возвращает mysqli_stmt или false/исключение. Не выполняет SQL сразу. В MySQLi нет именованных :name-параметров PDO. Нельзя параметризовать SQL-ключевые слова, имена таблиц или колонок. После подготовки bind_param+execute либо execute(array) с PHP 8.1; затем get_result или bind_result+fetch. Каждый statement удерживает ресурсы до закрытия.

SQL-ошибка при MYSQLI_REPORT_ERROR выдаёт warning, при сочетании с MYSQLI_REPORT_STRICT — mysqli_sql_exception; с PHP 8.1 это сочетание включено по умолчанию. В примерах оно задано явно. Ошибки типов, закрытого объекта и неверных аргументов могут возникать отдельно; сырое сообщение SQL не публикуют посетителю.

Путь данных. Шаблон проходит prepare → Объект хранит подготовленную команду → execute передаёт значения → fetch читает новый результат.

Как читать этот вариант. Контекстный пример: нужен отдельный учебный MySQL, расширение mysqli, база course_demo и её пользователь course_user с разрешением временных таблиц. Учебные параметры подключения заменяют своими; рабочие базы не используют. Здесь проверен PHP-синтаксис, серверный запрос не выполнялся. prepare разбирает шаблон, execute подаёт данные. Здесь execute(array) требует PHP 8.1+. Подготовка добавляет отдельный сетевой шаг, поэтому не нужно утверждать, что любой единичный запрос от неё быстрее.

<?php
mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
$db = new mysqli('127.0.0.1', 'course_user', 'course_password', 'course_demo', 3306);
$db->set_charset('utf8mb4');
$db->query('CREATE TEMPORARY TABLE course_products (id INT PRIMARY KEY, name VARCHAR(80) NOT NULL, price INT NOT NULL) ENGINE=InnoDB');
$db->query("INSERT INTO course_products VALUES (1, 'Pen', 120), (2, 'Notebook', 350), (3, 'Box', 200)");
$statement = $db->prepare('SELECT name FROM course_products WHERE id = ?');
foreach ([1, 3] as $id) {
    $statement->execute([$id]);
    echo $statement->get_result()->fetch_column(), "\n";
}

Pen
Box

Как читать этот вариант. Контекстный пример: нужен отдельный учебный MySQL, расширение mysqli, база course_demo и её пользователь course_user с разрешением временных таблиц. Учебные параметры подключения заменяют своими; рабочие базы не используют. Здесь проверен PHP-синтаксис, серверный запрос не выполнялся. Не добавляйте кавычки вокруг ? и не экранируйте параметр заранее: драйвер передаст значение как данные. Подготовка защищает значения, но разрешения приложения и проверку цены всё равно пишет разработчик.

<?php
mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
$db = new mysqli('127.0.0.1', 'course_user', 'course_password', 'course_demo', 3306);
$db->set_charset('utf8mb4');
$db->query('CREATE TEMPORARY TABLE course_products (id INT PRIMARY KEY, name VARCHAR(80) NOT NULL, price INT NOT NULL) ENGINE=InnoDB');
$db->query("INSERT INTO course_products VALUES (1, 'Pen', 120), (2, 'Notebook', 350), (3, 'Box', 200)");
$statement = mysqli_prepare($db, 'INSERT INTO course_products VALUES (?, ?, ?)');
mysqli_stmt_execute($statement, [4, "Reader's book", 500]);
echo $db->query('SELECT name FROM course_products WHERE id = 4')->fetch_column(), "\n";

Reader's book

Связанные операции: mysqli_stmt_bind_param, mysqli_stmt_execute, mysqli_stmt_close.

Оба входа к этой операции: mysqli_prepare, mysqli::prepare.

• PHP: mysqli.prepare

PHP 5+; изменения отмечены · mysqli; mysqlnd для отмеченных операций

mysqli_prepare(mysqli $mysql, string $query): mysqli_stmt|false; mysqli::prepare(string $query): mysqli_stmt|false

<?php
require __DIR__ . '/catalog.php';
$stmt = $db->prepare('SELECT name, stock FROM products WHERE id = ?');
$stmt->execute([2]);
$result = $stmt->get_result();
$row = $result->fetch_assoc();
echo $row['name'], ' — ', $row['stock'], " шт.\n";
$result->free();
$stmt->close();

Перчатки — 15 шт.

Получить команду, которую можно безопасно выполнять с разными данными.

Процедурная функция получает соединение $db, команду $statement или результат $result первым аргументом. В записи $object->method(...) тот же объект стоит перед стрелкой. Свойство читается без круглых скобок. Эти варианты используют один механизм: выбирать стиль стоит по понятности проекта. аргументы и возврат, объект и его состояние.

Возвращает mysqli_stmt или false/исключение. Не выполняет SQL сразу. В MySQLi нет именованных :name-параметров PDO. Нельзя параметризовать SQL-ключевые слова, имена таблиц или колонок. После подготовки bind_param+execute либо execute(array) с PHP 8.1; затем get_result или bind_result+fetch. Каждый statement удерживает ресурсы до закрытия.

SQL-ошибка при MYSQLI_REPORT_ERROR выдаёт warning, при сочетании с MYSQLI_REPORT_STRICT — mysqli_sql_exception; с PHP 8.1 это сочетание включено по умолчанию. В примерах оно задано явно. Ошибки типов, закрытого объекта и неверных аргументов могут возникать отдельно; сырое сообщение SQL не публикуют посетителю.

Путь данных. Шаблон проходит prepare → Объект хранит подготовленную команду → execute передаёт значения → fetch читает новый результат.

Как читать этот вариант. Контекстный пример: нужен отдельный учебный MySQL, расширение mysqli, база course_demo и её пользователь course_user с разрешением временных таблиц. Учебные параметры подключения заменяют своими; рабочие базы не используют. Здесь проверен PHP-синтаксис, серверный запрос не выполнялся. prepare разбирает шаблон, execute подаёт данные. Здесь execute(array) требует PHP 8.1+. Подготовка добавляет отдельный сетевой шаг, поэтому не нужно утверждать, что любой единичный запрос от неё быстрее.

<?php
mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
$db = new mysqli('127.0.0.1', 'course_user', 'course_password', 'course_demo', 3306);
$db->set_charset('utf8mb4');
$db->query('CREATE TEMPORARY TABLE course_products (id INT PRIMARY KEY, name VARCHAR(80) NOT NULL, price INT NOT NULL) ENGINE=InnoDB');
$db->query("INSERT INTO course_products VALUES (1, 'Pen', 120), (2, 'Notebook', 350), (3, 'Box', 200)");
$statement = $db->prepare('SELECT name FROM course_products WHERE id = ?');
foreach ([1, 3] as $id) {
    $statement->execute([$id]);
    echo $statement->get_result()->fetch_column(), "\n";
}

Pen
Box

Как читать этот вариант. Контекстный пример: нужен отдельный учебный MySQL, расширение mysqli, база course_demo и её пользователь course_user с разрешением временных таблиц. Учебные параметры подключения заменяют своими; рабочие базы не используют. Здесь проверен PHP-синтаксис, серверный запрос не выполнялся. Не добавляйте кавычки вокруг ? и не экранируйте параметр заранее: драйвер передаст значение как данные. Подготовка защищает значения, но разрешения приложения и проверку цены всё равно пишет разработчик.

<?php
mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
$db = new mysqli('127.0.0.1', 'course_user', 'course_password', 'course_demo', 3306);
$db->set_charset('utf8mb4');
$db->query('CREATE TEMPORARY TABLE course_products (id INT PRIMARY KEY, name VARCHAR(80) NOT NULL, price INT NOT NULL) ENGINE=InnoDB');
$db->query("INSERT INTO course_products VALUES (1, 'Pen', 120), (2, 'Notebook', 350), (3, 'Box', 200)");
$statement = mysqli_prepare($db, 'INSERT INTO course_products VALUES (?, ?, ?)');
mysqli_stmt_execute($statement, [4, "Reader's book", 500]);
echo $db->query('SELECT name FROM course_products WHERE id = 4')->fetch_column(), "\n";

Reader's book

Связанные операции: mysqli_stmt_bind_param, mysqli_stmt_execute, mysqli_stmt_close.

Оба входа к этой операции: mysqli_prepare, mysqli::prepare.

• PHP: mysqli.prepare

PHP 5+; изменения отмечены · mysqli; mysqlnd для отмеченных операций

mysqli_stmt_init(mysqli $mysql): mysqli_stmt|false; mysqli::stmt_init(): mysqli_stmt|false

<?php
require __DIR__ . '/catalog.php';
$stmt = $db->stmt_init();
$stmt->prepare('SELECT name, stock FROM products WHERE id = ?');
$stmt->execute([2]);
$result = $stmt->get_result();
$row = $result->fetch_assoc();
echo $row['name'], ' — ', $row['stock'], " шт.\n";
$result->free();
$stmt->close();

Перчатки — 15 шт.

Создать пустой объект подготовленной команды.

Процедурная функция получает соединение $db, команду $statement или результат $result первым аргументом. В записи $object->method(...) тот же объект стоит перед стрелкой. Свойство читается без круглых скобок. Эти варианты используют один механизм: выбирать стиль стоит по понятности проекта. аргументы и возврат, объект и его состояние.

mysqli_stmt либо false. До execute нужно вызвать prepare на statement. Не путать с mysqli_init: тот выделяет соединение, этот — команду внутри соединения.

SQL-ошибка при MYSQLI_REPORT_ERROR выдаёт warning, при сочетании с MYSQLI_REPORT_STRICT — mysqli_sql_exception; с PHP 8.1 это сочетание включено по умолчанию. В примерах оно задано явно. Ошибки типов, закрытого объекта и неверных аргументов могут возникать отдельно; сырое сообщение SQL не публикуют посетителю.

Путь данных. Соединение создаёт statement → stmt::prepare задаёт SQL → stmt::execute запускает.

Как читать этот вариант. Контекстный пример: нужен отдельный учебный MySQL, расширение mysqli, база course_demo и её пользователь course_user с разрешением временных таблиц. Учебные параметры подключения заменяют своими; рабочие базы не используют. Здесь проверен PHP-синтаксис, серверный запрос не выполнялся. Выделенный объект ещё не содержит подготовленного SQL. Это промежуточный шаг для обёртки, которая создаёт команду отдельно от шаблона.

<?php
mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
$db = new mysqli('127.0.0.1', 'course_user', 'course_password', 'course_demo', 3306);
$db->set_charset('utf8mb4');
$statement = $db->stmt_init();
$statement->prepare('SELECT 42');
$statement->execute();
echo $statement->get_result()->fetch_column(), "\n";

42

Как читать этот вариант. Контекстный пример: нужен отдельный учебный MySQL, расширение mysqli, база course_demo и её пользователь course_user с разрешением временных таблиц. Учебные параметры подключения заменяют своими; рабочие базы не используют. Здесь проверен PHP-синтаксис, серверный запрос не выполнялся. Если предварительная настройка не нужна, $db->prepare(...) сразу делает выделение и подготовку, сокращая код без изменения подхода.

<?php
mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
$db = new mysqli('127.0.0.1', 'course_user', 'course_password', 'course_demo', 3306);
$db->set_charset('utf8mb4');
$db->query('CREATE TEMPORARY TABLE course_products (id INT PRIMARY KEY, name VARCHAR(80) NOT NULL, price INT NOT NULL) ENGINE=InnoDB');
$db->query("INSERT INTO course_products VALUES (1, 'Pen', 120), (2, 'Notebook', 350), (3, 'Box', 200)");
$statement = mysqli_stmt_init($db);
mysqli_stmt_prepare($statement, 'SELECT name FROM course_products WHERE id = ?');
mysqli_stmt_execute($statement, [3]);
echo mysqli_stmt_get_result($statement)->fetch_column(), "\n";

Box

Связанные операции: mysqli_prepare, mysqli_stmt_prepare.

Оба входа к этой операции: mysqli_stmt_init, mysqli::stmt_init.

• PHP: mysqli.stmt-init

PHP 5+; изменения отмечены · mysqli; mysqlnd для отмеченных операций

mysqli_stmt_init(mysqli $mysql): mysqli_stmt|false; mysqli::stmt_init(): mysqli_stmt|false

<?php
require __DIR__ . '/catalog.php';
$stmt = $db->stmt_init();
$stmt->prepare('SELECT name, stock FROM products WHERE id = ?');
$stmt->execute([2]);
$result = $stmt->get_result();
$row = $result->fetch_assoc();
echo $row['name'], ' — ', $row['stock'], " шт.\n";
$result->free();
$stmt->close();

Перчатки — 15 шт.

Создать пустой объект подготовленной команды.

Процедурная функция получает соединение $db, команду $statement или результат $result первым аргументом. В записи $object->method(...) тот же объект стоит перед стрелкой. Свойство читается без круглых скобок. Эти варианты используют один механизм: выбирать стиль стоит по понятности проекта. аргументы и возврат, объект и его состояние.

mysqli_stmt либо false. До execute нужно вызвать prepare на statement. Не путать с mysqli_init: тот выделяет соединение, этот — команду внутри соединения.

SQL-ошибка при MYSQLI_REPORT_ERROR выдаёт warning, при сочетании с MYSQLI_REPORT_STRICT — mysqli_sql_exception; с PHP 8.1 это сочетание включено по умолчанию. В примерах оно задано явно. Ошибки типов, закрытого объекта и неверных аргументов могут возникать отдельно; сырое сообщение SQL не публикуют посетителю.

Путь данных. Соединение создаёт statement → stmt::prepare задаёт SQL → stmt::execute запускает.

Как читать этот вариант. Контекстный пример: нужен отдельный учебный MySQL, расширение mysqli, база course_demo и её пользователь course_user с разрешением временных таблиц. Учебные параметры подключения заменяют своими; рабочие базы не используют. Здесь проверен PHP-синтаксис, серверный запрос не выполнялся. Выделенный объект ещё не содержит подготовленного SQL. Это промежуточный шаг для обёртки, которая создаёт команду отдельно от шаблона.

<?php
mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
$db = new mysqli('127.0.0.1', 'course_user', 'course_password', 'course_demo', 3306);
$db->set_charset('utf8mb4');
$statement = $db->stmt_init();
$statement->prepare('SELECT 42');
$statement->execute();
echo $statement->get_result()->fetch_column(), "\n";

42

Как читать этот вариант. Контекстный пример: нужен отдельный учебный MySQL, расширение mysqli, база course_demo и её пользователь course_user с разрешением временных таблиц. Учебные параметры подключения заменяют своими; рабочие базы не используют. Здесь проверен PHP-синтаксис, серверный запрос не выполнялся. Если предварительная настройка не нужна, $db->prepare(...) сразу делает выделение и подготовку, сокращая код без изменения подхода.

<?php
mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
$db = new mysqli('127.0.0.1', 'course_user', 'course_password', 'course_demo', 3306);
$db->set_charset('utf8mb4');
$db->query('CREATE TEMPORARY TABLE course_products (id INT PRIMARY KEY, name VARCHAR(80) NOT NULL, price INT NOT NULL) ENGINE=InnoDB');
$db->query("INSERT INTO course_products VALUES (1, 'Pen', 120), (2, 'Notebook', 350), (3, 'Box', 200)");
$statement = mysqli_stmt_init($db);
mysqli_stmt_prepare($statement, 'SELECT name FROM course_products WHERE id = ?');
mysqli_stmt_execute($statement, [3]);
echo mysqli_stmt_get_result($statement)->fetch_column(), "\n";

Box

Связанные операции: mysqli_prepare, mysqli_stmt_prepare.

Оба входа к этой операции: mysqli_stmt_init, mysqli::stmt_init.

• PHP: mysqli.stmt-init

PHP 5+; изменения отмечены · mysqli; mysqlnd для отмеченных операций

mysqli_store_result(mysqli $mysql, int $mode = 0): mysqli_result|false; mysqli::store_result(int $mode = 0): mysqli_result|false

<?php
require __DIR__ . '/catalog.php';
$db->real_query('SELECT name, stock FROM products ORDER BY id');
$result = $db->store_result();
if ($result === false) { throw new RuntimeException('Не удалось получить каталог'); }
while (($row = $result->fetch_assoc()) !== null) {
    if ($row === false) { throw new RuntimeException('Не удалось прочитать строку'); }
    echo $row['name'], ' — ', $row['stock'], " шт.\n";
}
$result->free();

Молоток — 8 шт.
Перчатки — 15 шт.
Кисть — 0 шт.

Забрать весь набор результата real_query/multi_query в память PHP-клиента.

Процедурная функция получает соединение $db, команду $statement или результат $result первым аргументом. В записи $object->method(...) тот же объект стоит перед стрелкой. Свойство читается без круглых скобок. Эти варианты используют один механизм: выбирать стиль стоит по понятности проекта. аргументы и возврат, объект и его состояние.

mysqli_result даже при нуле строк. false означает команду без набора либо отказ; сверяйте field_count/ошибку. Не вызывайте повторно для уже полученного набора. MYSQLI_STORE_RESULT_COPY_DATA — историческая настройка mysqlnd, с 8.1 не действует, с 8.4 deprecated.

SQL-ошибка при MYSQLI_REPORT_ERROR выдаёт warning, при сочетании с MYSQLI_REPORT_STRICT — mysqli_sql_exception; с PHP 8.1 это сочетание включено по умолчанию. В примерах оно задано явно. Ошибки типов, закрытого объекта и неверных аргументов могут возникать отдельно; сырое сообщение SQL не публикуют посетителю.

Путь данных. Сервер выдаёт набор → store_result получает все строки → num_rows известен → data_seek может выбрать строку.

Как читать этот вариант. Контекстный пример: нужен отдельный учебный MySQL, расширение mysqli, база course_demo и её пользователь course_user с разрешением временных таблиц. Учебные параметры подключения заменяют своими; рабочие базы не используют. Здесь проверен PHP-синтаксис, серверный запрос не выполнялся. Все строки уже получены клиентом: доступны счётчик и перемотка. Цена — память для набора; это не вариант по умолчанию для экспорта миллионов записей.

<?php
mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
$db = new mysqli('127.0.0.1', 'course_user', 'course_password', 'course_demo', 3306);
$db->set_charset('utf8mb4');
$db->query('CREATE TEMPORARY TABLE course_products (id INT PRIMARY KEY, name VARCHAR(80) NOT NULL, price INT NOT NULL) ENGINE=InnoDB');
$db->query("INSERT INTO course_products VALUES (1, 'Pen', 120), (2, 'Notebook', 350), (3, 'Box', 200)");
$db->real_query('SELECT name FROM course_products ORDER BY id');
$result = $db->store_result();
echo $result->num_rows, "\n";
$result->data_seek(2);
echo $result->fetch_column(), "\n";

3
Box

Как читать этот вариант. Контекстный пример: нужен отдельный учебный MySQL, расширение mysqli, база course_demo и её пользователь course_user с разрешением временных таблиц. Учебные параметры подключения заменяют своими; рабочие базы не используют. Здесь проверен PHP-синтаксис, серверный запрос не выполнялся. У пустого SELECT есть колонки, поэтому объект результата существует с нулём строк. SET не создаёт набора. Если field_count > 0, а результата нет, исследуйте ошибку, включая отказ выделения памяти.

<?php
mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
$db = new mysqli('127.0.0.1', 'course_user', 'course_password', 'course_demo', 3306);
$db->set_charset('utf8mb4');
$db->real_query('SELECT 42 WHERE 1 = 0');
$result = $db->store_result();
echo $result->num_rows, "\n";
$result->free();
$db->real_query('SET @course_number = 42');
var_dump($db->store_result());

0
bool(false)

Связанные операции: mysqli_use_result, mysqli_field_count, mysqli_num_rows.

Оба входа к этой операции: mysqli_store_result, mysqli::store_result.

• PHP: mysqli.store-result

PHP 5+; изменения отмечены · mysqli; mysqlnd для отмеченных операций

mysqli_store_result(mysqli $mysql, int $mode = 0): mysqli_result|false; mysqli::store_result(int $mode = 0): mysqli_result|false

<?php
require __DIR__ . '/catalog.php';
$db->real_query('SELECT name, stock FROM products ORDER BY id');
$result = $db->store_result();
if ($result === false) { throw new RuntimeException('Не удалось получить каталог'); }
while (($row = $result->fetch_assoc()) !== null) {
    if ($row === false) { throw new RuntimeException('Не удалось прочитать строку'); }
    echo $row['name'], ' — ', $row['stock'], " шт.\n";
}
$result->free();

Молоток — 8 шт.
Перчатки — 15 шт.
Кисть — 0 шт.

Забрать весь набор результата real_query/multi_query в память PHP-клиента.

Процедурная функция получает соединение $db, команду $statement или результат $result первым аргументом. В записи $object->method(...) тот же объект стоит перед стрелкой. Свойство читается без круглых скобок. Эти варианты используют один механизм: выбирать стиль стоит по понятности проекта. аргументы и возврат, объект и его состояние.

mysqli_result даже при нуле строк. false означает команду без набора либо отказ; сверяйте field_count/ошибку. Не вызывайте повторно для уже полученного набора. MYSQLI_STORE_RESULT_COPY_DATA — историческая настройка mysqlnd, с 8.1 не действует, с 8.4 deprecated.

SQL-ошибка при MYSQLI_REPORT_ERROR выдаёт warning, при сочетании с MYSQLI_REPORT_STRICT — mysqli_sql_exception; с PHP 8.1 это сочетание включено по умолчанию. В примерах оно задано явно. Ошибки типов, закрытого объекта и неверных аргументов могут возникать отдельно; сырое сообщение SQL не публикуют посетителю.

Путь данных. Сервер выдаёт набор → store_result получает все строки → num_rows известен → data_seek может выбрать строку.

Как читать этот вариант. Контекстный пример: нужен отдельный учебный MySQL, расширение mysqli, база course_demo и её пользователь course_user с разрешением временных таблиц. Учебные параметры подключения заменяют своими; рабочие базы не используют. Здесь проверен PHP-синтаксис, серверный запрос не выполнялся. Все строки уже получены клиентом: доступны счётчик и перемотка. Цена — память для набора; это не вариант по умолчанию для экспорта миллионов записей.

<?php
mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
$db = new mysqli('127.0.0.1', 'course_user', 'course_password', 'course_demo', 3306);
$db->set_charset('utf8mb4');
$db->query('CREATE TEMPORARY TABLE course_products (id INT PRIMARY KEY, name VARCHAR(80) NOT NULL, price INT NOT NULL) ENGINE=InnoDB');
$db->query("INSERT INTO course_products VALUES (1, 'Pen', 120), (2, 'Notebook', 350), (3, 'Box', 200)");
$db->real_query('SELECT name FROM course_products ORDER BY id');
$result = $db->store_result();
echo $result->num_rows, "\n";
$result->data_seek(2);
echo $result->fetch_column(), "\n";

3
Box

Как читать этот вариант. Контекстный пример: нужен отдельный учебный MySQL, расширение mysqli, база course_demo и её пользователь course_user с разрешением временных таблиц. Учебные параметры подключения заменяют своими; рабочие базы не используют. Здесь проверен PHP-синтаксис, серверный запрос не выполнялся. У пустого SELECT есть колонки, поэтому объект результата существует с нулём строк. SET не создаёт набора. Если field_count > 0, а результата нет, исследуйте ошибку, включая отказ выделения памяти.

<?php
mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
$db = new mysqli('127.0.0.1', 'course_user', 'course_password', 'course_demo', 3306);
$db->set_charset('utf8mb4');
$db->real_query('SELECT 42 WHERE 1 = 0');
$result = $db->store_result();
echo $result->num_rows, "\n";
$result->free();
$db->real_query('SET @course_number = 42');
var_dump($db->store_result());

0
bool(false)

Связанные операции: mysqli_use_result, mysqli_field_count, mysqli_num_rows.

Оба входа к этой операции: mysqli_store_result, mysqli::store_result.

• PHP: mysqli.store-result

PHP 5+; изменения отмечены · mysqli; mysqlnd для отмеченных операций

mysqli_use_result(mysqli $mysql): mysqli_result|false; mysqli::use_result(): mysqli_result|false

<?php
require __DIR__ . '/catalog.php';
$db->real_query('SELECT name, stock FROM products ORDER BY id');
$result = $db->use_result();
if ($result === false) { throw new RuntimeException('Не удалось получить каталог'); }
while (($row = $result->fetch_assoc()) !== null) {
    if ($row === false) { throw new RuntimeException('Не удалось прочитать строку'); }
    echo $row['name'], ' — ', $row['stock'], " шт.\n";
}
$result->free();

Молоток — 8 шт.
Перчатки — 15 шт.
Кисть — 0 шт.

Получить небуферизованный поток строк предыдущего запроса.

Процедурная функция получает соединение $db, команду $statement или результат $result первым аргументом. В записи $object->method(...) тот же объект стоит перед стрелкой. Свойство читается без круглых скобок. Эти варианты используют один механизм: выбирать стиль стоит по понятности проекта. аргументы и возврат, объект и его состояние.

mysqli_result либо false. Нельзя перематывать data_seek; num_rows не даёт итог до полного чтения. До следующей команды дочитайте/освободите набор, иначе Commands out of sync. Обработка не должна без необходимости держать долгую операцию/блокировки сервера; фактические блокировки зависят от SQL, движка и транзакции.

SQL-ошибка при MYSQLI_REPORT_ERROR выдаёт warning, при сочетании с MYSQLI_REPORT_STRICT — mysqli_sql_exception; с PHP 8.1 это сочетание включено по умолчанию. В примерах оно задано явно. Ошибки типов, закрытого объекта и неверных аргументов могут возникать отдельно; сырое сообщение SQL не публикуют посетителю.

Путь данных. Запрос открыл серверный набор → fetch передаёт очередную строку → PHP обрабатывает её → Конец/free освобождает соединение.

Как читать этот вариант. Контекстный пример: нужен отдельный учебный MySQL, расширение mysqli, база course_demo и её пользователь course_user с разрешением временных таблиц. Учебные параметры подключения заменяют своими; рабочие базы не используют. Здесь проверен PHP-синтаксис, серверный запрос не выполнялся. Поток уменьшает клиентский буфер, но соединение занято до завершения. Медленные внешние HTTP-вызовы внутри цикла удлинят SQL-операцию и жизнь серверных ресурсов; для таких задач читайте ограниченные страницы.

<?php
mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
$db = new mysqli('127.0.0.1', 'course_user', 'course_password', 'course_demo', 3306);
$db->set_charset('utf8mb4');
$db->query('CREATE TEMPORARY TABLE course_products (id INT PRIMARY KEY, name VARCHAR(80) NOT NULL, price INT NOT NULL) ENGINE=InnoDB');
$db->query("INSERT INTO course_products VALUES (1, 'Pen', 120), (2, 'Notebook', 350), (3, 'Box', 200)");
$db->real_query('SELECT name FROM course_products ORDER BY id');
$result = $db->use_result();
while ($row = $result->fetch_assoc()) { echo $row['name'], "\n"; }
$result->free();
echo $db->query('SELECT 42')->fetch_column(), "\n";

Pen
Notebook
Box
42

Как читать этот вариант. Контекстный пример: нужен отдельный учебный MySQL, расширение mysqli, база course_demo и её пользователь course_user с разрешением временных таблиц. Учебные параметры подключения заменяют своими; рабочие базы не используют. Здесь проверен PHP-синтаксис, серверный запрос не выполнялся. free завершает работу с остатком результата; это не обещание мгновенной отмены тяжёлого SQL. Если нужна лишь первая запись, эффективнее ограничить запрос LIMIT 1.

<?php
mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
$db = new mysqli('127.0.0.1', 'course_user', 'course_password', 'course_demo', 3306);
$db->set_charset('utf8mb4');
$db->query('CREATE TEMPORARY TABLE course_products (id INT PRIMARY KEY, name VARCHAR(80) NOT NULL, price INT NOT NULL) ENGINE=InnoDB');
$db->query("INSERT INTO course_products VALUES (1, 'Pen', 120), (2, 'Notebook', 350), (3, 'Box', 200)");
mysqli_real_query($db, 'SELECT name FROM course_products ORDER BY id');
$result = mysqli_use_result($db);
echo mysqli_fetch_column($result), "\n";
mysqli_free_result($result);
echo $db->query('SELECT 7')->fetch_column(), "\n";

Pen
7

Связанные операции: mysqli_store_result, mysqli_free_result.

Оба входа к этой операции: mysqli_use_result, mysqli::use_result.

• PHP: mysqli.use-result

PHP 5+; изменения отмечены · mysqli; mysqlnd для отмеченных операций

mysqli_use_result(mysqli $mysql): mysqli_result|false; mysqli::use_result(): mysqli_result|false

<?php
require __DIR__ . '/catalog.php';
$db->real_query('SELECT name, stock FROM products ORDER BY id');
$result = $db->use_result();
if ($result === false) { throw new RuntimeException('Не удалось получить каталог'); }
while (($row = $result->fetch_assoc()) !== null) {
    if ($row === false) { throw new RuntimeException('Не удалось прочитать строку'); }
    echo $row['name'], ' — ', $row['stock'], " шт.\n";
}
$result->free();

Молоток — 8 шт.
Перчатки — 15 шт.
Кисть — 0 шт.

Получить небуферизованный поток строк предыдущего запроса.

Процедурная функция получает соединение $db, команду $statement или результат $result первым аргументом. В записи $object->method(...) тот же объект стоит перед стрелкой. Свойство читается без круглых скобок. Эти варианты используют один механизм: выбирать стиль стоит по понятности проекта. аргументы и возврат, объект и его состояние.

mysqli_result либо false. Нельзя перематывать data_seek; num_rows не даёт итог до полного чтения. До следующей команды дочитайте/освободите набор, иначе Commands out of sync. Обработка не должна без необходимости держать долгую операцию/блокировки сервера; фактические блокировки зависят от SQL, движка и транзакции.

SQL-ошибка при MYSQLI_REPORT_ERROR выдаёт warning, при сочетании с MYSQLI_REPORT_STRICT — mysqli_sql_exception; с PHP 8.1 это сочетание включено по умолчанию. В примерах оно задано явно. Ошибки типов, закрытого объекта и неверных аргументов могут возникать отдельно; сырое сообщение SQL не публикуют посетителю.

Путь данных. Запрос открыл серверный набор → fetch передаёт очередную строку → PHP обрабатывает её → Конец/free освобождает соединение.

Как читать этот вариант. Контекстный пример: нужен отдельный учебный MySQL, расширение mysqli, база course_demo и её пользователь course_user с разрешением временных таблиц. Учебные параметры подключения заменяют своими; рабочие базы не используют. Здесь проверен PHP-синтаксис, серверный запрос не выполнялся. Поток уменьшает клиентский буфер, но соединение занято до завершения. Медленные внешние HTTP-вызовы внутри цикла удлинят SQL-операцию и жизнь серверных ресурсов; для таких задач читайте ограниченные страницы.

<?php
mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
$db = new mysqli('127.0.0.1', 'course_user', 'course_password', 'course_demo', 3306);
$db->set_charset('utf8mb4');
$db->query('CREATE TEMPORARY TABLE course_products (id INT PRIMARY KEY, name VARCHAR(80) NOT NULL, price INT NOT NULL) ENGINE=InnoDB');
$db->query("INSERT INTO course_products VALUES (1, 'Pen', 120), (2, 'Notebook', 350), (3, 'Box', 200)");
$db->real_query('SELECT name FROM course_products ORDER BY id');
$result = $db->use_result();
while ($row = $result->fetch_assoc()) { echo $row['name'], "\n"; }
$result->free();
echo $db->query('SELECT 42')->fetch_column(), "\n";

Pen
Notebook
Box
42

Как читать этот вариант. Контекстный пример: нужен отдельный учебный MySQL, расширение mysqli, база course_demo и её пользователь course_user с разрешением временных таблиц. Учебные параметры подключения заменяют своими; рабочие базы не используют. Здесь проверен PHP-синтаксис, серверный запрос не выполнялся. free завершает работу с остатком результата; это не обещание мгновенной отмены тяжёлого SQL. Если нужна лишь первая запись, эффективнее ограничить запрос LIMIT 1.

<?php
mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
$db = new mysqli('127.0.0.1', 'course_user', 'course_password', 'course_demo', 3306);
$db->set_charset('utf8mb4');
$db->query('CREATE TEMPORARY TABLE course_products (id INT PRIMARY KEY, name VARCHAR(80) NOT NULL, price INT NOT NULL) ENGINE=InnoDB');
$db->query("INSERT INTO course_products VALUES (1, 'Pen', 120), (2, 'Notebook', 350), (3, 'Box', 200)");
mysqli_real_query($db, 'SELECT name FROM course_products ORDER BY id');
$result = mysqli_use_result($db);
echo mysqli_fetch_column($result), "\n";
mysqli_free_result($result);
echo $db->query('SELECT 7')->fetch_column(), "\n";

Pen
7

Связанные операции: mysqli_store_result, mysqli_free_result.

Оба входа к этой операции: mysqli_use_result, mysqli::use_result.

• PHP: mysqli.use-result

PHP 5+; изменения отмечены · mysqli; mysqlnd для отмеченных операций

mysqli_multi_query(mysqli $mysql, string $query): bool; mysqli::multi_query(string $query): bool

<?php
require __DIR__ . '/catalog.php';
$db->multi_query('SELECT name, stock FROM products ORDER BY id; SELECT COUNT(*) AS total FROM products');
$result = $db->store_result();
while (($row = $result->fetch_assoc()) !== null) {
    if ($row === false) { throw new RuntimeException('Не удалось прочитать строку'); }
    echo $row['name'], ' — ', $row['stock'], " шт.\n";
}
$result->free();
if (!$db->more_results() || !$db->next_result()) { throw new RuntimeException('Итоговый ответ не получен'); }
$result = $db->store_result();
echo 'Всего позиций: ', $result->fetch_column(), "\n";
$result->free();

Молоток — 8 шт.
Перчатки — 15 шт.
Кисть — 0 шт.
Всего позиций: 3

Отправить несколько доверенных SQL-команд и последовательно прочитать каждый результат.

Процедурная функция получает соединение $db, команду $statement или результат $result первым аргументом. В записи $object->method(...) тот же объект стоит перед стрелкой. Свойство читается без круглых скобок. Эти варианты используют один механизм: выбирать стиль стоит по понятности проекта. аргументы и возврат, объект и его состояние.

true означает успех первого запроса; дальнейшие результаты, включая ошибки, приходят при next_result. Сервер выполняет последовательно, соединение занято до обработки всех наборов/статусов. CALL тоже может вернуть несколько наборов и завершающий статус. Для атомарности нужна отдельная транзакция.

SQL-ошибка при MYSQLI_REPORT_ERROR выдаёт warning, при сочетании с MYSQLI_REPORT_STRICT — mysqli_sql_exception; с PHP 8.1 это сочетание включено по умолчанию. В примерах оно задано явно. Ошибки типов, закрытого объекта и неверных аргументов могут возникать отдельно; сырое сообщение SQL не публикуют посетителю.

Путь данных. multi_query запускает пакет → store_result читает текущий набор → more_results проверяет продолжение → next_result переводит к следующему.

Как читать этот вариант. Контекстный пример: нужен отдельный учебный MySQL, расширение mysqli, база course_demo и её пользователь course_user с разрешением временных таблиц. Учебные параметры подключения заменяют своими; рабочие базы не используют. Здесь проверен PHP-синтаксис, серверный запрос не выполнялся. do выполняет тело для уже доступного первого результата. more_results сообщает наличие следующего, next_result переходит к нему. Пакет — только доверенный SQL, без пользовательских подстановок.

<?php
mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
$db = new mysqli('127.0.0.1', 'course_user', 'course_password', 'course_demo', 3306);
$db->set_charset('utf8mb4');
$db->multi_query('SELECT 12 AS value; SELECT 25 AS value');
do {
    if ($result = $db->store_result()) {
        echo $result->fetch_column(), "\n";
        $result->free();
    }
    if (!$db->more_results()) { break; }
} while ($db->next_result());

12
25

Как читать этот вариант. Контекстный пример: нужен отдельный учебный MySQL, расширение mysqli, база course_demo и её пользователь course_user с разрешением временных таблиц. Учебные параметры подключения заменяют своими; рабочие базы не используют. Здесь проверен PHP-синтаксис, серверный запрос не выполнялся. multi_query не является транзакцией: если поздняя команда упадёт, ранняя может уже сохраниться. При строгом режиме ошибка следующей команды может возникнуть в next_result, а не в исходном multi_query.

<?php
mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
$db = new mysqli('127.0.0.1', 'course_user', 'course_password', 'course_demo', 3306);
$db->set_charset('utf8mb4');
$db->query('CREATE TEMPORARY TABLE course_products (id INT PRIMARY KEY, name VARCHAR(80) NOT NULL, price INT NOT NULL) ENGINE=InnoDB');
$db->query("INSERT INTO course_products VALUES (1, 'Pen', 120), (2, 'Notebook', 350), (3, 'Box', 200)");
$db->multi_query('UPDATE course_products SET price = 125 WHERE id = 1; SELECT price FROM course_products WHERE id = 1');
do {
    if ($result = $db->store_result()) {
        echo 'Цена:', $result->fetch_column(), "\n";
        $result->free();
    } else {
        echo 'Изменено:', $db->affected_rows, "\n";
    }
    if (!$db->more_results()) { break; }
} while ($db->next_result());

Изменено:1
Цена:125

Связанные операции: mysqli_more_results, mysqli_next_result, mysqli_store_result, mysqli_begin_transaction.

Оба входа к этой операции: mysqli_multi_query, mysqli::multi_query.

• PHP: mysqli.multi-query

PHP 5+; изменения отмечены · mysqli; mysqlnd для отмеченных операций

mysqli_multi_query(mysqli $mysql, string $query): bool; mysqli::multi_query(string $query): bool

<?php
require __DIR__ . '/catalog.php';
$db->multi_query('SELECT name, stock FROM products ORDER BY id; SELECT COUNT(*) AS total FROM products');
$result = $db->store_result();
while (($row = $result->fetch_assoc()) !== null) {
    if ($row === false) { throw new RuntimeException('Не удалось прочитать строку'); }
    echo $row['name'], ' — ', $row['stock'], " шт.\n";
}
$result->free();
if (!$db->more_results() || !$db->next_result()) { throw new RuntimeException('Итоговый ответ не получен'); }
$result = $db->store_result();
echo 'Всего позиций: ', $result->fetch_column(), "\n";
$result->free();

Молоток — 8 шт.
Перчатки — 15 шт.
Кисть — 0 шт.
Всего позиций: 3

Отправить несколько доверенных SQL-команд и последовательно прочитать каждый результат.

Процедурная функция получает соединение $db, команду $statement или результат $result первым аргументом. В записи $object->method(...) тот же объект стоит перед стрелкой. Свойство читается без круглых скобок. Эти варианты используют один механизм: выбирать стиль стоит по понятности проекта. аргументы и возврат, объект и его состояние.

true означает успех первого запроса; дальнейшие результаты, включая ошибки, приходят при next_result. Сервер выполняет последовательно, соединение занято до обработки всех наборов/статусов. CALL тоже может вернуть несколько наборов и завершающий статус. Для атомарности нужна отдельная транзакция.

SQL-ошибка при MYSQLI_REPORT_ERROR выдаёт warning, при сочетании с MYSQLI_REPORT_STRICT — mysqli_sql_exception; с PHP 8.1 это сочетание включено по умолчанию. В примерах оно задано явно. Ошибки типов, закрытого объекта и неверных аргументов могут возникать отдельно; сырое сообщение SQL не публикуют посетителю.

Путь данных. multi_query запускает пакет → store_result читает текущий набор → more_results проверяет продолжение → next_result переводит к следующему.

Как читать этот вариант. Контекстный пример: нужен отдельный учебный MySQL, расширение mysqli, база course_demo и её пользователь course_user с разрешением временных таблиц. Учебные параметры подключения заменяют своими; рабочие базы не используют. Здесь проверен PHP-синтаксис, серверный запрос не выполнялся. do выполняет тело для уже доступного первого результата. more_results сообщает наличие следующего, next_result переходит к нему. Пакет — только доверенный SQL, без пользовательских подстановок.

<?php
mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
$db = new mysqli('127.0.0.1', 'course_user', 'course_password', 'course_demo', 3306);
$db->set_charset('utf8mb4');
$db->multi_query('SELECT 12 AS value; SELECT 25 AS value');
do {
    if ($result = $db->store_result()) {
        echo $result->fetch_column(), "\n";
        $result->free();
    }
    if (!$db->more_results()) { break; }
} while ($db->next_result());

12
25

Как читать этот вариант. Контекстный пример: нужен отдельный учебный MySQL, расширение mysqli, база course_demo и её пользователь course_user с разрешением временных таблиц. Учебные параметры подключения заменяют своими; рабочие базы не используют. Здесь проверен PHP-синтаксис, серверный запрос не выполнялся. multi_query не является транзакцией: если поздняя команда упадёт, ранняя может уже сохраниться. При строгом режиме ошибка следующей команды может возникнуть в next_result, а не в исходном multi_query.

<?php
mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
$db = new mysqli('127.0.0.1', 'course_user', 'course_password', 'course_demo', 3306);
$db->set_charset('utf8mb4');
$db->query('CREATE TEMPORARY TABLE course_products (id INT PRIMARY KEY, name VARCHAR(80) NOT NULL, price INT NOT NULL) ENGINE=InnoDB');
$db->query("INSERT INTO course_products VALUES (1, 'Pen', 120), (2, 'Notebook', 350), (3, 'Box', 200)");
$db->multi_query('UPDATE course_products SET price = 125 WHERE id = 1; SELECT price FROM course_products WHERE id = 1');
do {
    if ($result = $db->store_result()) {
        echo 'Цена:', $result->fetch_column(), "\n";
        $result->free();
    } else {
        echo 'Изменено:', $db->affected_rows, "\n";
    }
    if (!$db->more_results()) { break; }
} while ($db->next_result());

Изменено:1
Цена:125

Связанные операции: mysqli_more_results, mysqli_next_result, mysqli_store_result, mysqli_begin_transaction.

Оба входа к этой операции: mysqli_multi_query, mysqli::multi_query.

• PHP: mysqli.multi-query

PHP 5+; изменения отмечены · mysqli; mysqlnd для отмеченных операций

mysqli_more_results(mysqli $mysql): bool; mysqli::more_results(): bool

<?php
require __DIR__ . '/catalog.php';
$db->multi_query('SELECT name, stock FROM products ORDER BY id; SELECT COUNT(*) AS total FROM products');
$result = $db->store_result();
while (($row = $result->fetch_assoc()) !== null) {
    if ($row === false) { throw new RuntimeException('Не удалось прочитать строку'); }
    echo $row['name'], ' — ', $row['stock'], " шт.\n";
}
$result->free();
if (!$db->more_results() || !$db->next_result()) { throw new RuntimeException('Итоговый ответ не получен'); }
$result = $db->store_result();
echo 'Всего позиций: ', $result->fetch_column(), "\n";
$result->free();

Молоток — 8 шт.
Перчатки — 15 шт.
Кисть — 0 шт.
Всего позиций: 3

Узнать, остались ли ещё результаты пакета.

Процедурная функция получает соединение $db, команду $statement или результат $result первым аргументом. В записи $object->method(...) тот же объект стоит перед стрелкой. Свойство читается без круглых скобок. Эти варианты используют один механизм: выбирать стиль стоит по понятности проекта. аргументы и возврат, объект и его состояние.

true включает ожидаемый результат с ошибкой: это признак наличия продолжения, не его успеха. false — всё прочитано. Проверка не извлекает строки и не переключает набор.

Путь данных. Текущий набор обработан → more_results отвечает да/нет → При да вызывается next_result.

Как читать этот вариант. Контекстный пример: нужен отдельный учебный MySQL, расширение mysqli, база course_demo и её пользователь course_user с разрешением временных таблиц. Учебные параметры подключения заменяют своими; рабочие базы не используют. Здесь проверен PHP-синтаксис, серверный запрос не выполнялся. do выполняет тело для уже доступного первого результата. more_results сообщает наличие следующего, next_result переходит к нему. Пакет — только доверенный SQL, без пользовательских подстановок.

<?php
mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
$db = new mysqli('127.0.0.1', 'course_user', 'course_password', 'course_demo', 3306);
$db->set_charset('utf8mb4');
$db->multi_query('SELECT 12 AS value; SELECT 25 AS value');
do {
    if ($result = $db->store_result()) {
        echo $result->fetch_column(), "\n";
        $result->free();
    }
    if (!$db->more_results()) { break; }
} while ($db->next_result());

12
25

Как читать этот вариант. Контекстный пример: нужен отдельный учебный MySQL, расширение mysqli, база course_demo и её пользователь course_user с разрешением временных таблиц. Учебные параметры подключения заменяют своими; рабочие базы не используют. Здесь проверен PHP-синтаксис, серверный запрос не выполнялся. multi_query не является транзакцией: если поздняя команда упадёт, ранняя может уже сохраниться. При строгом режиме ошибка следующей команды может возникнуть в next_result, а не в исходном multi_query.

<?php
mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
$db = new mysqli('127.0.0.1', 'course_user', 'course_password', 'course_demo', 3306);
$db->set_charset('utf8mb4');
$db->query('CREATE TEMPORARY TABLE course_products (id INT PRIMARY KEY, name VARCHAR(80) NOT NULL, price INT NOT NULL) ENGINE=InnoDB');
$db->query("INSERT INTO course_products VALUES (1, 'Pen', 120), (2, 'Notebook', 350), (3, 'Box', 200)");
$db->multi_query('UPDATE course_products SET price = 125 WHERE id = 1; SELECT price FROM course_products WHERE id = 1');
do {
    if ($result = $db->store_result()) {
        echo 'Цена:', $result->fetch_column(), "\n";
        $result->free();
    } else {
        echo 'Изменено:', $db->affected_rows, "\n";
    }
    if (!$db->more_results()) { break; }
} while ($db->next_result());

Изменено:1
Цена:125

Связанные операции: mysqli_next_result, mysqli_multi_query.

Оба входа к этой операции: mysqli_more_results, mysqli::more_results.

• PHP: mysqli.more-results

PHP 5+; изменения отмечены · mysqli; mysqlnd для отмеченных операций

mysqli_more_results(mysqli $mysql): bool; mysqli::more_results(): bool

<?php
require __DIR__ . '/catalog.php';
$db->multi_query('SELECT name, stock FROM products ORDER BY id; SELECT COUNT(*) AS total FROM products');
$result = $db->store_result();
while (($row = $result->fetch_assoc()) !== null) {
    if ($row === false) { throw new RuntimeException('Не удалось прочитать строку'); }
    echo $row['name'], ' — ', $row['stock'], " шт.\n";
}
$result->free();
if (!$db->more_results() || !$db->next_result()) { throw new RuntimeException('Итоговый ответ не получен'); }
$result = $db->store_result();
echo 'Всего позиций: ', $result->fetch_column(), "\n";
$result->free();

Молоток — 8 шт.
Перчатки — 15 шт.
Кисть — 0 шт.
Всего позиций: 3

Узнать, остались ли ещё результаты пакета.

Процедурная функция получает соединение $db, команду $statement или результат $result первым аргументом. В записи $object->method(...) тот же объект стоит перед стрелкой. Свойство читается без круглых скобок. Эти варианты используют один механизм: выбирать стиль стоит по понятности проекта. аргументы и возврат, объект и его состояние.

true включает ожидаемый результат с ошибкой: это признак наличия продолжения, не его успеха. false — всё прочитано. Проверка не извлекает строки и не переключает набор.

Путь данных. Текущий набор обработан → more_results отвечает да/нет → При да вызывается next_result.

Как читать этот вариант. Контекстный пример: нужен отдельный учебный MySQL, расширение mysqli, база course_demo и её пользователь course_user с разрешением временных таблиц. Учебные параметры подключения заменяют своими; рабочие базы не используют. Здесь проверен PHP-синтаксис, серверный запрос не выполнялся. do выполняет тело для уже доступного первого результата. more_results сообщает наличие следующего, next_result переходит к нему. Пакет — только доверенный SQL, без пользовательских подстановок.

<?php
mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
$db = new mysqli('127.0.0.1', 'course_user', 'course_password', 'course_demo', 3306);
$db->set_charset('utf8mb4');
$db->multi_query('SELECT 12 AS value; SELECT 25 AS value');
do {
    if ($result = $db->store_result()) {
        echo $result->fetch_column(), "\n";
        $result->free();
    }
    if (!$db->more_results()) { break; }
} while ($db->next_result());

12
25

Как читать этот вариант. Контекстный пример: нужен отдельный учебный MySQL, расширение mysqli, база course_demo и её пользователь course_user с разрешением временных таблиц. Учебные параметры подключения заменяют своими; рабочие базы не используют. Здесь проверен PHP-синтаксис, серверный запрос не выполнялся. multi_query не является транзакцией: если поздняя команда упадёт, ранняя может уже сохраниться. При строгом режиме ошибка следующей команды может возникнуть в next_result, а не в исходном multi_query.

<?php
mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
$db = new mysqli('127.0.0.1', 'course_user', 'course_password', 'course_demo', 3306);
$db->set_charset('utf8mb4');
$db->query('CREATE TEMPORARY TABLE course_products (id INT PRIMARY KEY, name VARCHAR(80) NOT NULL, price INT NOT NULL) ENGINE=InnoDB');
$db->query("INSERT INTO course_products VALUES (1, 'Pen', 120), (2, 'Notebook', 350), (3, 'Box', 200)");
$db->multi_query('UPDATE course_products SET price = 125 WHERE id = 1; SELECT price FROM course_products WHERE id = 1');
do {
    if ($result = $db->store_result()) {
        echo 'Цена:', $result->fetch_column(), "\n";
        $result->free();
    } else {
        echo 'Изменено:', $db->affected_rows, "\n";
    }
    if (!$db->more_results()) { break; }
} while ($db->next_result());

Изменено:1
Цена:125

Связанные операции: mysqli_next_result, mysqli_multi_query.

Оба входа к этой операции: mysqli_more_results, mysqli::more_results.

• PHP: mysqli.more-results

PHP 5+; изменения отмечены · mysqli; mysqlnd для отмеченных операций

mysqli_next_result(mysqli $mysql): bool; mysqli::next_result(): bool

<?php
require __DIR__ . '/catalog.php';
$db->multi_query('SELECT name, stock FROM products ORDER BY id; SELECT COUNT(*) AS total FROM products');
$result = $db->store_result();
while (($row = $result->fetch_assoc()) !== null) {
    if ($row === false) { throw new RuntimeException('Не удалось прочитать строку'); }
    echo $row['name'], ' — ', $row['stock'], " шт.\n";
}
$result->free();
if (!$db->more_results() || !$db->next_result()) { throw new RuntimeException('Итоговый ответ не получен'); }
$result = $db->store_result();
echo 'Всего позиций: ', $result->fetch_column(), "\n";
$result->free();

Молоток — 8 шт.
Перчатки — 15 шт.
Кисть — 0 шт.
Всего позиций: 3

Перейти к следующему набору или статусу пакета.

Процедурная функция получает соединение $db, команду $statement или результат $result первым аргументом. В записи $object->method(...) тот же объект стоит перед стрелкой. Свойство читается без круглых скобок. Эти варианты используют один механизм: выбирать стиль стоит по понятности проекта. аргументы и возврат, объект и его состояние.

true — следующий запрос завершился успешно; false — отказ/нет успешного следующего результата. В отличие от more_results, ошибка SQL следующей команды отражается здесь, при строгом режиме исключением. Затем вызовите store_result/use_result, если есть колонки.

SQL-ошибка при MYSQLI_REPORT_ERROR выдаёт warning, при сочетании с MYSQLI_REPORT_STRICT — mysqli_sql_exception; с PHP 8.1 это сочетание включено по умолчанию. В примерах оно задано явно. Ошибки типов, закрытого объекта и неверных аргументов могут возникать отдельно; сырое сообщение SQL не публикуют посетителю.

Путь данных. Текущий набор освобождён → next_result ожидает следующую команду → store_result получает её строки.

Как читать этот вариант. Контекстный пример: нужен отдельный учебный MySQL, расширение mysqli, база course_demo и её пользователь course_user с разрешением временных таблиц. Учебные параметры подключения заменяют своими; рабочие базы не используют. Здесь проверен PHP-синтаксис, серверный запрос не выполнялся. do выполняет тело для уже доступного первого результата. more_results сообщает наличие следующего, next_result переходит к нему. Пакет — только доверенный SQL, без пользовательских подстановок.

<?php
mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
$db = new mysqli('127.0.0.1', 'course_user', 'course_password', 'course_demo', 3306);
$db->set_charset('utf8mb4');
$db->multi_query('SELECT 12 AS value; SELECT 25 AS value');
do {
    if ($result = $db->store_result()) {
        echo $result->fetch_column(), "\n";
        $result->free();
    }
    if (!$db->more_results()) { break; }
} while ($db->next_result());

12
25

Как читать этот вариант. Контекстный пример: нужен отдельный учебный MySQL, расширение mysqli, база course_demo и её пользователь course_user с разрешением временных таблиц. Учебные параметры подключения заменяют своими; рабочие базы не используют. Здесь проверен PHP-синтаксис, серверный запрос не выполнялся. multi_query не является транзакцией: если поздняя команда упадёт, ранняя может уже сохраниться. При строгом режиме ошибка следующей команды может возникнуть в next_result, а не в исходном multi_query.

<?php
mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
$db = new mysqli('127.0.0.1', 'course_user', 'course_password', 'course_demo', 3306);
$db->set_charset('utf8mb4');
$db->query('CREATE TEMPORARY TABLE course_products (id INT PRIMARY KEY, name VARCHAR(80) NOT NULL, price INT NOT NULL) ENGINE=InnoDB');
$db->query("INSERT INTO course_products VALUES (1, 'Pen', 120), (2, 'Notebook', 350), (3, 'Box', 200)");
$db->multi_query('UPDATE course_products SET price = 125 WHERE id = 1; SELECT price FROM course_products WHERE id = 1');
do {
    if ($result = $db->store_result()) {
        echo 'Цена:', $result->fetch_column(), "\n";
        $result->free();
    } else {
        echo 'Изменено:', $db->affected_rows, "\n";
    }
    if (!$db->more_results()) { break; }
} while ($db->next_result());

Изменено:1
Цена:125

Связанные операции: mysqli_more_results, mysqli_store_result.

Оба входа к этой операции: mysqli_next_result, mysqli::next_result.

• PHP: mysqli.next-result

PHP 5+; изменения отмечены · mysqli; mysqlnd для отмеченных операций

mysqli_next_result(mysqli $mysql): bool; mysqli::next_result(): bool

<?php
require __DIR__ . '/catalog.php';
$db->multi_query('SELECT name, stock FROM products ORDER BY id; SELECT COUNT(*) AS total FROM products');
$result = $db->store_result();
while (($row = $result->fetch_assoc()) !== null) {
    if ($row === false) { throw new RuntimeException('Не удалось прочитать строку'); }
    echo $row['name'], ' — ', $row['stock'], " шт.\n";
}
$result->free();
if (!$db->more_results() || !$db->next_result()) { throw new RuntimeException('Итоговый ответ не получен'); }
$result = $db->store_result();
echo 'Всего позиций: ', $result->fetch_column(), "\n";
$result->free();

Молоток — 8 шт.
Перчатки — 15 шт.
Кисть — 0 шт.
Всего позиций: 3