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

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

    function statistics157($service,string $database,int $action,int $argument=0): string {
        $call=f157Capture(static fn()=>ibase_db_info($service,$database,$action,$argument));
        if (!is_string($call['value']) || $call['warning'] || $call['code']!==0) {
            f157Failure('Текст статистического отчёта не получен',$call);
        }
        return $call['value'];
    }
    function headerField157(string $report,string $pattern): string {
        if (preg_match($pattern,$report,$match)!==1) {
            throw new RuntimeException('Ожидаемое поле отсутствует в формате отчёта.');
        }
        return $match[1];
    }

    // START obtained both strings through actual server_info calls with immediate diagnostics.
    $version=$runtime['server_version'];$implementation=$runtime['implementation'];
    $closed=f157Detach($service);
    $rows=[['Версия экземпляра',$version],['Реализация',$implementation],['Версия PHP',$runtime['php']],
        ['Версия interbase',$runtime['extension']],['Сервис освобождён',$closed && $service===null],['Создано учебных баз',count($owned)]];
    $checks=['version_observed'=>is_string($version) && str_contains($version,'V5.0.4.'),
        'implementation_observed'=>is_string($implementation) && str_contains($implementation,'Firebird/Windows/'),
        'pinned_extension'=>$runtime['extension']==='3.0.1','service_closed'=>$closed===true && $service===null,
        'no_database_required'=>$owned===[]];
    $observations=['server_version'=>$version,'implementation'=>$implementation,
        'connection_kind'=>'локальный Services API отдельного учебного экземпляра',
        'database_path_not_required'=>true,'php_extension_not_server_version'=>true];

} finally {
    if(is_resource($db)){f157Close($db);}
    if(is_resource($service)){f157Detach($service);}
    $removed=f157Cleanup($owned);
}

f157Report('fb157-service-passport','Паспорт экземпляра: узнать версию и платформу перед проверкой базы',$rows,$checks,$observations,$runtime,$owned,$removed);

Версия экземпляра — WI-V5.0.4.1812 Firebird 5.0
Реализация — Firebird/Windows/AMD/Intel/x64
Версия PHP — 8.2.35
Версия interbase — 3.0.1
Сервис освобождён — да
Создано учебных баз — 0

Самостоятельный CLI-пример с lab.php, README и синтетическим шаблоном. Выполняются настоящие вызовы Services API; собственные файлы базы освобождаются и удаляются после проверки. Создаются result.html и result.json.

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

    function statistics157($service,string $database,int $action,int $argument=0): string {
        $call=f157Capture(static fn()=>ibase_db_info($service,$database,$action,$argument));
        if (!is_string($call['value']) || $call['warning'] || $call['code']!==0) {
            f157Failure('Текст статистического отчёта не получен',$call);
        }
        return $call['value'];
    }
    function headerField157(string $report,string $pattern): string {
        if (preg_match($pattern,$report,$match)!==1) {
            throw new RuntimeException('Ожидаемое поле отсутствует в формате отчёта.');
        }
        return $match[1];
    }

    $database=f157CreateDatabase($service,$owned,'header');
    $report=statistics157($service,$database,IBASE_STS_HDR_PAGES);
    $pageSize=(int)headerField157($report,'/\bPage size\s+(\d+)\b/u');
    $ods=headerField157($report,'/\bODS version\s+(\d+\.\d+)\b/u');
    $dialect=(int)headerField157($report,'/\bDatabase dialect\s+(\d+)\b/u');
    $db=f157Connect($database);
    $count=(int)f157Read($db,'SELECT COUNT(*) AS "n" FROM LAB_ITEMS')[0]['n'];
    $sample=f157Read($db,'SELECT ID AS "id",TITLE AS "title",QTY AS "qty" FROM LAB_ITEMS WHERE ID=?',[1])[0];
    f157Close($db);
    $rows=[['Размер страницы, байт',$pageSize],['Формат файла ODS',$ods],['SQL-диалект',$dialect],
        ['Товарных строк в учебной таблице',$count],['Пример товара',$sample['title']],['Остаток примера',$sample['qty']]];
    $checks=['header_text_received'=>str_contains($report,'Database header page information'),
        'page_size_observed'=>$pageSize===8192,'ods_observed'=>$ods==='13.1','dialect_observed'=>$dialect===3,
        'business_rows_read'=>$count===2 && $sample===['id'=>1,'title'=>'Cable','qty'=>3],
        'sql_link_closed'=>$db===null];
    $observations=['header_fields'=>['page_size'=>$pageSize,'ods'=>$ods,'dialect'=>$dialect],
        'selected'=>$sample,'business_row_count'=>$count,'report_excerpt'=>f157PublicText($report),
        'page_size_is_not_row_count'=>true,'source'=>'собственная база из приложенного синтетического шаблона'];

} finally {
    if(is_resource($db)){f157Close($db);}
    if(is_resource($service)){f157Detach($service);}
    $removed=f157Cleanup($owned);
}

