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

PHP5 / PHP7 <7.4; далее отдельное расширение. Целевой профиль interbase3.0.1 / PHP8.2. · interbase

fbird_trans(int $trans_args = ?, resource $link_identifier = ?): resource|false

Когда несколько запросов должны составлять одну операцию, сначала создают явную транзакцию и передают её всем частям этой операции. fbird_trans — зарегистрированное расширением альтернативное имя ibase_trans. Ресурсы, правила аргументов и результат у этой пары общие; смена префикса не создаёт другой способ работы с базой.

fbird_trans(): resource|false
fbird_trans(resource $connection): resource|false
fbird_trans(int $flags, resource $connection): resource|false

Страница PHP Manual относит имя к PHP5 и встроенному расширению PHP7 до 7.4. После удаления расширения из комплекта PHP оно устанавливается отдельно; наличие имени нужно проверять в используемой сборке. Здесь целевой профиль PHP8.2.35 / interbase3.0.1 / Firebird5.0.4. В исходнике этой версии PHP_FALIAS связывает два имени с одним обработчиком. Это не ускорение, не миграция на PDO и не изменение версии SQL-сервера.

Все девять флагов краткой официальной страницы перечислены выше; DEFAULT объясняет дополнительный стандартный режим. В Firebird4/5 настройка ReadConsistency влияет на трактовку классических модификаторов COMMITTED: нельзя обещать поведение любой установки только по одной константе. В примерах задан CONCURRENCY, а не проводится тест конкурентной нагрузки.

Применение 1: сохранить согласованный пересчёт

$tx = fbird_trans(IBASE_WRITE | IBASE_CONCURRENCY | IBASE_NOWAIT, $db);
if ($tx === false) { throw new RuntimeException("Пересчёт не начат"); }
// UPDATE обеих выбранных строк получает именно $tx.
// Проверить affected_rows, освободить результаты, затем commit/rollback.

Полный пересчёт подтверждает Cable10 и Clamp14 одной транзакцией. Передача $db вместо $tx незаметно выбрала бы другой, стандартный контекст соединения.

Применение 2: один снимок для составного отчёта

$tx = fbird_trans(IBASE_READ | IBASE_CONCURRENCY | IBASE_NOWAIT, $db);
if ($tx === false) { throw new RuntimeException("Отчёт не начат"); }
// Несколько SELECT отчёта выполняются через $tx.
// Освободить результаты; завершить чтение обычным fbird_commit($tx).

Это контекстный фрагмент: таблицы отчёта зависят от вашей задачи. Даже чтение имеет срок жизни; не оставляйте снимок открытым, пока посетитель рассматривает готовую страницу. Самостоятельный пример показывает отличие сохранённого контекста от окончательного завершения.

Полная форма допускает несколько пар настроек и соединений: fbird_trans($flagsA, $dbA, $flagsB, $dbB). Последняя заданная маска применяется к следующим соединениям до новой маски. Драйвер поддерживает распределённую транзакцию с двухфазным commit; query/prepare тогда должны получить и нужный link, и общий transaction. Это не JOIN таблиц разных баз в одном SELECT. При сбое между фазами возможны limbo-транзакции и административное восстановление; многобазовый вариант здесь является объяснением контракта и не входит в четыре выполненных проекта. Незавершённые явные транзакции в конце скрипта откатываются, но это аварийная граница. В нормальном коде каждый путь заканчивается явно.

• PHP Manual: fbird_trans
• PHP Manual: ibase_trans
• FirebirdSQL: исходник 3.0.1
• Firebird: транзакции

PHP5 / PHP7 <7.4; далее отдельное расширение. Целевой профиль interbase3.0.1 / PHP8.2. · interbase

fbird_commit(resource $link_or_trans_identifier = ?): bool

Согласованную часть операции нужно сохранить. Эта функция окончательно завершает выбранную транзакцию. fbird_commit — зарегистрированное расширением альтернативное имя ibase_commit. Ресурсы, правила аргументов и результат у этой пары общие; смена префикса не создаёт другой способ работы с базой.

fbird_commit(): bool
fbird_commit(resource $connectionOrTransaction): bool

