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

Mysqlnd: драйвер под mysqli и PDO_MYSQL

Mysqlnd — нативный MySQL-драйвер проекта PHP, включённый в распространение PHP с 5.3. Он работает ниже пользовательских mysqli/PDO_MYSQL, а не вводит отдельный mysqlnd_query. Сам сервер MySQL — другой процесс и отдельная установка. Клиентская библиотека не требует локального сервера для сборки/подключения к удалённому серверу; наша лаборатория намеренно использует локальный.

Драйвер распространяется под лицензией PHP, интегрирован с менеджером памяти и streams; это упростило распространение по сравнению с внешним libmysqlclient. Статистика, доступные режимы результата и persistent-подключения помогают исследовать узкие места; «нативный» сам по себе не доказывает ускорение вашего запроса. Поддерживаются TLS/SSL, сжатый протокол для соответствующего API и named pipes на Windows. Применимость конкретной опции сжатия и аутентификации проверяют по текущему API/сборке: старый обзор описывает ограничение PDO_MYSQL, но текущий Pdo\Mysql::ATTR_COMPRESS документирован, а исходник PHP 8.5.11 устанавливает MYSQL_OPT_COMPRESS и для mysqlnd. Это уточнение по текущему API и исходнику, не результат замера сжатия в наших программах. В старых обзорах ext/mysql уже удалён из PHP 7; fetch_all перестал быть только-mysqlnd-возможностью с PHP 8.1. Для mysqli 8.2+ mysqlnd — единственная поддержанная библиотека.

Установка, версии и проверка текущего PHP

На Windows официальная PHP-сборка уже содержит mysqlnd, но расширение mysqli всё равно включают через совместимую php_mysqli.dll; PDO_MYSQL — отдельно. На Linux пакет расширения выбирают для своей ветки PHP. При сборке актуального mysqli используется --with-mysqli, PDO_MYSQL — --with-pdo-mysql=mysqlnd. Команды старого manual с --with-mysql относятся к удалённому ext/mysql и не являются инструкцией PHP 8.5.

php --ri mysqli
php --ri mysqlnd
php --ri pdo_mysql

Это команды терминала: они показывают текущую сборку, не устанавливают сервер. SHA-256-аутентификация требует OpenSSL-возможностей; --with-openssl включает расширенную поддержку SSL при сборке. С PHP 8.4 добавлен --with-mysqlnd-ssl для явного включения расширенной поддержки без сборки openssl-расширения. Проверяйте TLS и аутентификацию на своём сервере; локальный учебный TCP-сеанс не является тестом удалённого TLS. Подробный пошаговый вход и ошибки находятся в первой главе MySQL.

Установить, какой клиент и настройки реально использует PHP

На одном компьютере PHP работает, на другом функция статистики отсутствует или настройки отличаются. Сначала нужно узнать фактический клиент текущего процесса, а не угадывать его по установленному серверу. Отчёт проверяет mysqlnd, кодировку соединения и включённость измерений.

Полученный результат

$client = mysqli_get_client_info();
$native = str_contains(strtolower($client), 'mysqlnd');
$statistics = filter_var(ini_get('mysqlnd.collect_statistics'), FILTER_VALIDATE_BOOLEAN);

mysqlnd — MySQL Native Driver, нижний уровень связи для mysqli и PDO_MYSQL; у него нет отдельного нового API для выполнения SELECT. Версия клиентской библиотеки не равна версии сервера. В PHP 8.2+ mysqli использует только mysqlnd. INI collect_statistics и collect_memory_statistics читаются в текущем CLI/SAPI; наличие php.ini рядом с файлом ещё не означает, что он загружен. Для запуска примера флаги включаются до старта PHP через -d, а не через ini_set в середине запроса.

Открыть таблицу · JSON результата · Измерения и диагностика.

<?php
declare(strict_types=1);
require __DIR__ . '/my106-results-helper.php';

