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

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

    $source=f157CreateDatabase($service,$owned,'catalog');
    $db=f157Connect($source);
    f157Command($db,'UPDATE LAB_ITEMS SET TITLE=? WHERE ID=?',['Кабель',1]);
    f157Command($db,'UPDATE LAB_ITEMS SET TITLE=? WHERE ID=?',['Клемма',2]);f157Commit($db);
    $before=f157Read($db,'SELECT ID,TITLE,QTY FROM LAB_ITEMS ORDER BY ID');f157Commit($db);f157Close($db);
    $backup=f157NewBackup('catalog');
    $backupLog=f157Backup($service,$source,$backup);
    $restored=f157RestoreDatabase($service,$owned,'catalog_copy',$backup);
    $db=f157Connect($restored);
    $after=f157Read($db,'SELECT ID,TITLE,QTY FROM LAB_ITEMS ORDER BY ID');f157Commit($db);f157Close($db);
    $expected=[['ID'=>1,'TITLE'=>'Кабель','QTY'=>3],['ID'=>2,'TITLE'=>'Клемма','QTY'=>0]];
    $rows=[['Первый восстановленный товар',$after[0]['TITLE']],['Остаток первого товара',$after[0]['QTY']],
        ['Второй восстановленный товар',$after[1]['TITLE']],['Остаток второго товара',$after[1]['QTY']],
        ['Количество восстановленных товаров',count($after)],['Строки источника и копии совпали',$before===$after],
        ['Назначение отличается от исходной базы',$source!==$restored],['Полный FBK создан',is_file($backup)&&filesize($backup)>0],
        ['Подробный вывод backup получен',is_string($backupLog)&&$backupLog!=='']];
    $checks=['source_fixture'=>$before===$expected,'restored_rows'=>$after===$expected,'rows_equal'=>$before===$after,
        'new_database'=>$source!==$restored,'backup_nonempty'=>is_file($backup)&&filesize($backup)>0,
        'backup_output_read'=>is_string($backupLog)&&$backupLog!=='','zero_stock_retained'=>$after[1]['QTY']===0];
    $observations=['source_rows'=>$before,'restored_rows'=>$after,'backup_basename'=>basename($backup),
        'backup_bytes'=>filesize($backup),'backup_sha256'=>hash_file('sha256',$backup),
        'backup_output_received'=>true,'raw_service_log_published'=>false,'existing_database_replaced'=>false];

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

f157Report('fb157-full-backup','Сделать полную копию каталога и получить те же товары в новой базе',$rows,$checks,$observations,$runtime,$owned,$removed);

Первый восстановленный товар — Кабель
Остаток первого товара — 3
Второй восстановленный товар — Клемма
Остаток второго товара — 0
Количество восстановленных товаров — 2
Строки источника и копии совпали — да
Назначение отличается от исходной базы — да
Полный FBK создан — да
Подробный вывод backup получен — да

Запустите example.php по README.txt. Создаются две собственные базы: источник и восстановленная копия. Программа не требует существующей рабочей базы: она использует приложенный синтетический шаблон. После наблюдений удаляются только базы и промежуточные FBK своего запуска; result.html, result.json и metrics.json остаются. Защита в lab.php проверяет собственный реестр, фактический путь соединения и маркер перед удалением. Сырой журнал службы с путями в публичный отчёт не попадает.

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

    $source=f157CreateDatabase($service,$owned,'schema_src');
    $db=f157Connect($source);
    $sourceCount=(int)f157Read($db,'SELECT COUNT(*) AS N FROM LAB_ITEMS')[0]['N'];f157Commit($db);f157Close($db);
    $backup=f157NewBackup('schema');
    $backupLog=f157Backup($service,$source,$backup,IBASE_BKP_METADATA_ONLY);
    $restored=f157RestoreDatabase($service,$owned,'schema_copy',$backup);
    $db=f157Connect($restored);
    $fields=f157Read($db,'SELECT TRIM(RDB$FIELD_NAME) AS FIELD_NAME FROM RDB$RELATION_FIELDS WHERE RDB$RELATION_NAME=? ORDER BY RDB$FIELD_POSITION',['LAB_ITEMS']);
    $columns=array_column($fields,'FIELD_NAME');
    $emptyCount=(int)f157Read($db,'SELECT COUNT(*) AS N FROM LAB_ITEMS')[0]['N'];
    f157Commit($db);f157Close($db);
    $db=f157Connect($source);
    $stillSource=(int)f157Read($db,'SELECT COUNT(*) AS N FROM LAB_ITEMS')[0]['N'];f157Commit($db);f157Close($db);
    $rows=[['Товаров в исходной базе',$sourceCount],['Таблица в восстановленной схеме','LAB_ITEMS'],
        ['Восстановленные столбцы',implode(', ',$columns)],['Товаров в восстановленной базе',$emptyCount],
        ['Исходная база сохранила товары',$stillSource],['Пустота ожидаема из-за METADATA_ONLY',$emptyCount===0&&$sourceCount===2],
        ['Схема восстановлена под новым именем',$source!==$restored]];
    $checks=['source_has_two'=>$sourceCount===2,'schema_columns'=>$columns===['ID','TITLE','QTY'],
        'schema_without_rows'=>$emptyCount===0,'source_unchanged'=>$stillSource===2,'separate_destination'=>$source!==$restored,
        'metadata_backup_nonempty'=>is_file($backup)&&filesize($backup)>0];
    $observations=['backup_mode'=>'IBASE_BKP_METADATA_ONLY','source_row_count'=>$sourceCount,'restored_columns'=>$columns,
        'restored_row_count'=>$emptyCount,'source_after'=>$stillSource,'backup_bytes'=>filesize($backup),
        'backup_output_received'=>is_string($backupLog)&&$backupLog!=='','raw_service_log_published'=>false];

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