Страница PHP Manual относит имя к PHP5 и встроенному расширению PHP7 до 7.4. После удаления расширения из комплекта PHP оно устанавливается отдельно; наличие имени нужно проверять в используемой сборке. Здесь целевой профиль PHP8.2.35 / interbase3.0.1 / Firebird5.0.4. В исходнике этой версии PHP_FALIAS связывает два имени с одним обработчиком. Это не ускорение, не миграция на PDO и не изменение версии SQL-сервера.

Управляющих флагов нет. В краткой сигнатуре canonical-страницы необязательный ресурс показан со значением null. Парсер interbase3.0.1 ожидает переданный аргумент типа resource: для выбора по умолчанию опустите аргумент, а не подставляйте явный null. Неподходящий или уже освобождённый ресурс может дать предупреждение либо PHP-ошибку; это не новый пустой контекст.

Применение 1: принять исправленные остатки

if (fbird_commit($tx) !== true) {
    $code = fbird_errcode();
    $message = fbird_errmsg();
    throw new RuntimeException("Остатки не подтверждены");
}
$tx = null;

Полный сценарий окончательно сохраняет Cable8 после проверки исправления. Успешный UPDATE до этой строки не заменяет commit; уже прочитанный массив PHP сам не обновляется.

Применение 2: закончить согласованное чтение отчёта

// Все результаты SELECT уже скопированы в PHP и освобождены.
if (fbird_commit($reportTx) !== true) {
    throw new RuntimeException("Чтение отчёта не завершено");
}
$reportTx = null;
// Теперь сформировать HTML из обычных PHP-массивов.

Отчёт с явной READ-транзакцией тоже должен освободить контекст. Это каркас окончания уже выполненного чтения; данные отчёта не удаляются из массивов при завершении транзакции. Пересчёт курсором также освобождает SELECT и подготовку перед окончательным commit.

После успешного завершения обнулите переменную явной транзакции; она больше не подходит для следующего запроса. Функция действует только на выбранную транзакцию, не на все соединения и не на историю ранее подтверждённых операций. Если действие вернуло false, его причина сохраняется до cleanup. Полная модель и условия выбора есть в ibase_commit.

• PHP Manual: fbird_commit
• PHP Manual: ibase_commit
• FirebirdSQL: исходник 3.0.1
• Firebird: транзакции

PHP5 / PHP7 <7.4; далее отдельное расширение. Целевой профиль interbase3.0.1 / PHP8.2. · interbase

fbird_rollback(resource $link_or_trans_identifier = ?): bool

Ошибочный или отменённый пользователем черновик не должен остаться в базе. Эта функция окончательно завершает выбранную транзакцию. fbird_rollback — зарегистрированное расширением альтернативное имя ibase_rollback. Ресурсы, правила аргументов и результат у этой пары общие; смена префикса не создаёт другой способ работы с базой.

fbird_rollback(): bool
fbird_rollback(resource $connectionOrTransaction): bool

Страница PHP Manual относит имя к PHP5 и встроенному расширению PHP7 до 7.4. После удаления расширения из комплекта PHP оно устанавливается отдельно; наличие имени нужно проверять в используемой сборке. Здесь целевой профиль PHP8.2.35 / interbase3.0.1 / Firebird5.0.4. В исходнике этой версии PHP_FALIAS связывает два имени с одним обработчиком. Это не ускорение, не миграция на PDO и не изменение версии SQL-сервера.

Управляющих флагов нет. В краткой сигнатуре canonical-страницы необязательный ресурс показан со значением null. Парсер interbase3.0.1 ожидает переданный аргумент типа resource: для выбора по умолчанию опустите аргумент, а не подставляйте явный null. Неподходящий или уже освобождённый ресурс может дать предупреждение либо PHP-ошибку; это не новый пустой контекст.

Применение 1: отменить отдельную пробную запись

// Пробная запись 100 выполнена через $tx; сохранять её не решили.
if (fbird_rollback($tx) !== true) {
    throw new RuntimeException("Пробная запись не отменена");
}
$tx = null;

Полная последовательность после этого читает ранее подтверждённые8. Rollback не возвращает базу ко времени до предыдущего commit.

Применение 2: отказаться от создания заявки

// INSERT черновой заявки выполнен через $tx.
if (fbird_rollback($tx) !== true) { throw new RuntimeException("Черновик не отменён"); }
$tx = null;
// Выданный ранее fbird_gen_id номер не уменьшайте.