$db = my106Connect();
try {
    $client = mysqli_get_client_info(); $server = $db->server_info;
    $native = str_contains(strtolower($client), 'mysqlnd');
    $statistics = filter_var(ini_get('mysqlnd.collect_statistics'), FILTER_VALIDATE_BOOLEAN);
    $memoryStatistics = filter_var(ini_get('mysqlnd.collect_memory_statistics'), FILTER_VALIDATE_BOOLEAN);
    $readTimeout = (int)ini_get('mysqlnd.net_read_timeout');
    $rows = [['mysqlnd client',$native],['connection utf8mb4',$db->character_set_name() === 'utf8mb4'],['statistics enabled',$statistics],['memory statistics enabled',$memoryStatistics],['positive read timeout',$readTimeout > 0]];
} finally { $db->close(); }
my106Report('mysql106-driver-report', ['Check','Value'], $rows, ['settings_from_current_process' => true], ['mysqlnd' => $native, 'statistics' => $statistics && $memoryStatistics, 'timeout' => $readTimeout > 0], ['client'=>$client,'server'=>$server,'sapi'=>PHP_SAPI,'mysqlnd_ini'=>ini_get_all('mysqlnd',false)]);
echo "mysqlnd detected; statistics enabled; effective settings saved\n";

mysqlnd detected; statistics enabled; effective settings saved

Это отчёт локальной среды, не гарантия настроек FPM или другого worker. Архив не содержит реквизитов базы; пример получает их из PHPMAN_MYSQL_* и допускает только 127.0.0.1 учебного сервера. TLS/compression/named pipes — отдельные возможности протокола, которые данный локальный TCP-пример не тестирует. Приложению всё равно нужен доступный сервер MySQL: встроенный клиентский драйвер сервер не заменяет.

Замерить запросы и прочитанные строки одного участка кода

Нужно понять, сколько запросов и строк породил конкретный участок страницы. Абсолютные счётчики содержат также подключение и подготовку данных, поэтому снимем показатели непосредственно до и после двух SELECT.

Полученный результат

$before = mysqli_get_connection_stats($db);
// Нужный участок SQL и чтения результатов.
$after = mysqli_get_connection_stats($db);
$delta = (int)$after['result_set_queries'] - (int)$before['result_set_queries'];

mysqli_get_connection_stats возвращает ассоциативный массив статистики этого соединения. Значения счётчиков представлены строками: приводим к int перед вычитанием. my106Stat не заменяет неизвестный ключ нулём, а сообщает о недоступной метрике. Собственный счётчик приложения подтверждает 6 обработанных строк. Дельты server_normal и rows_buffered также дают 6, число результатов и буферов — 2, трафик положительный. При этом rows_fetched_from_client_normal_buffered в фактическом PHP 8.5.11 остался 0, хотя цикл действительно получил строки. Мы показываем этот ноль как наблюдение данной сборки, а не выдаём его за отсутствие чтения. Поэтому корректность обхода проверяется по собственному счётчику и полученным данным; существование ключа статистики ещё не гарантирует, что он обновляется на выбранном пути API. Точные байтовые числа сохраняются в diagnostics.json: они меняются вместе с версиями сервера и протокола.

Открыть таблицу · JSON результата · Измерения и диагностика.

<?php
declare(strict_types=1);
require __DIR__ . '/my106-results-helper.php';

$db = my106Connect(); my106Seed($db);
try {
    $before = mysqli_get_connection_stats($db);
    $read = 0;
    foreach ([1,3] as $minimum) {
        $result = $db->query('SELECT id FROM mysql106_result_items WHERE id >= ' . $minimum . ' ORDER BY id', MYSQLI_STORE_RESULT);
        try { while ($row = $result->fetch_assoc()) { $read++; } }
        finally { $result->free(); }
    }
    $after = mysqli_get_connection_stats($db);
    $delta = [];
    foreach (['result_set_queries','buffered_sets','rows_fetched_from_server_normal','rows_buffered_from_client_normal','rows_fetched_from_client_normal_buffered','bytes_received'] as $name) { $delta[$name] = my106Stat($after,$name) - my106Stat($before,$name); }
} finally { $db->close(); }
$rows = [['application rows',$read],['SELECT result sets',$delta['result_set_queries']],['buffered result sets',$delta['buffered_sets']],['rows received from server',$delta['rows_fetched_from_server_normal']],['rows placed in buffer',$delta['rows_buffered_from_client_normal']],['client fetch counter (observed)',$delta['rows_fetched_from_client_normal_buffered']],['received bytes increased',$delta['bytes_received'] > 0]];
my106Report('mysql106-statistics',['Observation','Value'],$rows,['measurement_window'=>'two SELECTs after setup'],['read_count'=>$read===6,'query_delta'=>$delta['result_set_queries']>=2,'buffer_delta'=>$delta['buffered_sets']>=2,'server_rows'=>$delta['rows_fetched_from_server_normal']===$read,'buffered_rows'=>$delta['rows_buffered_from_client_normal']===$read,'traffic'=>$delta['bytes_received']>0],['delta'=>$delta,'before'=>$before,'after'=>$after]);
echo "stats: 2 SELECTs, 6 application rows; positive measured deltas\n";

