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

Данные, описание результата и каталог — три разных задачи

При переносе старого сайта мало заменить mysql_query на mysqli_query. Генератор CSV или редактор форм мог использовать описание колонок: имя, тип, ширину, ключи. Начнём с отчёта о кружке, у которого имя в таблице name, а заголовок результата product_name. Нужен понятный результат: данные остаются прежними, а код правильно отличает имя для вывода от структуры хранения.

Метаданные — описание, похожее на подписи колонок в бланке; это не сами заполненные строки. Аналогия ограничена: вычисляемое выражение SELECT может не иметь единственного исходного столбца. Полезно знать массивы и таблицы, типы и связи, но смысл каждого обращения показан в малом фрагменте перед полной программой.

Как запустить современный пример и прочитать отчёт

Полные программы выполняются на PHP 8.2+ с mysqli/mysqlnd и отдельной локальной учебной базой MySQL 8.4/InnoDB. Контрольное окружение — PHP 8.5.11/MySQL 8.4.13. Устаревшее ext/mysql не устанавливается, PHP 5 не нужен. Начальную настройку см. в подключении PHP к MySQL.

Распакуйте архив, задайте PHPMAN_MYSQL_HOST, PHPMAN_MYSQL_PORT, PHPMAN_MYSQL_DATABASE, PHPMAN_MYSQL_USER, PHPMAN_MYSQL_PASSWORD в окружении своего терминала и выполните php example.php. На контрольном стенде используется localhost:33070; у вас порт может быть другим. Реквизиты в архив не входят. README и mysql108-metadata-helper.php включены в каждый архив.

Создаются только собственные mysql108_meta_* и mysql108_diag_* таблицы в выделенной базе. Занятое имя вызывает отказ CREATE и не попадает в список очистки. finally удаляет только успешно созданные этим запуском таблицы; после аварийного завершения процесса они могут остаться. Запускать это в базе рабочего сайта не следует. Права на базу ограничены; CREATE/DROP DATABASE ни один пример не выполняет.

Версии, ID и показания счётчиков не придумываются: они поступают из текущего запуска и показаны в result.html. В тексте главы таблица «Что получится» содержит устойчивые свойства и учебные данные; переменные показания находятся в сохранённом фактическом результате. Это CLI-проверка PHP/MySQL, не отправка HTML-формы и не тест HTTP.

Отличить заголовок отчёта от исходного столбца

Старый экспорт строит заголовки через mysql_field_name, а затем пытается по этим же строкам найти исходные поля таблицы. После AS product_name это уже разные имена. Покажем и удобный заголовок, и происхождение значения.

Исходные данные

Таблица mysql108_meta_aliases

Что получится

Имена выходных и исходных полей

Данные отчёта

Малый фрагмент: сначала смысл действия

$result = $db->query('SELECT p.name AS product_name FROM mysql108_meta_aliases AS p');
$field = $result->fetch_field();
echo $field->name;    // product_name
echo $field->orgname; // name

Это фрагмент внутри показанного сценария: $db — уже установленное соединение; $result — результат соответствующего SELECT. Полный запуск ниже самостоятельно создаёт нужные входные таблицы. Если показан SQL, его выполняет query/execute_query из полной программы.

Результат SELECT имеет свою структуру: три выходных поля располагаются в указанном запросом порядке. Объект metadata описывает столбец, а fetch_row читает значения строки. AS меняет name, но orgname хранит исходное имя обычного столбца; alias таблицы p виден в table, исходное имя — в orgtable. Стрелка -> обращается к свойству объекта поля. Вызов fetch_fields возвращает массив таких объектов, по одному на выбранный столбец.

Не определяйте SQL для UPDATE прямо по metadata клиентского отчёта: выражения, JOIN и вычисляемые поля могут не иметь единственной исходной колонки. Для вычисления price*2 поля table/orgtable могут быть пустыми. Сначала задайте разрешённую модель редактирования. Для денежных данных SQL DECIMAL остаётся строковым десятичным значением в этом чтении; метаданные не превращают PHP float в точную валюту.

