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

Зачем сохранять соединение и чему оно не принадлежит

Каталог получает много коротких обращений: показать товар, обновить остаток, отменить резерв. Если создание соединения дорого, живущий PHP-процесс может использовать его повторно. Но соединение не принадлежит посетителю: прежде чем добавить pconnect, нужно понять, что сохраняется между запросами, что необходимо очистить и что исчезает вместе с процессом.

Можно представить рабочее место оператора: подготовленный канал связи остаётся на его рабочем месте, но сведения о предыдущем клиенте нельзя оставить для следующего. Это только модель времени жизни; она не означает общий канал для всех процессов или сохранение PHP-переменных. Подключение — канал, транзакция — группа изменений, HTTP-запрос — одно обращение клиента.

Перед этим маршрутом полезны первое подключение и SELECT и транзакции с наблюдаемым результатом. Примеры используют небольшой синтетический каталог, а не выгрузку всей рабочей базы.

Как запустить реальные HTTP-примеры

Каждый ZIP запускается одной командой PHP CLI из README. Внешний example.php запускает scenario.php: тот создаёт собственную учебную базу, отправляет запросы настоящему HTTP-процессу на 127.0.0.1, сохраняет ответы, останавливает HTTP-процесс и сам завершается. Только затем отдельный процесс проверяет и удаляет свою базу. Persistent-вызовы находятся именно в HTTP-обработчике; короткий одиночный CLI-запуск не выдаётся за межзапросное повторное использование.

Почему процессы разделены: в Windows принудительная остановка worker не равна штатному завершению PHP и освобождению всех ресурсов драйвера. В проверенной embedded-лаборатории перед удалением завершается весь процесс сценария, а удаление подтверждается отдельно. Это техническая организация запуска примера: рабочую базу сайта не создают и не удаляют на каждый HTTP-запрос. Приватный scenario-handoff.json и журналы остаются в локальном каталоге; для просмотра результата нужны result.html и result.json.

PID и attachment ID не имеют заранее фиксированного числового значения. В таблицах ниже показывается смысл сравнения, а JSON сохраняет фактические номера, HTTP-коды и SHA256 тел ответов. Эти результаты подтверждают конкретное поведение и очистку на стенде; они не являются замером ускорения сервера. HTTP-обработчик допускает только четыре учебных действия и случайный заголовок своего запуска; это не публичный API магазина.

Два участка страницы: один канал к базе, два нужных товара

На странице каталога один блок показывает Cable, другой — Clamp. Оба получают настройки подключения из одного места. Второй вызов pconnect с теми же параметрами не означает обязательное создание второго соединения: проверим идентификатор соединения на стороне самой базы и получим только нужные товары.

Минимальный вызов и его смысл

$db = ibase_pconnect($database, $user, $password, 'UTF8', 0, 3);
if ($db === false) {
    $error = ibase_errmsg();
    throw new RuntimeException('Не удалось подключиться');
}

pconnect — вызов функции; в скобках передаются путь базы, пользователь, пароль, кодировка соединения, число буферов и SQL-диалект. Возвращённый ресурс сохраняется в $db и передаётся запросам. Это служебный идентификатор PHP, а не строка пароля или готовый список товаров. Сравнение === false отделяет отказ подключения от результата.

Что делает HTTP-обработчик

$first = ibase_pconnect($database, $user, $password, 'UTF8', 0, 3);
$second = ibase_pconnect($database, $user, $password, 'UTF8', 0, 3);
// Через каждый ресурс выполнить SELECT CURRENT_CONNECTION FROM RDB$DATABASE.
// Затем SELECT ID, TITLE, QTY FROM LAB_ITEMS WHERE ID = 1 или ID = 2.

Этот фрагмент выделяет изучаемый шаг. Полный http-router.php в ZIP содержит проверку результата, ограничение собственной базы, завершение транзакций и обработку ошибок.