stats: 2 SELECTs, 6 application rows; positive measured deltas

mysqli_get_client_stats относится к клиенту/процессу и может объединять вклад разных расширений, использующих mysqlnd, в том числе PDO_MYSQL. По одному глобальному счётчику нельзя установить точный PHP-вызов виновника. Отсутствующая статистика не равна нулю; выключенный сбор не доказывает отсутствие запросов. Показатель no_index_used не заменяет EXPLAIN, а slow_queries зависит от серверных порогов.

Увидеть память буфера, PHP-массива и освобождения

Большая выдача может занять память ещё до того, как приложение построило свой массив. Измерим отдельные моменты: до SELECT, после буферизации, после fetch_all, после free результата и после unset массива. Временная таблица содержит 128 текстов по 4096 байт; реальные цифры приведены в сохранённой HTML-таблице запуска.

Числа зависят от сборки и запуска. Ниже загружается фактически сохранённая таблица, а не заранее выбранные «красивые» значения.

$before = memory_get_usage(false);
$result = $db->query('SELECT id,body FROM mysql106_memory ORDER BY id', MYSQLI_STORE_RESULT);
$buffered = memory_get_usage(false);
$items = $result->fetch_all(MYSQLI_ASSOC);
$result->free();
unset($items);

memory_get_usage(false) показывает память, учтённую менеджером PHP, а не RSS процесса в диспетчере задач. mysqlnd использует этот менеджер, поэтому его буфер входит в memory_limit. free не делает переменную $items пустой: она по-прежнему содержит 128 строк. В зависимости от версии mysqlnd и копирования PHP данные могут разделяться или копироваться; пример проверяет смысловую сохранность и наблюдаемое освобождение после unset, не фиксирует универсальную разницу в байтах.

Открыть таблицу · JSON результата · Измерения и диагностика.

<?php
declare(strict_types=1);
require __DIR__ . '/my106-results-helper.php';

$db = my106Connect();
try {
    $db->query('CREATE TEMPORARY TABLE mysql106_memory (id INT PRIMARY KEY, body TEXT NOT NULL)');
    $stmt = $db->prepare('INSERT INTO mysql106_memory VALUES (?,?)');
    $payload = str_repeat('x', 4096);
    try { for ($id=1; $id<=128; $id++) { $stmt->bind_param('is',$id,$payload); $stmt->execute(); } }
    finally { $stmt->close(); }
    unset($payload);
    $before = memory_get_usage(false);
    $result = $db->query('SELECT id,body FROM mysql106_memory ORDER BY id', MYSQLI_STORE_RESULT);
    $buffered = memory_get_usage(false);
    $items = $result->fetch_all(MYSQLI_ASSOC); $fetched = memory_get_usage(false);
    $valid = count($items) === 128 && strlen($items[127]['body']) === 4096;
    $result->free(); $afterFree = memory_get_usage(false);
    // Пользовательский массив ещё жив и продолжает содержать данные.
    $retained = strlen($items[0]['body']) === 4096;
    unset($items); $afterUnset = memory_get_usage(false);
} finally { $db->close(); }
$rows = [['before query',$before],['buffered result',$buffered],['PHP array also alive',$fetched],['result freed, PHP array alive',$afterFree],['PHP array unset',$afterUnset]];
my106Report('mysql106-memory',['Stage','PHP allocated bytes'],$rows,['rows'=>128,'payload_bytes_per_row'=>4096,'not_os_rss'=>true],['data_complete'=>$valid,'buffer_cost_visible'=>$buffered>$before,'array_survives_free'=>$retained,'array_release_visible'=>$afterUnset<$afterFree],['memory_get_usage_false'=>array_column($rows,1),'memory_peak_usage_false'=>memory_get_peak_usage(false),'client_stats'=>mysqli_get_client_stats()]);
echo "memory: 128 x 4096-byte rows measured; buffer and PHP array lifetimes shown\n";

