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

Исторически PHP 5 / PHP 7 до 7.4; затем внешнее interbase. Профиль:3.0.1 / PHP 8.2.35 / Firebird 5.0.4. · interbase

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

Короткие запросы каталога могут обращаться к базе многократно. fbird_pconnect позволяет процессу PHP повторно использовать своё подключение с теми же настройками. При этом остаток товара всё равно надо читать SQL: программа выше показывает переход Cable 3→7 без смены attachment. Польза — возможность сократить повторную установку канала; ускорение конкретного сайта не обещается без измерения.

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

Сигнатура показывает порядок аргументов реализации 3.0.1; это справочная запись, её не вставляют как готовый вызов. Все параметры допускают пропуск. Пустые database, username, password, charset дополняются соответствующими ini-настройками, если они заданы. Скобки вызова не создают пользовательскую функцию; возвращённый resource присваивается переменной слева.

Применение 1: новый HTTP-запрос получает новый остаток

$db = fbird_pconnect($database, $user, $password, 'UTF8', 0, 3);
if ($db === false) { throw new RuntimeException('База недоступна'); }
$tx = fbird_trans(IBASE_READ | IBASE_COMMITTED, $db);
if ($tx === false) { throw new RuntimeException('Чтение не началось'); }
// SELECT выбранных полей; затем освобождение результата и fbird_commit($tx).

В полном HTTP-проекте есть два настоящих ответа, SQL-чтение attachment ID и изменение между ними. Транзакция чтения заканчивается до ответа. Повторное использование подключения не сохраняет старый PHP-массив и не освобождает от контроля согласованности данных.

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

$reader = fbird_pconnect($database, $user, $password, 'UTF8', 0, 3, 'LAB_READER');
if ($reader === false) { throw new RuntimeException('Читатель не подключён'); }
$result = fbird_query($reader, 'SELECT TITLE, QTY FROM LAB_ITEMS WHERE ID = ?', $id);
// Проверить результат, прочитать одну карточку и закончить транзакцию.

Это контекстный вариант для уже созданной роли, не ещё один исполненный проект. Параметры подключения участвуют в выборе повторно используемого соединения; роль нельзя считать изменяемой меткой посетителя поверх случайно взятого attachment. Разбор выдачи прав и явного выбора роли есть в практике ролей, а создание отдельных учётных записей — в администрировании fbird_*.

Системные INI-настройки задают до запуска worker. Ускорение зависит от стоимости подключения, объёма запросов и числа процессов; один только переход на alias не меняет производительность. Если база недоступна, права недостаточны или кодировка не подходит, сохранённый канал не исправляет причину. Для простой короткой задачи подходит fbird_connect. Диагностика разобрана в fbird_errcode и fbird_errmsg.

fbird_pconnect — alias ibase_pconnect: тот же обработчик расширения, а не второй механизм или более быстрый протокол. Историческая метка PHP 5 / PHP 7 ниже 7.4 описывает прежнюю поставку interbase. Здесь используется внешнее interbase 3.0.1, PHP 8.2.35 NTS x64 и Firebird 5.0.4 через отдельный TCP-сервер. Версии в README записаны явно. Эти функции не появляются автоматически при установке PDO_FIREBIRD и не мигрируют приложение на PDO.

• PHP Manual: fbird_pconnect
• PHP Manual: ibase_pconnect
• FirebirdSQL 3.0.1: подключение и очистка
• FirebirdSQL 3.0.1: регистрация и доставка событий
• Firebird 5: POST_EVENT
• Firebird: свойства доставки событий

Исторически PHP 5 / PHP 7 до 7.4; затем внешнее interbase. Профиль:3.0.1 / PHP 8.2.35 / Firebird 5.0.4. · interbase

fbird_wait_event([resource $connection,] string $event_name, string ...$event_names): string|false

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

fbird_wait_event(string $event_name, string ...$event_names): string|false
fbird_wait_event(resource $connection, string $event_name, string ...$event_names): string|false

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

$name = fbird_wait_event($db, 'FB164_CHANGED');
if ($name === false) { throw new RuntimeException('Нет корректного события'); }
$result = fbird_query($db, 'SELECT TITLE, QTY FROM LAB_ITEMS WHERE ID = ?', 1);

Полный ограниченный запуск listener/sender покажет Cable 11, а не только строку FB164_CHANGED. SELECT не извлекает ID из сигнала: нужный товар уже выбран экраном. Результат SELECT освобождается, транзакция заканчивается; затем можно решить, нужен ли ещё один цикл ожидания.

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

$name = fbird_wait_event($db, 'STOCK_CHANGED', 'PRICE_CHANGED');
if ($name === false) { throw new RuntimeException('Ожидание не удалось'); }
$result = fbird_query($db, 'SELECT TITLE, QTY, PRICE_CENTS FROM GOODS WHERE ID = ?', $id);

