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

$db->set_charset('utf8mb4');
$name = 'Кружка 😀';
$statement = $db->prepare('INSERT INTO mysql106_unicode (name) VALUES (?)');
$statement->bind_param('s', $name);
$statement->execute();

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

$details = [];
$db = mysql106Connect();
$db->set_charset('utf8mb4');
$db->query('CREATE TEMPORARY TABLE mysql106_unicode (name VARCHAR(60) NOT NULL) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4');
$name = 'Кружка 😀';
$statement = $db->prepare('INSERT INTO mysql106_unicode (name) VALUES (?)');
$statement->bind_param('s',$name);
$statement->execute();
$statement->close();
$row = $db->query('SELECT name,CHAR_LENGTH(name) AS characters,LENGTH(name) AS bytes FROM mysql106_unicode')->fetch_assoc();
$rows = [[$row['name'],(int)$row['characters'],(int)$row['bytes']]];
$checks = ['roundtrip_equal'=>$row['name']===$name,'eight_characters'=>(int)$row['characters']===8,'seventeen_bytes'=>(int)$row['bytes']===17,'client_utf8mb4'=>$db->character_set_name()==='utf8mb4'];
$details = $db->query('SELECT @@character_set_client AS client,@@character_set_connection AS connection_charset,@@character_set_results AS results_charset')->fetch_assoc();
$runtime = mysql106Runtime($db);
$db->close();
mysql106Report('mysql106-utf8mb4-roundtrip', ['Прочитанное название', 'Символов', 'Байтов'], $rows, $checks, $runtime, $details);
echo "utf8mb4: exact round trip; 8 characters, 17 bytes\n";

utf8mb4: exact round trip; 8 characters, 17 bytes

Полный самостоятельный комплект: example.php, mysql106-helper.php и README.txt. Настройте отдельный локальный MySQL и переменные окружения из инструкции выше, затем выполните php example.php. Код сам создаёт свои TEMPORARY-таблицы и исходные строки; другие примеры предварительно запускать не нужно. Helper читает окружение, устанавливает соединение и сохраняет HTML/JSON; вся SQL-работа видна в example.php. Для повторения достаточно новой сессии; локальные файлы отчёта будут перезаписаны.

$db->set_charset('utf8mb4'); // Это объявление кодировки отправляемых байтов.
// PHP-строка и исходный файл программы тоже должны содержать UTF-8.
// Исправление настройки не переписывает уже сохранённые испорченные значения.

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

$details = [];
$db = mysql106Connect();
$db->query('CREATE TEMPORARY TABLE mysql106_charset (id INT PRIMARY KEY,label VARCHAR(60) NOT NULL) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4');
$text = 'Café';
$db->set_charset('latin1');
$bad = $db->prepare('INSERT INTO mysql106_charset (id,label) VALUES (1,?)');
$bad->bind_param('s',$text); $bad->execute(); $bad->close();
$db->set_charset('utf8mb4');
$good = $db->prepare('INSERT INTO mysql106_charset (id,label) VALUES (2,?)');
$good->bind_param('s',$text); $good->execute(); $good->close();
$rows = [];
foreach ($db->query('SELECT id,label,CHAR_LENGTH(label) AS characters,LENGTH(label) AS bytes FROM mysql106_charset ORDER BY id') as $row) {
    $rows[] = [(int)$row['id']===1 ? 'latin1 при UTF-8 входе' : 'utf8mb4 при UTF-8 входе',$row['label'],(int)$row['characters'],(int)$row['bytes']];
}
$checks = ['wrong_declaration_visible'=>$rows[0][1]==='Café','correct_declaration_preserves'=>$rows[1][1]===$text,'earlier_data_not_repaired'=>$rows[0][1]!==$rows[1][1]];
$runtime = mysql106Runtime($db);
$db->close();
mysql106Report('mysql106-charset-mismatch', ['Настройка соединения при INSERT', 'Прочитано через utf8mb4', 'Символов', 'Байтов'], $rows, $checks, $runtime, $details);
echo "charset mismatch reproduced; correct connection preserves Cafe with accent\n";

charset mismatch reproduced; correct connection preserves Cafe with accent

Полный самостоятельный комплект: example.php, mysql106-helper.php и README.txt. Настройте отдельный локальный MySQL и переменные окружения из инструкции выше, затем выполните php example.php. Код сам создаёт свои TEMPORARY-таблицы и исходные строки; другие примеры предварительно запускать не нужно. Helper читает окружение, устанавливает соединение и сохраняет HTML/JSON; вся SQL-работа видна в example.php. Для повторения достаточно новой сессии; локальные файлы отчёта будут перезаписаны.

$search = "O'Reilly mug";
$find = $db->prepare('SELECT name FROM mysql106_names WHERE name=?');
$find->bind_param('s', $search);
$find->execute();
$result = $find->get_result();

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