memory: 128 x 4096-byte rows measured; buffer and PHP array lifetimes shown

Пиковая память, текущая PHP-память и память ОС — разные величины. Аллокатор может оставить освобождённые страницы процессу; отсутствие немедленного падения RSS не доказывает утечку. Нельзя сравнивать mysqlnd с историческим libmysqlclient только по memory_get_usage: у них разный учёт. Эксперимент малый и последовательный, не нагрузочный тест. Для больших данных используйте нужные колонки/WHERE, потоковый вывод или ограниченные порции; fetch_all может сам накопить результат независимо от способа SQL-чтения.

Разобранная ситуация: Unexpectedly hitting PHP memory limit with a single PDO query?. Один запрос расходует PHP memory_limit до пользовательского накопления строк. Обсуждение использовано как источник реальной задачи; объяснения и программы здесь собственные, правила сверены с PHP/MySQL.

Проверить повторное использование соединения в одном процессе

Нужно проверить, что persistent-соединение действительно переиспользовалось, а не просто предположить ускорение по префиксу p:. Откроем handle, выполним запрос, закроем handle и откроем второй с теми же параметрами в одном CLI-процессе.

Полученный результат

$first = my106Connect(true);
$firstId = $first->thread_id;
$first->close();
$second = my106Connect(true);
$same = $firstId === $second->thread_id;

Префикс p: добавляет helper к имени хоста; отдельной mysqli_pconnect нет. close завершает использование handle приложением, но пригодное persistent-соединение может вернуться в локальный пул процесса. thread_id — идентификатор серверной сессии; он не равен PHP object ID. Счётчик connection_reused подтверждает reuse с другой стороны. Ни конкретный ID, ни полные абсолютные счётчики не зашиты в ожидаемый результат.

Открыть таблицу · JSON результата · Измерения и диагностика.

<?php
declare(strict_types=1);
require __DIR__ . '/my106-results-helper.php';

$before = mysqli_get_client_stats();
$first = my106Connect(true); $firstId = $first->thread_id;
$probe = $first->query('SELECT 7 AS number'); $number = (int)$probe->fetch_assoc()['number']; $probe->free();
$first->close();
$second = my106Connect(true); $secondId = $second->thread_id;
try { $probe = $second->query('SELECT 8 AS number'); $next = (int)$probe->fetch_assoc()['number']; $probe->free(); }
finally { $second->close(); }
$after = mysqli_get_client_stats();
$reused = my106Stat($after,'connection_reused') - my106Stat($before,'connection_reused');
$rows = [['first query',$number],['second query',$next],['same server connection',$firstId===$secondId],['reuse counter increased',$reused>=1]];
my106Report('mysql106-persistent-reuse',['Observation','Value'],$rows,['scope'=>'one CLI process'],['queries'=>$number===7&&$next===8,'same_connection'=>$firstId===$secondId,'reuse_counter'=>$reused>=1],['first_thread_id'=>$firstId,'second_thread_id'=>$secondId,'reuse_delta'=>$reused]);
echo "persistent: two handles, one reused server connection in this process\n";

persistent: two handles, one reused server connection in this process

Два самостоятельных запуска php example.php — два процесса, а не один общий пул. PHP-FPM имеет несколько worker: каждый хранит собственные соединения; чужой HTTP-запрос не получает обещание конкретной сессии. Persistent не означает автоматически быстрее: повторная аутентификация/очистка имеют цену. Проверяйте лимиты mysqli.max_persistent/max_links и MySQL max_connections, измеряйте свой сценарий, не включайте p: как лечение медленного SQL.

Не хранить данные пользователя в persistent-сессии

После reuse серверное соединение осталось тем же. Значит ли это, что можно хранить в нём черновик следующего пользователя? Проверим переменную сессии и temporary table: обычная очистка mysqli/mysqlnd убирает прежнее состояние перед новым использованием.

Полученный результат

$first->query("SET @mysql106_user_note = 'private draft'");
$first->close();
$second = my106Connect(true);
$probe = $second->query('SELECT @mysql106_user_note AS note');

