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

PHP 5 / PHP 7 < 7.4 исторически; отдельный FirebirdSQL interbase 3.0.1 · interbase

fbird_connect(string $database = "", string $username = "", string $password = "", string $charset = "", int $buffers = 0, int $dialect = 0, string $role = "", int $sync = 0): resource|false

Нужен доступ к существующей базе старого приложения, в исходнике которого стоит fbird_connect. Соединение — это ресурс для следующих запросов, а не сами товары. ibase_connect — каноническое имя той же операции. В драйвере FirebirdSQL 3.0.1 fbird_connect зарегистрировано как alias того же C-обработчика; собственного формата ресурсов или отдельного SQL-движка у него нет.

Версии: историческая страница PHP Manual указывает PHP 5 и PHP 7 до 7.4. Старое встроенное расширение удалено из поставки PHP 7.4; в наших примерах эти имена предоставляет отдельный interbase 3.0.1 для PHP 8.2.35. Наличие функции проверяют в том PHP, который исполняет приложение. Это не метод PDO и не рекомендация менять работающий драйвер только ради другого префикса.

Подключить каталог в UTF8

$db = fbird_connect($database, $user, $password, "UTF8", 0, 3);
if ($db === false) { throw new RuntimeException("База недоступна"); }

Так начинается экран наличия. Его результат — две карточки, а не печать ресурса соединения. Неверный путь, недоступный сервер, отказ входа и невозможная кодировка требуют диагностики; сырые сообщения могут раскрывать путь базы. Ошибка преобразования текста может появиться позднее при query/fetch.

Тот же вход для подготовленного импорта

$db = fbird_connect($database, $user, $password, "UTF8", 0, 3);
if ($db === false) { throw new RuntimeException("Импорт не подключён"); }
$query = fbird_prepare($db, $insertSql);

Импорт с именованными полями использует то же соединение и затем отдельную команду. Не проверяйте смену пароля повторным connect в том же процессе: возможен повторно используемый ресурс. Проверка настоящего нового входа и права на таблицы разобраны отдельно. Параметры показаны позиционно, потому что историческая arginfo и фактический C-разбор не во всём совпадают.

• PHP Manual — fbird_connect
• PHP Manual — канонический контракт
• FirebirdSQL 3.0.1 — регистрация alias
• FirebirdSQL 3.0.1 — запросы и результаты

PHP 5 / PHP 7 < 7.4 исторически; отдельный FirebirdSQL interbase 3.0.1 · interbase

fbird_query([resource $dbOrTransaction, [resource $transaction,]] string $sql, mixed ...$values): resource|int|bool

Разовый SELECT нужен, когда SQL выполняется один раз и требуется сразу прочитать результат. Значения можно передать отдельно даже без явного prepare. ibase_query — каноническое имя той же операции. В драйвере FirebirdSQL 3.0.1 fbird_query зарегистрировано как alias того же C-обработчика; собственного формата ресурсов или отдельного SQL-движка у него нет.

Версии: историческая страница PHP Manual указывает PHP 5 и PHP 7 до 7.4. Старое встроенное расширение удалено из поставки PHP 7.4; в наших примерах эти имена предоставляет отдельный interbase 3.0.1 для PHP 8.2.35. Наличие функции проверяют в том PHP, который исполняет приложение. Это не метод PDO и не рекомендация менять работающий драйвер только ради другого префикса.

Данные для экрана

$result = fbird_query($db, 'SELECT title AS "title",qty AS "qty" FROM items WHERE active=? AND qty>=? ORDER BY id ROWS 2', 1, 1);

В экране наличия условия и лимит применяет Firebird. Перед fetch проверьте resource/false. Пустой набор — действующий результат, у которого первый fetch даст false без ошибки.

Убедиться, что импорт сохранился

$result = fbird_query($db, "SELECT id,title,qty FROM items WHERE id BETWEEN ? AND ? ORDER BY id ROWS 3", 100, 102);