<?php
declare(strict_types=1);
require __DIR__.'/lab.php';
$owned=[];$removed=[];$db=$service=null;$error=null;
$rows=$checks=$observations=$runtime=[];
$transferToken=getenv('PHPMAN_FIREBIRD_SCENARIO_TOKEN');
try {
    $config=f158Config();
    if(!is_string($transferToken)||!preg_match('/^[a-f0-9]{32}$/D',$transferToken))throw new RuntimeException('Запускайте example.php, а не scenario.php напрямую.');
    $service=f158Service();$runtime=f158Runtime($service);

    require __DIR__.'/http-lab.php';

    $database=f158CreateDatabase($service,$owned,'reuse');
    $session=f158HttpSession($database,['same-request']);$reply=$session['responses'][0];$seen=$reply['observed'];
    $same=$reply['attachment_id']===$seen['second_attachment_id'];
    $rows=[['HTTP-запросов',$session['http_requests']],['Два вызова используют одно подключение',$same],
        ['Товар основного блока',$seen['item']['title']],['Его остаток',$seen['item']['qty']],
        ['Товар второго блока',$seen['second_item']['title']],['Его остаток',$seen['second_item']['qty']],
        ['HTTP-процесс остановлен',$session['stopped']]];
    $checks=['one_real_http_request'=>$session['http_requests']===1,'same_attachment'=>$same,
        'first_item'=>$seen['item']===['id'=>1,'title'=>'Cable','qty'=>3],
        'second_item'=>$seen['second_item']===['id'=>2,'title'=>'Clamp','qty'=>0],
        'worker_identity'=>$reply['pid']===$session['worker_pid'],'http_200'=>$session['proof']['statuses']===[200],
        'worker_stopped'=>$session['stopped'],'no_inherited_context'=>$seen['context']===null];
    $observations=['http_session'=>$session,'same_attachment'=>$same,'two_calls_not_two_connections'=>true,
        'single_request_is_not_cross_request_proof'=>true];

}catch(Throwable $caught){$error=['class'=>get_class($caught),'message'=>$caught->getMessage()];}
finally{
    try{
        if(is_resource($db))f158Close($db);
        if(is_resource($service))f158Detach($service);
    }catch(Throwable $cleanupError){$error=$error??['class'=>get_class($cleanupError),'message'=>$cleanupError->getMessage()];}
}
$handoff=['schema'=>'aen-firebird158-private-handoff-v1','ok'=>$error===null,'pid'=>getmypid(),
    'transfer_token'=>$transferToken,'state'=>f158State(),'error'=>$error,
    'result'=>['rows'=>$rows,'checks'=>$checks,'observations'=>$observations,'runtime'=>$runtime,'owned'=>$owned]];
file_put_contents(__DIR__.'/scenario-handoff.json',json_encode($handoff,JSON_PRETTY_PRINT|JSON_UNESCAPED_UNICODE|JSON_THROW_ON_ERROR)."\n",LOCK_EX);
// The process exits before the outer controller starts database cleanup.
exit($error===null?0:1);

Прикладные шаги этого сценария сохранены в scenario.php. Запускается внешний example.php ниже: он дожидается штатного завершения сценария перед отдельным удалением базы.

Видимый результат полного запуска

<?php
declare(strict_types=1);
require __DIR__.'/lab.php';require __DIR__.'/http-lab.php';
// No service/database connection is opened by this outer process.
$result=f158RunScenario();
$owned=$result['owned'];$rows=$result['rows'];$checks=$result['checks'];
$observations=$result['observations'];$runtime=$result['runtime'];
f158HttpDrop($owned[0]['name']);
$removed=f158Cleanup($owned);

f158Report('fb158-pconnect-reuse','Два участка страницы: один канал к базе, два нужных товара',$rows,$checks,$observations,$runtime,$owned,$removed);

HTTP-запросов — 1
Два вызова используют одно подключение — да
Товар основного блока — Cable
Его остаток — 3
Товар второго блока — Clamp
Его остаток — 0
HTTP-процесс остановлен — да

Фактический HTML-результат · Фактические данные JSON.

Ошибки, границы и применение

CURRENT_CONNECTION — идентификатор подключения внутри Firebird, а не номер PHP resource. Два вызова обычного ibase_connect с одинаковыми аргументами в одном запросе тоже могут использовать одно соединение. Поэтому этот первый шаг показывает повторное использование внутри запроса; отличие pconnect между разными запросами проверяется следующим примером. Из того, что соединение существует, не следует, что любой SELECT выполнится успешно.

В историческом вопросе второй вызов подключения приводил к недействительному первому ресурсу при переходе на PHP 7. Исходный вопрос Stack Overflow. Это повод фиксировать версию драйвера и проверять оба реальных чтения, а не выводить из числа PHP-переменных число соединений. Старый дефект не объявляется обязательным поведением interbase 3.0.1.