Ошибки и ограничения

Не путайте регистр имени, alias и название физической таблицы. Тип mysqli — числовой MYSQLI_TYPE_*; старые проверки type === "int" не перенесутся автоматически. PHP-тип прочитанного значения и SQL-тип — разные сведения.

<?php
declare(strict_types=1);
require __DIR__.'/mysql108-metadata-helper.php';
$db=legacy108Connect();$other=null;$created=[];$blocks=[];$checks=[];$observations=[];
try {
legacy108Create($db,$created,'mysql108_meta_aliases','id INT PRIMARY KEY, name VARCHAR(40) NOT NULL, price DECIMAL(8,2) NOT NULL');
$db->query("INSERT INTO mysql108_meta_aliases VALUES(1,'Кружка',250.00)");
$result=$db->query('SELECT p.id AS product_id,p.name AS product_name,p.price FROM mysql108_meta_aliases AS p');
$fields=$result->fetch_fields();$rows=[];foreach($fields as $f){$rows[]=[$f->name,$f->orgname,$f->table,$f->orgtable];}
$data=$result->fetch_row();$result->free();
$blocks=[legacy108Block('Имена выходных и исходных полей',['name','orgname','table','orgtable'],$rows),legacy108Block('Данные отчёта',['product_id','product_name','price'],[array_map('strval',$data)])];
$checks=['three_fields'=>count($fields)===3,'alias_and_origin'=>$rows[1]===['product_name','name','p','mysql108_meta_aliases'],'data_preserved'=>(string)$data[0]==='1'&&$data[1]==='Кружка'];
$observations=[['Тип id из metadata',(string)$fields[0]->type],['Тип price из metadata',(string)$fields[2]->type]];
legacy108Report('mysql108-meta-aliases',$blocks,$checks,$observations,$db,[]);
} finally {legacy108Cleanup($db,$other,$created);}
echo "mysql108-meta-aliases: saved result.html and result.json\n";

mysql108-meta-aliases: saved result.html and result.json

Скачать таблицы JSON · Открыть фактический результат · Скачать реальные наблюдения

Попробуйте сами. Добавьте p.price*2 AS double_price. В новом результате отдельно покажите name/orgname/table/orgtable этого выражения. Не обещайте, что по вычислению можно автоматически восстановить один редактируемый столбец.

Перенести строковые флаги в явные проверки битов

В старом редакторе форма ищет слова primary_key и not_null в строке mysql_field_flags. После перехода mysqli возвращает число. Из этого числа нужно извлечь конкретные свойства, сохранив nullable-поле заметки.

Исходные данные

Объявленная схема

Что получится

Проверяем свойства, а не всю числовую маску

Малый фрагмент: сначала смысл действия

$field = $result->fetch_field_direct(0);
$isPrimary = ($field->flags & MYSQLI_PRI_KEY_FLAG) !== 0;

Это фрагмент внутри показанного сценария: $db — уже установленное соединение; $result — результат соответствующего SELECT. Полный запуск ниже самостоятельно создаёт нужные входные таблицы. Если показан SQL, его выполняет query/execute_query из полной программы.

Число flags — битовая маска: отдельным свойствам соответствуют отдельные биты. Операция & оставляет общие биты двух чисел; сравнение !== 0 означает «нужный бит установлен». MYSQLI_PRI_KEY_FLAG — именованная маска PRIMARY KEY. В отличие от равенства всей маске, эта проверка продолжает работать, если сервер сообщает и другие свойства поля. Полная числовая маска сохранена в наблюдениях, но договор примера проверяет только выбранные признаки.

ID одновременно PRIMARY KEY, UNSIGNED и AUTO_INCREMENT. SKU обязателен и уникален. Note допускает NULL, поэтому NOT_NULL_FLAG у него отсутствует. Битовая маска описывает серверную структуру, а не все правила формы: корректность артикула, разрешённые переходы статуса и права пользователя задаются приложением. UNIQUE допускает разные правила для NULL; здесь SKU явно NOT NULL.

Ошибки и ограничения

