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

Результат, строка, ячейка и курсор — разные вещи

Набор SELECT — таблица ответа со своим указателем текущей строки. Запрос может вернуть0 строк, но сохранить сведения о выбранных полях. Следующий fetch двигает указатель вперёд; data_seek меняет позицию только в уже полученном буфере. Здесь переносим чтение старого кода так, чтобы не потерять имена, NULL и порядок обработки.

В старом ext/mysql конец fetch обозначался false. В MySQLi конец — null, а false может обозначать отказ. Нельзя оставить условие !==false без пересмотра. Подготовка среды и полный путь подключения находятся в первой главе блока.

Выбрать форму одной строки: имена, номера или оба набора ключей

Шаблон страницы ждёт $row[1], а перенесённый код выдаёт $row["name"]. Сравним договоры одного товара, чтобы выбрать подходящий формат и не дублировать данные случайно.

$row = $result->fetch_assoc();
echo $row['name'];
// Вместо этого можно fetch_row() и $row[1].

ASSOC сопоставляет имена id/name со значениями. NUM использует0/1 по порядку SELECT. BOTH содержит обе формы ключей одной строки. Указатель набора перемещается при каждом fetch, поэтому для сравнения выполняются три одинаковых запроса, а не три последовательных чтения разных товаров.

Что должно получиться

Полный example.php ниже создаёт свой исходный набор и сохраняет эту таблицу. Вспомогательный файл legacy108-helper.php содержит только настройку соединения и оформление отчёта; он уже включён в скачиваемый архив, это не обязательная часть самого API-вызова.

<?php
declare(strict_types=1);
require __DIR__.'/legacy108-helper.php';
$details=[];
$db=legacy108Connect();legacy108Catalog($db);
try {
    $sql='SELECT id,name FROM mysql108_legacy_products WHERE id=1';
    $a=$db->query($sql);$assoc=$a->fetch_assoc();$end=$a->fetch_assoc();$a->free();
    $b=$db->query($sql);$numeric=$b->fetch_row();$b->free();
    $c=$db->query($sql);$both=$c->fetch_array(MYSQLI_BOTH);$c->free();
    $rows=[['ASSOC',implode(', ',array_keys($assoc)),(int)$assoc['id'],$assoc['name']],['NUM',implode(', ',array_keys($numeric)),(int)$numeric[0],$numeric[1]],['BOTH',implode(', ',array_keys($both)),(int)$both[0],$both['name']],['Следующий fetch после конца','null',null,null]];
    $checks=['assoc_names'=>array_keys($assoc)===['id','name'],'numeric_indices'=>array_keys($numeric)===[0,1],'both_contains_two_views'=>count($both)===4 && $both[1]===$both['name'],'end_is_null'=>$end===null];
    $details=['both_actual_keys'=>array_keys($both),'id_type_observed'=>get_debug_type($assoc['id'])];$runtime=legacy108Runtime($db);
} finally {$db->close();}
legacy108Report('mysql108-fetch-shapes', ['Режим', 'Ключи', 'ID', 'Имя'], $rows, $checks, $runtime, $details);
echo "ASSOC, NUM and BOTH read same product; EOF is null\n";

ASSOC, NUM and BOTH read same product; EOF is null

Открыть сохранённый HTML-отчёт · Данные результата JSON

Границы и частые ошибки

Главная ловушка миграции: старое !==false не является верным условием конца современного fetch. NULL внутри поля отличается от null вместо всей строки. Тип ID может зависеть от протокола/настроек драйвера; наш прикладной отчёт явно приводит известный INT к int, наблюдаемый исходный тип записан отдельно.

Попробовать самостоятельно

Поменяйте SELECT на name,id. Решение: числовые индексы поменяются, именованные ключи сохранят смысл; не исправляйте это SELECT *.

Сохранить два одноимённых поля JOIN с помощью AS

Страница выводит название склада вместо названия товара. Оба поля JOIN назывались name, а ассоциативный массив способен хранить только одно значение для одинакового ключа.

$sql = 'SELECT p.name AS product_name,s.name AS warehouse_name FROM ...';
$row = $result->fetch_assoc();
echo $row['product_name'], ' / ', $row['warehouse_name'];

AS назначает имя выходной колонки, не переименовывает колонку таблицы. product_name и warehouse_name образуют два понятных ключа результата. field_count показывает2 SQL-поля даже у ошибочной проекции; count($row) без AS оказывается1.

Что должно получиться

Полный example.php ниже создаёт свой исходный набор и сохраняет эту таблицу. Вспомогательный файл legacy108-helper.php содержит только настройку соединения и оформление отчёта; он уже включён в скачиваемый архив, это не обязательная часть самого API-вызова.