Проверьте понимание на новой задаче

Два компонента страницы должны независимо читать товары. Нужно ли каждому обязательно открывать отдельное физическое соединение?

Обновить карточку товара вторым HTTP-запросом без нового подключения

Посетитель открыл карточку Cable и нажал «Обновить остаток». Это два HTTP-запроса, каждый выполняет свой SELECT. Проверим, что один обслуживающий процесс PHP использует уже созданное соединение, хотя PHP-переменные предыдущего запроса больше не являются состоянием страницы. Сохранённое соединение не превращает старый остаток в кэш: данные надо запросить снова.

Минимальный вызов и его смысл

$db = ibase_pconnect($database, $user, $password, 'UTF8', 0, 3);
// На каждом запросе снова читаем требуемые данные.
$result = ibase_query($db, 'SELECT TITLE, QTY FROM LAB_ITEMS WHERE ID = 1');

HTTP-запрос — отдельное обращение клиента к обработчику. Worker — процесс PHP, который способен выполнить несколько обращений последовательно. pid сообщает номер этого процесса, CURRENT_CONNECTION — номер соединения с базой. Нужны обе величины: одна и та же строка товара сама по себе не доказывает повторного использования соединения.

Что делает HTTP-обработчик

// Эти сведения добавляются к JSON только в локальной учебной диагностике.
$process = getmypid();
$result = ibase_query($db, 'SELECT CURRENT_CONNECTION AS ID FROM RDB$DATABASE');
$row = ibase_fetch_assoc($result);
$connection = $row['ID'];
ibase_free_result($result);
$result = null;

Этот фрагмент выделяет изучаемый шаг. Полный http-router.php в ZIP содержит проверку результата, ограничение собственной базы, завершение транзакций и обработку ошибок.

<?php
declare(strict_types=1);
require __DIR__.'/lab.php';
$owned=[];$removed=[];$db=$service=null;$error=null;
$rows=$checks=$observations=$runtime=[];
$transferToken=getenv('PHPMAN_FIREBIRD_SCENARIO_TOKEN');
try {
    $config=f158Config();
    if(!is_string($transferToken)||!preg_match('/^[a-f0-9]{32}$/D',$transferToken))throw new RuntimeException('Запускайте example.php, а не scenario.php напрямую.');
    $service=f158Service();$runtime=f158Runtime($service);

    require __DIR__.'/http-lab.php';

    $database=f158CreateDatabase($service,$owned,'requests');
    $session=f158HttpSession($database,['read-item','read-item']);[$first,$second]=$session['responses'];
    $sameWorker=$first['pid']===$second['pid'];$sameConnection=$first['attachment_id']===$second['attachment_id'];
    $rows=[['Отдельных HTTP-запросов',$session['http_requests']],['Запросы обслужил один PHP-процесс',$sameWorker],
        ['Соединение Firebird использовано повторно',$sameConnection],['Первый ответ: товар',$first['observed']['item']['title']],
        ['Первый ответ: остаток',$first['observed']['item']['qty']],['Второй ответ: остаток',$second['observed']['item']['qty']],
        ['HTTP-процесс остановлен',$session['stopped']]];
    $checks=['two_real_http_requests'=>$session['http_requests']===2,'same_worker'=>$sameWorker,'same_attachment'=>$sameConnection,
        'first_response'=>$first['observed']['item']===['id'=>1,'title'=>'Cable','qty'=>3],
        'second_response'=>$second['observed']['item']===['id'=>1,'title'=>'Cable','qty'=>3],
        'both_http_200'=>$session['proof']['statuses']===[200,200],'worker_stopped'=>$session['stopped'],
        'separate_response_bodies'=>count($session['proof']['sha256s'])===2];
    $observations=['http_session'=>$session,'same_worker'=>$sameWorker,'same_attachment'=>$sameConnection,
        'each_response_queries_current_data'=>true,'resource_not_stored_in_browser_session'=>true];

}catch(Throwable $caught){$error=['class'=>get_class($caught),'message'=>$caught->getMessage()];}
finally{
    try{
        if(is_resource($db))f158Close($db);
        if(is_resource($service))f158Detach($service);
    }catch(Throwable $cleanupError){$error=$error??['class'=>get_class($cleanupError),'message'=>$cleanupError->getMessage()];}
}
$handoff=['schema'=>'aen-firebird158-private-handoff-v1','ok'=>$error===null,'pid'=>getmypid(),
    'transfer_token'=>$transferToken,'state'=>f158State(),'error'=>$error,
    'result'=>['rows'=>$rows,'checks'=>$checks,'observations'=>$observations,'runtime'=>$runtime,'owned'=>$owned]];