Это вариант для приложения, у которого уже есть GOODS и нужный ID. Любое из двух имён означает, что представление стоит перечитать. Если вернулось STOCK_CHANGED, нельзя заключать, что PRICE_CHANGED за это время не происходило: функция возвращает одно имя. Драйвер 3.0.1 выбирает первое подходящее имя из своего буфера. Для полного журнала изменений нужна отдельная сохраняемая модель.

Перед долгим ожиданием завершите старую snapshot-транзакцию. После сигнала прочитайте данные в новой подходящей транзакции: уведомление не обновляет прежний снимок автоматически. Сигналы поступают после commit, при rollback эта транзакция не публикует подтверждённое изменение. События отключённому клиенту не превращаются в долговечный почтовый ящик. Для браузера нужен ещё прикладной транспорт HTTP/SSE/WebSocket; wait_event сам не меняет HTML.

В нашем TCP-стенде основной порт и вспомогательное соединение событий ограничены loopback. Если SQL работает, а события не приходят, отдельно проверяют сетевой путь events и настройки сервера; успешный SELECT не проверяет доставку callback. Для нескольких одновременно ожидаемых задач обычно нужен отдельный worker либо подходящий событийный клиент. Альтернатива с сохранённым handle — fbird_set_event_handler, отмена его регистрации — fbird_free_event_handler.

fbird_wait_event — alias ibase_wait_event: тот же обработчик расширения, а не второй механизм или более быстрый протокол. Историческая метка PHP 5 / PHP 7 ниже 7.4 описывает прежнюю поставку interbase. Здесь используется внешнее interbase 3.0.1, PHP 8.2.35 NTS x64 и Firebird 5.0.4 через отдельный TCP-сервер. Версии в README записаны явно. Эти функции не появляются автоматически при установке PDO_FIREBIRD и не мигрируют приложение на PDO.

• PHP Manual: fbird_wait_event
• PHP Manual: ibase_wait_event
• FirebirdSQL 3.0.1: подключение и очистка
• FirebirdSQL 3.0.1: регистрация и доставка событий
• Firebird 5: POST_EVENT
• Firebird: свойства доставки событий

Исторически PHP 5 / PHP 7 до 7.4; затем внешнее interbase. Профиль:3.0.1 / PHP 8.2.35 / Firebird 5.0.4. · interbase

fbird_set_event_handler([resource $connection,] callable $callback, string $event, string ...$events): resource|false

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

fbird_set_event_handler(callable $callback, string $event, string ...$events): resource|false
fbird_set_event_handler(resource $connection, callable $callback, string $event, string ...$events): resource|false

Граница документации и реализации важна: PHP Manual обещает до 15 имён. В C-коде 3.0.1 цикл заполнения использует абсолютный индекс аргумента i<15 вместо количества событий: при явном connection рассматривается не более 13 имён, без него 14. Это обнаружено чтением исходника, а не отдельным runtime-прогоном больших списков. Проекты используют одно имя; для другого числа не полагайтесь на непроверенную границу. Документированный максимум сохранён здесь явно вместе с ограничением конкретной версии.

Применение 1: обновление после commit

function requestRefresh($eventName, $connection) {
    $GLOBALS['refreshNeeded'] = true;
    return true;
}
$handler = fbird_set_event_handler($db, 'requestRefresh', 'FB164_CHANGED');
if ($handler === false) { throw new RuntimeException('Регистрация не удалась'); }

Полный проект с отменой 99 и сохранением 7 выполняет реальную запись во втором процессе. Callback не получает значение 7 и не выполняет тяжёлую работу; основной код позже делает SELECT. Это упрощает владение ресурсами и отделяет механизм доставки от бизнес-логики.

Применение 2: одноразовый сигнал о готовности отчёта

function reportReady($name, $connection) {
    $GLOBALS['reportNeedsRead'] = true;
    return false; // Следующее уведомление этой регистрации уже не нужно.
}
$handler = fbird_set_event_handler($db, 'reportReady', 'REPORT_READY');
if ($handler === false) { throw new RuntimeException('Не удалось ждать отчёт'); }
// Основной код по флагу читает сохранённый отчёт; затем освобождает handler.

Контекстный вариант предполагает, что генератор уже сохраняет отчёт в базе и публикует имя после commit. return false — политика подписки, а не подтверждение успешного чтения отчёта. Сохранённый handle освобождают отдельно; пример такого порядка — отмена регистрации с последующим чтением 11.