<?php
declare(strict_types=1);
require __DIR__.'/legacy108-helper.php';
$details=[];
$db=legacy108Connect();legacy108Catalog($db);
try {
    $ambiguous=$db->query('SELECT p.name,s.name FROM mysql108_legacy_products p JOIN (SELECT 1 AS product_id,\'Склад А\' AS name) s ON s.product_id=p.id');
    $lost=$ambiguous->fetch_assoc();$ambiguous->free();
    $correct=$db->query('SELECT p.name AS product_name,s.name AS warehouse_name FROM mysql108_legacy_products p JOIN (SELECT 1 AS product_id,\'Склад А\' AS name) s ON s.product_id=p.id');
    $kept=$correct->fetch_assoc();$fieldCount=$correct->field_count;$correct->free();
    $rows=[['Без AS',count($lost),$lost['name'],'второе поле заняло имя name'],['С AS',count($kept),$kept['product_name'],$kept['warehouse_name']]];
    $checks=['collision_demonstrated'=>count($lost)===1 && $lost['name']==='Склад А','both_preserved'=>$kept===['product_name'=>'Чай','warehouse_name'=>'Склад А'],'two_projected_fields'=>$fieldCount===2];$runtime=legacy108Runtime($db);
} finally {$db->close();}
legacy108Report('mysql108-column-aliases', ['Выборка', 'Ключей PHP', 'Первое значение', 'Второе значение / пояснение'], $rows, $checks, $runtime, $details);
echo "Aliases preserved product and warehouse names\n";

Aliases preserved product and warehouse names

Открыть сохранённый HTML-отчёт · Данные результата JSON

Границы и частые ошибки

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

Попробовать самостоятельно

Добавьте p.id AS product_id. Решение: в правильном результате появится третий явный ключ, не изменяющий смысл первых двух.

Получить объект строки и увидеть порядок заполнения свойств

Старый код получал объект строки; при переносе конструктор неожиданно стирает имя товара. Покажем действительный порядок: сначала поля, потом конструктор.

$product = $result->fetch_object(Legacy108Product::class, ['Товар: ']);
echo $product->label; // Товар: Чай

Класс описывает свойства id/name и действие конструктора. fetch_object(Legacy108Product::class,["Товар: "]) создаёт объект, заполняет свойства и вызывает конструктор с нашим префиксом. Конструктор видит уже загруженное name и формирует label. Без класса возвращается stdClass.

Что должно получиться

Полный example.php ниже создаёт свой исходный набор и сохраняет эту таблицу. Вспомогательный файл legacy108-helper.php содержит только настройку соединения и оформление отчёта; он уже включён в скачиваемый архив, это не обязательная часть самого API-вызова.

<?php
declare(strict_types=1);
require __DIR__.'/legacy108-helper.php';
$details=[];
class Legacy108Product {
    public $id; public $name; public string $label;
    public function __construct(string $prefix) {$this->label=$prefix.$this->name;}
}
$db=legacy108Connect();legacy108Catalog($db);
try {
    $result=$db->query('SELECT id,name FROM mysql108_legacy_products WHERE id=1');
    $product=$result->fetch_object(Legacy108Product::class,['Товар: ']);$lengths=$result->lengths;$result->free();
    $plainResult=$db->query('SELECT id,name FROM mysql108_legacy_products WHERE id=2');$plain=$plainResult->fetch_object();$plainResult->free();
    $rows=[['Свой класс',(int)$product->id,$product->name,$product->label],['stdClass',(int)$plain->id,$plain->name,'без пользовательского конструктора']];
    $checks=['custom_class'=>$product instanceof Legacy108Product,'properties_before_constructor'=>$product->label==='Товар: Чай','default_stdclass'=>$plain instanceof stdClass && $plain->name==='Кофе','lengths_after_object'=>$lengths[1]===6];$details=['name_bytes_after_object'=>$lengths[1]];$runtime=legacy108Runtime($db);
} finally {$db->close();}
legacy108Report('mysql108-object-hydration', ['Вариант', 'ID', 'Имя', 'Результат конструктора'], $rows, $checks, $runtime, $details);
echo "Custom constructor saw fetched name; default row is stdClass\n";

Custom constructor saw fetched name; default row is stdClass

Открыть сохранённый HTML-отчёт · Данные результата JSON

Границы и частые ошибки

Аргументы конструктора — переданный программистом список, не массив полей SQL. Если нужны проверки инвариантов до присваивания данных, выберите fetch_assoc и явное создание доменного объекта. Объявленные свойства избегают случайных динамических свойств. Пользователь не должен выбирать имя класса из запроса.

Попробовать самостоятельно

Добавьте в конструктор $this->name="Заменено". Решение: загруженное имя будет затёрто. Это демонстрация порядка, а не рекомендация так проектировать объект.