В проверке импорта этот SELECT выполняется после commit и выдаёт только 101 и 102. Его ресурс освобождается отдельно. Сама query не является обещанием подтверждения всей бизнес-операции: управляйте транзакцией явно. Исторический специальный режим IBASE_CREATE для CREATE DATABASE также существует в реализации, но не нужен для чтения и не должен принимать произвольную строку пользователя.

• PHP Manual — fbird_query
• PHP Manual — канонический контракт
• FirebirdSQL 3.0.1 — регистрация alias
• FirebirdSQL 3.0.1 — запросы и результаты

PHP 5 / PHP 7 < 7.4 исторически; отдельный FirebirdSQL interbase 3.0.1 · interbase

fbird_prepare(string $sql): resource|false; fbird_prepare(resource $dbOrTransaction, string $sql): resource|false; fbird_prepare(resource $db, resource $transaction, string $sql): resource|false

При одинаковом SQL с меняющимися значениями полезно один раз подготовить команду и затем выполнять её многократно. Подготовка описывает входные места и выходные колонки до чтения строк. ibase_prepare — каноническое имя той же операции. В драйвере FirebirdSQL 3.0.1 fbird_prepare зарегистрировано как alias того же C-обработчика; собственного формата ресурсов или отдельного SQL-движка у него нет.

Версии: историческая страница PHP Manual указывает PHP 5 и PHP 7 до 7.4. Старое встроенное расширение удалено из поставки PHP 7.4; в наших примерах эти имена предоставляет отдельный interbase 3.0.1 для PHP 8.2.35. Наличие функции проверяют в том PHP, который исполняет приложение. Это не метод PDO и не рекомендация менять работающий драйвер только ради другого префикса.

Подготовить диапазон остатков

$query = fbird_prepare($db, "SELECT title,qty FROM items WHERE qty BETWEEN ? AND ? ORDER BY id");
if ($query === false) { throw new RuntimeException("Нельзя подготовить диапазон"); }

Две вкладки используют один query для диапазонов 2…8 и 0…1. Положения 0 и 1 остаются минимумом и максимумом при каждом execute; одинаковый тип INTEGER не выражает этот смысл.

Подготовить строку приёмки товаров

$query = fbird_prepare($db, "INSERT INTO items (id,title,qty) VALUES (?,?,?)");
if ($query === false) { throw new RuntimeException("Нельзя подготовить импорт"); }
$needed = fbird_num_params($query); // 3

В импорте подготовка делается до цикла входных строк. Освободить команду нужно и при отказе последующей проверки: finally охватывает весь её срок жизни. Подготовка сама не сохраняет товар и не возвращает его ID.

• PHP Manual — fbird_prepare
• PHP Manual — канонический контракт
• FirebirdSQL 3.0.1 — регистрация alias
• FirebirdSQL 3.0.1 — запросы и результаты

PHP 5 / PHP 7 < 7.4 исторически; отдельный FirebirdSQL interbase 3.0.1 · interbase

fbird_execute(resource $query, mixed ...$values): resource|int|bool

Когда шаблон уже подготовлен, execute связывает очередные значения с его местами и выполняет команду. ibase_execute — каноническое имя той же операции. В драйвере FirebirdSQL 3.0.1 fbird_execute зарегистрировано как alias того же C-обработчика; собственного формата ресурсов или отдельного SQL-движка у него нет.

Версии: историческая страница PHP Manual указывает PHP 5 и PHP 7 до 7.4. Старое встроенное расширение удалено из поставки PHP 7.4; в наших примерах эти имена предоставляет отдельный interbase 3.0.1 для PHP 8.2.35. Наличие функции проверяют в том PHP, который исполняет приложение. Это не метод PDO и не рекомендация менять работающий драйвер только ради другого префикса.

Переключить вкладку

$result = fbird_execute($query, 2, 8);
// Прочитать/освободить результат.
$result = fbird_execute($query, 0, 1);

