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

$result = $db->query('SELECT id,title,qty FROM mysql106_result_items ORDER BY id', MYSQLI_STORE_RESULT);
$count = $result->num_rows;
$first = $result->fetch_assoc();
$result->data_seek(0);

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

$db = my106Connect(); my106Seed($db);
try {
    $result = $db->query('SELECT id,title,qty FROM mysql106_result_items ORDER BY id', MYSQLI_STORE_RESULT);
    try {
        $count = $result->num_rows;
        $first = $result->fetch_assoc();
        $result->data_seek(0);
        $rows = [];
        while ($row = $result->fetch_assoc()) { $rows[] = [(int)$row['id'], $row['title'], (int)$row['qty']]; }
        // Новый SQL допустим: весь предыдущий результат уже принят в клиентский буфер.
        $totalResult = $db->query('SELECT SUM(qty) AS total FROM mysql106_result_items');
        $total = (int)$totalResult->fetch_assoc()['total']; $totalResult->free();
    } finally { $result->free(); }
} finally { $db->close(); }
my106Report('mysql106-buffered', ['ID','Title','QTY'], $rows, ['num_rows' => $count, 'first_id_before_seek' => (int)$first['id'], 'total_qty' => $total], ['count_and_repeat' => $count === 4 && $rows[0][0] === 1, 'second_query' => $total === 22]);
echo "buffered: 4 rows; repeat from ID1; total=22\n";

buffered: 4 rows; repeat from ID1; total=22

Комплект содержит example.php, helper и README. Задайте переменные окружения PHPMAN_MYSQL_* для отдельного локального сервера и выполните php -d mysqlnd.collect_statistics=1 -d mysqlnd.collect_memory_statistics=1 example.php. Расширение mysqli/mysqlnd обязательно; пароль в исходник и отчёт не записывается. Учебные TEMPORARY-таблицы создаёт программа, их входные строки видны в helper. Результаты — result.html, result.json и diagnostics.json. Таблицы принадлежат только учебной сессии; обычные таблицы пользователя не удаляются.

$result = $db->query('SELECT id,title,qty FROM mysql106_result_items ORDER BY id', MYSQLI_USE_RESULT);
while ($row = $result->fetch_assoc()) {
    fputcsv($file, [$row['id'],$row['title'],$row['qty']], ';', '"', '', "\n");
}

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

$db = my106Connect(); my106Seed($db);
$file = fopen(__DIR__ . '/catalog.csv', 'wb');
if ($file === false) { $db->close(); throw new RuntimeException('Cannot create CSV'); }
try {
    fputcsv($file, ['id','title','qty'], ';', '"', '', "\n");
    $result = $db->query('SELECT id,title,qty FROM mysql106_result_items ORDER BY id', MYSQLI_USE_RESULT);
    try {
        $written = 0;
        while ($row = $result->fetch_assoc()) {
            if (fputcsv($file, [$row['id'],$row['title'],$row['qty']], ';', '"', '', "\n") === false) { throw new RuntimeException('CSV write failed'); }
            $written++;
        }
    } finally { $result->free(); }
} finally { fclose($file); $db->close(); }
$reader = fopen(__DIR__ . '/catalog.csv', 'rb');
if ($reader === false) { throw new RuntimeException('Cannot reopen CSV'); }
try {
    $header = fgetcsv($reader, 0, ';', '"', ''); $rows = [];
    while (($row = fgetcsv($reader, 0, ';', '"', '')) !== false) { $rows[] = [(int)$row[0], $row[1], (int)$row[2]]; }
} finally { fclose($reader); }
my106Report('mysql106-stream-csv', ['ID','Title','QTY'], $rows, ['written' => $written, 'csv_roundtrip' => true], ['csv_data' => $written === 4 && $rows[0][1] === 'Чай; зелёный' && $rows[1][1] === 'Кружка "Дом"', 'header' => $header === ['id','title','qty']]);
echo "stream CSV: 4 rows; delimiter and quotes preserved\n";

stream CSV: 4 rows; delimiter and quotes preserved

Комплект содержит example.php, helper и README. Задайте переменные окружения PHPMAN_MYSQL_* для отдельного локального сервера и выполните php -d mysqlnd.collect_statistics=1 -d mysqlnd.collect_memory_statistics=1 example.php. Расширение mysqli/mysqlnd обязательно; пароль в исходник и отчёт не записывается. Учебные TEMPORARY-таблицы создаёт программа, их входные строки видны в helper. Результаты — result.html, result.json и diagnostics.json. Таблицы принадлежат только учебной сессии; обычные таблицы пользователя не удаляются.