В обычной сборке mysqli/mysqlnd выполняет COM_CHANGE_USER при повторном получении persistent-соединения. Документированная очистка откатывает активную транзакцию, удаляет временные таблицы, снимает блокировки, сбрасывает session variables, закрывает statements/handlers и освобождает GET_LOCK. Проверяем две наблюдаемые части: наша переменная исчезла, temporary table недоступна. Helper заново задаёт charset при каждом открытии, поэтому требование приложения явно восстановлено.

Открыть таблицу · JSON результата · Измерения и диагностика.

<?php
declare(strict_types=1);
require __DIR__ . '/my106-results-helper.php';

$first = my106Connect(true); $firstId = $first->thread_id;
$first->query("SET @mysql106_user_note = 'private draft'");
$first->query('CREATE TEMPORARY TABLE mysql106_session_draft (id INT PRIMARY KEY)');
$first->query('INSERT INTO mysql106_session_draft VALUES (1)');
$first->close();
$second = my106Connect(true);
try {
    $secondId = $second->thread_id;
    $probe = $second->query('SELECT @mysql106_user_note AS note'); $note = $probe->fetch_assoc()['note']; $probe->free();
    $missing = false; $errorCode = 0;
    try { $second->query('SELECT id FROM mysql106_session_draft'); }
    catch (mysqli_sql_exception $error) { $errorCode = $error->getCode(); $missing = $errorCode === 1146; }
    $charset = $second->character_set_name();
} finally { $second->close(); }
$rows = [['same server connection',$firstId===$secondId],['old user variable',$note],['temporary table missing',$missing],['connection charset',$charset]];
my106Report('mysql106-persistent-reset',['Observation','Value'],$rows,['cleanup_observed'=>'mysqli/mysqlnd default build'],['same_connection'=>$firstId===$secondId,'variable_reset'=>$note===null,'temporary_removed'=>$missing,'charset_reapplied'=>$charset==='utf8mb4'],['first_thread_id'=>$firstId,'second_thread_id'=>$secondId,'missing_table_error'=>$errorCode]);
echo "persistent reset: user variable NULL, temporary table absent, utf8mb4 reapplied\n";

persistent reset: user variable NULL, temporary table absent, utf8mb4 reapplied

Программа проверяет стандартную конфигурацию текущего runtime, не все возможные сборки. Компиляционный MYSQLI_NO_CHANGE_USER_ON_PCONNECT отключает этот механизм в пользу ping; не советуем отключать очистку ради сомнительного ускорения. Не переносите контракт mysqli автоматически на PDO persistent. Temporary table не подходит для хранения черновика между HTTP-запросами; нужен обычный устойчивый storage с идентификатором пользователя и сроком жизни. Резервирование/транзакции завершайте явно, не рассчитывая только на уборку пула.

Разобранная ситуация: Persistent connections that dont persist between two php scripts. Временную таблицу ошибочно пытаются переносить между отдельными скриптами через persistent connection. Обсуждение использовано как источник реальной задачи; объяснения и программы здесь собственные, правила сверены с PHP/MySQL.

Собрать ограниченную диагностику и найти лишнюю выдачу

В отчёте поддержки важно увидеть лишнюю работу, не сохраняя пароль и весь phpinfo. Исходный код выбирает 4 товара, использует 1 и выбрасывает остальное. Покажем ограниченную диагностику и вариант LIMIT1 с тем же первым товаром.

Полученный результат

$returned = $result->num_rows;
$chosen = $result->fetch_assoc();
$result->free();
// Для одного товара формулируем ограничение в SQL: ORDER BY id LIMIT 1.

Число returned берётся из num_rows buffered-результата, used ведёт приложение. Разница показывает неиспользованную выдачу, хотя сама по себе не измеряет время или байты. diagnostics.json содержит выбранные INI-настройки, снимки connection stats и client stats; HOST/USER/PASSWORD не записываются. Для однозначного «первого» применяется ORDER BY id. Исправленный запрос выбирает тот же ID с LIMIT1.

Открыть таблицу · JSON результата · Измерения и диагностика.

<?php
declare(strict_types=1);
require __DIR__ . '/my106-results-helper.php';