Не передавайте flags в explode и не сравнивайте всё число с одним MYSQLI_*_FLAG. Смысл multi-column индекса сложнее одного поля; для полного состава индекса нужен отдельный запрос к каталогу. Для nullable-поля отсутствие NOT NULL не означает, что пустая строка равна NULL.

<?php
declare(strict_types=1);
require __DIR__.'/mysql108-metadata-helper.php';
$db=legacy108Connect();$other=null;$created=[];$blocks=[];$checks=[];$observations=[];
try {
legacy108Create($db,$created,'mysql108_meta_flags','id INT UNSIGNED PRIMARY KEY AUTO_INCREMENT, sku VARCHAR(12) NOT NULL UNIQUE, note VARCHAR(30) NULL');
$db->query("INSERT INTO mysql108_meta_flags(sku,note) VALUES('A-100',NULL)");
$result=$db->query('SELECT id,sku,note FROM mysql108_meta_flags');$f=$result->fetch_fields();$result->free();
$tests=[['id','PRIMARY KEY',($f[0]->flags&MYSQLI_PRI_KEY_FLAG)!==0],['id','UNSIGNED',($f[0]->flags&MYSQLI_UNSIGNED_FLAG)!==0],['id','AUTO_INCREMENT',($f[0]->flags&MYSQLI_AUTO_INCREMENT_FLAG)!==0],['sku','NOT NULL',($f[1]->flags&MYSQLI_NOT_NULL_FLAG)!==0],['sku','UNIQUE',($f[1]->flags&MYSQLI_UNIQUE_KEY_FLAG)!==0],['note','NOT NULL',($f[2]->flags&MYSQLI_NOT_NULL_FLAG)!==0]];
$rows=array_map(fn($x)=>[$x[0],$x[1],legacy108Yes($x[2])],$tests);
$blocks=[legacy108Block('Проверяем свойства, а не всю числовую маску',['Столбец','Свойство','Есть'],$rows)];
$checks=['primary'=>$tests[0][2],'unsigned'=>$tests[1][2],'auto'=>$tests[2][2],'required'=>$tests[3][2],'unique'=>$tests[4][2],'nullable'=>!$tests[5][2]];
foreach($f as $field){$observations[]=[$field->name.' raw flags',(string)$field->flags];}
legacy108Report('mysql108-meta-flags',$blocks,$checks,$observations,$db,[]);
} finally {legacy108Cleanup($db,$other,$created);}
echo "mysql108-meta-flags: saved result.html and result.json\n";

mysql108-meta-flags: saved result.html and result.json

Скачать таблицы JSON · Открыть фактический результат · Скачать реальные наблюдения

Попробуйте сами. Сделайте note NOT NULL DEFAULT "" и сравните только её NOT_NULL_FLAG. Затем объясните, почему обязательность столбца не проверяет непустой пользовательский текст.

Не принять байты поля за maxlength формы

Разработчик автоматически подставляет length из metadata в maxlength HTML-поля и получает 48 вместо ожидаемых 12. Разделим вместимость столбца в символах, предел в байтах и байты конкретного значения.

Исходные данные

Два значения

Что получится

Договор VARCHAR(12) с utf8mb4

Фактические значения

Малый фрагмент: сначала смысл действия

SELECT CHARACTER_MAXIMUM_LENGTH, CHARACTER_OCTET_LENGTH
FROM INFORMATION_SCHEMA.COLUMNS
WHERE TABLE_SCHEMA = DATABASE()
  AND TABLE_NAME = 'mysql108_meta_widths' AND COLUMN_NAME = 'label';

Это фрагмент внутри показанного сценария: $db — уже установленное соединение; $result — результат соответствующего SELECT. Полный запуск ниже самостоятельно создаёт нужные входные таблицы. Если показан SQL, его выполняет query/execute_query из полной программы.

VARCHAR(12) с utf8mb4 допускает до 12 символов, для которых может потребоваться до 48 байтов. INFORMATION_SCHEMA.COLUMNS сообщает CHARACTER_MAXIMUM_LENGTH и CHARACTER_OCTET_LENGTH раздельно. В значении Кот три символа и шесть UTF-8 байтов; AB содержит два и два. CHAR_LENGTH выполняется сервером над значением, а result->lengths сообщает байтовую длину текущей уже прочитанной строки результата.