$details = [];
$db = mysql106Connect();
$db->query('CREATE TEMPORARY TABLE mysql106_names (id INT PRIMARY KEY,name VARCHAR(80) NOT NULL) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4');
$insert = $db->prepare('INSERT INTO mysql106_names (id,name) VALUES (?,?)');
$id = 1; $name = "O'Reilly mug";
$insert->bind_param('is',$id,$name); $insert->execute();
$id = 2; $name = 'Plain mug'; $insert->execute(); $insert->close();
$find = $db->prepare('SELECT name FROM mysql106_names WHERE name=? ORDER BY id');
$search = ''; $find->bind_param('s',$search);
$rows = [];
foreach (["O'Reilly mug", "' OR 1=1 -- "] as $search) {
    $find->execute();
    $result = $find->get_result();
    $matches = [];
    while ($row = $result->fetch_assoc()) { $matches[]=$row['name']; }
    $rows[] = [$search,count($matches),implode(', ',$matches)];
    $result->free();
}
$find->close();
$checks = ['apostrophe_found'=>$rows[0][1]===1,'sql_text_is_only_value'=>$rows[1][1]===0,'both_records_remain'=>(int)$db->query('SELECT COUNT(*) AS n FROM mysql106_names')->fetch_assoc()['n']===2];
$runtime = mysql106Runtime($db);
$db->close();
mysql106Report('mysql106-prepared-values', ['Искомое значение', 'Совпадений', 'Название'], $rows, $checks, $runtime, $details);
echo "prepared search: apostrophe=1; SQL-looking text=0; records=2\n";

prepared search: apostrophe=1; SQL-looking text=0; records=2

Полный самостоятельный комплект: example.php, mysql106-helper.php и README.txt. Настройте отдельный локальный MySQL и переменные окружения из инструкции выше, затем выполните php example.php. Код сам создаёт свои TEMPORARY-таблицы и исходные строки; другие примеры предварительно запускать не нужно. Helper читает окружение, устанавливает соединение и сохраняет HTML/JSON; вся SQL-работа видна в example.php. Для повторения достаточно новой сессии; локальные файлы отчёта будут перезаписаны.

$value = null; // Неизвестно, а не ноль.
$insert->bind_param('is', $id, $value);
$insert->execute();
$result = $db->query('SELECT value FROM mysql106_optional WHERE value IS NULL');

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

$details = [];
$db = mysql106Connect();
$db->query('CREATE TEMPORARY TABLE mysql106_optional (id INT PRIMARY KEY,value VARCHAR(20) NULL) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4');
$insert = $db->prepare('INSERT INTO mysql106_optional (id,value) VALUES (?,?)');
$id = 0; $value = null; $insert->bind_param('is',$id,$value);
foreach ([1=>null,2=>'',3=>'0'] as $id=>$value) { $insert->execute(); }
$insert->close();
$rows = [];
foreach ($db->query('SELECT id,value,value IS NULL AS missing,LENGTH(value) AS bytes FROM mysql106_optional ORDER BY id') as $row) {
    $rows[]=[(int)$row['id'],$row['value'],(int)$row['missing'],$row['bytes']===null ? null : (int)$row['bytes']];
}
$missing = (int)$db->query('SELECT COUNT(*) AS n FROM mysql106_optional WHERE value IS NULL')->fetch_assoc()['n'];
$checks = ['three_distinct_values'=>$rows[0][1]===null && $rows[1][1]==='' && $rows[2][1]==='0','one_missing_value'=>$missing===1];
$runtime = mysql106Runtime($db);
$db->close();
mysql106Report('mysql106-null-empty-zero', ['id', 'value', 'IS NULL', 'LENGTH в байтах'], $rows, $checks, $runtime, $details);
echo "optional values: NULL, empty string and string zero remain distinct\n";

optional values: NULL, empty string and string zero remain distinct

Полный самостоятельный комплект: example.php, mysql106-helper.php и README.txt. Настройте отдельный локальный MySQL и переменные окружения из инструкции выше, затем выполните php example.php. Код сам создаёт свои TEMPORARY-таблицы и исходные строки; другие примеры предварительно запускать не нужно. Helper читает окружение, устанавливает соединение и сохраняет HTML/JSON; вся SQL-работа видна в example.php. Для повторения достаточно новой сессии; локальные файлы отчёта будут перезаписаны.

$db->query('UPDATE mysql106_counts SET stock=7 WHERE id=1');
$changed = $db->affected_rows;
// 0 может означать: строка найдена, но stock уже равен 7.
// В строгом режиме ошибка запроса выбросила бы исключение.

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