try { $db->query('SELECT 99 AS number'); }
catch (mysqli_sql_exception $error) { $errorCode = $error->getCode(); }
while ($row = $result->fetch_assoc()) { $seen[] = (int)$row['id']; }
$result->free();

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

$db = my106Connect(); my106Seed($db);
try {
    $result = $db->query('SELECT id FROM mysql106_result_items ORDER BY id', MYSQLI_USE_RESULT);
    $seen = [];
    try {
        $seen[] = (int)$result->fetch_assoc()['id']; $errorCode = 0;
        try { $db->query('SELECT 99 AS number'); }
        catch (mysqli_sql_exception $error) { $errorCode = $error->getCode(); }
        while ($row = $result->fetch_assoc()) { $seen[] = (int)$row['id']; }
    } finally { $result->free(); }
    $next = $db->query('SELECT 99 AS number'); $number = (int)$next->fetch_assoc()['number']; $next->free();
} finally { $db->close(); }
my106Report('mysql106-busy', ['Step','Outcome'], [['query before drain',$errorCode],['rows consumed',count($seen)],['query after drain',$number]], ['ids' => $seen], ['busy_detected' => $errorCode === 2014, 'recovered' => $seen === [1,2,3,4] && $number === 99]);
echo "busy=2014; consumed=4; next query=99\n";

busy=2014; consumed=4; next query=99

Комплект содержит example.php, helper и README. Задайте переменные окружения PHPMAN_MYSQL_* для отдельного локального сервера и выполните php -d mysqlnd.collect_statistics=1 -d mysqlnd.collect_memory_statistics=1 example.php. Расширение mysqli/mysqlnd обязательно; пароль в исходник и отчёт не записывается. Учебные TEMPORARY-таблицы создаёт программа, их входные строки видны в helper. Результаты — result.html, result.json и diagnostics.json. Таблицы принадлежат только учебной сессии; обычные таблицы пользователя не удаляются.

try {
    while ($row = $result->fetch_assoc()) {
        if ((int)$row['id'] === 2) { $found = $row['title']; break; }
    }
} finally { $result->free(); }

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

$db = my106Connect(); my106Seed($db);
try {
    $result = $db->query('SELECT id,title FROM mysql106_result_items ORDER BY id', MYSQLI_USE_RESULT);
    $found = null; $read = 0;
    try {
        while ($row = $result->fetch_assoc()) {
            $read++;
            if ((int)$row['id'] === 2) { $found = $row['title']; break; }
        }
    } finally { $result->free(); }
    $next = $db->query('SELECT COUNT(*) AS n FROM mysql106_result_items'); $count = (int)$next->fetch_assoc()['n']; $next->free();
    // Если условие известно заранее, лучше не запрашивать лишние строки.
    $limited = $db->query('SELECT title FROM mysql106_result_items WHERE id=2 LIMIT 1'); $direct = $limited->fetch_assoc()['title']; $limited->free();
} finally { $db->close(); }
my106Report('mysql106-early-stop', ['Method','Read by application','Title'], [['break + finally', $read, $found], ['WHERE + LIMIT',1,$direct]], ['next_query_count' => $count], ['same_product' => $found === $direct && $found === 'Кружка "Дом"', 'connection_ready' => $count === 4]);
echo "early stop: read2; free completed; WHERE returns same product\n";

early stop: read2; free completed; WHERE returns same product

Комплект содержит example.php, helper и README. Задайте переменные окружения PHPMAN_MYSQL_* для отдельного локального сервера и выполните php -d mysqlnd.collect_statistics=1 -d mysqlnd.collect_memory_statistics=1 example.php. Расширение mysqli/mysqlnd обязательно; пароль в исходник и отчёт не записывается. Учебные TEMPORARY-таблицы создаёт программа, их входные строки видны в helper. Результаты — result.html, result.json и diagnostics.json. Таблицы принадлежат только учебной сессии; обычные таблицы пользователя не удаляются.

$stmt->execute();
$stmt->bind_result($id, $qty);
while ($stmt->fetch()) { $boundRows[] = [$id, $qty]; }
$stmt->free_result();

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