mysqli metadata length — ширина поля результата в байтах; она зависит и от кодировки соединения. Она не равна длине текущего значения. max_length с PHP 8.1 всегда 0: старый код, рассчитывающий по нему ширину отчёта, нужно пересмотреть. Даже ограничение HTML maxlength не является универсально идентичным MySQL CHAR_LENGTH: браузер считает кодовые единицы UTF-16, а пользовательский видимый символ может состоять из нескольких кодовых точек. Серверная проверка договора обязательна.

Ошибки и ограничения

Не делите любую длину на 4: типы, бинарные поля и кодировки различаются. Для нужной таблицы явно ограничивайте TABLE_SCHEMA и TABLE_NAME, иначе одноимённые таблицы разных баз смешаются. Максимум фактически полученных строк считайте по выбранной выборке, а не считайте max_length готовой статистикой.

<?php
declare(strict_types=1);
require __DIR__.'/mysql108-metadata-helper.php';
$db=legacy108Connect();$other=null;$created=[];$blocks=[];$checks=[];$observations=[];
try {
legacy108Create($db,$created,'mysql108_meta_widths','id INT PRIMARY KEY, label VARCHAR(12)');
$db->query("INSERT INTO mysql108_meta_widths VALUES(1,'Кот'),(2,'AB')");
$schema=legacy108Read($db,'SELECT CHARACTER_MAXIMUM_LENGTH,CHARACTER_OCTET_LENGTH FROM INFORMATION_SCHEMA.COLUMNS WHERE TABLE_SCHEMA=DATABASE() AND TABLE_NAME=? AND COLUMN_NAME=?',['mysql108_meta_widths','label'])[0];
$result=$db->query('SELECT label,CHAR_LENGTH(label) FROM mysql108_meta_widths ORDER BY id');$field=$result->fetch_field_direct(0);$rows=[];
while($row=$result->fetch_row()){$lengths=$result->lengths;$rows[]=[$row[0],(string)$row[1],(string)$lengths[0]];}$result->free();
$blocks=[legacy108Block('Договор VARCHAR(12) с utf8mb4',['Максимум символов','Максимум байтов'],[$schema]),legacy108Block('Фактические значения',['label','CHAR_LENGTH','Байты полученной строки'],$rows)];
$checks=['schema_characters'=>$schema[0]==='12','schema_bytes'=>$schema[1]==='48','unicode'=>$rows[0]===['Кот','3','6'],'ascii'=>$rows[1]===['AB','2','2']];
$observations=[['mysqli metadata length',(string)$field->length],['mysqli metadata max_length (PHP 8.1+)',(string)$field->max_length]];
legacy108Report('mysql108-meta-widths',$blocks,$checks,$observations,$db,[]);
} finally {legacy108Cleanup($db,$other,$created);}
echo "mysql108-meta-widths: saved result.html and result.json\n";

mysql108-meta-widths: saved result.html and result.json

Скачать таблицы JSON · Открыть фактический результат · Скачать реальные наблюдения

Попробуйте сами. Добавьте строку с emoji и сравните CHAR_LENGTH, OCTET_LENGTH и PHP strlen. Затем ограничьте выборку одной строкой и объясните, почему схема VARCHAR(12) при этом не изменилась.

Практический вопрос: Why does fetch_fields length differ from the declared CHAR/VARCHAR length?. Разработчик получает ширину в байтах и пытается использовать её как maxlength формы. Наш пример отдельно показывает символы схемы, максимальные байты и длину фактического UTF-8 значения. Обсуждение задаёт ситуацию; семантика сверена с PHP/MySQL, программа и её учебные данные написаны отдельно.

Перемещаться по полям, не теряя строки результата

Старый генератор отчётов сначала читает первое описание поля, затем переходит к третьему. При переносе легко принять field_seek за перемещение по строкам. Небольшой результат позволяет увидеть оба независимых указателя.