Подготовленный фильтр сначала возвращает Кабель и Клемму, затем Ленту с нулевым остатком. Освобождается каждый result; общий query остаётся до окончания второй вкладки.

Сохранить именованные данные в порядке SQL

$values = [$item["id"], $item["title"], $item["qty"]];
$affected = fbird_execute($query, ...$values);
if ($affected === false) { throw new RuntimeException("Товар не сохранён"); }

Это сохранение товаров 101 и 102. На каждом INSERT получено 1. После всех успешных записей отдельно выполнен commit. Если требование — принять пакет целиком, не подтверждайте частичный набор после исключения.

• PHP Manual — fbird_execute
• PHP Manual — канонический контракт
• FirebirdSQL 3.0.1 — регистрация alias
• FirebirdSQL 3.0.1 — запросы и результаты

PHP 5 / PHP 7 < 7.4 исторически; отдельный FirebirdSQL interbase 3.0.1 · interbase

fbird_fetch_assoc(resource $result, int $fetch_flag = 0): array|false

Именованные ключи удобны для карточки страницы: название читается как $row["title"], без зависимости от номера колонки. ibase_fetch_assoc — каноническое имя той же операции. В драйвере FirebirdSQL 3.0.1 fbird_fetch_assoc зарегистрировано как alias того же C-обработчика; собственного формата ресурсов или отдельного SQL-движка у него нет.

Версии: историческая страница PHP Manual указывает PHP 5 и PHP 7 до 7.4. Старое встроенное расширение удалено из поставки PHP 7.4; в наших примерах эти имена предоставляет отдельный interbase 3.0.1 для PHP 8.2.35. Наличие функции проверяют в том PHP, который исполняет приложение. Это не метод PDO и не рекомендация менять работающий драйвер только ради другого префикса.

Вывести первую карточку

$row = fbird_fetch_assoc($result);
if ($row !== false) { echo $row["title"], ": ", $row["qty"]; }

В каталоге первая строка — Кабель: 3. Для всех строк повторяют fetch в цикле, а false разбирают с немедленной диагностикой. Не вставляйте отдельный пробный fetch перед основным циклом.

Различить отсутствующую заметку и пустую

$row = fbird_fetch_assoc($result);
if ($row !== false && array_key_exists("note", $row)) {
    $label = $row["note"] === null ? "не заполнено" : ($row["note"] === "" ? "очищено" : $row["note"]);
}

Одинаковые товары в трёх формах сохраняют note=null у первого и note="" у второго. Повторяющиеся названия колонок перезаписываются последним: используйте разные AS или fetch_row. Alias в двойных кавычках фиксирует регистр ключа.

Флаг IBASE_UNIXTIME нельзя считать обещанием UTC: в закреплённом Windows-драйвере преобразование использует нативное время процесса; отдельный TIME в проверке дал -1. Разбор времён с явной зоной и список флагов разобраны в настройках Firebird. Для больших вложений используйте порционное чтение BLOB, а не автоматическую загрузку всего содержимого. Форму строки выбирают независимо от её экранирования для HTML или правил экспорта CSV.

• PHP Manual — fbird_fetch_assoc
• PHP Manual — канонический контракт
• FirebirdSQL 3.0.1 — регистрация alias
• FirebirdSQL 3.0.1 — запросы и результаты

PHP 5 / PHP 7 < 7.4 исторически; отдельный FirebirdSQL interbase 3.0.1 · interbase

fbird_fetch_row(resource $result, int $fetch_flag = 0): array|false

Числовая строка удобна для фиксированного порядка колонок файла выгрузки. Её индексы идут от нуля в порядке SELECT. ibase_fetch_row — каноническое имя той же операции. В драйвере FirebirdSQL 3.0.1 fbird_fetch_row зарегистрировано как alias того же C-обработчика; собственного формата ресурсов или отдельного SQL-движка у него нет.