f157Report('fb157-database-header','Заголовок базы: отличить формат файла от версии сервера и строк каталога',$rows,$checks,$observations,$runtime,$owned,$removed);

Размер страницы, байт — 8192
Формат файла ODS — 13.1
SQL-диалект — 3
Товарных строк в учебной таблице — 2
Пример товара — Cable
Остаток примера — 3

Самостоятельный CLI-пример с lab.php, README и синтетическим шаблоном. Выполняются настоящие вызовы Services API; собственные файлы базы освобождаются и удаляются после проверки. Создаются result.html и result.json.

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

    function statistics157($service,string $database,int $action,int $argument=0): string {
        $call=f157Capture(static fn()=>ibase_db_info($service,$database,$action,$argument));
        if (!is_string($call['value']) || $call['warning'] || $call['code']!==0) {
            f157Failure('Текст статистического отчёта не получен',$call);
        }
        return $call['value'];
    }
    function headerField157(string $report,string $pattern): string {
        if (preg_match($pattern,$report,$match)!==1) {
            throw new RuntimeException('Ожидаемое поле отсутствует в формате отчёта.');
        }
        return $match[1];
    }

    $database=f157CreateDatabase($service,$owned,'statistics');
    $db=f157Connect($database);
    f157Command($db,'CREATE INDEX IX_FB157_QTY ON LAB_ITEMS(QTY)');
    f157Commit($db);
    $selected=f157Read($db,'SELECT ID AS "id",TITLE AS "title",QTY AS "qty" FROM LAB_ITEMS WHERE QTY>0 ORDER BY ID ROWS 10');
    f157Close($db);
    // In this driver DATA is the action; additional IDX bits belong to the fourth argument.
    $report=statistics157($service,$database,IBASE_STS_DATA_PAGES,IBASE_STS_IDX_PAGES);
    if (preg_match('/\bLAB_ITEMS\s+\(\d+\).*?\bData pages:\s*(\d+)/s',$report,$tableMatch)!==1) {
        throw new RuntimeException('Блок LAB_ITEMS отсутствует в отчёте.');
    }
    if (preg_match('/\bIndex IX_FB157_QTY\s+\(\d+\).*?\bdepth:\s*(\d+),\s*leaf buckets:\s*(\d+),\s*nodes:\s*(\d+)/s',$report,$indexMatch)!==1) {
        throw new RuntimeException('Блок собственного индекса отсутствует в отчёте.');
    }
    $pages=(int)$tableMatch[1];$depth=(int)$indexMatch[1];$leafPages=(int)$indexMatch[2];$nodes=(int)$indexMatch[3];
    $rows=[['Таблица','LAB_ITEMS'],['Страниц данных',$pages],['Индекс','IX_FB157_QTY'],['Глубина индекса',$depth],
        ['Листовых страниц индекса',$leafPages],['Узлов в индексе',$nodes],['Товаров с остатком больше нуля',count($selected)],
        ['Показанный товар',$selected[0]['title']],['Его остаток',$selected[0]['qty']]];
    $checks=['data_pages_observed'=>$pages===1,'own_index_observed'=>str_contains($report,'Index IX_FB157_QTY'),
        'index_structure_observed'=>$depth===1 && $leafPages===1 && $nodes===2,
        'bounded_business_selection'=>$selected===[['id'=>1,'title'=>'Cable','qty'=>3]],
        'physical_nodes_not_selected_rows'=>$nodes!==count($selected),'sql_link_closed'=>$db===null];
    $observations=['statistics'=>['table'=>'LAB_ITEMS','data_pages'=>$pages,'index'=>'IX_FB157_QTY','depth'=>$depth,'leaf_pages'=>$leafPages,'nodes'=>$nodes],
        'selected'=>$selected,'query'=>'SELECT ID,TITLE,QTY FROM LAB_ITEMS WHERE QTY>0 ORDER BY ID ROWS 10',
        'service_action'=>'IBASE_STS_DATA_PAGES','service_argument'=>'IBASE_STS_IDX_PAGES','report_excerpt'=>f157PublicText($report),
        'index_existence_does_not_prove_query_plan'=>true];

} finally {
    if(is_resource($db)){f157Close($db);}
    if(is_resource($service)){f157Detach($service);}
    $removed=f157Cleanup($owned);
}