Исходные данные

Результат SELECT

Что получится

Отдельный курсор метаданных

Малый фрагмент: сначала смысл действия

$result->field_seek(2); // Номер третьего столбца, не третьей строки.
$field = $result->fetch_field();
echo $field->name;      // title

Это фрагмент внутри показанного сценария: $db — уже установленное соединение; $result — результат соответствующего SELECT. Полный запуск ниже самостоятельно создаёт нужные входные таблицы. Если показан SQL, его выполняет query/execute_query из полной программы.

Нумерация полей начинается с нуля: id — 0, sku — 1, title — 2. fetch_field без номера берёт описание у текущего указателя и продвигает его. field_seek(2) переставляет только указатель метаданных; следующий fetch_field читает title. fetch_field_direct(1) обращается к конкретному полю, не меняя этот указатель. После конца fetch_field возвращает false. При этом первое чтение строки по-прежнему даёт id=7.

data_seek относится к строкам буферизованного результата, field_seek — к описаниям столбцов. Массив fetch_fields часто проще ручного курсора, если нужны все заголовки: foreach перебирает уже явный набор объектов. Прямой индекс полезен, если схема SELECT известна и нужен один столбец.

Ошибки и ограничения

Проверяйте границу 0 <= offset < field_count до доступа. Старое предупреждение или false для неправильного offset не следует механически переносить в современный код: mysqli может отклонить неверный аргумент исключением. Курсор метаданных не листает товары и не отменяет запрос.

<?php
declare(strict_types=1);
require __DIR__.'/mysql108-metadata-helper.php';
$db=legacy108Connect();$other=null;$created=[];$blocks=[];$checks=[];$observations=[];
try {
legacy108Create($db,$created,'mysql108_meta_cursor','id INT PRIMARY KEY, sku VARCHAR(12), title VARCHAR(30)');
$db->query("INSERT INTO mysql108_meta_cursor VALUES(7,'A-100','Кружка')");
$result=$db->query('SELECT id,sku,title FROM mysql108_meta_cursor');
$first=$result->fetch_field()->name;$result->field_seek(2);$third=$result->fetch_field()->name;
$direct=$result->fetch_field_direct(1)->name;$end=$result->fetch_field();$row=$result->fetch_row();$result->free();
$blocks=[legacy108Block('Отдельный курсор метаданных',['Действие','Результат'],[['fetch_field()',$first],['field_seek(2), затем fetch_field()',$third],['fetch_field_direct(1)',$direct],['fetch_field() после конца',$end===false?'false':'unexpected'],['Первое поле первой строки',(string)$row[0]]])];
$checks=['first'=>$first==='id','seek'=>$third==='title','direct'=>$direct==='sku','end'=>$end===false,'rows_not_moved'=>(string)$row[0]==='7'];
legacy108Report('mysql108-meta-cursor',$blocks,$checks,$observations,$db,[]);
} finally {legacy108Cleanup($db,$other,$created);}
echo "mysql108-meta-cursor: saved result.html and result.json\n";

mysql108-meta-cursor: saved result.html and result.json

Скачать таблицы JSON · Открыть фактический результат · Скачать реальные наблюдения

Попробуйте сами. Переставьте SELECT в порядок title,id,sku и заново подпишите индексы. Исправьте только намеренную точку обращения, а затем покажите вариант foreach(fetch_fields()) без жёсткого номера.

Получить схему таблицы, даже если в ней нет товаров

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

Исходные данные

План создания

Что получится

Описание пустой таблицы

Данные и описание — разные результаты

Малый фрагмент: сначала смысл действия

SHOW COLUMNS FROM mysql108_meta_catalog;

Это фрагмент внутри показанного сценария: $db — уже установленное соединение; $result — результат соответствующего SELECT. Полный запуск ниже самостоятельно создаёт нужные входные таблицы. Если показан SQL, его выполняет query/execute_query из полной программы.