$db = my106Connect(); my106Seed($db);
try {
    $before = mysqli_get_connection_stats($db);
    $result = $db->query('SELECT id,title FROM mysql106_result_items ORDER BY id', MYSQLI_STORE_RESULT);
    $returned = $result->num_rows; $used = 0;
    try { $chosen = $result->fetch_assoc(); $used++; }
    finally { $result->free(); }
    $after = mysqli_get_connection_stats($db);
    $fixed = $db->query('SELECT id,title FROM mysql106_result_items ORDER BY id LIMIT 1');
    try { $fixedCount = $fixed->num_rows; $fixedRow = $fixed->fetch_assoc(); }
    finally { $fixed->free(); }
    $clientStats = mysqli_get_client_stats();
    $ini = [];
    foreach (['collect_statistics','collect_memory_statistics','net_read_timeout','net_cmd_buffer_size','net_read_buffer_size'] as $name) { $ini['mysqlnd.'.$name] = ini_get('mysqlnd.'.$name); }
} finally { $db->close(); }
$rows = [['original SELECT',$returned,$used],['with LIMIT 1',$fixedCount,1]];
my106Report('mysql106-incident-report',['Variant','Rows returned','Rows used'],$rows,['same_chosen_id'=>(int)$chosen['id']===(int)$fixedRow['id'],'credentials_logged'=>false],['unneeded_rows_visible'=>$returned===4&&$used===1,'bounded_fix'=>$fixedCount===1&&(int)$fixedRow['id']===1,'stats_available'=>array_key_exists('result_set_queries',$after)],['ini'=>$ini,'connection_before'=>$before,'connection_after'=>$after,'client_stats'=>$clientStats,'application_received'=>$returned,'application_used'=>$used]);
echo "diagnostics: original used1 of4; LIMIT used1 of1; credentials omitted\n";

diagnostics: original used1 of4; LIMIT used1 of1; credentials omitted

Не делайте автоматический совет LIMIT1 по любой разнице: бизнес может намеренно читать повторно или показывать несколько блоков из одного буфера. SQL-план, индексы, объём строк и частота выполнения — отдельные измерения. В production отчёты и trace обычно должны быть закрыты от посетителей; опубликованные здесь файлы содержат исключительно синтетические локальные данные. trace_alloc/debug не включаются ради каждого обычного запроса.

Все настройки mysqlnd и версии их действия

В таблице сохранены все директивы официального раздела. Важное расхождение версий: страница manual отмечает несколько параметров INI_SYSTEM, а наш PHP 8.5.11 сообщает access=7 (INI_ALL) для collect_statistics и обоих сетевых размеров. Колонка runtime получена из ini_get_all в реальном процессе. Это наблюдение сборки, не исправление правил всех старых PHP. Для воспроизводимого эксперимента задаём -d до запуска.

Счётчики: полный каталог и правила интерпретации

Два входа: mysqli_get_connection_stats($db) для соединения и mysqli_get_client_stats() для клиента/процесса. Часть счётчиков процессная даже в общей таблице; глобальные значения агрегируют вызовы расширений, использующих mysqlnd. Дельта вокруг небольшого участка полезнее случайного абсолютного числа. Счётчики приходят строками; существование имени, включённость сбора и смысл единиц проверяются отдельно.

Каталог ниже содержит все 152 имени официального раздела с объяснениями; в исследованном runtime 163 ключа. Документированный com_daemon отсутствует. Старые/зарезервированные показатели могут возвращаться нулём и не иметь полезного измерения. Не вычитайте число строк из числа байтов: размер пакета и количество fetch — разные единицы. Ошибка сервера может прийти там, где ожидался пакет другого вида; статистика протокола не заменяет обработку исключений.

COM-счётчик увеличивается перед отправкой: он не уменьшается автоматически при сетевом отказе. Поэтому com_stmt_execute/com_stmt_prepare помогает оценить повторное использование подготовки, но не число успешных транзакций. Сетевые байты включают служебную нагрузку; real_data отражает данные, дошедшие до PHP-fetch. rows_fetched_from_server включает дочитанный остаток unbuffered. Документированные client-fetch счётчики следует сверять с реальными строками: в нашем buffered-пути один из них остался нулём, поэтому он не служит единственным доказательством чтения. Для slow/no_index нужны серверные пороги и план; MYSQLI_REPORT_INDEX может сообщать индексные признаки, но не превращает slow_queries в исключение.