file_put_contents(__DIR__.'/scenario-handoff.json',json_encode($handoff,JSON_PRETTY_PRINT|JSON_UNESCAPED_UNICODE|JSON_THROW_ON_ERROR)."\n",LOCK_EX);
// The process exits before the outer controller starts database cleanup.
exit($error===null?0:1);

Прикладные шаги этого сценария сохранены в scenario.php. Запускается внешний example.php ниже: он дожидается штатного завершения сценария перед отдельным удалением базы.

Видимый результат полного запуска

<?php
declare(strict_types=1);
require __DIR__.'/lab.php';require __DIR__.'/http-lab.php';
// No service/database connection is opened by this outer process.
$result=f158RunScenario();
$owned=$result['owned'];$rows=$result['rows'];$checks=$result['checks'];
$observations=$result['observations'];$runtime=$result['runtime'];
f158HttpDrop($owned[0]['name']);
$removed=f158Cleanup($owned);

f158Report('fb158-http-reuse','Обновить карточку товара вторым HTTP-запросом без нового подключения',$rows,$checks,$observations,$runtime,$owned,$removed);

Отдельных HTTP-запросов — 2
Запросы обслужил один PHP-процесс — да
Соединение Firebird использовано повторно — да
Первый ответ: товар — Cable
Первый ответ: остаток — 3
Второй ответ: остаток — 3
HTTP-процесс остановлен — да

Фактический HTML-результат · Фактические данные JSON.

Ошибки, границы и применение

В примере HTTP-запросы направлены одному специально запущенному процессу, поэтому сравнение воспроизводимо. На сайте с несколькими workers второй запрос того же посетителя может обслужить другой процесс. Persistent-соединение не закрепляется за браузером и не хранится в $_SESSION. Короткие независимые CLI-запуски завершают свои процессы: один такой запуск не подтверждает межзапросную работу. Лабораторный cli-server здесь проверен фактически; его не предлагают использовать как публичный промышленный сервер.

Автор хотел сохранить соединение Firebird в PHP-сессии и повторно получать его на других страницах. Исходный вопрос Stack Overflow. Вместо переноса resource через $_SESSION показаны повторные HTTP-запросы живому worker и серверный идентификатор соединения. Предположения о чужих высоконагруженных системах из обсуждения здесь не используются.

Проверьте понимание на новой задаче

Почему нельзя сохранить $db в $_SESSION и затем продолжить чтение результата на следующей странице?

Отменить резерв и не передать контекст клиента следующему запросу

В каталоге есть 3 единицы Cable. Покупатель временно резервирует 2, но отменяет заявку до подтверждения. Вернём остаток через rollback и отдельно удалим служебную метку CUSTOMER-A из состояния соединения. Следующий запрос должен увидеть 3 единицы и отсутствие чужой метки, даже если физическое соединение осталось прежним.

Минимальный вызов и его смысл

$tx = ibase_trans(IBASE_WRITE | IBASE_CONCURRENCY | IBASE_NOWAIT, $db);
if ($tx === false) { throw new RuntimeException('Транзакция не началась'); }
ibase_query($tx, 'UPDATE LAB_ITEMS SET QTY=QTY-2 WHERE ID=1 AND QTY>=2');
ibase_rollback($tx);
$tx = null;

Явная транзакция $tx объединяет изменения до commit или rollback; запрос получает именно $tx. Условие QTY>=2 проверяет возможность резерва в самой базе, а affected_rows подтверждает изменение одной строки. Вертикальная черта | объединяет флаги: запись, снимок согласованного состояния и немедленный отказ при конфликте блокировки. Они не означают фиксацию изменения.

Что делает HTTP-обработчик

// Метка привязана к соединению, не к браузеру и не к транзакции.
ibase_query($tx, "SELECT RDB\$SET_CONTEXT('USER_SESSION','CUSTOMER','CUSTOMER-A') FROM RDB\$DATABASE");
// После rollback другая транзакция того же подключения удаляет метку:
ibase_query($cleanupTx, "SELECT RDB\$SET_CONTEXT('USER_SESSION','CUSTOMER',NULL) FROM RDB\$DATABASE");