f157Report('fb157-metadata-copy','Получить пустую базу с той же схемой для нового теста',$rows,$checks,$observations,$runtime,$owned,$removed);

Товаров в исходной базе — 2
Таблица в восстановленной схеме — LAB_ITEMS
Восстановленные столбцы — ID, TITLE, QTY
Товаров в восстановленной базе — 0
Исходная база сохранила товары — 2
Пустота ожидаема из-за METADATA_ONLY — да
Схема восстановлена под новым именем — да

Запустите example.php по README.txt. Создаются две собственные базы: источник и восстановленная копия. Программа не требует существующей рабочей базы: она использует приложенный синтетический шаблон. После наблюдений удаляются только базы и промежуточные FBK своего запуска; result.html, result.json и metrics.json остаются. Защита в lab.php проверяет собственный реестр, фактический путь соединения и маркер перед удалением. Сырой журнал службы с путями в публичный отчёт не попадает.

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

    $source=f157CreateDatabase($service,$owned,'invoice');$db=f157Connect($source);
    f157Command($db,'UPDATE LAB_ITEMS SET TITLE=? WHERE ID=?',['Кабель',1]);
    f157Command($db,'UPDATE LAB_ITEMS SET TITLE=? WHERE ID=?',['Клемма',2]);f157Commit($db);
    f157Command($db,'CREATE TABLE LAB_DOCUMENTS (ID INTEGER NOT NULL PRIMARY KEY, TITLE VARCHAR(60) CHARACTER SET UTF8 NOT NULL, DOC_TEXT BLOB SUB_TYPE TEXT CHARACTER SET UTF8)');f157Commit($db);
    f157Command($db,'CREATE TABLE LAB_DOCUMENT_LINES (ID INTEGER NOT NULL PRIMARY KEY, DOC_ID INTEGER NOT NULL, ITEM_ID INTEGER NOT NULL, QUANTITY INTEGER NOT NULL CHECK (QUANTITY>0), UNIT_CENTS INTEGER NOT NULL CHECK (UNIT_CENTS>=0), CONSTRAINT FK157_DOC FOREIGN KEY (DOC_ID) REFERENCES LAB_DOCUMENTS(ID), CONSTRAINT FK157_ITEM FOREIGN KEY (ITEM_ID) REFERENCES LAB_ITEMS(ID))');f157Commit($db);
    $document='Накладная № 7. Кабель — 3 шт.; Клемма — 2 шт.';$blob=null;
    try {
        $blob=ibase_blob_create($db);
        if ($blob===false) {throw new RuntimeException('Документ-BLOB не открыт');}
        if (ibase_blob_add($blob,$document)===false) {throw new RuntimeException('Текст документа не записан');}
        $blobId=ibase_blob_close($blob);
        if ($blobId===false) {throw new RuntimeException('Документ-BLOB не завершён');}$blob=null;
        f157Command($db,'INSERT INTO LAB_DOCUMENTS (ID,TITLE,DOC_TEXT) VALUES (?,?,?)',[7,'Накладная № 7',$blobId]);
    } finally {if (is_resource($blob)) {ibase_blob_cancel($blob);$blob=null;}}
    f157Command($db,'INSERT INTO LAB_DOCUMENT_LINES (ID,DOC_ID,ITEM_ID,QUANTITY,UNIT_CENTS) VALUES (?,?,?,?,?)',[1,7,1,3,12500]);
    f157Command($db,'INSERT INTO LAB_DOCUMENT_LINES (ID,DOC_ID,ITEM_ID,QUANTITY,UNIT_CENTS) VALUES (?,?,?,?,?)',[2,7,2,2,2000]);
    f157Commit($db);f157Close($db);
    $backup=f157NewBackup('invoice');f157Backup($service,$source,$backup);
    $restored=f157RestoreDatabase($service,$owned,'invoice_copy',$backup);$db=f157Connect($restored);
    $lines=f157Read($db,'SELECT L.ID,P.TITLE,L.QUANTITY,L.UNIT_CENTS FROM LAB_DOCUMENT_LINES L JOIN LAB_ITEMS P ON P.ID=L.ITEM_ID WHERE L.DOC_ID=? ORDER BY L.ID',[7]);
    $sum=(int)f157Read($db,'SELECT CAST(SUM(QUANTITY*UNIT_CENTS) AS BIGINT) AS TOTAL_CENTS FROM LAB_DOCUMENT_LINES WHERE DOC_ID=?',[7])[0]['TOTAL_CENTS'];
    $foreignKeys=(int)f157Read($db,'SELECT COUNT(*) AS N FROM RDB$RELATION_CONSTRAINTS WHERE RDB$RELATION_NAME=? AND RDB$CONSTRAINT_TYPE=?',['LAB_DOCUMENT_LINES','FOREIGN KEY'])[0]['N'];
    $saved=f157Read($db,'SELECT TITLE,DOC_TEXT FROM LAB_DOCUMENTS WHERE ID=?',[7])[0];
    $actualDocument='';$blob=null;
    try {
        $blob=ibase_blob_open($db,$saved['DOC_TEXT']);
        if ($blob===false) {throw new RuntimeException('Восстановленный BLOB не открыт');}
        while (true) {
            $part=ibase_blob_get($blob,8192);
            if ($part===false) {throw new RuntimeException('Текст восстановленного BLOB не прочитан');}
            if ($part==='') {break;}$actualDocument.=$part;
        }
        if (ibase_blob_close($blob)===false) {throw new RuntimeException('Восстановленный BLOB не закрыт');}$blob=null;
    } finally {if (is_resource($blob)) {ibase_blob_close($blob);$blob=null;}}
    f157Commit($db);f157Close($db);
    $expectedLines=[['ID'=>1,'TITLE'=>'Кабель','QUANTITY'=>3,'UNIT_CENTS'=>12500],['ID'=>2,'TITLE'=>'Клемма','QUANTITY'=>2,'UNIT_CENTS'=>2000]];
    $rows=[['Документ',$saved['TITLE']],['Первая позиция',$lines[0]['TITLE'].' — '.$lines[0]['QUANTITY'].' × '.$lines[0]['UNIT_CENTS'].' коп.'],
        ['Вторая позиция',$lines[1]['TITLE'].' — '.$lines[1]['QUANTITY'].' × '.$lines[1]['UNIT_CENTS'].' коп.'],
        ['Итог SQL в копейках',$sum],['Внешних связей у таблицы позиций',$foreignKeys],['Текст восстановленного документа',$actualDocument],
        ['Байты BLOB совпали',$actualDocument===$document],['Строки позиций совпали',$lines===$expectedLines]];
    $checks=['document_title'=>$saved['TITLE']==='Накладная № 7','exact_line_rows'=>$lines===$expectedLines,
        'sql_total'=>$sum===41500,'foreign_key_definitions'=>$foreignKeys===2,'exact_blob'=>$actualDocument===$document,
        'blob_hash'=>hash('sha256',$actualDocument)===hash('sha256',$document),'new_database'=>$source!==$restored];
    $observations=['document_title'=>$saved['TITLE'],'lines'=>$lines,'total_cents'=>$sum,'foreign_key_count'=>$foreignKeys,
        'document_text'=>$actualDocument,'document_sha256'=>hash('sha256',$actualDocument),'blob_id_not_compared'=>true,
        'backup_bytes'=>filesize($backup),'raw_service_log_published'=>false,'late_restore_failure_simulated'=>false];

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