Пример с последовательностью показывает отсутствие строки1 и сохранённый следующий ID2. Откат данных не возвращает выданные номера и не отменяет внешнюю отправку письма/HTTP-запроса.

После успешного завершения обнулите переменную явной транзакции; она больше не подходит для следующего запроса. Функция действует только на выбранную транзакцию, не на все соединения и не на историю ранее подтверждённых операций. Если действие вернуло false, его причина сохраняется до cleanup. Полная модель и условия выбора есть в ibase_rollback.

• PHP Manual: fbird_rollback
• PHP Manual: ibase_rollback
• FirebirdSQL: исходник 3.0.1
• Firebird: транзакции

PHP5 / PHP7 <7.4; далее отдельное расширение. Целевой профиль interbase3.0.1 / PHP8.2. · interbase

fbird_commit_ret(resource $link_or_trans_identifier = ?): bool

Согласованную часть операции нужно сохранить. Эта функция сохраняет транзакционный контекст для продолжения. fbird_commit_ret — зарегистрированное расширением альтернативное имя ibase_commit_ret. Ресурсы, правила аргументов и результат у этой пары общие; смена префикса не создаёт другой способ работы с базой.

fbird_commit_ret(): bool
fbird_commit_ret(resource $connectionOrTransaction): bool

Страница PHP Manual относит имя к PHP5 и встроенному расширению PHP7 до 7.4. После удаления расширения из комплекта PHP оно устанавливается отдельно; наличие имени нужно проверять в используемой сборке. Здесь целевой профиль PHP8.2.35 / interbase3.0.1 / Firebird5.0.4. В исходнике этой версии PHP_FALIAS связывает два имени с одним обработчиком. Это не ускорение, не миграция на PDO и не изменение версии SQL-сервера.

Управляющих флагов нет. В краткой сигнатуре canonical-страницы необязательный ресурс показан со значением null. Парсер interbase3.0.1 ожидает переданный аргумент типа resource: для выбора по умолчанию опустите аргумент, а не подставляйте явный null. Неподходящий или уже освобождённый ресурс может дать предупреждение либо PHP-ошибку; это не новый пустой контекст.

Применение 1: принять проверенную партию

if (fbird_commit_ret($tx) !== true) {
    throw new RuntimeException("Партия не принята");
}
// $tx остаётся активным для следующей короткой части работы.

Проверяемый сценарий принимает7, затем отменяет ошибочные99 через rollback_ret. Подтверждённые7 при этом сохраняются.

Применение 2: продолжить существующую подготовленную операцию

// $update подготовлен в $tx; предыдущая партия проверена.
if (fbird_commit_ret($tx) !== true) { throw new RuntimeException("Партия не сохранена"); }
if (fbird_execute($update, $verifiedQuantity, $productId) === false) {
    $failure = [fbird_errcode(), fbird_errmsg()];
    // Решить об откате текущей части, сохранив причину.
}
// Освободить подготовку и окончательно завершить $tx.

Фрагмент объясняет обслуживание существующего кода с подготовленной командой: retaining не инвалидирует её контекст. Это не дополнительный измеренный MAIN и не обещание ускорения. Обычный commit нужен в конце всей задачи.

Retaining не равен новой независимой транзакции: сохраняются контекст, связанные statements и особенности видимости снимка. Не используйте его как вечный цикл веб-сессии. В конце обязательно обычный commit/rollback. Функция действует только на выбранную транзакцию, не на все соединения и не на историю ранее подтверждённых операций. Если действие вернуло false, его причина сохраняется до cleanup. Полная модель и условия выбора есть в ibase_commit_ret.

• PHP Manual: fbird_commit_ret
• PHP Manual: ibase_commit_ret
• FirebirdSQL: исходник 3.0.1
• Firebird: транзакции

PHP5 / PHP7 <7.4; далее отдельное расширение. Целевой профиль interbase3.0.1 / PHP8.2. · interbase

fbird_rollback_ret(resource $link_or_trans_identifier = ?): bool

Ошибочный или отменённый пользователем черновик не должен остаться в базе. Эта функция сохраняет транзакционный контекст для продолжения. fbird_rollback_ret — зарегистрированное расширением альтернативное имя ibase_rollback_ret. Ресурсы, правила аргументов и результат у этой пары общие; смена префикса не создаёт другой способ работы с базой.