Практическая ситуация: How to use mysqli::fetch_object()?. Автор хотел автоматически передать SQL-строку массивом в конструктор нескольких классов. Пример объясняет собственные аргументы конструктора и порядок заполнения свойств; явное fetch_assoc остаётся альтернативой. Вопрос используется как описание проблемы; код и объяснение написаны заново, технические правила сверены с PHP.net.

Заменить mysql_result: строка буфера и точечный запрос по ID

После замены mysql_ на mysqli_ функция mysqli_result не нашлась. Нужно определить настоящую задачу: третья строка уже готового набора или товар с известным ID.

$result->data_seek(2); // третья строка существующего буфера
$row = $result->fetch_assoc();
$name = $row['name'];

data_seek(2) переставляет указатель буфера на третью строку, потому что счёт начинается с0. Последующий fetch_assoc извлекает её. WHERE id=? ищет конкретный ключ на сервере и не зависит от позиции других строк. SQL ORDER BY делает учебный порядок воспроизводимым.

Что должно получиться

Полный example.php ниже создаёт свой исходный набор и сохраняет эту таблицу. Вспомогательный файл legacy108-helper.php содержит только настройку соединения и оформление отчёта; он уже включён в скачиваемый архив, это не обязательная часть самого API-вызова.

<?php
declare(strict_types=1);
require __DIR__.'/legacy108-helper.php';
$details=[];
$db=legacy108Connect();legacy108Catalog($db);
try {
    $buffer=$db->query('SELECT id,name FROM mysql108_legacy_products ORDER BY id');
    $moved=$buffer->data_seek(2);$third=$buffer->fetch_assoc();$buffer->data_seek(0);$first=$buffer->fetch_assoc();$count=$buffer->num_rows;$buffer->free();
    $id=3;$stmt=$db->prepare('SELECT name FROM mysql108_legacy_products WHERE id=?');$stmt->bind_param('i',$id);$stmt->execute();$one=$stmt->get_result();$target=$one->fetch_assoc();$one->free();
    $id=99;$stmt->execute();$none=$stmt->get_result();$missing=$none->fetch_assoc();$none->free();$stmt->close();
    $rows=[['Смещение 2 в ORDER BY id',(int)$third['id'],$third['name']],['Смещение 0',(int)$first['id'],$first['name']],['WHERE id=3',3,$target['name']],['WHERE id=99',99,$missing]];
    $checks=['seek_third'=>$moved && (int)$third['id']===3,'seek_back'=>(int)$first['id']===1,'buffer_count'=>$count===4,'specific_id'=>$target['name']==='Какао','missing_is_null'=>$missing===null];$runtime=legacy108Runtime($db);
} finally {$db->close();}
legacy108Report('mysql108-seek-cell', ['Доступ', 'ID', 'Значение'], $rows, $checks, $runtime, $details);
echo "Buffer position2 and ID3 found Cocoa; missing ID99 stayed null\n";

Buffer position2 and ID3 found Cocoa; missing ID99 stayed null

Открыть сохранённый HTML-отчёт · Данные результата JSON

Границы и частые ошибки

Позиция2 не равна ID2; без ORDER BY нет устойчивого порядка. Пустой набор нельзя seek(0). Не сканируйте все товары ради одного ключа. Для поля, содержащего SQL NULL, array_key_exists и сравнение строки целиком помогают не спутать отсутствие значения и отсутствие записи.

Попробовать самостоятельно

Поменяйте ORDER BY id DESC. Решение: позиция2 теперь ID2, но WHERE id=3 по-прежнему возвращает Какао.

Практическая ситуация: MySQLi equivalent of mysql_result()?. При переносе чтения одной ячейки не нашлось метода result. Мы разделяем доступ к готовому буферу по позиции и запрос нужного поля по идентификатору, не создаём фиктивную встроенную функцию. Вопрос используется как описание проблемы; код и объяснение написаны заново, технические правила сверены с PHP.net.

Не перепутать байты текста, пустую строку и SQL NULL

Экспортёр видит нулевую длину и решает, что значения нет. Но пустой комментарий и SQL NULL имеют разный смысл; слово Чай занимает больше байтов, чем букв.

$row = $result->fetch_assoc();
$byteLengths = $result->lengths;
$isMissing = $row['missing_text'] === null;

fetch_assoc получает текущую строку, затем lengths возвращает размеры её колонок. title имеет6 UTF-8 байтов; empty_text и missing_text имеют длину0, но первое значение "", второе null. zero_text содержит один байт0. field_count сообщает число колонок4.

Что должно получиться

Полный example.php ниже создаёт свой исходный набор и сохраняет эту таблицу. Вспомогательный файл legacy108-helper.php содержит только настройку соединения и оформление отчёта; он уже включён в скачиваемый архив, это не обязательная часть самого API-вызова.

