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

<?php
declare(strict_types=1);
require __DIR__.'/lab.php';
$owned=[];$removed=[];$db=$service=null;
try {
    $config=f163Config();$service=f163Service();$runtime=f163Runtime($service);

    function reportText163(&$service,string $database,int $action,int $argument=0): string {
        $call=f163Capture(static fn()=>fbird_db_info($service,$database,$action,$argument));
        if(!is_string($call['value']) || $call['warning'] || $call['code']!==0) {
            if($call['value']===false) {$service=null;}
            f163Failure('Статистический текст не получен',$call);
        }
        return $call['value'];
    }
    function reportField163(string $report,string $pattern): string {
        if(preg_match($pattern,$report,$match)!==1) {
            throw new RuntimeException('Ожидаемое поле отсутствует в служебном отчёте.');
        }
        return $match[1];
    }
    function header163(&$service,string $database): array {
        $report=reportText163($service,$database,IBASE_STS_HDR_PAGES);
        return ['page_size'=>(int)reportField163($report,'/\bPage size\s+(\d+)\b/'),
            'ods'=>reportField163($report,'/\bODS version\s+(\d+\.\d+)\b/'),
            'dialect'=>(int)reportField163($report,'/\bDatabase dialect\s+(\d+)\b/')];
    }

    $database=f163CreateDatabase($service,$owned,'support');
    $db=f163Connect($database);
    f163Command($db,'UPDATE LAB_ITEMS SET TITLE=?,QTY=? WHERE ID=?',['Cable USB',12,1]);
    f163Command($db,'UPDATE LAB_ITEMS SET TITLE=?,QTY=? WHERE ID=?',['Fuse 10A',0,2]);
    f163Commit($db);
    $items=f163Read($db,'SELECT ID AS "id",TITLE AS "title",QTY AS "qty" FROM LAB_ITEMS WHERE ID IN (?,?) ORDER BY ID ROWS 2',[1,2]);
    f163Close($db);
    $header=header163($service,$database);
    $serviceClosed=f163Detach($service);
    $summary='Сервис отвечает; Fuse 10A отсутствует на складе';
    $rows=[['Заявка','SUPPORT-163'],['Маршрут приложения','main-catalog'],['Версия экземпляра',$runtime['server_version']],
        ['Формат файла ODS',$header['ods']],['SQL-диалект',$header['dialect']],['Проверено товарных строк',count($items)],
        ['Остаток Cable USB',$items[0]['qty']],['Остаток Fuse 10A',$items[1]['qty']],['Вывод для поддержки',$summary],
        ['Сервисное соединение освобождено',$serviceClosed && $service===null]];
    $checks=['engine_received'=>str_contains($runtime['server_version'],'V5.0.4.'),
        'header_received'=>$header===['page_size'=>8192,'ods'=>'13.1','dialect'=>3],
        'business_rows_received'=>$items===[['id'=>1,'title'=>'Cable USB','qty'=>12],['id'=>2,'title'=>'Fuse 10A','qty'=>0]],
        'zero_is_data'=>$items[1]['qty']===0,'sql_closed'=>$db===null,'service_closed'=>$serviceClosed===true && $service===null];
    $observations=['ticket'=>'SUPPORT-163','route'=>'main-catalog','engine'=>$runtime['server_version'],
        'implementation'=>$runtime['implementation'],'storage'=>$header,'selected_items'=>$items,
        'conclusions'=>['service_replied'=>true,'configured_database_read'=>true,'zero_stock_is_not_connection_failure'=>true],
        'limits'=>['not_full_integrity_validation'=>true,'not_an_inventory_of_all_tables'=>true],
        'password_and_physical_path_in_report'=>false];

} finally {
    if(is_resource($db)){f163Close($db);}
    if(is_resource($service)){f163Detach($service);}
    $removed=f163Cleanup($owned);
}

f163Report('fb163-support-report','Собрать понятный отчёт для поддержки',$rows,$checks,$observations,$runtime,$owned,$removed);

Заявка — SUPPORT-163
Маршрут приложения — main-catalog
Версия экземпляра — WI-V5.0.4.1812 Firebird 5.0
Формат файла ODS — 13.1
SQL-диалект — 3
Проверено товарных строк — 2
Остаток Cable USB — 12
Остаток Fuse 10A — 0
Вывод для поддержки — Сервис отвечает; Fuse 10A отсутствует на складе
Сервисное соединение освобождено — да

Самостоятельный CLI-файл: настоящие service-алиасы, собственная база/базы из приложенного шаблона, осмысленные SQL-результаты, result.html/result.json и очистка своего окружения.