Версии: историческая страница PHP Manual указывает PHP 5 и PHP 7 до 7.4. Старое встроенное расширение удалено из поставки PHP 7.4; в наших примерах эти имена предоставляет отдельный interbase 3.0.1 для PHP 8.2.35. Наличие функции проверяют в том PHP, который исполняет приложение. Это не метод PDO и не рекомендация менять работающий драйвер только ради другого префикса.

Прочитать две колонки вкладки

$row = fbird_fetch_row($result);
if ($row !== false) { echo $row[0], ": ", $row[1]; }

В диапазоне остатков SELECT содержит title,qty, поэтому $row[0] — название. Это массив, обращение $row->title к нему неверно. Изменив список SELECT, обновите потребителя.

Получить порядок полей для CSV

$row = fbird_fetch_row($result);
// SELECT title,qty,note: ["Кабель", 0, null].
// Перед fputcsv явно выбрать представление null: например "не заполнено".

Сравнение форм показывает исходные значения для такой выгрузки. Числовые позиции позволяют сохранить два одноимённых поля JOIN; это не даёт им бизнес-названий. Заголовки берут из собственного контракта или field_info, не из попытки прочитать дополнительную строку.

Флаг IBASE_UNIXTIME нельзя считать обещанием UTC: в закреплённом Windows-драйвере преобразование использует нативное время процесса; отдельный TIME в проверке дал -1. Разбор времён с явной зоной и список флагов разобраны в настройках Firebird. Для больших вложений используйте порционное чтение BLOB, а не автоматическую загрузку всего содержимого. Форму строки выбирают независимо от её экранирования для HTML или правил экспорта CSV.

• PHP Manual — fbird_fetch_row
• PHP Manual — канонический контракт
• FirebirdSQL 3.0.1 — регистрация alias
• FirebirdSQL 3.0.1 — запросы и результаты

PHP 5 / PHP 7 < 7.4 исторически; отдельный FirebirdSQL interbase 3.0.1 · interbase

fbird_fetch_object(resource $result, int $fetch_flag = 0): object|false

Если существующий шаблон читает $item->title, следующую строку можно получить объектом с именованными свойствами. ibase_fetch_object — каноническое имя той же операции. В драйвере FirebirdSQL 3.0.1 fbird_fetch_object зарегистрировано как alias того же C-обработчика; собственного формата ресурсов или отдельного SQL-движка у него нет.

Версии: историческая страница PHP Manual указывает PHP 5 и PHP 7 до 7.4. Старое встроенное расширение удалено из поставки PHP 7.4; в наших примерах эти имена предоставляет отдельный interbase 3.0.1 для PHP 8.2.35. Наличие функции проверяют в том PHP, который исполняет приложение. Это не метод PDO и не рекомендация менять работающий драйвер только ради другого префикса.

Карточка старого виджета

$item = fbird_fetch_object($result);
if ($item !== false) { echo $item->title, ": ", $item->qty; }

В трёх формах карточки это Кабель: 0. Для свойства title SQL использует AS "title". Никакой дополнительной бизнес-логики при создании stdClass не исполняется.

Замечание оператора

$item = fbird_fetch_object($result);
if ($item !== false && property_exists($item, "note")) {
    $unsetNote = $item->note === null;
    $clearedNote = $item->note === "";
}

На двух строках видны разные состояния заметки. Одноимённые колонки сталкиваются так же, как у fetch_assoc: последний столбец займёт свойство. Это не ORM: объект не сохраняет изменения обратно в базу при присваивании $item->qty.

Флаг IBASE_UNIXTIME нельзя считать обещанием UTC: в закреплённом Windows-драйвере преобразование использует нативное время процесса; отдельный TIME в проверке дал -1. Разбор времён с явной зоной и список флагов разобраны в настройках Firebird. Для больших вложений используйте порционное чтение BLOB, а не автоматическую загрузку всего содержимого. Форму строки выбирают независимо от её экранирования для HTML или правил экспорта CSV.

• PHP Manual — fbird_fetch_object
• PHP Manual — канонический контракт
• FirebirdSQL 3.0.1 — регистрация alias
• FirebirdSQL 3.0.1 — запросы и результаты