fbird_rollback_ret(): bool
fbird_rollback_ret(resource $connectionOrTransaction): bool

Страница PHP Manual относит имя к PHP5 и встроенному расширению PHP7 до 7.4. После удаления расширения из комплекта PHP оно устанавливается отдельно; наличие имени нужно проверять в используемой сборке. Здесь целевой профиль PHP8.2.35 / interbase3.0.1 / Firebird5.0.4. В исходнике этой версии PHP_FALIAS связывает два имени с одним обработчиком. Это не ускорение, не миграция на PDO и не изменение версии SQL-сервера.

Управляющих флагов нет. В краткой сигнатуре canonical-страницы необязательный ресурс показан со значением null. Парсер interbase3.0.1 ожидает переданный аргумент типа resource: для выбора по умолчанию опустите аргумент, а не подставляйте явный null. Неподходящий или уже освобождённый ресурс может дать предупреждение либо PHP-ошибку; это не новый пустой контекст.

Применение 1: отбросить ошибку после принятой партии

if (fbird_rollback_ret($tx) !== true) {
    throw new RuntimeException("Черновая партия не отменена");
}
// Тот же контекст можно использовать для исправленной партии.

В полном сценарии отменённые99 заменяются подтверждёнными ранее7, затем исправленные8 сохраняются обычным commit. Это не rollback всего прошлого импорта.

Применение 2: повторно использовать подготовку с исправленными данными

// Решение об отмене текущего черновика уже принято приложением.
if (fbird_rollback_ret($tx) !== true) { throw new RuntimeException("Черновик не отменён"); }
if (fbird_execute($preparedUpdate, $correctedQuantity, $id) === false) {
    throw new RuntimeException("Исправление не выполнено");
}
// Затем проверить строки, освободить подготовку и сделать обычный commit/rollback.

Речь о конечной операции с уже проверенным исправлением, а не об автоматическом бесконечном повторе любой ошибки. Retaining сохраняет контекст statements; готовые значения в PHP и текущая серверная позиция курсора — разные вещи.

Retaining не равен новой независимой транзакции: сохраняются контекст, связанные statements и особенности видимости снимка. Не используйте его как вечный цикл веб-сессии. В конце обязательно обычный commit/rollback. Функция действует только на выбранную транзакцию, не на все соединения и не на историю ранее подтверждённых операций. Если действие вернуло false, его причина сохраняется до cleanup. Полная модель и условия выбора есть в ibase_rollback_ret.

• PHP Manual: fbird_rollback_ret
• PHP Manual: ibase_rollback_ret
• FirebirdSQL: исходник 3.0.1
• Firebird: транзакции

PHP5 / PHP7 <7.4; далее отдельное расширение. Целевой профиль interbase3.0.1 / PHP8.2. · interbase

fbird_affected_rows(resource $link_identifier = ?): int|false

Условный UPDATE корректно исполнился, но товар мог не пройти проверку остатка или версии. Счётчик показывает, состоялось ли изменение нужного числа строк. fbird_affected_rows — зарегистрированное расширением альтернативное имя ibase_affected_rows. Ресурсы, правила аргументов и результат у этой пары общие; смена префикса не создаёт другой способ работы с базой.

fbird_affected_rows(): int|false
fbird_affected_rows(resource $connectionOrTransaction): int|false

Страница PHP Manual относит имя к PHP5 и встроенному расширению PHP7 до 7.4. После удаления расширения из комплекта PHP оно устанавливается отдельно; наличие имени нужно проверять в используемой сборке. Здесь целевой профиль PHP8.2.35 / interbase3.0.1 / Firebird5.0.4. В исходнике этой версии PHP_FALIAS связывает два имени с одним обработчиком. Это не ускорение, не миграция на PDO и не изменение версии SQL-сервера.

Canonical-страница кратко указывает int; false дополнен из реального исходника этой версии. Специальных флагов нет. Читайте счётчик сразу после успешной записи, до других SQL-команд и завершения транзакции. При false самого query сначала снимайте ошибку. Это не число строк SELECT, не размер таблицы, не признак commit и не обещание подсчёта всех побочных изменений триггеров.