Память PHP, буфер результата и copy-on-write

Mysqlnd выделяет память через менеджер PHP. memory_get_usage отражает этот учёт и memory_limit его ограничивает. Менеджер может удерживать страницы у процесса после логического освобождения; RSS не обязан сразу уменьшаться. Историческое сравнение с libmysqlclient осложнено тем, что тот использовал собственные C-выделения вне PHP memory_limit.

Путь данных — сетевой пакет, внутренний буфер, затем PHP-значения. В исторических реализациях mysqlnd использовал ссылки на буфер и copy-on-write: изменение извлечённой переменной или освобождение буфера при живых переменных могло вызвать копию. Не превращайте старую реализационную схему в универсальную гарантию числа копий PHP 8.5: смотрите текущие измерения. Небольшие строки тоже имеют накладные расходы массивов/ссылок. Директива fetch_data_copy удалена в 8.1; совет включить её в современной среде не работает.

Практическая диагностика начинается со статистики и собственного участка измерения. Debug trace может показывать операции памяти, но не обязательно размер каждой порции. Внутренние режимы имитации out-of-memory предназначены разработчикам C-драйвера и не являются стабильным пользовательским API; мы их не включаем и не выдаём учебный пример за тест всех путей аварийного выделения.

Границы persistent и очистка соединения

Persistent сохраняет пригодное соединение внутри процесса, а не данные пользователя. Mysqli использует p: в имени хоста, обычная сборка при reuse выполняет COM_CHANGE_USER с повторной аутентификацией и очисткой. Это имеет стоимость. Компиляционный MYSQLI_NO_CHANGE_USER_ON_PCONNECT меняет путь на ping и убирает обычную очистку; главы не предлагают эту оптимизацию. Другой API/driver может иметь иной жизненный цикл; переносить правила mysqli на PDO нельзя.

Результаты нашего CLI подтверждают reuse, сброс пользовательской переменной и удаление temporary table. Они не доказывают балансировку FPM, производительность пула или отсутствие ошибок приложения. Завершайте транзакции сами, устанавливайте нужные настройки при каждом получении соединения, не используйте состояние persistent-сессии как пользовательскую память.

Streams, таймауты и несовместимости старых библиотек

Mysqlnd использует PHP streams для транспорта, поэтому таймауты нужно интерпретировать по его настройкам и документации streams, а не переносить все детали MYSQL_OPT_READ_TIMEOUT из libmysqlclient. net_read_timeout задаёт ожидание чтения, а не точный общий бюджет SQL/HTTP; серверные max_execution_time/locks и срок HTTP-запроса — другие уровни. Командный буфер расширяется для длинной команды; рост command_buffer_too_small показывает причину рассмотреть размер, но не обещает ускорение от любого увеличения. Порция чтения ограничивает отдельное read тела пакета, не общий размер результата.

Аутентификация с публичным RSA-ключом и шифрованный проверенный TLS-канал — разные задачи. Выбор keyfile и способ обмена зависят от протокола/сервера; пароль в логи и архивы не помещают. В историческом разделе несовместимостей BIT у libmysqlclient возвращался бинарной строкой, у mysqlnd — десятичной строкой. Для общего числового договора выбирайте SQL вида SELECT flags + 0 AS flags_number FROM table_name. BIT + 0 здесь — поясняющий фрагмент формы запроса, не отдельный выполненный пример. Различия NULL, пустой строки и нуля разобраны в примере необязательного значения; сохранение и чтение цены DECIMAL — в примере создания товарной таблицы. Не приводите любое бинарное значение к int без знания SQL-типа.

Диагностировать по причине, затем менять поведение

Если приложение использует 1 из 10000 строк, сначала исправьте SQL. Если сохраняет все 10000 в массиве, unbuffered не устранит это накопление. Если выдача недочитана, завершите её до нового SQL. Если мало соединений на сервере, посчитайте worker и их persistent-пулы. Меняйте один фактор и сохраняйте вход, результат и измерение. Внутренний C Plugin API mysqlnd — отдельная тема следующего пакета; наличие этих глав не объявляет её уже раскрытой.