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

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

    $name=f159CreateDatabase($service,$owned,'sweep');
    $db=f159Connect($name);
    $initial=f159Read($db,'SELECT ID,TITLE,QTY FROM LAB_ITEMS ORDER BY ID');
    f159Command($db,'UPDATE LAB_ITEMS SET QTY=4 WHERE ID=1');
    f159Commit($db);
    f159Command($db,'UPDATE LAB_ITEMS SET QTY=7 WHERE ID=1');
    f159Commit($db);
    f159Command($db,'UPDATE LAB_ITEMS SET QTY=99 WHERE ID=1');
    $uncommitted=f159Read($db,'SELECT QTY FROM LAB_ITEMS WHERE ID=1')[0]['QTY'];
    if(ibase_rollback($db)!==true)f159Failure('Отмена пробной записи не подтверждена');
    $before=f159Read($db,'SELECT ID,TITLE,QTY FROM LAB_ITEMS ORDER BY ID');
    f159Close($db);
    $job=f159Maintain($service,$name,IBASE_RPR_SWEEP_DB);
    $db=f159Connect($name);
    $after=f159Read($db,'SELECT ID,TITLE,QTY FROM LAB_ITEMS ORDER BY ID');
    f159Close($db);
    $expected=[['ID'=>1,'TITLE'=>'Cable','QTY'=>7],['ID'=>2,'TITLE'=>'Clamp','QTY'=>0]];
    $rows=[['Первоначальный остаток Cable',$initial[0]['QTY']],
        ['Пробное значение до rollback',$uncommitted],
        ['Перед sweep: Cable / Clamp',$before[0]['QTY'].' / '.$before[1]['QTY']],
        ['Сервисная команда принята',$job['started']],
        ['Ответ службы прочитан',$job['output']===true || is_string($job['output'])],
        ['После sweep: Cable / Clamp',$after[0]['QTY'].' / '.$after[1]['QTY']],
        ['Подтверждённые товары сохранились',$after===$expected]];
    $checks=['initial_stock'=>$initial===[['ID'=>1,'TITLE'=>'Cable','QTY'=>3],['ID'=>2,'TITLE'=>'Clamp','QTY'=>0]],
        'rollback_discarded_99'=>$uncommitted===99 && $before===$expected,
        'service_started'=>$job['started']===true,
        'service_completed'=>$job['output']===true || is_string($job['output']),
        'committed_rows_unchanged'=>$after===$before && $after===$expected];
    $observations=['initial'=>$initial,'uncommitted_stock'=>$uncommitted,'before'=>$before,'after'=>$after,
        'service_started'=>$job['started'],'completion_kind'=>get_debug_type($job['output']),
        'completion_has_text'=>is_string($job['output']) && $job['output']!==''];

} finally {
    if(is_resource($db)){f159Close($db);}
    if(is_resource($service)){f159Detach($service);}
    $removed=f159Cleanup($owned);
}

f159Report('fb159-manual-sweep','Выполнить ручной sweep и сохранить подтверждённые остатки',$rows,$checks,$observations,$runtime,$owned,$removed);

Первоначальный остаток Cable — 3
Пробное значение до rollback — 99
Перед sweep: Cable / Clamp — 7 / 0
Сервисная команда принята — да
Ответ службы прочитан — да
После sweep: Cable / Clamp — 7 / 0
Подтверждённые товары сохранились — да