<?php
declare(strict_types=1);
require __DIR__.'/legacy108-helper.php';
$details=[];
$db=legacy108Connect();
try {
    $r=$db->query("SELECT 'Чай' AS title,'' AS empty_text,NULL AS missing_text,'0' AS zero_text");
    $record=$r->fetch_assoc();$lengths=$r->lengths;$fields=$r->field_count;$r->free();
    $rows=[];$names=array_keys($record);
    foreach ($names as $i=>$name) {$rows[]=[$name,$record[$name],$lengths[$i],$record[$name]===null?'SQL NULL':'строка'];}
    $checks=['bytes_utf8'=>$lengths===[6,0,0,1],'four_fields'=>$fields===4,'null_distinct'=>$record['missing_text']===null && $record['empty_text']==='' && $record['zero_text']==='0','name_matches'=>$record['title']==='Чай'];
    $details=['php_strlen_title'=>strlen($record['title']),'character_length'=>3,'lengths_apply_to_last_fetched_row'=>true];$runtime=legacy108Runtime($db);
} finally {$db->close();}
legacy108Report('mysql108-lengths-null', ['Поле', 'Значение', 'Байт в результате', 'Смысл'], $rows, $checks, $runtime, $details);
echo "UTF-8 bytes6; empty0; NULL0; zero1; all four meanings retained\n";

UTF-8 bytes6; empty0; NULL0; zero1; all four meanings retained

Открыть сохранённый HTML-отчёт · Данные результата JSON

Границы и частые ошибки

lengths действует для последней прочитанной строки; до fetch и после конца у API другой результат. Это длина данных, не максимальный размер столбца. Для количества пользовательских символов нужны функции многобайтового текста; здесь число букв3 известно для фиксированного слова, не вычислено bytes/2.

Попробовать самостоятельно

Замените Чай на Tea. Решение: длина станет3байта при том же количестве букв; остальные значения не изменятся.

Разделить набор результата и соединение, которое его создало

Старый обработчик освобождал ресурс, после чего случайно терял возможность выполнить следующий запрос. Разделим два уровня владения: результат и подключение.

$result->free(); // освобождён набор, не соединение
$next = $db->query('SELECT COUNT(*) AS total FROM products');
$db->close(); // закрывается соединение

mysqli_result содержит ответ конкретного SELECT. free завершает его использование. $db всё ещё представляет соединение и может выполнить другой query. Даже пустой набор содержит схему выбранных колонок:0 строк и2 поля не противоречат друг другу.

Что должно получиться

Полный example.php ниже создаёт свой исходный набор и сохраняет эту таблицу. Вспомогательный файл legacy108-helper.php содержит только настройку соединения и оформление отчёта; он уже включён в скачиваемый архив, это не обязательная часть самого API-вызова.

<?php
declare(strict_types=1);
require __DIR__.'/legacy108-helper.php';
$details=[];
$db=legacy108Connect();legacy108Catalog($db);
try {
    $first=$db->query('SELECT id,name FROM mysql108_legacy_products WHERE stock=0');$before=$first->num_rows;$record=$first->fetch_assoc();$first->free();
    $second=$db->query('SELECT COUNT(*) AS total FROM mysql108_legacy_products');$total=(int)$second->fetch_assoc()['total'];$second->free();
    $empty=$db->query('SELECT id,name FROM mysql108_legacy_products WHERE id<0');$emptyRows=$empty->num_rows;$emptyFields=$empty->field_count;$empty->free();
    $rows=[['Первый набор до free',$before,$record['name']],['Новый запрос тем же соединением',$total,'соединение осталось открытым'],['Пустой набор',$emptyRows,'полей: '.$emptyFields]];
    $checks=['out_of_stock_found'=>$before===1 && $record['name']==='Кофе','connection_not_result'=>$total===4,'empty_has_schema'=>$emptyRows===0 && $emptyFields===2];$runtime=legacy108Runtime($db);
} finally {$db->close();}
legacy108Report('mysql108-result-lifetime', ['Действие', 'Строк', 'Пояснение'], $rows, $checks, $runtime, $details);
echo "Freed results independently; connection reused; empty result has2fields\n";

Freed results independently; connection reused; empty result has2fields

Открыть сохранённый HTML-отчёт · Данные результата JSON

Границы и частые ошибки

Не вызывать free на true от UPDATE, не читать уже освобождённый объект. Подготовленный statement имеет собственный close; он не заменяет free результата. Современный free возвращает void, поэтому if(free()) не переносится из исторического bool-контракта.

Попробовать самостоятельно

Добавьте третье явное поле stock к пустой выборке. Решение: строк по-прежнему0, полей3; схема ответа существует независимо от данных.

Как проверить перенос в своём проекте

Переносите одну наблюдаемую операцию целиком: входные параметры, SQL, тип результата, контроль ошибок, данные на экране. После этого переходите к фильтрам и подготовленным запросам, конфликтам редактирования и транзакциям. Простая замена префикса не проверяет ни один из этих договоров.