SHOW COLUMNS возвращает строки-описания: Field, Type, Null, Key, Default, Extra. Это обычная таблица результата, а не специальный старый resource mysql_list_fields. INFORMATION_SCHEMA.COLUMNS даёт именованные колонки каталога; фильтр TABLE_SCHEMA=DATABASE() закрепляет выбранную базу, TABLE_NAME=? получает имя как значение параметра, ORDER BY ORDINAL_POSITION сохраняет порядок определения полей.

Пустой SELECT id,name,qty возвращает ноль строк данных, но схема всё равно имеет три столбца. Для отчёта по произвольному SELECT подходят fetch_fields; для точного определения таблицы — каталог или SHOW COLUMNS. DATA_TYPE даёт базовое имя вроде varchar, COLUMN_TYPE — более подробное объявление. COLUMN_KEY — краткая подсказка, а не полное описание составных индексов или всех ограничений.

Ошибки и ограничения

Знак ? в запросе к INFORMATION_SCHEMA подставляет значение TABLE_NAME, а не SQL-идентификатор. В SHOW COLUMNS FROM ? так подставить имя таблицы нельзя. При динамическом FROM выбирайте имя из разрешённого списка; в самостоятельной программе имя фиксировано.

<?php
declare(strict_types=1);
require __DIR__.'/mysql108-metadata-helper.php';
$db=legacy108Connect();$other=null;$created=[];$blocks=[];$checks=[];$observations=[];
try {
legacy108Create($db,$created,'mysql108_meta_catalog','id INT PRIMARY KEY, name VARCHAR(12) NOT NULL, qty INT NOT NULL DEFAULT 0');
$rows=legacy108Read($db,'SELECT COLUMN_NAME,DATA_TYPE,IS_NULLABLE,COLUMN_KEY FROM INFORMATION_SCHEMA.COLUMNS WHERE TABLE_SCHEMA=DATABASE() AND TABLE_NAME=? ORDER BY ORDINAL_POSITION',['mysql108_meta_catalog']);
$empty=legacy108Read($db,'SELECT id,name,qty FROM mysql108_meta_catalog');
$show=legacy108Read($db,'SHOW COLUMNS FROM mysql108_meta_catalog');
$blocks=[legacy108Block('Описание пустой таблицы',['COLUMN_NAME','DATA_TYPE','IS_NULLABLE','COLUMN_KEY'],$rows),legacy108Block('Данные и описание — разные результаты',['Показатель','Количество'],[['Строк данных',(string)count($empty)],['Столбцов по SHOW COLUMNS',(string)count($show)]])];
$checks=['empty'=>$empty===[],'three_columns'=>count($rows)===3,'ordered_names'=>array_column($rows,0)===['id','name','qty'],'show_agrees'=>array_column($show,0)===array_column($rows,0)];
legacy108Report('mysql108-meta-catalog',$blocks,$checks,$observations,$db,[]);
} finally {legacy108Cleanup($db,$other,$created);}
echo "mysql108-meta-catalog: saved result.html and result.json\n";

mysql108-meta-catalog: saved result.html and result.json

Скачать таблицы JSON · Открыть фактический результат · Скачать реальные наблюдения

Попробуйте сами. Добавьте nullable-поле comment VARCHAR(100) и выведите CHARACTER_MAXIMUM_LENGTH. Затем разработайте понятную ошибку импорта, если обязательного qty нет, вместо попытки угадать столбец по позиции.

Различить выбранную базу и список доступных таблиц

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

Исходные данные

Две созданные таблицы

Что получится

Проверка контекста

Только две таблицы этого примера

Малый фрагмент: сначала смысл действия

SELECT DATABASE();
SELECT TABLE_NAME FROM INFORMATION_SCHEMA.TABLES
WHERE TABLE_SCHEMA = DATABASE()
  AND TABLE_NAME IN ('mysql108_meta_listing_a','mysql108_meta_listing_b')
ORDER BY TABLE_NAME;

Это фрагмент внутри показанного сценария: $db — уже установленное соединение; $result — результат соответствующего SELECT. Полный запуск ниже самостоятельно создаёт нужные входные таблицы. Если показан SQL, его выполняет query/execute_query из полной программы.