Применение 1: атомарно зарезервировать остаток

$ok = fbird_query($db, "UPDATE STOCK SET QTY=QTY-? WHERE ID=? AND QTY>=?", 2, 1, 2);
if ($ok === false) { throw new RuntimeException("Запрос резерва не выполнен"); }
$changed = fbird_affected_rows($db);
// 1: резерв выполнен; 0: условие не совпало. Commit проверяется отдельно.

Полная программа показывает1 после запроса двух единиц и0 после запроса четырёх при остатке1. Бизнес-условие проверяет база; не требуется сортировать весь каталог в PHP.

Применение 2: не перезаписать чужое изменение формы

$ok = fbird_query($tx, "UPDATE PRODUCTS SET TITLE=?, VERSION=VERSION+1 WHERE ID=? AND VERSION=?", $title, $id, $seenVersion);
if ($ok === false) { throw new RuntimeException("Сохранение не выполнено"); }
$changed = fbird_affected_rows($tx);
// При 0: сообщить о несовпадении условия, не выдавать ложное «сохранено».

Фрагмент предполагает поле VERSION и выбранную модель конкурентного редактирования. Это не отдельный нагрузочный тест. Ноль также возможен при отсутствии ID; приложение решает, нужно ли уточняющее чтение. Сверка курсором использует строгую проверку1 после каждого изменения текущей строки.

• PHP Manual: fbird_affected_rows
• PHP Manual: ibase_affected_rows
• FirebirdSQL: исходник 3.0.1

PHP5 / PHP7 <7.4; далее отдельное расширение. Целевой профиль interbase3.0.1 / PHP8.2. · interbase

fbird_errcode(): int|false

После неудачного запроса нужно сохранить причину до следующего обращения к драйверу. Числовой SQLCODE помогает различить отказы. fbird_errcode — зарегистрированное расширением альтернативное имя ibase_errcode. Ресурсы, правила аргументов и результат у этой пары общие; смена префикса не создаёт другой способ работы с базой.

fbird_errcode(): int|false

Страница PHP Manual относит имя к PHP5 и встроенному расширению PHP7 до 7.4. После удаления расширения из комплекта PHP оно устанавливается отдельно; наличие имени нужно проверять в используемой сборке. Здесь целевой профиль PHP8.2.35 / interbase3.0.1 / Firebird5.0.4. В исходнике этой версии PHP_FALIAS связывает два имени с одним обработчиком. Это не ускорение, не миграция на PDO и не изменение версии SQL-сервера.

Чтение errcode/errmsg само сохраняет снимок; многие другие функции очищают или заменяют его. Наличие warning также важно: PHP-ошибка параметров не обязана иметь SQL-код. SQLCODE не является SQLSTATE или системным errno. Локальные ошибки модуля могут иметь -999; одно число не описывает все детали причины.

Применение 1: сохранить опечатку запроса

$result = fbird_query($db, "SELECT NOT_A_FIELD FROM PRODUCTS");
if ($result === false) {
    $savedCode = fbird_errcode();
    $savedMessage = fbird_errmsg();
    $hasMessage = is_string($savedMessage) && $savedMessage !== "";
    // Сначала сохранить безопасную диагностику; затем rollback/cleanup.
}

Полный пример сохраняет -206 и признак упоминания поля. После исправленного SELECT текущее состояние уже false, но сохранённая переменная остаётся. Это снимок причины, а не автоматическое исправление SQL.

Применение 2: отличить EOF от сбоя получения строки

$row = fbird_fetch_assoc($result);
if ($row === false) {
    $fetchCode = fbird_errcode();
    $fetchMessage = fbird_errmsg();
    if ($fetchCode !== false || $fetchMessage !== false) {
        throw new RuntimeException("Не удалось прочитать результат");
    }
    // При отсутствии предупреждений это обычный конец выдачи.
}

Это середина цикла уже открытого SELECT. Полные программы дополнительно перехватывают warning, чтобы ошибка PHP не превратилась в безусловный конец списка. Курсорный пример заканчивает обход только при чистом EOF. Соседняя карточка fbird_errmsg объясняет вторую часть снимка.

• PHP Manual: fbird_errcode
• PHP Manual: ibase_errcode
• FirebirdSQL: исходник 3.0.1