Этот фрагмент выделяет изучаемый шаг. Полный http-router.php в ZIP содержит проверку результата, ограничение собственной базы, завершение транзакций и обработку ошибок.

<?php
declare(strict_types=1);
require __DIR__.'/lab.php';
$owned=[];$removed=[];$db=$service=null;$error=null;
$rows=$checks=$observations=$runtime=[];
$transferToken=getenv('PHPMAN_FIREBIRD_SCENARIO_TOKEN');
try {
    $config=f158Config();
    if(!is_string($transferToken)||!preg_match('/^[a-f0-9]{32}$/D',$transferToken))throw new RuntimeException('Запускайте example.php, а не scenario.php напрямую.');
    $service=f158Service();$runtime=f158Runtime($service);

    require __DIR__.'/http-lab.php';

    $database=f158CreateDatabase($service,$owned,'cancel');
    $session=f158HttpSession($database,['cancel-reservation','check-clean']);[$cancel,$next]=$session['responses'];
    $seen=$cancel['observed'];$clean=$next['observed'];
    $same=$cancel['attachment_id']===$next['attachment_id'];
    $rows=[['Остаток перед резервом',$seen['qty_before']],['Остаток внутри неподтверждённого резерва',$seen['qty_during']],
        ['Остаток после rollback',$seen['qty_after']],['Контекст соединения после rollback',$seen['context_before_clear']],
        ['Контекст после явной очистки',$seen['context_after_clear']],['Следующий запрос: остаток',$clean['item']['qty']],
        ['Следующий запрос: контекст',$clean['context']],['Соединение осталось тем же',$same],['HTTP-процесс остановлен',$session['stopped']]];
    $checks=['two_real_http_requests'=>$session['http_requests']===2,'expected_reservation_cancelled'=>$seen['cancelled'],
        'reserve_was_visible_inside_transaction'=>$seen['qty_before']===3&&$seen['qty_during']===1,
        'rollback_restored_quantity'=>$seen['qty_after']===3,'session_context_not_transactional'=>$seen['context_before_clear']==='CUSTOMER-A',
        'context_cleared'=>$seen['context_after_clear']===null,'next_request_clean'=>$clean['context']===null&&$clean['item']['qty']===3,
        'same_attachment'=>$same,'both_http_200'=>$session['proof']['statuses']===[200,200],'worker_stopped'=>$session['stopped']];
    $observations=['http_session'=>$session,'explicit_rollback'=>true,'explicit_context_cleanup'=>true,
        'same_attachment'=>$same,'connection_context_is_not_browser_identity'=>true];

}catch(Throwable $caught){$error=['class'=>get_class($caught),'message'=>$caught->getMessage()];}
finally{
    try{
        if(is_resource($db))f158Close($db);
        if(is_resource($service))f158Detach($service);
    }catch(Throwable $cleanupError){$error=$error??['class'=>get_class($cleanupError),'message'=>$cleanupError->getMessage()];}
}
$handoff=['schema'=>'aen-firebird158-private-handoff-v1','ok'=>$error===null,'pid'=>getmypid(),
    'transfer_token'=>$transferToken,'state'=>f158State(),'error'=>$error,
    'result'=>['rows'=>$rows,'checks'=>$checks,'observations'=>$observations,'runtime'=>$runtime,'owned'=>$owned]];
file_put_contents(__DIR__.'/scenario-handoff.json',json_encode($handoff,JSON_PRETTY_PRINT|JSON_UNESCAPED_UNICODE|JSON_THROW_ON_ERROR)."\n",LOCK_EX);
// The process exits before the outer controller starts database cleanup.
exit($error===null?0:1);

Прикладные шаги этого сценария сохранены в scenario.php. Запускается внешний example.php ниже: он дожидается штатного завершения сценария перед отдельным удалением базы.

Видимый результат полного запуска

<?php
declare(strict_types=1);
require __DIR__.'/lab.php';require __DIR__.'/http-lab.php';
// No service/database connection is opened by this outer process.
$result=f158RunScenario();
$owned=$result['owned'];$rows=$result['rows'];$checks=$result['checks'];
$observations=$result['observations'];$runtime=$result['runtime'];
f158HttpDrop($owned[0]['name']);
$removed=f158Cleanup($owned);