DATABASE() отвечает на вопрос о текущем контексте конкретного соединения; вне выбранной схемы результат может быть NULL. SCHEMATA содержит доступные сведения о схемах. TABLES описывает таблицы и представления; TABLE_SCHEMA и TABLE_NAME — разные колонки. В примере оба имени таблиц передаются параметрами условия IN, а результат сортируется по имени. Имена базы и таблиц не интерпретируются как номера строк каталога.

SHOW DATABASES и каталог показывают только то, что разрешено видеть текущему аккаунту. Отсутствие имени в списке не доказывает, что схемы физически нет. Для списка конкретного приложения обычно достаточно одной выделенной схемы и фильтра по нужным объектам. mysql_tablename извлекал имя из строки старого списка, а mysql_field_table — происхождение выходного столбца SELECT: это принципиально разные операции.

Ошибки и ограничения

Не публикуйте полный каталог сервера на диагностической странице сайта. Не принимайте первый результат SHOW DATABASES за текущую базу. Одинаковые имена таблиц встречаются в разных схемах; фильтр только по TABLE_NAME недостаточен.

<?php
declare(strict_types=1);
require __DIR__.'/mysql108-metadata-helper.php';
$db=legacy108Connect();$other=null;$created=[];$blocks=[];$checks=[];$observations=[];
try {
legacy108Create($db,$created,'mysql108_meta_listing_a','id INT PRIMARY KEY');
legacy108Create($db,$created,'mysql108_meta_listing_b','id INT PRIMARY KEY');
$current=legacy108Read($db,'SELECT DATABASE()')[0][0];
$visible=legacy108Read($db,'SELECT SCHEMA_NAME FROM INFORMATION_SCHEMA.SCHEMATA WHERE SCHEMA_NAME=DATABASE()');
$tables=legacy108Read($db,'SELECT TABLE_NAME FROM INFORMATION_SCHEMA.TABLES WHERE TABLE_SCHEMA=DATABASE() AND TABLE_NAME IN (?,?) ORDER BY TABLE_NAME',['mysql108_meta_listing_a','mysql108_meta_listing_b']);
$same=$current===getenv('PHPMAN_MYSQL_DATABASE');$available=count($visible)===1&&$visible[0][0]===$current;
$blocks=[legacy108Block('Проверка контекста',['Вопрос','Ответ'],[['DATABASE() совпадает с настройкой',legacy108Yes($same)],['Выбранная схема видна в каталоге',legacy108Yes($available)]]),legacy108Block('Только две таблицы этого примера',['TABLE_NAME'],$tables)];
$checks=['selected_schema'=>$same,'visible_schema'=>$available,'owned_only'=>$tables===[['mysql108_meta_listing_a'],['mysql108_meta_listing_b']]];
$observations=[['Фактическое имя выбранной учебной базы',$current]];
legacy108Report('mysql108-meta-listing',$blocks,$checks,$observations,$db,[]);
} finally {legacy108Cleanup($db,$other,$created);}
echo "mysql108-meta-listing: saved result.html and result.json\n";

mysql108-meta-listing: saved result.html and result.json

Скачать таблицы JSON · Открыть фактический результат · Скачать реальные наблюдения

Попробуйте сами. Измените SQL списка так, чтобы он возвращал только mysql108_meta_listing_b. Проверьте, что DATABASE() не поменялся: фильтрация списка не выбирает другую схему.

Практический вопрос: How to determine which MySQL database has been selected?. Путаются выбранная база, перечень доступных схем и сведения о хосте. Программа проверяет DATABASE() отдельно от каталога. Обсуждение задаёт ситуацию; семантика сверена с PHP/MySQL, программа и её учебные данные написаны отдельно.

Исторические функции: отдельные контракты и путь переноса

Каждая карточка отдельно разбирает параметры, возврат, ограничения, исторический контекст и два случая современного применения. Исторический фрагмент не запускается; запускаемые программы главы используют mysqli.

Следующий шаг: перенести реальный отчёт

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