PHP5 / PHP7 <7.4; далее отдельное расширение. Целевой профиль interbase3.0.1 / PHP8.2. · interbase

fbird_errmsg(): string|false

После неудачного запроса нужно сохранить причину до следующего обращения к драйверу. Текст помогает разработчику найти конкретное имя поля или нарушенное ограничение. fbird_errmsg — зарегистрированное расширением альтернативное имя ibase_errmsg. Ресурсы, правила аргументов и результат у этой пары общие; смена префикса не создаёт другой способ работы с базой.

fbird_errmsg(): string|false

Страница PHP Manual относит имя к PHP5 и встроенному расширению PHP7 до 7.4. После удаления расширения из комплекта PHP оно устанавливается отдельно; наличие имени нужно проверять в используемой сборке. Здесь целевой профиль PHP8.2.35 / interbase3.0.1 / Firebird5.0.4. В исходнике этой версии PHP_FALIAS связывает два имени с одним обработчиком. Это не ускорение, не миграция на PDO и не изменение версии SQL-сервера.

Чтение errcode/errmsg само сохраняет снимок; многие другие функции очищают или заменяют его. Наличие warning также важно: PHP-ошибка параметров не обязана иметь SQL-код. Сырая строка может содержать путь к базе, SQL и внутренние данные. HTML-экранирование не скрывает эти сведения; не показывайте её посетителю и не сравнивайте целиком как стабильный машинный протокол.

Применение 1: сохранить опечатку запроса

$result = fbird_query($db, "SELECT NOT_A_FIELD FROM PRODUCTS");
if ($result === false) {
    $savedCode = fbird_errcode();
    $savedMessage = fbird_errmsg();
    $hasMessage = is_string($savedMessage) && $savedMessage !== "";
    // Сначала сохранить безопасную диагностику; затем rollback/cleanup.
}

Полный пример сохраняет -206 и признак упоминания поля. После исправленного SELECT текущее состояние уже false, но сохранённая переменная остаётся. Это снимок причины, а не автоматическое исправление SQL.

Применение 2: отличить EOF от сбоя получения строки

$row = fbird_fetch_assoc($result);
if ($row === false) {
    $fetchCode = fbird_errcode();
    $fetchMessage = fbird_errmsg();
    if ($fetchCode !== false || $fetchMessage !== false) {
        throw new RuntimeException("Не удалось прочитать результат");
    }
    // При отсутствии предупреждений это обычный конец выдачи.
}

Это середина цикла уже открытого SELECT. Полные программы дополнительно перехватывают warning, чтобы ошибка PHP не превратилась в безусловный конец списка. Курсорный пример заканчивает обход только при чистом EOF. Соседняя карточка fbird_errcode объясняет вторую часть снимка.

• PHP Manual: fbird_errmsg
• PHP Manual: ibase_errmsg
• FirebirdSQL: исходник 3.0.1

PHP5 / PHP7 <7.4; далее отдельное расширение. Целевой профиль interbase3.0.1 / PHP8.2. · interbase

fbird_close(resource $connection_id = ?): bool

Задача закончила работу с обычным подключением. Сначала явно решают судьбу транзакций и освобождают результаты, затем закрывают соединение. fbird_close — зарегистрированное расширением альтернативное имя ibase_close. Ресурсы, правила аргументов и результат у этой пары общие; смена префикса не создаёт другой способ работы с базой.

fbird_close(): bool
fbird_close(resource $connection): bool

Страница PHP Manual относит имя к PHP5 и встроенному расширению PHP7 до 7.4. После удаления расширения из комплекта PHP оно устанавливается отдельно; наличие имени нужно проверять в используемой сборке. Здесь целевой профиль PHP8.2.35 / interbase3.0.1 / Firebird5.0.4. В исходнике этой версии PHP_FALIAS связывает два имени с одним обработчиком. Это не ускорение, не миграция на PDO и не изменение версии SQL-сервера.

Флагов нет. Для необязательного аргумента в3.0.1 пропустите его, а не передавайте null. Закрытие link не является удалением FDB: для последнего существует отдельный административный API. Результаты и подготовки могут удерживать ссылки, поэтому free_result/free_query и null/unset важны. Не решайте по одному is_resource, что уже освобождённый внутренний объект всё ещё пригоден.