<?php
declare(strict_types=1);
require __DIR__.'/lab.php';
$owned=[];$removed=[];$db=$service=null;
try {
    $config=f163Config();$service=f163Service();$runtime=f163Runtime($service);

    function reportText163(&$service,string $database,int $action,int $argument=0): string {
        $call=f163Capture(static fn()=>fbird_db_info($service,$database,$action,$argument));
        if(!is_string($call['value']) || $call['warning'] || $call['code']!==0) {
            if($call['value']===false) {$service=null;}
            f163Failure('Статистический текст не получен',$call);
        }
        return $call['value'];
    }
    function reportField163(string $report,string $pattern): string {
        if(preg_match($pattern,$report,$match)!==1) {
            throw new RuntimeException('Ожидаемое поле отсутствует в служебном отчёте.');
        }
        return $match[1];
    }
    function header163(&$service,string $database): array {
        $report=reportText163($service,$database,IBASE_STS_HDR_PAGES);
        return ['page_size'=>(int)reportField163($report,'/\bPage size\s+(\d+)\b/'),
            'ods'=>reportField163($report,'/\bODS version\s+(\d+\.\d+)\b/'),
            'dialect'=>(int)reportField163($report,'/\bDatabase dialect\s+(\d+)\b/')];
    }

    $database=f163CreateDatabase($service,$owned,'capacity');
    $db=f163Connect($database);
    f163Command($db,'DELETE FROM LAB_ITEMS');f163Commit($db);
    for($id=1;$id<=120;$id++) {
        f163Command($db,'INSERT INTO LAB_ITEMS(ID,TITLE,QTY) VALUES (?,?,?)',[$id,sprintf('SKU-%03d',$id),$id%5]);
    }
    f163Commit($db);
    f163Command($db,'CREATE INDEX IX_FB163_QTY ON LAB_ITEMS(QTY)');f163Commit($db);
    $total=(int)f163Read($db,'SELECT COUNT(*) AS "n" FROM LAB_ITEMS')[0]['n'];
    $eligible=(int)f163Read($db,'SELECT COUNT(*) AS "n" FROM LAB_ITEMS WHERE QTY BETWEEN ? AND ?',[1,2])[0]['n'];
    $selected=f163Read($db,'SELECT ID AS "id",TITLE AS "title",QTY AS "qty" FROM LAB_ITEMS WHERE QTY BETWEEN ? AND ? ORDER BY QTY,ID ROWS 3',[1,2]);
    f163Close($db);
    $report=reportText163($service,$database,IBASE_STS_DATA_PAGES,IBASE_STS_IDX_PAGES);
    $pages=(int)reportField163($report,'/\bLAB_ITEMS\s+\(\d+\).*?\bData pages:\s*(\d+)/s');
    if(preg_match('/\bIndex IX_FB163_QTY\s+\(\d+\).*?\bdepth:\s*(\d+),\s*leaf buckets:\s*(\d+),\s*nodes:\s*(\d+)/s',$report,$index)!==1) {
        throw new RuntimeException('Статистика собственного индекса отсутствует.');
    }
    $stats=['data_pages'=>$pages,'index'=>'IX_FB163_QTY','depth'=>(int)$index[1],
        'leaf_pages'=>(int)$index[2],'nodes'=>(int)$index[3]];
    $statisticsPresent=$pages>0 && $stats['depth']>0 && $stats['leaf_pages']>0 && $stats['nodes']>0;
    $screen=implode('; ',array_map(static fn($item)=>$item['title'].' / '.$item['qty'],$selected));
    $rows=[['Всего синтетических SKU',$total],['Остаток от 1 до 2 включительно',$eligible],['Строк передано экрану',count($selected)],
        ['На экране',$screen],['Таблица физического отчёта','LAB_ITEMS'],['Индекс физического отчёта','IX_FB163_QTY'],
        ['Статистика страниц и узлов получена',$statisticsPresent],['Все 120 строк выгружены в PHP',false],
        ['Использование индекса запросом доказано',false]];
    $checks=['fixture_count'=>$total===120,'sql_filter_count'=>$eligible===48,
        'bounded_screen_rows'=>$selected===[['id'=>1,'title'=>'SKU-001','qty'=>1],['id'=>6,'title'=>'SKU-006','qty'=>1],['id'=>11,'title'=>'SKU-011','qty'=>1]],
        'physical_statistics_present'=>$statisticsPresent,'only_three_rows_transferred'=>count($selected)===3,
        'sql_link_closed'=>$db===null];
    $observations=['physical_statistics'=>$stats,'selected_items'=>$selected,'total_fixture_rows'=>$total,'matching_rows'=>$eligible,
        'screen_sql'=>'SELECT ID,TITLE,QTY FROM LAB_ITEMS WHERE QTY BETWEEN 1 AND 2 ORDER BY QTY,ID ROWS 3',
        'statistics_request'=>['action'=>'IBASE_STS_DATA_PAGES','argument'=>'IBASE_STS_IDX_PAGES'],
        'report_excerpt'=>f163PublicText($report),'gstat_is_not_a_transaction_snapshot'=>true,
        'index_presence_is_not_query_plan'=>true,'physical_numbers_not_guessed_before_run'=>true];

} finally {
    if(is_resource($db)){f163Close($db);}
    if(is_resource($service)){f163Detach($service);}
    $removed=f163Cleanup($owned);
}