В callback передаются только имя и соединение. Внутренний Firebird counter не раскрыт этим PHP API; полезные строки, ID заказа и количество изменённых записей не передаются. Реализация 3.0.1 берёт первое подходящее имя из буфера, а группировка доставки не гарантирует один callback на строку/commit. Поэтому обработчик не должен считать вызовы как проданные товары. Сохраняемый outbox или журнал имеют собственные строки и статусы; уведомление может только разбудить их читателя.

Событие принадлежит соединению и процессу, в котором зарегистрировано. Не передавайте resource через HTTP или сериализацию. Не закрывайте connection раньше handler; не используйте callback как способ бесконечно удержать короткий web request. Для блокирующего одного шага есть fbird_wait_event, для контролируемого завершения — fbird_free_event_handler.

fbird_set_event_handler — alias ibase_set_event_handler: тот же обработчик расширения, а не второй механизм или более быстрый протокол. Историческая метка PHP 5 / PHP 7 ниже 7.4 описывает прежнюю поставку interbase. Здесь используется внешнее interbase 3.0.1, PHP 8.2.35 NTS x64 и Firebird 5.0.4 через отдельный TCP-сервер. Версии в README записаны явно. Эти функции не появляются автоматически при установке PDO_FIREBIRD и не мигрируют приложение на PDO.

• PHP Manual: fbird_set_event_handler
• PHP Manual: ibase_set_event_handler
• FirebirdSQL 3.0.1: подключение и очистка
• FirebirdSQL 3.0.1: регистрация и доставка событий
• Firebird 5: POST_EVENT
• Firebird: свойства доставки событий

Исторически PHP 5 / PHP 7 до 7.4; затем внешнее interbase. Профиль:3.0.1 / PHP 8.2.35 / Firebird 5.0.4. · interbase

fbird_free_event_handler(resource $event): bool

Когда экран или worker больше не следит за изменениями, принадлежащую ему подписку надо закончить. fbird_free_event_handler освобождает регистрацию. Данные Firebird, открытое соединение и уже выполненный commit имеют другие сроки жизни: в проекте после освобождения подписки товар всё равно получает остаток 11.

fbird_free_event_handler(resource $event): bool

Применение 1: завершить временное наблюдение

if (fbird_free_event_handler($handler) !== true) {
    throw new RuntimeException('Подписка не завершена');
}
$handler = null;
$result = fbird_query($db, 'SELECT TITLE, QTY FROM LAB_ITEMS WHERE ID = ?', 1);

В полном двухпроцессном проекте поздний SELECT показывает 11, а счётчик callback не увеличивается после free. Это видимое различие отмены регистрации и отката транзакции. Прочитанный SQL-результат затем освобождают своей функцией, не free_event_handler.

Применение 2: гарантировать один путь освобождения при ошибке приложения

$handler = fbird_set_event_handler($db, 'requestRefresh', 'STOCK_CHANGED');
if ($handler === false) { throw new RuntimeException('Нет подписки'); }
try {
    // Ограниченная работа с флагом requestRefresh и свежими SQL-данными.
} finally {
    if (fbird_free_event_handler($handler) !== true) {
        throw new RuntimeException('Ресурс подписки не освобождён');
    }
    $handler = null;
}

Это каркас владения: requestRefresh объявляется заранее, работа имеет внешний срок, а единственный finally знает, кто отвечает за handler. В более крупном приложении ошибку очистки логируют так, чтобы сохранить и первоначальную причину. Не добавляйте второй free в callback или соседнем участке кода. Если callback вернул false, сохранённая PHP-ссылка всё ещё требует контролируемого завершения.

В закреплённом native-коде нельзя считать is_resource доказательством, что ранее освобождённый handle снова пригоден. Повторный free или закрытие связи в неправильном порядке опаснее обычной логической ошибки. Присваивание null и явный единственный владелец предотвращают такой путь. Для отмены SQL нужен fbird_rollback, для соединения — fbird_close, для регистрации новой подписки — fbird_set_event_handler.

fbird_free_event_handler — alias ibase_free_event_handler: тот же обработчик расширения, а не второй механизм или более быстрый протокол. Историческая метка PHP 5 / PHP 7 ниже 7.4 описывает прежнюю поставку interbase. Здесь используется внешнее interbase 3.0.1, PHP 8.2.35 NTS x64 и Firebird 5.0.4 через отдельный TCP-сервер. Версии в README записаны явно. Эти функции не появляются автоматически при установке PDO_FIREBIRD и не мигрируют приложение на PDO.

• PHP Manual: fbird_free_event_handler
• PHP Manual: ibase_free_event_handler
• FirebirdSQL 3.0.1: подключение и очистка
• FirebirdSQL 3.0.1: регистрация и доставка событий
• Firebird 5: POST_EVENT
• Firebird: свойства доставки событий