Применение 1: явно сохранить и закончить задачу

if (fbird_commit($db) !== true) { throw new RuntimeException("Изменения не подтверждены"); }
if (fbird_close($db) !== true) { throw new RuntimeException("Соединение не закрыто"); }
$db = null;

Полный проект открывает соединение снова и получает Cable8. Успешный close отдельно от commit делает границу сохранения понятной; чтение после открытия подтверждает предметные данные.

Применение 2: отменить черновик перед закрытием

if (fbird_rollback($tx) !== true) { throw new RuntimeException("Черновик не отменён"); }
$tx = null;
// Подготовки и результаты были освобождены раньше.
if (fbird_close($db) !== true) { throw new RuntimeException("Соединение не закрыто"); }
$db = null;

Это окончание отменённой задачи, подобной черновой заявке. Close не заменяет осмысленный rollback, а ранее сохранённые PHP-массивы после закрытия остаются обычными данными. Действующие ссылки на link могут влиять на его срок жизни; для доказательства независимой аутентификации при смене пароля смотрите отдельные проверки входа.

• PHP Manual: fbird_close
• PHP Manual: ibase_close
• FirebirdSQL: исходник 3.0.1

PHP5 / PHP7 <7.4; далее отдельное расширение. Целевой профиль interbase3.0.1 / PHP8.2. · interbase

fbird_gen_id(string $generator, int $increment = 1, resource $link_identifier = ?): int|string|false

Приложению нужен новый технический ключ до INSERT, например для заявки и её связанных записей. Последовательность выдаёт число, а вставка и подтверждение выполняются отдельно. fbird_gen_id — зарегистрированное расширением альтернативное имя ibase_gen_id. Ресурсы, правила аргументов и результат у этой пары общие; смена префикса не создаёт другой способ работы с базой.

fbird_gen_id(string $generator, int $increment = 1): int|string|false
fbird_gen_id(string $generator, int $increment, resource $connection): int|string|false

Страница PHP Manual относит имя к PHP5 и встроенному расширению PHP7 до 7.4. После удаления расширения из комплекта PHP оно устанавливается отдельно; наличие имени нужно проверять в используемой сборке. Здесь целевой профиль PHP8.2.35 / interbase3.0.1 / Firebird5.0.4. В исходнике этой версии PHP_FALIAS связывает два имени с одним обработчиком. Это не ускорение, не миграция на PDO и не изменение версии SQL-сервера.

Официальная canonical-страница отмечена как неполная и содержит список аргументов и краткий возврат; дополнительные правила взяты из закреплённого исходника и руководства генераторов. Для выбора default-соединения третий аргумент опускают: явный null в3.0.1 не заменяет resource. Функция не создаёт sequence и не делает INSERT. Она использует явный шаг GEN_ID, что не следует безусловно приравнивать к NEXT VALUE FOR с настроенным шагом последовательности.

Применение 1: ID до создания заявки

$id = fbird_gen_id("APPLICATION_ID_SEQ", 1, $db);
if ($id === false) { throw new RuntimeException("ID не выдан"); }
$ok = fbird_query($db, "INSERT INTO APPLICATIONS (ID,TITLE) VALUES (?,?)", $id, $title);
if ($ok === false) { throw new RuntimeException("Заявка не записана"); }
if (fbird_commit($db) !== true) { throw new RuntimeException("Заявка не подтверждена"); }

Фрагмент предполагает существующие таблицу и sequence. Самостоятельный проект создаёт собственные объекты: отменённый ID1 не используется повторно, сохранённая заявка имеет ID2.

Применение 2: посмотреть счётчик без выдачи номера

$current = fbird_gen_id("APPLICATION_ID_SEQ", 0, $db);
if ($current === false) { throw new RuntimeException("Счётчик недоступен"); }
echo "Текущее значение: ", $current;

После нашего примера значение равно2 при одной сохранённой строке. Шаг0 не резервирует будущий ID и не обходит SQL-права. Другой процесс может увеличить счётчик сразу после чтения; для выдачи нужен настоящий шаг1, не $current+1 в PHP.