f163Report('fb163-table-capacity','Показать три товара и отдельно оценить хранение',$rows,$checks,$observations,$runtime,$owned,$removed);

Всего синтетических SKU — 120
Остаток от 1 до 2 включительно — 48
Строк передано экрану — 3
На экране — SKU-001 / 1; SKU-006 / 1; SKU-011 / 1
Таблица физического отчёта — LAB_ITEMS
Индекс физического отчёта — IX_FB163_QTY
Статистика страниц и узлов получена — да
Все 120 строк выгружены в PHP — нет
Использование индекса запросом доказано — нет

Самостоятельный CLI-файл: настоящие service-алиасы, собственная база/базы из приложенного шаблона, осмысленные SQL-результаты, result.html/result.json и очистка своего окружения.

<?php
declare(strict_types=1);
require __DIR__.'/lab.php';
$owned=[];$removed=[];$db=$service=null;
try {
    $config=f163Config();$service=f163Service();$runtime=f163Runtime($service);

    function reportText163(&$service,string $database,int $action,int $argument=0): string {
        $call=f163Capture(static fn()=>fbird_db_info($service,$database,$action,$argument));
        if(!is_string($call['value']) || $call['warning'] || $call['code']!==0) {
            if($call['value']===false) {$service=null;}
            f163Failure('Статистический текст не получен',$call);
        }
        return $call['value'];
    }
    function reportField163(string $report,string $pattern): string {
        if(preg_match($pattern,$report,$match)!==1) {
            throw new RuntimeException('Ожидаемое поле отсутствует в служебном отчёте.');
        }
        return $match[1];
    }
    function header163(&$service,string $database): array {
        $report=reportText163($service,$database,IBASE_STS_HDR_PAGES);
        return ['page_size'=>(int)reportField163($report,'/\bPage size\s+(\d+)\b/'),
            'ods'=>reportField163($report,'/\bODS version\s+(\d+\.\d+)\b/'),
            'dialect'=>(int)reportField163($report,'/\bDatabase dialect\s+(\d+)\b/')];
    }

    $routes=['EAST'=>f163CreateDatabase($service,$owned,'east'),'WEST'=>f163CreateDatabase($service,$owned,'west')];
    $before=[];$headers=[];
    foreach(['EAST'=>7,'WEST'=>2] as $branch=>$quantity) {
        $db=f163Connect($routes[$branch]);
        f163Command($db,'DELETE FROM LAB_ITEMS WHERE ID<>?',[1]);
        f163Command($db,'UPDATE LAB_ITEMS SET TITLE=?,QTY=? WHERE ID=?',['Cable USB',$quantity,1]);
        f163Command($db,'CREATE TABLE BRANCH_INFO(BRANCH_CODE VARCHAR(4) NOT NULL)');f163Commit($db);
        f163Command($db,'INSERT INTO BRANCH_INFO(BRANCH_CODE) VALUES (?)',[$branch]);f163Commit($db);
        $before[$branch]=f163Read($db,'SELECT ID AS "id",TITLE AS "title",QTY AS "qty" FROM LAB_ITEMS WHERE ID=?',[1])[0];
        f163Close($db);
        $headers[$branch]=header163($service,$routes[$branch]);
    }
    $requestedBranch='EAST';
    if(!array_key_exists($requestedBranch,$routes)) {throw new DomainException('Неизвестный филиал.');}
    $db=f163Connect($routes[$requestedBranch]);
    $actualBranch=f163Read($db,'SELECT BRANCH_CODE AS "branch" FROM BRANCH_INFO ROWS 1')[0]['branch'];
    if($actualBranch!==$requestedBranch) {throw new DomainException('Файл не соответствует выбранному филиалу.');}
    $changed=f163Query($db,'UPDATE LAB_ITEMS SET QTY=QTY-? WHERE ID=? AND QTY>=?',[2,1,2]);
    if($changed!==1) {throw new DomainException('Выдача не выполнена: товара нет или остатка недостаточно.');}
    f163Commit($db);f163Close($db);
    $after=[];
    // interbase 3.0.1 хранит default link: последнее чтение EAST согласовано
    // с порядком удаления учебных баз WEST → EAST в завершающей очистке.
    foreach(array_reverse($routes,true) as $branch=>$database) {
        $db=f163Connect($database);
        $after[$branch]=f163Read($db,'SELECT ID AS "id",TITLE AS "title",QTY AS "qty" FROM LAB_ITEMS WHERE ID=?',[1])[0];
        f163Close($db);
    }
    $sameFormat=$headers['EAST']===$headers['WEST'];
    $rows=[['Выбран филиал',$requestedBranch],['ID товара в обеих базах',1],['Товар','Cable USB'],
        ['EAST до выдачи',$before['EAST']['qty']],['WEST до выдачи',$before['WEST']['qty']],['Выдано из EAST',2],
        ['EAST после выдачи',$after['EAST']['qty']],['WEST после выдачи',$after['WEST']['qty']],
        ['Формат ODS обеих баз',$headers['EAST']['ods']],['Одинаковый формат означает одну базу',false]];
    $checks=['two_distinct_owned_routes'=>count($routes)===2 && $routes['EAST']!==$routes['WEST'],
        'initial_stock_per_branch'=>$before['EAST']['qty']===7 && $before['WEST']['qty']===2,
        'route_identity_checked'=>$actualBranch==='EAST','single_row_changed'=>$changed===1,
        'east_stock_changed'=>$after['EAST']['qty']===5,'west_stock_unchanged'=>$after['WEST']===$before['WEST'],
        'same_storage_format'=>$sameFormat && $headers['EAST']['ods']==='13.1','sql_handles_closed'=>$db===null];
    $observations=['logical_routes'=>array_keys($routes),'before'=>$before,'after'=>$after,'database_headers'=>$headers,
        'requested_branch'=>$requestedBranch,'database_branch_marker'=>$actualBranch,
        'same_id_in_two_independent_databases'=>true,'path_taken_only_from_allowlist'=>true,
        'cross_database_transaction_claimed'=>false,'raw_database_paths_published'=>false];

} finally {
    if(is_resource($db)){f163Close($db);}
    if(is_resource($service)){f163Detach($service);}
    $removed=f163Cleanup($owned);
}