Распакуйте архив целиком в собственную папку и выполните example.php по README.txt. lab.php содержит проверку владельца, создание синтетической базы, SQL-помощники, чтение Service API и уборку. seed.sql показывает исходные Cable/3 и Clamp/0. result.html отображает предметный результат, result.json сохраняет наблюдения, metrics.json — проверки. После работы собственная база и промежуточный backup удаляются; отчёты остаются.

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

    $name=f159CreateDatabase($service,$owned,'validate');
    $db=f159Connect($name);
    $before=f159Read($db,'SELECT ID,TITLE,QTY FROM LAB_ITEMS ORDER BY ID');
    f159Close($db);
    $invalid=f159MaintenanceAttempt($service,$name,2147483647,0);
    $localHandleKept=is_resource($service);
    $headerAfterInvalid=f159Header($service,$name);
    $validation=f159MaintenanceAttempt($service,$name,IBASE_RPR_VALIDATE_DB,IBASE_RPR_CHECK_DB);
    $consumedHandleCleared=$service===null;
    if($validation['value']!==false || $validation['code']!==-924 || !$validation['message_present'] || !$consumedHandleCleared) {
        throw new RuntimeException('Ожидаемый отказ secondary attachment не подтверждён этим профилем');
    }
    $service=f159Service();
    $db=f159Connect($name);
    $after=f159Read($db,'SELECT ID,TITLE,QTY FROM LAB_ITEMS ORDER BY ID');
    f159Close($db);
    $rows=[['Неизвестный action принят',$invalid['value']],['Код неверного action',$invalid['code']],
        ['После локального отказа читается заголовок',is_int($headerAfterInvalid['sweep_interval'])],
        ['Проверка структуры запущена',$validation['value']],['Код отказа среды',$validation['code']],
        ['Старый сервисный handle больше не используется',$consumedHandleCleared],
        ['Через новое подключение: Cable / Clamp',$after[0]['QTY'].' / '.$after[1]['QTY']],
        ['Успешная проверка целостности заявлена',false]];
    $checks=['unknown_action_rejected'=>$invalid['value']===false && $invalid['code']===-999 && $invalid['warning'] && $invalid['message_present'],
        'local_failure_kept_service'=>$localHandleKept && is_int($headerAfterInvalid['sweep_interval']),
        'profile_validation_refusal'=>$validation['value']===false && $validation['code']===-924 && $validation['warning'] && $validation['message_present'],
        'consumed_service_cleared'=>$consumedHandleCleared,
        'fresh_service_created'=>is_resource($service),
        'catalogue_still_readable'=>$before===$after && $after===[['ID'=>1,'TITLE'=>'Cable','QTY'=>3],['ID'=>2,'TITLE'=>'Clamp','QTY'=>0]]];
    $observations=['unknown_action'=>$invalid,'header_interval_after_invalid'=>$headerAfterInvalid['sweep_interval'],
        'validation_attempt'=>$validation,'validation_completed'=>false,
        'profile_limitation'=>'secondary server attachments cannot validate databases',
        'old_service_cleared'=>$consumedHandleCleared,'before'=>$before,'after'=>$after];

} finally {
    if(is_resource($db)){f159Close($db);}
    if(is_resource($service)){f159Detach($service);}
    $removed=f159Cleanup($owned);
}

f159Report('fb159-validation','Отличить неверную команду от отказа среды при проверке базы',$rows,$checks,$observations,$runtime,$owned,$removed);

Неизвестный action принят — нет
Код неверного action — -999
После локального отказа читается заголовок — да
Проверка структуры запущена — нет
Код отказа среды — -924
Старый сервисный handle больше не используется — да
Через новое подключение: Cable / Clamp — 3 / 0
Успешная проверка целостности заявлена — нет

Распакуйте архив целиком в собственную папку и выполните example.php по README.txt. lab.php содержит проверку владельца, создание синтетической базы, SQL-помощники, чтение Service API и уборку. seed.sql показывает исходные Cable/3 и Clamp/0. result.html отображает предметный результат, result.json сохраняет наблюдения, metrics.json — проверки. После работы собственная база и промежуточный backup удаляются; отчёты остаются.

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

    $name=f159CreateDatabase($service,$owned,'interval');
    $original=f159Header($service,$name);
    $restore=false;
    try {
        $restore=true;
        $changedJob=f159Maintain($service,$name,IBASE_PRP_SWEEP_INTERVAL,12345);
        $changed=f159Header($service,$name);
        $db=f159Connect($name);
        $catalogue=f159Read($db,'SELECT ID,TITLE,QTY FROM LAB_ITEMS ORDER BY ID');
        f159Close($db);
    } finally {
        if(is_resource($db))f159Close($db);
        if($restore) {
            if($service===null)$service=f159Service();
            $restoreJob=f159Maintain($service,$name,IBASE_PRP_SWEEP_INTERVAL,$original['sweep_interval']);
        }
    }
    $restored=f159Header($service,$name);
    $rows=[['Исходный sweep interval',$original['sweep_interval']],['Из заголовка после изменения',$changed['sweep_interval']],
        ['Товары при новом пороге','Cable — '.$catalogue[0]['QTY'].'; Clamp — '.$catalogue[1]['QTY']],
        ['После восстановления',$restored['sweep_interval']],['Исходная настройка возвращена',$restored['sweep_interval']===$original['sweep_interval']]];
    $checks=['fixture_interval_20000'=>$original['sweep_interval']===20000,
        'changed_readback_12345'=>$changed['sweep_interval']===12345 && $changedJob['started']===true,
        'unchanged_catalogue'=>$catalogue===[['ID'=>1,'TITLE'=>'Cable','QTY'=>3],['ID'=>2,'TITLE'=>'Clamp','QTY'=>0]],
        'restored_readback'=>$restoreJob['started']===true && $restored['sweep_interval']===$original['sweep_interval']];
    $observations=['original_interval'=>$original['sweep_interval'],'requested_interval'=>12345,'readback_interval'=>$changed['sweep_interval'],
        'restored_interval'=>$restored['sweep_interval'],'catalogue'=>$catalogue,'changed_service_started'=>$changedJob['started'],
        'restore_service_started'=>$restoreJob['started']];

} finally {
    if(is_resource($db)){f159Close($db);}
    if(is_resource($service)){f159Detach($service);}
    $removed=f159Cleanup($owned);
}