Последовательности находятся вне rollback пользовательской транзакции. Не уменьшайте значение после ошибки и не ищите ID через MAX+1. PRIMARY KEY по-прежнему нужен; уникальный ключ бизнес-операции защищает от повторного HTTP-запроса отдельно. Технические ID с пропусками и непрерывные номера документов — разные задачи. Не превращайте строковое большое число во float. Альтернативы новой схеме: identity-столбцы и INSERT RETURNING; они не делают простую замену имени fbird_gen_id миграцией на другой API.

• PHP Manual: fbird_gen_id
• PHP Manual: ibase_gen_id
• FirebirdSQL: исходник 3.0.1
• Firebird: генераторы

PHP5 / PHP7 <7.4; далее отдельное расширение. Целевой профиль interbase3.0.1 / PHP8.2. · interbase

fbird_name_result(resource $result, string $name): bool

Старый код обходит изменяемый результат и должен менять именно только что прочитанную строку. Имя курсора связывает SELECT с WHERE CURRENT OF в UPDATE или DELETE. fbird_name_result — зарегистрированное расширением альтернативное имя ibase_name_result. Ресурсы, правила аргументов и результат у этой пары общие; смена префикса не создаёт другой способ работы с базой.

fbird_name_result(resource $result, string $name): bool

Страница PHP Manual относит имя к PHP5 и встроенному расширению PHP7 до 7.4. После удаления расширения из комплекта PHP оно устанавливается отдельно; наличие имени нужно проверять в используемой сборке. Здесь целевой профиль PHP8.2.35 / interbase3.0.1 / Firebird5.0.4. В исходнике этой версии PHP_FALIAS связывает два имени с одним обработчиком. Это не ускорение, не миграция на PDO и не изменение версии SQL-сервера.

Дополнительных флагов нет. SELECT и связанный UPDATE/DELETE должны использовать один подходящий транзакционный контекст. После EOF, освобождения результата или обычного завершения транзакции старую позицию использовать нельзя. Ошибочные PHP-типы/ресурсы дают отдельную ошибку. Отчёт с агрегатом или JOIN не становится изменяемым от назначения имени.

Применение 1: записать подтверждённый остаток

if (fbird_name_result($result, "STOCK_CURSOR") !== true) { throw new RuntimeException("Нет имени курсора"); }
$update = fbird_prepare($tx, "UPDATE PRODUCTS SET QTY=? WHERE CURRENT OF STOCK_CURSOR");
if ($update === false) { throw new RuntimeException("UPDATE не подготовлен"); }
$row = fbird_fetch_row($result);
if ($row !== false && fbird_execute($update, 10) === false) {
    throw new RuntimeException("Текущий товар не изменён");
}

Контекстный фрагмент начинается с уже открытого SELECT в $tx. Полная сверка проверяет каждое affected_rows, освобождает оба ресурса до commit и отдельно читает Cable10 / Clamp14 / Archive9.

Применение 2: удалить текущую проверенную запись очереди

if (fbird_name_result($expiredRows, "EXPIRED_CURSOR") !== true) { throw new RuntimeException("Курсор не назван"); }
$delete = fbird_prepare($tx, "DELETE FROM JOBS WHERE CURRENT OF EXPIRED_CURSOR");
if ($delete === false) { throw new RuntimeException("DELETE не подготовлен"); }
$row = fbird_fetch_row($expiredRows);
if ($row !== false && fbird_execute($delete) === false) {
    throw new RuntimeException("Задание не удалено");
}

Здесь предполагается авторизованная выборка действительно просроченных заданий и готовая таблица JOBS. Это объяснение второго применения, не дополнительный выполненный MAIN. После операций проверяют строки, освобождают подготовку/результат и окончательно завершают транзакцию.

Не накапливайте результат в PHP, чтобы позже обращаться к закрытому курсору. Если известен ID, параметризованный UPDATE/DELETE WHERE ID=? обычно проще; версия записи добавляет контроль конкурирующего изменения. Для массового общего правила рассматривайте один SQL-запрос. FOR UPDATE обозначает изменяемую выборку, но не обещает универсальную блокировку всего набора или отсутствие конфликтов. Храните имя курсора в коде, не принимайте его из запроса посетителя.

• PHP Manual: fbird_name_result
• PHP Manual: ibase_name_result
• FirebirdSQL: исходник 3.0.1
• Firebird: UPDATE