f157Report('fb157-restore-checks','Проверить восстановление накладной: позиции, связи, итог и BLOB-документ',$rows,$checks,$observations,$runtime,$owned,$removed);

Документ — Накладная № 7
Первая позиция — Кабель — 3 × 12500 коп.
Вторая позиция — Клемма — 2 × 2000 коп.
Итог SQL в копейках — 41500
Внешних связей у таблицы позиций — 2
Текст восстановленного документа — Накладная № 7. Кабель — 3 шт.; Клемма — 2 шт.
Байты BLOB совпали — да
Строки позиций совпали — да

Запустите example.php по README.txt. Создаются две собственные базы: источник и восстановленная копия. Программа не требует существующей рабочей базы: она использует приложенный синтетический шаблон. После наблюдений удаляются только базы и промежуточные FBK своего запуска; result.html, result.json и metrics.json остаются. Защита в lab.php проверяет собственный реестр, фактический путь соединения и маркер перед удалением. Сырой журнал службы с путями в публичный отчёт не попадает.

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

    $template=f157Template();$templateHash=hash_file('sha256',f157Path($template));
    $restored=f157RestoreDatabase($service,$owned,'disposable',$template);
    $db=f157Connect($restored);$items=f157Read($db,'SELECT ID,TITLE,QTY FROM LAB_ITEMS ORDER BY ID');
    f157Commit($db);f157Close($db);
    // This name is syntactically inside the laboratory, but was never registered as an owned database.
    $foreign=f157NewName('foreign','fdb');$guardRefused=false;
    $removedBefore=count(f157State()['removed']);
    try {f157DropDatabase($owned,$foreign);}
    catch (RuntimeException $error) {
        if ($error->getMessage()!=='База не принадлежит этому запуску.') {throw $error;}
        $guardRefused=true;
    }
    $removedAfterRefusal=count(f157State()['removed']);
    $ownStillPresent=is_file(f157Path($restored));
    $dropResult=f157DropDatabase($owned,$restored);
    clearstatcache(true,f157Path($restored));$ownAbsent=!file_exists(f157Path($restored));
    $templateUnchanged=is_file(f157Path($template))&&hash_file('sha256',f157Path($template))===$templateHash;
    $rows=[['Первый товар до удаления',$items[0]['TITLE'].' — '.$items[0]['QTY']],
        ['Второй товар до удаления',$items[1]['TITLE'].' — '.$items[1]['QTY']],
        ['Чужое имя отклонено до удаления',$guardRefused],['Отказ не изменил реестр удалённых баз',$removedBefore===$removedAfterRefusal],
        ['Своя копия сохранилась после чужого запроса',$ownStillPresent],['Удаление своей копии вернуло true',$dropResult],
        ['Файл своей копии отсутствует',$ownAbsent],['Шаблон FBK остался неизменным до общей очистки',$templateUnchanged]];
    $checks=['restored_fixture'=>$items===[['ID'=>1,'TITLE'=>'Cable','QTY'=>3],['ID'=>2,'TITLE'=>'Clamp','QTY'=>0]],
        'unowned_refused'=>$guardRefused,'no_removal_on_refusal'=>$removedBefore===$removedAfterRefusal,
        'owned_survived_refusal'=>$ownStillPresent,'owned_drop_success'=>$dropResult===true,'owned_file_absent'=>$ownAbsent,
        'template_unchanged'=>$templateUnchanged,'only_one_owned'=>count($owned)===1];
    $observations=['rows_before_drop'=>$items,'unowned_name_registered'=>false,'unowned_request_rejected'=>$guardRefused,
        'removed_count_before'=>$removedBefore,'removed_count_after_refusal'=>$removedAfterRefusal,
        'own_drop_return'=>$dropResult,'own_file_absent'=>$ownAbsent,'template_sha256'=>$templateHash,
        'template_unchanged_before_cleanup'=>$templateUnchanged,'unowned_connection_opened'=>false];

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

f157Report('fb157-owned-drop','Удалить свою проверочную базу и заранее отклонить чужой путь',$rows,$checks,$observations,$runtime,$owned,$removed);

Первый товар до удаления — Cable — 3
Второй товар до удаления — Clamp — 0
Чужое имя отклонено до удаления — да
Отказ не изменил реестр удалённых баз — да
Своя копия сохранилась после чужого запроса — да
Удаление своей копии вернуло true — да
Файл своей копии отсутствует — да
Шаблон FBK остался неизменным до общей очистки — да

Запустите example.php по README.txt. Создаются одна собственная восстановленная база. Программа не требует существующей рабочей базы: она использует приложенный синтетический шаблон. После наблюдений удаляются только базы и промежуточные FBK своего запуска; result.html, result.json и metrics.json остаются. Защита в lab.php проверяет собственный реестр, фактический путь соединения и маркер перед удалением. Сырой журнал службы с путями в публичный отчёт не попадает.