f158Report('fb158-session-cleanup','Отменить резерв и не передать контекст клиента следующему запросу',$rows,$checks,$observations,$runtime,$owned,$removed);

Остаток перед резервом — 3
Остаток внутри неподтверждённого резерва — 1
Остаток после rollback — 3
Контекст соединения после rollback — CUSTOMER-A
Контекст после явной очистки — null
Следующий запрос: остаток — 3
Следующий запрос: контекст — null
Соединение осталось тем же — да
HTTP-процесс остановлен — да

Фактический HTML-результат · Фактические данные JSON.

Ошибки, границы и применение

USER_SESSION — пространство переменных подключения Firebird. Оно не равно PHP $_SESSION; откат транзакции не обязан удалять эти значения. Полный HTTP-обработчик использует finally для rollback и удаления метки, в том числе при исключении. Если очистка не завершилась, ответ не выдаётся за успешный. Драйвер 3.0.1 при завершении ресурса запроса подтверждает оставшуюся неявную транзакцию, а остальные отменяет; полагаться на это вместо явного решения о покупке нельзя. Нельзя растягивать бизнес-транзакцию на несколько HTTP-запросов.

Проверьте понимание на новой задаче

После отмены заявки остаток восстановился, но следующая заявка получила метку предыдущего клиента. Почему одного rollback недостаточно?

Перезапустить обработчик: данные остаются, постоянное соединение создаётся заново

После обновления PHP или перезапуска обработчика соединение к базе не переносится в новый процесс. Каталог при этом остаётся в файле базы. Покажем границу явно: первый HTTP-процесс читает Cable и завершается, второй процесс с теми же настройками снова читает Cable, но получает другой идентификатор соединения.

Минимальный вызов и его смысл

$db = ibase_pconnect($database, $user, $password, 'UTF8', 0, 3);
// Этот вызов ищет соединение в текущем процессе PHP.
// Запуск другого процесса не переносит сюда старый resource.

«Постоянное» означает возможность пережить отдельный запрос в живущем процессе, а не вечное соединение. В полном примере контроллер запускает два процесса последовательно и сохраняет их реальные PID, ответы и идентификаторы Firebird. Число PID не является вечным уникальным именем: ОС может использовать номер снова, поэтому проверка опирается также на подтверждённую остановку и новый attachment.

Что делает HTTP-обработчик

// Одинаковый код выполняется в каждом из двух процессов отдельно.
$result = ibase_query($db, 'SELECT CURRENT_CONNECTION AS ID FROM RDB$DATABASE');
$attachment = ibase_fetch_assoc($result)['ID'];
ibase_free_result($result);
$result = null;

Этот фрагмент выделяет изучаемый шаг. Полный http-router.php в ZIP содержит проверку результата, ограничение собственной базы, завершение транзакций и обработку ошибок.

<?php
declare(strict_types=1);
require __DIR__.'/lab.php';
$owned=[];$removed=[];$db=$service=null;$error=null;
$rows=$checks=$observations=$runtime=[];
$transferToken=getenv('PHPMAN_FIREBIRD_SCENARIO_TOKEN');
try {
    $config=f158Config();
    if(!is_string($transferToken)||!preg_match('/^[a-f0-9]{32}$/D',$transferToken))throw new RuntimeException('Запускайте example.php, а не scenario.php напрямую.');
    $service=f158Service();$runtime=f158Runtime($service);

    require __DIR__.'/http-lab.php';

    $database=f158CreateDatabase($service,$owned,'workers');
    $firstSession=f158HttpSession($database,['read-item']);
    $secondSession=f158HttpSession($database,['read-item']);
    $first=$firstSession['responses'][0];$second=$secondSession['responses'][0];
    $changed=$first['attachment_id']!==$second['attachment_id'];
    $sameData=$first['observed']['item']===$second['observed']['item'];
    $rows=[['Последовательно запущено HTTP-процессов',2],['Первый процесс остановлен до второго',$firstSession['stopped']],
        ['Новое подключение Firebird получило другой ID',$changed],['Данные товара сохранились',$sameData],
        ['Товар после перезапуска',$second['observed']['item']['title']],['Остаток после перезапуска',$second['observed']['item']['qty']],
        ['Второй HTTP-процесс остановлен',$secondSession['stopped']]];
    $checks=['first_worker_stopped'=>$firstSession['stopped'],'second_worker_stopped'=>$secondSession['stopped'],
        'one_request_each'=>$firstSession['http_requests']===1&&$secondSession['http_requests']===1,
        'new_attachment'=>$changed,'persistent_data_survived'=>$sameData&&$second['observed']['item']===['id'=>1,'title'=>'Cable','qty'=>3],
        'fresh_connection_context'=>$second['observed']['context']===null,
        'both_http_200'=>$firstSession['proof']['statuses']===[200]&&$secondSession['proof']['statuses']===[200]];
    $observations=['http_sessions'=>[$firstSession,$secondSession],'new_attachment'=>$changed,
        'processes_were_sequential'=>true,'pid_numbers_are_observations_not_permanent_identity'=>true,
        'database_file_kept_until_both_workers_stopped'=>true];

}catch(Throwable $caught){$error=['class'=>get_class($caught),'message'=>$caught->getMessage()];}
finally{
    try{
        if(is_resource($db))f158Close($db);
        if(is_resource($service))f158Detach($service);
    }catch(Throwable $cleanupError){$error=$error??['class'=>get_class($cleanupError),'message'=>$cleanupError->getMessage()];}
}
$handoff=['schema'=>'aen-firebird158-private-handoff-v1','ok'=>$error===null,'pid'=>getmypid(),
    'transfer_token'=>$transferToken,'state'=>f158State(),'error'=>$error,
    'result'=>['rows'=>$rows,'checks'=>$checks,'observations'=>$observations,'runtime'=>$runtime,'owned'=>$owned]];