f163Report('fb163-database-routing','Выдать товар из нужного филиала',$rows,$checks,$observations,$runtime,$owned,$removed);

Выбран филиал — EAST
ID товара в обеих базах — 1
Товар — Cable USB
EAST до выдачи — 7
WEST до выдачи — 2
Выдано из EAST — 2
EAST после выдачи — 5
WEST после выдачи — 2
Формат ODS обеих баз — 13.1
Одинаковый формат означает одну базу — нет

Самостоятельный CLI-файл: настоящие service-алиасы, собственная база/базы из приложенного шаблона, осмысленные SQL-результаты, result.html/result.json и очистка своего окружения.

<?php
declare(strict_types=1);
require __DIR__.'/lab.php';
$owned=[];$removed=[];$db=$service=null;
try {
    $config=f163Config();$service=f163Service();$runtime=f163Runtime($service);

    function reportText163(&$service,string $database,int $action,int $argument=0): string {
        $call=f163Capture(static fn()=>fbird_db_info($service,$database,$action,$argument));
        if(!is_string($call['value']) || $call['warning'] || $call['code']!==0) {
            if($call['value']===false) {$service=null;}
            f163Failure('Статистический текст не получен',$call);
        }
        return $call['value'];
    }
    function reportField163(string $report,string $pattern): string {
        if(preg_match($pattern,$report,$match)!==1) {
            throw new RuntimeException('Ожидаемое поле отсутствует в служебном отчёте.');
        }
        return $match[1];
    }
    function header163(&$service,string $database): array {
        $report=reportText163($service,$database,IBASE_STS_HDR_PAGES);
        return ['page_size'=>(int)reportField163($report,'/\bPage size\s+(\d+)\b/'),
            'ods'=>reportField163($report,'/\bODS version\s+(\d+\.\d+)\b/'),
            'dialect'=>(int)reportField163($report,'/\bDatabase dialect\s+(\d+)\b/')];
    }

    $database=f163CreateDatabase($service,$owned,'recovery');
    $db=f163Connect($database);
    f163Command($db,'UPDATE LAB_ITEMS SET TITLE=?,QTY=? WHERE ID=?',['Fuse 10A',9,1]);f163Commit($db);f163Close($db);
    $routes=['main-catalog'=>$database];
    $missing='fb163_missing_0000000000.fdb';$missingPath=f163Path($missing);
    clearstatcache(true,$missingPath);
    if(file_exists($missingPath)) {throw new RuntimeException('Отсутствующий учебный путь уже существует.');}
    $failed=f163Capture(static fn()=>fbird_db_info($service,$missing,IBASE_STS_HDR_PAGES));
    $failure=['returned_false'=>$failed['value']===false,'code'=>$failed['code'],
        'warning'=>$failed['warning'],'message_present'=>$failed['message_present']];
    // This native error path in interbase3.0.1 already invalidates the service resource.
    // Keep the diagnostics; do not call detach a second time on that handle.
    $service=null;
    if(!$failure['returned_false']) {throw new RuntimeException('Ожидаемый отказ пути не получен.');}
    $service=f163Service();
    $version=f163Capture(static fn()=>fbird_server_info($service,IBASE_SVC_SERVER_VERSION));
    if(!is_string($version['value']) || $version['warning']) {
        if($version['value']===false) {$service=null;}
        f163Failure('Новый сервис не ответил',$version);
    }
    $header=header163($service,$routes['main-catalog']);
    $db=f163Connect($routes['main-catalog']);
    $item=f163Read($db,'SELECT ID AS "id",TITLE AS "title",QTY AS "qty" FROM LAB_ITEMS WHERE ID=?',[1])[0];
    f163Close($db);$closed=f163Detach($service);
    clearstatcache(true,$missingPath);$missingStillAbsent=!file_exists($missingPath);
    $rows=[['Отказ первой операции сохранён',$failure['returned_false']],['Код первоначального отказа',$failure['code']],
        ['Предупреждение и сообщение сохранены',$failure['warning'] && $failure['message_present']],
        ['Доступность нового service handle',is_string($version['value'])],['Исправленный маршрут','main-catalog'],
        ['Товар после исправления',$item['title']],['Остаток после исправления',$item['qty']],
        ['Первоначальная причина','Ошибочное имя отсутствующего учебного файла'],['Пустая база вместо отсутствующей создана',!$missingStillAbsent],
        ['Новый сервис освобождён',$closed && $service===null]];
    $checks=['initial_task_rejected'=>$failure['returned_false'],
        'diagnostics_preserved'=>$failure['code']===-901 && $failure['warning'] && $failure['message_present'],
        'fresh_service_available'=>str_contains($version['value'],'V5.0.4.'),
        'correct_header_received'=>$header['ods']==='13.1',
        'business_read_recovered'=>$item===['id'=>1,'title'=>'Fuse 10A','qty'=>9],
        'wrong_path_not_created'=>$missingStillAbsent,'all_owned_handles_closed'=>$db===null && $service===null && $closed===true];
    $observations=['initial_failure'=>$failure,'known_fixture_cause'=>'Отсутствие файла проверено до вызова.',
        'recovery'=>['fresh_service_version'=>$version['value'],'logical_route'=>'main-catalog','header'=>$header,'item'=>$item],
        'initial_diagnostics_not_overwritten'=>true,'automatic_retry_of_bad_path'=>false,
        'changed_only_the_confirmed_route'=>true,'server_restart_performed'=>false,'raw_error_message_published'=>false];

} finally {
    if(is_resource($db)){f163Close($db);}
    if(is_resource($service)){f163Detach($service);}
    $removed=f163Cleanup($owned);
}

f163Report('fb163-service-recovery','Восстановить диагностику после неверного маршрута',$rows,$checks,$observations,$runtime,$owned,$removed);

Отказ первой операции сохранён — да
Код первоначального отказа — -901
Предупреждение и сообщение сохранены — да
Доступность нового service handle — да
Исправленный маршрут — main-catalog
Товар после исправления — Fuse 10A
Остаток после исправления — 9
Первоначальная причина — Ошибочное имя отсутствующего учебного файла
Пустая база вместо отсутствующей создана — нет
Новый сервис освобождён — да

Самостоятельный CLI-файл: настоящие service-алиасы, собственная база/базы из приложенного шаблона, осмысленные SQL-результаты, result.html/result.json и очистка своего окружения.