PHP 5 / PHP 7 < 7.4 исторически; отдельный FirebirdSQL interbase 3.0.1 · interbase

fbird_num_fields(resource $result): int

Перед построением таблицы результата полезно узнать, сколько колонок предусмотрено SELECT. Число товаров здесь ни при чём. ibase_num_fields — каноническое имя той же операции. В драйвере FirebirdSQL 3.0.1 fbird_num_fields зарегистрировано как alias того же C-обработчика; собственного формата ресурсов или отдельного SQL-движка у него нет.

Версии: историческая страница PHP Manual указывает PHP 5 и PHP 7 до 7.4. Старое встроенное расширение удалено из поставки PHP 7.4; в наших примерах эти имена предоставляет отдельный interbase 3.0.1 для PHP 8.2.35. Наличие функции проверяют в том PHP, который исполняет приложение. Это не метод PDO и не рекомендация менять работающий драйвер только ради другого префикса.

Создать заголовки экрана

$columns = fbird_num_fields($result);
for ($i=0; $i<$columns; $i++) {
    $info = fbird_field_info($result, $i);
    // Проверить false, использовать alias для заголовка.
}

В каталоге три колонки: id,title,qty. Затем читаются обе строки, включая первую. Заголовки получили из описания, не пожертвовав товаром ради образца.

Проверить формат выгрузки

$columns = fbird_num_fields($result);
if ($columns !== 3) { throw new DomainException("Ожидались title, qty, note"); }

Для числовой формы карточки ожидаются три колонки. Такая проверка выявит добавленный столбец, но не обмен title и note местами: дополните её проверкой alias через field_info. Две строки и три колонки — независимые числа.

• PHP Manual — fbird_num_fields
• PHP Manual — канонический контракт
• FirebirdSQL 3.0.1 — регистрация alias
• FirebirdSQL 3.0.1 — запросы и результаты

PHP 5 / PHP 7 < 7.4 исторически; отдельный FirebirdSQL interbase 3.0.1 · interbase

fbird_field_info(resource $result, int $field_number): array|false

Чтобы подписать или проверить колонки результата, нужно их описание, а не случайные значения первого товара. ibase_field_info — каноническое имя той же операции. В драйвере FirebirdSQL 3.0.1 fbird_field_info зарегистрировано как alias того же C-обработчика; собственного формата ресурсов или отдельного SQL-движка у него нет.

Версии: историческая страница PHP Manual указывает PHP 5 и PHP 7 до 7.4. Старое встроенное расширение удалено из поставки PHP 7.4; в наших примерах эти имена предоставляет отдельный interbase 3.0.1 для PHP 8.2.35. Наличие функции проверяют в том PHP, который исполняет приложение. Это не метод PDO и не рекомендация менять работающий драйвер только ради другого префикса.

Подпись количества

$info = fbird_field_info($result, 2);
if ($info === false) { throw new RuntimeException("Третьей колонки нет"); }
echo $info["alias"]; // qty для SELECT id,title,qty

Это третья колонка экрана наличия. Она читается без перемещения курсора, поэтому первый товар не пропадёт.

Защитить CSV от перестановки столбцов

$expected = ["title", "qty", "note"];
foreach ($expected as $index=>$alias) {
    $info = fbird_field_info($result, $index);
    if ($info === false || $info["alias"] !== $alias) {
        throw new DomainException("Изменился формат выгрузки");
    }
}

Это прикладная проверка SELECT из сценария форм строки. Метаданные не содержат полного набора CHECK/внешних ключей/прав: не генерируйте по ним всю бизнес-форму. Входные места INSERT описывает другая функция — fbird_param_info.

• PHP Manual — fbird_field_info
• PHP Manual — канонический контракт
• FirebirdSQL 3.0.1 — регистрация alias
• FirebirdSQL 3.0.1 — запросы и результаты

PHP 5 / PHP 7 < 7.4 исторически; отдельный FirebirdSQL interbase 3.0.1 · interbase