file_put_contents(__DIR__.'/scenario-handoff.json',json_encode($handoff,JSON_PRETTY_PRINT|JSON_UNESCAPED_UNICODE|JSON_THROW_ON_ERROR)."\n",LOCK_EX);
// The process exits before the outer controller starts database cleanup.
exit($error===null?0:1);

Прикладные шаги этого сценария сохранены в scenario.php. Запускается внешний example.php ниже: он дожидается штатного завершения сценария перед отдельным удалением базы.

Видимый результат полного запуска

<?php
declare(strict_types=1);
require __DIR__.'/lab.php';require __DIR__.'/http-lab.php';
// No service/database connection is opened by this outer process.
$result=f158RunScenario();
$owned=$result['owned'];$rows=$result['rows'];$checks=$result['checks'];
$observations=$result['observations'];$runtime=$result['runtime'];
f158HttpDrop($owned[0]['name']);
$removed=f158Cleanup($owned);

f158Report('fb158-worker-boundary','Перезапустить обработчик: данные остаются, постоянное соединение создаётся заново',$rows,$checks,$observations,$runtime,$owned,$removed);

Последовательно запущено HTTP-процессов — 2
Первый процесс остановлен до второго — да
Новое подключение Firebird получило другой ID — да
Данные товара сохранились — да
Товар после перезапуска — Cable
Остаток после перезапуска — 3
Второй HTTP-процесс остановлен — да

Фактический HTML-результат · Фактические данные JSON.

Ошибки, границы и применение

Несколько работников PHP обычно держат отдельные наборы постоянных подключений; посетители не получают персональный канал по номеру своей сессии. Чем больше процессов и различных наборов параметров, тем больше потенциально открытых соединений. Здесь не измеряется скорость: выгоду надо оценивать на своей нагрузке, отдельно от времени SQL и передачи данных. Временно недоступную базу pconnect не делает доступной; false и диагностику всё равно проверяют.

Разработчик сравнивал удаление переменной через unset с закрытием соединения через ibase_close. Исходный вопрос Stack Overflow. Разделяем PHP-ссылку, ресурс текущего запроса, физическое соединение и завершение транзакции. Для persistent-варианта окончание процесса показано отдельно; неизвестный эффект очистки не подменяется советом выбрать «более быстрый unset».

Проверьте понимание на новой задаче

После перезапуска worker ID подключения изменился, но данные совпадают. Это означает потерю persistent-механизма?

Карточка функции и следующий шаг

ibase_pconnect: все параметры, результаты и ограничения

Соединение остаётся готовым к следующим запросам, но изменения в базе ещё нужно обнаруживать. В главе о событиях Firebird рассмотрим сигнал о подтверждённом изменении и новый SELECT после него. Persistent-соединение само по себе не подписывает приложение на обновления и не превращает событие в надёжную очередь.