$db = my106Connect(); my106Seed($db);
try {
    $minimum = 3;
    $stmt = $db->prepare('SELECT id,qty FROM mysql106_result_items WHERE qty >= ? ORDER BY id');
    try {
        $stmt->bind_param('i', $minimum); $stmt->execute();
        $stmt->bind_result($id, $qty); $boundRows = [];
        while ($stmt->fetch()) { $boundRows[] = [$id, $qty]; }
        $stmt->free_result();
    } finally { $stmt->close(); }
    $stmt = $db->prepare('SELECT id,qty FROM mysql106_result_items WHERE qty >= ? ORDER BY id');
    try {
        $stmt->bind_param('i', $minimum); $stmt->execute();
        $result = $stmt->get_result();
        try { $bufferedRows = $result->fetch_all(MYSQLI_NUM); }
        finally { $result->free(); }
    } finally { $stmt->close(); }
} finally { $db->close(); }
my106Report('mysql106-prepared-results', ['ID','QTY'], $boundRows, ['both_methods_equal' => $boundRows === $bufferedRows, 'minimum' => $minimum], ['same_rows' => $boundRows === [[1,12],[3,7],[4,3]] && $boundRows === $bufferedRows]);
echo "prepared: bind_result and get_result give the same 3 rows\n";

prepared: bind_result and get_result give the same 3 rows

Комплект содержит example.php, helper и README. Задайте переменные окружения PHPMAN_MYSQL_* для отдельного локального сервера и выполните php -d mysqlnd.collect_statistics=1 -d mysqlnd.collect_memory_statistics=1 example.php. Расширение mysqli/mysqlnd обязательно; пароль в исходник и отчёт не записывается. Учебные TEMPORARY-таблицы создаёт программа, их входные строки видны в helper. Результаты — result.html, result.json и diagnostics.json. Таблицы принадлежат только учебной сессии; обычные таблицы пользователя не удаляются.

$stmt = $db->prepare('SELECT id,title,qty FROM mysql106_result_items WHERE id > ? AND id <= ? ORDER BY id LIMIT 2');
$stmt->bind_param('ii', $last, $upper);
$stmt->execute();
$result = $stmt->get_result();

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

$db = my106Connect(); my106Seed($db);
try {
    $maxResult = $db->query('SELECT MAX(id) AS maximum FROM mysql106_result_items');
    $upper = (int)$maxResult->fetch_assoc()['maximum']; $maxResult->free();
    $db->query("INSERT INTO mysql106_result_items VALUES (5,'Поздняя строка',1)");
    $stmt = $db->prepare('SELECT id,title,qty FROM mysql106_result_items WHERE id > ? AND id <= ? ORDER BY id LIMIT 2');
    $last = 0; $rows = []; $pages = 0;
    try {
        $stmt->bind_param('ii', $last, $upper);
        while (true) {
            $stmt->execute(); $result = $stmt->get_result();
            try { $batch = $result->fetch_all(MYSQLI_ASSOC); }
            finally { $result->free(); }
            if ($batch === []) { break; }
            $pages++;
            foreach ($batch as $row) { $last = (int)$row['id']; $rows[] = [$last, $row['title'], (int)$row['qty']]; }
        }
    } finally { $stmt->close(); }
} finally { $db->close(); }
my106Report('mysql106-keyset', ['ID','Title','QTY'], $rows, ['upper_id' => $upper, 'nonempty_pages' => $pages, 'late_id_excluded' => $last === 4], ['bounded_complete' => array_column($rows,0) === [1,2,3,4] && $pages === 2]);
echo "keyset: 2 pages, IDs1..4; late ID5 excluded\n";

keyset: 2 pages, IDs1..4; late ID5 excluded

Комплект содержит example.php, helper и README. Задайте переменные окружения PHPMAN_MYSQL_* для отдельного локального сервера и выполните php -d mysqlnd.collect_statistics=1 -d mysqlnd.collect_memory_statistics=1 example.php. Расширение mysqli/mysqlnd обязательно; пароль в исходник и отчёт не записывается. Учебные TEMPORARY-таблицы создаёт программа, их входные строки видны в helper. Результаты — result.html, result.json и diagnostics.json. Таблицы принадлежат только учебной сессии; обычные таблицы пользователя не удаляются.