f159Report('fb159-sweep-interval','Изменить sweep interval, прочитать настройку и вернуть исходную',$rows,$checks,$observations,$runtime,$owned,$removed);

Исходный sweep interval — 20000
Из заголовка после изменения — 12345
Товары при новом пороге — Cable — 3; Clamp — 0
После восстановления — 20000
Исходная настройка возвращена — да

Распакуйте архив целиком в собственную папку и выполните example.php по README.txt. lab.php содержит проверку владельца, создание синтетической базы, SQL-помощники, чтение Service API и уборку. seed.sql показывает исходные Cable/3 и Clamp/0. result.html отображает предметный результат, result.json сохраняет наблюдения, metrics.json — проверки. После работы собственная база и промежуточный backup удаляются; отчёты остаются.

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

    function readPageBuffers159(&$service,string $name): int {
        $header=f159Header($service,$name);
        if(!preg_match('/Page buffers\s+(\d+)/i',$header['text'],$match)) {
            throw new RuntimeException('Заголовок не содержит число буферов страниц');
        }
        return (int)$match[1];
    }
    function setPageBuffers159(&$service,string $name,int $pages): array {
        if($pages!==0 && ($pages<50 || $pages>2147483646))throw new InvalidArgumentException('Число буферов вне диапазона');
        $started=f159MaintenanceAttempt($service,$name,IBASE_PRP_PAGE_BUFFERS,$pages);
        if($started['value']!==true || $started['warning'])f159Failure('Число буферов не принято',$started);
        $completed=f159Capture(static fn()=>ibase_server_info($service,F159_SVC_LINE));
        if($completed['value']===false || $completed['warning'] || (!is_string($completed['value']) && $completed['value']!==true)) {
            if($completed['value']===false && $completed['code']!==0)$service=null;
            f159Failure('Ответ настройки буферов не прочитан',$completed);
        }
        return ['started'=>true,'completion_read'=>true];
    }
    $name=f159CreateDatabase($service,$owned,'buffers');
    $original=readPageBuffers159($service,$name);
    $restore=false;
    try {
        $restore=true;
        $changedJob=setPageBuffers159($service,$name,256);
        $changed=readPageBuffers159($service,$name);
        $db=f159Connect($name);
        $catalogue=f159Read($db,'SELECT ID,TITLE,QTY FROM LAB_ITEMS ORDER BY ID');
        f159Close($db);
    } finally {
        if(is_resource($db))f159Close($db);
        if($restore) {
            if($service===null)$service=f159Service();
            $restoreJob=setPageBuffers159($service,$name,$original);
        }
    }
    $restored=readPageBuffers159($service,$name);
    $rows=[['Исходное число page buffers в заголовке',$original],['Запрошенное число страниц',256],
        ['Прочитано из заголовка после изменения',$changed],
        ['Каталог при новой настройке','Cable — '.$catalogue[0]['QTY'].'; Clamp — '.$catalogue[1]['QTY']],
        ['После восстановления',$restored],['Исходное значение возвращено',$restored===$original]];
    $checks=['fixture_default_buffers'=>$original===0,
        'changed_buffers_readback'=>$changed===256 && $changedJob['started'] && $changedJob['completion_read'],
        'catalogue_unchanged'=>$catalogue===[['ID'=>1,'TITLE'=>'Cable','QTY'=>3],['ID'=>2,'TITLE'=>'Clamp','QTY'=>0]],
        'restored_buffers_readback'=>$restored===$original && $restoreJob['started'] && $restoreJob['completion_read']];
    $observations=['original_page_buffers'=>$original,'requested_page_buffers'=>256,'readback_page_buffers'=>$changed,
        'restored_page_buffers'=>$restored,'catalogue'=>$catalogue,'change'=>$changedJob,'restore'=>$restoreJob,
        'unit'=>'database pages; not bytes or megabytes'];

} finally {
    if(is_resource($db)){f159Close($db);}
    if(is_resource($service)){f159Detach($service);}
    $removed=f159Cleanup($owned);
}

f159Report('fb159-page-buffers','Настроить число страниц кэша и проверить сохранённое значение',$rows,$checks,$observations,$runtime,$owned,$removed);

Исходное число page buffers в заголовке — 0
Запрошенное число страниц — 256
Прочитано из заголовка после изменения — 256
Каталог при новой настройке — Cable — 3; Clamp — 0
После восстановления — 0
Исходное значение возвращено — да

Распакуйте архив целиком в собственную папку и выполните example.php по README.txt. lab.php содержит проверку владельца, создание синтетической базы, SQL-помощники, чтение Service API и уборку. seed.sql показывает исходные Cable/3 и Clamp/0. result.html отображает предметный результат, result.json сохраняет наблюдения, metrics.json — проверки. После работы собственная база и промежуточный backup удаляются; отчёты остаются.