$details = [];
$rows = []; $details = []; $runtime = [];
foreach (['changed'=>0,'matched'=>MYSQLI_CLIENT_FOUND_ROWS] as $mode=>$flags) {
    $db = mysql106Connect($flags);
    $db->query('CREATE TEMPORARY TABLE mysql106_counts (id INT PRIMARY KEY,stock INT NOT NULL) ENGINE=InnoDB');
    $db->query('INSERT INTO mysql106_counts (id,stock) VALUES (1,7)');
    $db->query('UPDATE mysql106_counts SET stock=7 WHERE id=1');
    $same = $db->affected_rows;
    $db->query('UPDATE mysql106_counts SET stock=8 WHERE id=1');
    $changed = $db->affected_rows;
    $actual = (int)$db->query('SELECT stock FROM mysql106_counts WHERE id=1')->fetch_assoc()['stock'];
    $rows[] = [$mode,'7 → 7',$same];
    $rows[] = [$mode,'7 → 8',$changed];
    $details[$mode.'_final_stock']=$actual;
    $runtime = mysql106Runtime($db);
    $db->close();
}
$checks = ['default_counts_changes'=>$rows[0][2]===0 && $rows[1][2]===1,'flag_counts_matches'=>$rows[2][2]===1 && $rows[3][2]===1,'both_saved_eight'=>$details['changed_final_stock']===8 && $details['matched_final_stock']===8];
mysql106Report('mysql106-update-counts', ['Режим подсчёта', 'Обновление', 'affected_rows'], $rows, $checks, $runtime, $details);
echo "UPDATE: default same=0 changed=1; FOUND_ROWS same=1 changed=1\n";

UPDATE: default same=0 changed=1; FOUND_ROWS same=1 changed=1

Полный самостоятельный комплект: example.php, mysql106-helper.php и README.txt. Настройте отдельный локальный MySQL и переменные окружения из инструкции выше, затем выполните php example.php. Код сам создаёт свои TEMPORARY-таблицы и исходные строки; другие примеры предварительно запускать не нужно. Helper читает окружение, устанавливает соединение и сохраняет HTML/JSON; вся SQL-работа видна в example.php. Для повторения достаточно новой сессии; локальные файлы отчёта будут перезаписаны.

$db->begin_transaction();
try {
    // UPDATE остатка и INSERT заказа выполняются через это же соединение.
    $db->commit();
} catch (Throwable $error) {
    $db->rollback();
    throw $error;
}

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

$details = [];
$db = mysql106Connect();
$db->query('CREATE TEMPORARY TABLE mysql106_stock (id INT PRIMARY KEY,qty INT NOT NULL) ENGINE=InnoDB');
$db->query('CREATE TEMPORARY TABLE mysql106_orders (id INT PRIMARY KEY,product_id INT NOT NULL) ENGINE=InnoDB');
$db->query('INSERT INTO mysql106_stock (id,qty) VALUES (1,2)');
$read = function(string $stage) use ($db): array {
    $qty = (int)$db->query('SELECT qty FROM mysql106_stock WHERE id=1')->fetch_assoc()['qty'];
    $count = (int)$db->query('SELECT COUNT(*) AS n FROM mysql106_orders')->fetch_assoc()['n'];
    return [$stage,$qty,$count];
};
$rows = [$read('До')];
$controlledFailure = false;
$db->begin_transaction();
try {
    $db->query('UPDATE mysql106_stock SET qty=qty-1 WHERE id=1 AND qty>0');
    if ($db->affected_rows!==1) { throw new RuntimeException('No stock'); }
    $db->query('INSERT INTO mysql106_orders (id,product_id) VALUES (101,1)');
    throw new RuntimeException('Controlled failure before commit');
} catch (Throwable $error) {
    $db->rollback();
    if ($error->getMessage() !== 'Controlled failure before commit') { throw $error; }
    $controlledFailure = true;
}
$rows[] = $read('После rollback');
$db->begin_transaction();
try {
    $db->query('UPDATE mysql106_stock SET qty=qty-1 WHERE id=1 AND qty>0');
    if ($db->affected_rows!==1) { throw new RuntimeException('No stock'); }
    $db->query('INSERT INTO mysql106_orders (id,product_id) VALUES (102,1)');
    $db->commit();
} catch (Throwable $error) { $db->rollback(); throw $error; }
$rows[] = $read('После commit');
$checks = ['controlled_failure_observed'=>$controlledFailure,'rollback_restored_both'=>$rows[1][1]===2 && $rows[1][2]===0,'commit_saved_both'=>$rows[2][1]===1 && $rows[2][2]===1];
$runtime = mysql106Runtime($db);
$db->close();
mysql106Report('mysql106-transaction-recovery', ['Этап', 'Остаток', 'Число заказов'], $rows, $checks, $runtime, $details);
echo "transaction: rollback stock=2/orders=0; commit stock=1/orders=1\n";

transaction: rollback stock=2/orders=0; commit stock=1/orders=1

Полный самостоятельный комплект: example.php, mysql106-helper.php и README.txt. Настройте отдельный локальный MySQL и переменные окружения из инструкции выше, затем выполните php example.php. Код сам создаёт свои TEMPORARY-таблицы и исходные строки; другие примеры предварительно запускать не нужно. Helper читает окружение, устанавливает соединение и сохраняет HTML/JSON; вся SQL-работа видна в example.php. Для повторения достаточно новой сессии; локальные файлы отчёта будут перезаписаны.