fbird_num_params(resource $query): int

До execute можно объяснить, сколько значений нужно подготовленному фильтру или импорту. ibase_num_params — каноническое имя той же операции. В драйвере FirebirdSQL 3.0.1 fbird_num_params зарегистрировано как alias того же C-обработчика; собственного формата ресурсов или отдельного SQL-движка у него нет.

Версии: историческая страница PHP Manual указывает PHP 5 и PHP 7 до 7.4. Старое встроенное расширение удалено из поставки PHP 7.4; в наших примерах эти имена предоставляет отдельный interbase 3.0.1 для PHP 8.2.35. Наличие функции проверяют в том PHP, который исполняет приложение. Это не метод PDO и не рекомендация менять работающий драйвер только ради другого префикса.

Две границы вкладки

$needed = fbird_num_params($query);
$values = [2, 8];
if (count($values) !== $needed) { throw new DomainException("Нужны две границы"); }

В диапазоне остатков needed=2. Дополнительно проверяется minimum<=maximum, потому что число мест не обнаруживает перестановку.

Изменившийся импорт

$needed = fbird_num_params($query);
$values = [$item["id"], $item["title"], $item["qty"]];
if (count($values) !== $needed) { throw new DomainException("Список полей не совпал с INSERT"); }

В импорте needed=3. Отсутствие ключа qty проверяется до построения $values; иначе PHP уже сообщит о неизвестном ключе. Имена входных полей сопоставляются с SQL нашим явным списком.

• PHP Manual — fbird_num_params
• PHP Manual — канонический контракт
• FirebirdSQL 3.0.1 — регистрация alias
• FirebirdSQL 3.0.1 — запросы и результаты

PHP 5 / PHP 7 < 7.4 исторически; отдельный FirebirdSQL interbase 3.0.1 · interbase

fbird_param_info(resource $query, int $param_number): array|false

Если prepared-команда ожидает другое представление, описание конкретного входного места поможет локализовать несовпадение до execute. ibase_param_info — каноническое имя той же операции. В драйвере FirebirdSQL 3.0.1 fbird_param_info зарегистрировано как alias того же C-обработчика; собственного формата ресурсов или отдельного SQL-движка у него нет.

Версии: историческая страница PHP Manual указывает PHP 5 и PHP 7 до 7.4. Старое встроенное расширение удалено из поставки PHP 7.4; в наших примерах эти имена предоставляет отдельный interbase 3.0.1 для PHP 8.2.35. Наличие функции проверяют в том PHP, который исполняет приложение. Это не метод PDO и не рекомендация менять работающий драйвер только ради другого префикса.

Объяснить название товара

$info = fbird_param_info($query, 1);
if ($info === false) { throw new RuntimeException("Второго параметра нет"); }
echo $info["type"], " / ", $info["length"]; // VARCHAR / 80

В импорте title объявлен VARCHAR(20) CHARACTER SET UTF8. Дескриптор 80 байт не означает 80 допустимых символов. Название title известно из контракта приложения, а не гарантируется полем name этого массива.

Диагностика обеих границ

$minimum = fbird_param_info($query, 0);
$maximum = fbird_param_info($query, 1);
// После проверки false: оба type равны INTEGER.

В фильтре остатков это одинаковые типы разных по смыслу мест. Полный разбор метаданных и ограничений формы объясняет также DECIMAL: представление NUMERIC(18,2) не восстанавливает буквальный DDL и не заменяет явный CHECK бизнес-лимита.

• PHP Manual — fbird_param_info
• PHP Manual — канонический контракт
• FirebirdSQL 3.0.1 — регистрация alias
• FirebirdSQL 3.0.1 — запросы и результаты

PHP 5 / PHP 7 < 7.4 исторически; отдельный FirebirdSQL interbase 3.0.1 · interbase

fbird_free_query(resource $query): bool