f157Report('fb157-table-statistics','Страницы и индекс: сопоставить физический отчёт с нужными товарами',$rows,$checks,$observations,$runtime,$owned,$removed);

Таблица — LAB_ITEMS
Страниц данных — 1
Индекс — IX_FB157_QTY
Глубина индекса — 1
Листовых страниц индекса — 1
Узлов в индексе — 2
Товаров с остатком больше нуля — 1
Показанный товар — Cable
Его остаток — 3

Самостоятельный CLI-пример с lab.php, README и синтетическим шаблоном. Выполняются настоящие вызовы Services API; собственные файлы базы освобождаются и удаляются после проверки. Создаются result.html и result.json.

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

    function statistics157($service,string $database,int $action,int $argument=0): string {
        $call=f157Capture(static fn()=>ibase_db_info($service,$database,$action,$argument));
        if (!is_string($call['value']) || $call['warning'] || $call['code']!==0) {
            f157Failure('Текст статистического отчёта не получен',$call);
        }
        return $call['value'];
    }
    function headerField157(string $report,string $pattern): string {
        if (preg_match($pattern,$report,$match)!==1) {
            throw new RuntimeException('Ожидаемое поле отсутствует в формате отчёта.');
        }
        return $match[1];
    }

    $missing='fb157_missing_0000000000.fdb';$missingPath=f157Path($missing);
    if (file_exists($missingPath)) {throw new RuntimeException('Ожидался заведомо отсутствующий учебный путь.');}
    $failure=f157Capture(static fn()=>ibase_db_info($service,$missing,IBASE_STS_HDR_PAGES));
    // Capture is complete before releasing the invalidated reference or requesting a new service.
    $safe=['returned_false'=>$failure['value']===false,'code'=>$failure['code'],
        'warning'=>$failure['warning'],'message_present'=>$failure['message_present']];
    if (!$safe['returned_false']) {throw new RuntimeException('Отсутствующий файл неожиданно дал отчёт.');}
    // In this native error branch interbase 3.0.1 already calls zend_list_delete.
    // Do not consume that resource again through ibase_service_detach.
    $service=null;
    $service=f157Service();
    $versionCall=f157Capture(static fn()=>ibase_server_info($service,IBASE_SVC_SERVER_VERSION));
    if (!is_string($versionCall['value']) || $versionCall['warning']) {f157Failure('Независимая проверка сервиса не прошла',$versionCall);}
    $serviceWorks=str_contains($versionCall['value'],'V5.0.4.');
    $closed=f157Detach($service);clearstatcache(true,$missingPath);
    $absent=!file_exists($missingPath);
    $rows=[['Результат db_info — false',$safe['returned_false']],['Код отказа',$safe['code']],
        ['Предупреждение сохранено',$safe['warning']],['Сообщение получено',$safe['message_present']],
        ['Понятная причина','Указанный учебный файл базы отсутствует'],['Новый сервис ответил версией',$serviceWorks],
        ['Отсутствующий файл не создан',$absent],['Создано учебных баз',count($owned)]];
    $checks=['missing_path_refused'=>$safe['returned_false'],'immediate_diagnostics_saved'=>$safe['code']===-901 && $safe['warning'] && $safe['message_present'],
        'fresh_service_works'=>$serviceWorks,'missing_file_not_created'=>$absent,'no_database_created'=>$owned===[],
        'fresh_service_closed'=>$closed===true && $service===null];
    $observations=['failure'=>$safe,'cause_in_this_owned_fixture'=>'Файл заранее проверен как отсутствующий.',
        'fresh_service_version'=>$versionCall['value'],'private_error_message_not_published'=>true,
        'same_code_can_require_other_investigation'=>true,'diagnostics_saved_before_cleanup'=>true];

} finally {
    if(is_resource($db)){f157Close($db);}
    if(is_resource($service)){f157Detach($service);}
    $removed=f157Cleanup($owned);
}

f157Report('fb157-missing-path','Неверный путь: сохранить причину отказа и отдельно проверить доступность сервиса',$rows,$checks,$observations,$runtime,$owned,$removed);

Результат db_info — false — да
Код отказа — -901
Предупреждение сохранено — да
Сообщение получено — да
Понятная причина — Указанный учебный файл базы отсутствует
Новый сервис ответил версией — да
Отсутствующий файл не создан — да
Создано учебных баз — 0

Самостоятельный CLI-пример с lab.php, README и синтетическим шаблоном. Выполняются настоящие вызовы Services API; собственные файлы базы освобождаются и удаляются после проверки. Создаются result.html и result.json.