После последнего execute нужно освободить prepared-команду, чтобы следующий этап не держал её ресурсы без необходимости. ibase_free_query — каноническое имя той же операции. В драйвере FirebirdSQL 3.0.1 fbird_free_query зарегистрировано как alias того же C-обработчика; собственного формата ресурсов или отдельного SQL-движка у него нет.

Версии: историческая страница PHP Manual указывает PHP 5 и PHP 7 до 7.4. Старое встроенное расширение удалено из поставки PHP 7.4; в наших примерах эти имена предоставляет отдельный interbase 3.0.1 для PHP 8.2.35. Наличие функции проверяют в том PHP, который исполняет приложение. Это не метод PDO и не рекомендация менять работающий драйвер только ради другого префикса.

Закончить обе вкладки

try {
    // execute первого диапазона → чтение → free_result.
    // execute второго диапазона → чтение → free_result.
} finally {
    $ok = fbird_free_query($query);
    $query = null;
    if ($ok !== true) { throw new RuntimeException("Команда не освобождена"); }
}

В двух вкладках prepare выполняется один раз, а free_query только после обоих результатов. Этот порядок не обещает исправить любую историческую утечку; он явно ограничивает срок жизни ресурсов.

Освободить INSERT перед подтверждением

try {
    // Проверить вход и выполнить INSERT для принятых строк.
} finally {
    fbird_free_query($query);
    $query = null;
}
// Отдельный commit после успешной бизнес-операции.

В импорте после закрытия команды и commit другой SELECT всё ещё видит товары 101 и 102. Полный файл проверяет успешное освобождение; сокращённый фрагмент показывает порядок. При исключении не подменяйте очистку ресурсов подтверждением частично выполненного пакета.

• PHP Manual — fbird_free_query
• PHP Manual — канонический контракт
• FirebirdSQL 3.0.1 — регистрация alias
• FirebirdSQL 3.0.1 — запросы и результаты

PHP 5 / PHP 7 < 7.4 исторически; отдельный FirebirdSQL interbase 3.0.1 · interbase

fbird_free_result(resource $result): bool

Прочитанные строки уже могут лежать в PHP-массиве. Серверный результат SELECT после этого освобождается отдельно. ibase_free_result — каноническое имя той же операции. В драйвере FirebirdSQL 3.0.1 fbird_free_result зарегистрировано как alias того же C-обработчика; собственного формата ресурсов или отдельного SQL-движка у него нет.

Версии: историческая страница PHP Manual указывает PHP 5 и PHP 7 до 7.4. Старое встроенное расширение удалено из поставки PHP 7.4; в наших примерах эти имена предоставляет отдельный interbase 3.0.1 для PHP 8.2.35. Наличие функции проверяют в том PHP, который исполняет приложение. Это не метод PDO и не рекомендация менять работающий драйвер только ради другого префикса.

Сохранить данные страницы, закрыть результат

try {
    $items = aliasRows161($result); // Читает ограниченный SELECT.
} finally {
    $ok = fbird_free_result($result);
    $result = null;
    if ($ok !== true) { throw new RuntimeException("Результат не освобождён"); }
}
// $items по-прежнему содержит прочитанные товары.

Это экран наличия. aliasRows161 — показанная в полном файле обёртка над fetch с немедленной диагностикой, не функция расширения. Массив данных и ресурс результата — разные вещи.

Перейти к следующей форме строки

$result = fbird_execute($query, 1);
// Прочитать в форме assoc.
fbird_free_result($result);
$result = null;
$result = fbird_execute($query, 1);
// Новый результат для формы row начинается с первой строки.

В сравнении форм так прочитаны одинаковые товары, а не последовательно потеряны разные строки одного курсора. Полный файл проверяет все возвраты и закрывает результат в finally. Не оставляйте ссылки на старые ресурсы перед удалением собственной учебной таблицы.

• PHP Manual — fbird_free_result
• PHP Manual — канонический контракт
• FirebirdSQL 3.0.1 — регистрация alias
• FirebirdSQL 3.0.1 — запросы и результаты