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

<?php
declare(strict_types=1);
require __DIR__.'/lab.php';
$db=null;$owned=$removed=$rows=$checks=$observations=[];
try {
    $config=f162Config();$db=f162Connect($config);$runtime=f162Runtime($db,$config);

    function blobWriter162($context) {
        $call=f162Capture(static fn()=>fbird_blob_create($context));
        if (!is_resource($call['value']) || $call['warning']) {f162Failure('Новый BLOB не открыт',$call);}
        return $call['value'];
    }
    function blobAppend162($writer,string $bytes): void {
        $call=f162Capture(static fn()=>fbird_blob_add($writer,$bytes));
        // Successful add returns null, not true; native refusal is false/diagnostic.
        if ($call['value']===false || $call['warning'] || $call['code']!==0) {f162Failure('Порция не записана',$call);}
    }
    function blobFinish162(&$writer): string {
        $call=f162Capture(static fn()=>fbird_blob_close($writer));
        if (!is_string($call['value']) || $call['warning'] || $call['code']!==0) {f162Failure('BLOB не закрыт',$call);}
        $writer=null;
        return $call['value'];
    }
    function blobCancel162(&$writer): bool {
        $call=f162Capture(static fn()=>fbird_blob_cancel($writer));
        if ($call['value']!==true || $call['warning'] || $call['code']!==0) {f162Failure('Черновик BLOB не отменён',$call);}
        $writer=null;
        return true;
    }
    function blobInspect162($context,string $savedId,bool $smallText=false): array {
        // Always use the ID selected from the saved row, not the transient creation ID.
        $call=f162Capture(static fn()=>fbird_blob_open($context,$savedId));
        if (!is_resource($call['value']) || $call['warning']) {f162Failure('Сохранённый BLOB не открыт',$call);}
        $reader=$call['value'];unset($call);
        $bytes=0;$value='';$hash=hash_init('sha256');
        try {
            while (true) {
                $call=f162Capture(static fn()=>fbird_blob_get($reader,4096));
                if (!is_string($call['value']) || $call['warning'] || $call['code']!==0) {f162Failure('BLOB не прочитан',$call);}
                $chunk=$call['value'];
                if ($chunk==='') {break;}
                $bytes+=strlen($chunk);hash_update($hash,$chunk);
                if ($smallText) {
                    if ($bytes>4096) {throw new DomainException('Текст учебного предпросмотра превышает 4096 байт.');}
                    $value.=$chunk;
                }
            }
        } finally {
            $call=f162Capture(static fn()=>fbird_blob_close($reader));$reader=null;
            if ($call['value']===false || $call['warning']) {f162Failure('Читающий BLOB не закрыт',$call);}
        }
        return ['bytes'=>$bytes,'sha256'=>hash_final($hash),'text'=>$value];
    }

    $name=f162OwnTable($db,$owned,'notes','(order_id INTEGER NOT NULL PRIMARY KEY,revision_no INTEGER NOT NULL,note_text BLOB SUB_TYPE TEXT CHARACTER SET UTF8)');
    $q=f162Qualified($name);
    f162Command($db,"INSERT INTO $q(order_id,revision_no,note_text) VALUES(?,?,?)",[162,0,null]);
    f162Commit($db);
    $initial=f162Read($db,"SELECT revision_no AS \"revision\",note_text AS \"blob_id\" FROM $q WHERE order_id=?",[162])[0];
    $firstParts=['Доставка к 10:00.',"\nПозвонить заранее."];
    $writer=blobWriter162($db);
    try {
        foreach ($firstParts as $part) {blobAppend162($writer,$part);}
        $createdId=blobFinish162($writer);
        $changed=f162Query($db,"UPDATE $q SET note_text=?,revision_no=1 WHERE order_id=? AND revision_no=?",[$createdId,162,0]);
        if ($changed!==1) {throw new DomainException('Редакция заказа уже изменилась.');}
        f162Commit($db);
    } finally {if (is_resource($writer)) {blobCancel162($writer);}}
    $row1=f162Read($db,"SELECT revision_no AS \"revision\",note_text AS \"blob_id\" FROM $q WHERE order_id=?",[162])[0];
    $first=blobInspect162($db,$row1['blob_id'],true);
    f162Commit($db);
    // A closed BLOB is not an appendable file. Build a new complete value.
    $writer=blobWriter162($db);
    try {
        blobAppend162($writer,$first['text']);
        blobAppend162($writer,"\nВход со двора.");
        $replacementId=blobFinish162($writer);
        $changed=f162Query($db,"UPDATE $q SET note_text=?,revision_no=2 WHERE order_id=? AND revision_no=?",[$replacementId,162,1]);
        if ($changed!==1) {throw new DomainException('Редакция заказа уже изменилась.');}
        f162Commit($db);
    } finally {if (is_resource($writer)) {blobCancel162($writer);}}
    $row2=f162Read($db,"SELECT revision_no AS \"revision\",note_text AS \"blob_id\" FROM $q WHERE order_id=?",[162])[0];
    $second=blobInspect162($db,$row2['blob_id'],true);
    $firstText=implode('',$firstParts);$secondText=$firstText."\nВход со двора.";
    $rows=[['До первой записи',($initial['blob_id']===null?'SQL NULL':'другое')],['Первая редакция',$first['text']],
        ['Текущая редакция',$row2['revision']],['Инструкция после обновления',$second['text']],
        ['Байт UTF-8 во второй редакции',$second['bytes']],['Первая часть не потеряна',str_starts_with($second['text'],$first['text'])],
        ['SHA-256 соответствует полному новому тексту',$second['sha256']===hash('sha256',$secondText)]];
    $checks=['starts_with_null'=>$initial===['revision'=>0,'blob_id'=>null],
        'first_revision_read'=>$row1['revision']===1 && $first['text']===$firstText,
        'second_revision_read'=>$row2['revision']===2 && $second['text']===$secondText,
        'new_text_bytes'=>$second['bytes']===strlen($secondText),'new_text_hash'=>$second['sha256']===hash('sha256',$secondText),
        'writers_closed'=>$writer===null];
    $observations=['order_id'=>162,'initial_null'=>$initial['blob_id']===null,
        'first'=>['revision'=>1,'text'=>$first['text'],'bytes'=>$first['bytes']],
        'second'=>['revision'=>2,'text'=>$second['text'],'bytes'=>$second['bytes'],'sha256'=>$second['sha256']],
        'updates_checked_expected_revision'=>true,'retained_history_table'=>false];

} finally {
    if (function_exists('f162HttpChildrenStopped') && !f162HttpChildrenStopped()) {
        throw new RuntimeException('Дочерний HTTP-процесс ещё работает: учебная таблица сохранена для точного восстановления.');
    }
    if (is_resource($db)) {try {$removed=f162Cleanup($db,$owned);} finally {ibase_close($db);}}
}

f162Report('fb162-note-revisions','Редакция инструкции курьеру: из NULL к двум последовательным текстам',$rows,$checks,$observations,$runtime,$owned,$removed);

До первой записи — SQL NULL
Первая редакция — Доставка к 10:00.
Позвонить заранее.
Текущая редакция — 2
Инструкция после обновления — Доставка к 10:00.
Позвонить заранее.
Вход со двора.
Байт UTF-8 во второй редакции — 87
Первая часть не потеряна — да
SHA-256 соответствует полному новому тексту — да

Самостоятельный CLI-пример: одна своя таблица Firebird, настоящая запись BLOB и чтение после сохранения; result.html/result.json; закрытие ресурсов и удаление таблицы. lab.php, README.txt и нужный CSV приложены.

<?php
declare(strict_types=1);
require __DIR__.'/lab.php';
$db=null;$owned=$removed=$rows=$checks=$observations=[];
try {
    $config=f162Config();$db=f162Connect($config);$runtime=f162Runtime($db,$config);

    function blobWriter162($context) {
        $call=f162Capture(static fn()=>fbird_blob_create($context));
        if (!is_resource($call['value']) || $call['warning']) {f162Failure('Новый BLOB не открыт',$call);}
        return $call['value'];
    }
    function blobAppend162($writer,string $bytes): void {
        $call=f162Capture(static fn()=>fbird_blob_add($writer,$bytes));
        // Successful add returns null, not true; native refusal is false/diagnostic.
        if ($call['value']===false || $call['warning'] || $call['code']!==0) {f162Failure('Порция не записана',$call);}
    }
    function blobFinish162(&$writer): string {
        $call=f162Capture(static fn()=>fbird_blob_close($writer));
        if (!is_string($call['value']) || $call['warning'] || $call['code']!==0) {f162Failure('BLOB не закрыт',$call);}
        $writer=null;
        return $call['value'];
    }
    function blobCancel162(&$writer): bool {
        $call=f162Capture(static fn()=>fbird_blob_cancel($writer));
        if ($call['value']!==true || $call['warning'] || $call['code']!==0) {f162Failure('Черновик BLOB не отменён',$call);}
        $writer=null;
        return true;
    }
    function blobInspect162($context,string $savedId,bool $smallText=false): array {
        // Always use the ID selected from the saved row, not the transient creation ID.
        $call=f162Capture(static fn()=>fbird_blob_open($context,$savedId));
        if (!is_resource($call['value']) || $call['warning']) {f162Failure('Сохранённый BLOB не открыт',$call);}
        $reader=$call['value'];unset($call);
        $bytes=0;$value='';$hash=hash_init('sha256');
        try {
            while (true) {
                $call=f162Capture(static fn()=>fbird_blob_get($reader,4096));
                if (!is_string($call['value']) || $call['warning'] || $call['code']!==0) {f162Failure('BLOB не прочитан',$call);}
                $chunk=$call['value'];
                if ($chunk==='') {break;}
                $bytes+=strlen($chunk);hash_update($hash,$chunk);
                if ($smallText) {
                    if ($bytes>4096) {throw new DomainException('Текст учебного предпросмотра превышает 4096 байт.');}
                    $value.=$chunk;
                }
            }
        } finally {
            $call=f162Capture(static fn()=>fbird_blob_close($reader));$reader=null;
            if ($call['value']===false || $call['warning']) {f162Failure('Читающий BLOB не закрыт',$call);}
        }
        return ['bytes'=>$bytes,'sha256'=>hash_final($hash),'text'=>$value];
    }

    $name=f162OwnTable($db,$owned,'packets','(attachment_id INTEGER NOT NULL PRIMARY KEY,file_name VARCHAR(80) NOT NULL,byte_size INTEGER NOT NULL,payload BLOB SUB_TYPE BINARY)');
    $q=f162Qualified($name);
    $input=tmpfile();
    if ($input===false) {throw new RuntimeException('Не создан учебный входной файл.');}
    $writer=null;$expectedHash=hash_init('sha256');$expectedBytes=0;$sentBytes=0;$calls=0;
    try {
        // Each synthetic record: four-byte unsigned sequence number + eight payload bytes.
        for ($index=0;$index<10000;$index++) {
            $record=pack('N',$index)."FB162\0\xFF\n";
            if (fwrite($input,$record)!==strlen($record)) {throw new RuntimeException('Входной файл записан не полностью.');}
            hash_update($expectedHash,$record);$expectedBytes+=strlen($record);
        }
        $expectedSha=hash_final($expectedHash);
        if (rewind($input)!==true) {throw new RuntimeException('Файл не перемотан.');}
        $writer=blobWriter162($db);
        while (!feof($input)) {
            $chunk=fread($input,4096);
            if ($chunk===false) {throw new RuntimeException('Не удалось прочитать порцию файла.');}
            if ($chunk==='') {
                if (!feof($input)) {throw new RuntimeException('Чтение остановилось до EOF.');}
                break;
            }
            blobAppend162($writer,$chunk);$sentBytes+=strlen($chunk);$calls++;
        }
        if ($sentBytes!==$expectedBytes) {throw new RuntimeException('Входной файл передан не полностью.');}
        $id=blobFinish162($writer);
        f162Command($db,"INSERT INTO $q(attachment_id,file_name,byte_size,payload) VALUES(?,?,?,?)",[162,'device-sequence.bin',$sentBytes,$id]);
        f162Commit($db);
    } finally {
        try {if (is_resource($writer)) {blobCancel162($writer);}}
        finally {fclose($input);$input=null;}
    }
    $row=f162Read($db,"SELECT file_name AS \"name\",byte_size AS \"declared_bytes\",payload AS \"blob_id\" FROM $q WHERE attachment_id=?",[162])[0];
    $saved=blobInspect162($db,$row['blob_id']);
    $rows=[['Файл',$row['name']],['Записей устройства',10000],['Байт передано',$sentBytes],['Вызовов add',$calls],
        ['Байт прочитано после commit',$saved['bytes']],['SHA-256',$saved['sha256']],
        ['Длина и содержимое совпали',$saved['bytes']===$expectedBytes && $saved['sha256']===$expectedSha],
        ['Большой текстовый буфер не создавался',$saved['text']==='']];
    $checks=['source_bytes'=>$expectedBytes===120000,'chunked_writes'=>$calls===30 && $sentBytes===120000,
        'stored_metadata'=>$row['declared_bytes']===120000,'roundtrip_length'=>$saved['bytes']===$sentBytes,
        'roundtrip_hash'=>$saved['sha256']===$expectedSha,'bounded_readback'=>$saved['text']==='',
        'file_and_blob_closed'=>$input===null && $writer===null];
    $observations=['source_records'=>10000,'record_bytes'=>12,'payload_hex'=>'464231363200ff0a','sequence_encoding'=>'unsigned32-big-endian',
        'chunk_bytes'=>4096,'write_calls'=>$calls,'expected_bytes'=>$expectedBytes,'actual_bytes'=>$saved['bytes'],
        'source_sha256'=>$expectedSha,'saved_sha256'=>$saved['sha256'],'readback_kept_whole_payload'=>false];

} finally {
    if (function_exists('f162HttpChildrenStopped') && !f162HttpChildrenStopped()) {
        throw new RuntimeException('Дочерний HTTP-процесс ещё работает: учебная таблица сохранена для точного восстановления.');
    }
    if (is_resource($db)) {try {$removed=f162Cleanup($db,$owned);} finally {ibase_close($db);}}
}

f162Report('fb162-chunked-file','Журнал устройства: сохранить 10000 бинарных записей без общего буфера',$rows,$checks,$observations,$runtime,$owned,$removed);

Файл — device-sequence.bin
Записей устройства — 10000
Байт передано — 120000
Вызовов add — 30
Байт прочитано после commit — 120000
SHA-256 — 345e92d9a9b697752abbc64fa4e2ff9eb450e0e1516f1689dc6f115e68477ca0
Длина и содержимое совпали — да
Большой текстовый буфер не создавался — да

Самостоятельный CLI-пример: одна своя таблица Firebird, настоящая запись BLOB и чтение после сохранения; result.html/result.json; закрытие ресурсов и удаление таблицы. lab.php, README.txt и нужный CSV приложены.

<?php
declare(strict_types=1);
require __DIR__.'/lab.php';
$db=null;$owned=$removed=$rows=$checks=$observations=[];
try {
    $config=f162Config();$db=f162Connect($config);$runtime=f162Runtime($db,$config);

    function blobWriter162($context) {
        $call=f162Capture(static fn()=>fbird_blob_create($context));
        if (!is_resource($call['value']) || $call['warning']) {f162Failure('Новый BLOB не открыт',$call);}
        return $call['value'];
    }
    function blobAppend162($writer,string $bytes): void {
        $call=f162Capture(static fn()=>fbird_blob_add($writer,$bytes));
        // Successful add returns null, not true; native refusal is false/diagnostic.
        if ($call['value']===false || $call['warning'] || $call['code']!==0) {f162Failure('Порция не записана',$call);}
    }
    function blobFinish162(&$writer): string {
        $call=f162Capture(static fn()=>fbird_blob_close($writer));
        if (!is_string($call['value']) || $call['warning'] || $call['code']!==0) {f162Failure('BLOB не закрыт',$call);}
        $writer=null;
        return $call['value'];
    }
    function blobCancel162(&$writer): bool {
        $call=f162Capture(static fn()=>fbird_blob_cancel($writer));
        if ($call['value']!==true || $call['warning'] || $call['code']!==0) {f162Failure('Черновик BLOB не отменён',$call);}
        $writer=null;
        return true;
    }
    function blobInspect162($context,string $savedId,bool $smallText=false): array {
        // Always use the ID selected from the saved row, not the transient creation ID.
        $call=f162Capture(static fn()=>fbird_blob_open($context,$savedId));
        if (!is_resource($call['value']) || $call['warning']) {f162Failure('Сохранённый BLOB не открыт',$call);}
        $reader=$call['value'];unset($call);
        $bytes=0;$value='';$hash=hash_init('sha256');
        try {
            while (true) {
                $call=f162Capture(static fn()=>fbird_blob_get($reader,4096));
                if (!is_string($call['value']) || $call['warning'] || $call['code']!==0) {f162Failure('BLOB не прочитан',$call);}
                $chunk=$call['value'];
                if ($chunk==='') {break;}
                $bytes+=strlen($chunk);hash_update($hash,$chunk);
                if ($smallText) {
                    if ($bytes>4096) {throw new DomainException('Текст учебного предпросмотра превышает 4096 байт.');}
                    $value.=$chunk;
                }
            }
        } finally {
            $call=f162Capture(static fn()=>fbird_blob_close($reader));$reader=null;
            if ($call['value']===false || $call['warning']) {f162Failure('Читающий BLOB не закрыт',$call);}
        }
        return ['bytes'=>$bytes,'sha256'=>hash_final($hash),'text'=>$value];
    }

    $name=f162OwnTable($db,$owned,'csv','(import_id INTEGER NOT NULL PRIMARY KEY,file_name VARCHAR(80) NOT NULL,payload BLOB SUB_TYPE BINARY)');
    $q=f162Qualified($name);
    $path=__DIR__.'/incoming.csv';$input=fopen($path,'rb');
    if ($input===false) {throw new RuntimeException('incoming.csv не открыт.');}
    try {
        $header=fgetcsv($input,0,';','"','');
        if ($header!==['id','title','qty']) {throw new DomainException('Неизвестные колонки CSV.');}
        $afterHeader=ftell($input);
        if (rewind($input)!==true) {throw new RuntimeException('Нельзя вернуться к началу CSV.');}
        $call=f162Capture(static fn()=>fbird_blob_import($db,$input));
        if (!is_string($call['value']) || $call['warning'] || $call['code']!==0) {f162Failure('CSV не импортирован',$call);}
        $id=$call['value'];$endPosition=ftell($input);$callerStillOwnsFile=is_resource($input);
    } finally {fclose($input);$input=null;}
    f162Command($db,"INSERT INTO $q(import_id,file_name,payload) VALUES(?,?,?)",[162,'incoming.csv',$id]);
    f162Commit($db);
    $row=f162Read($db,"SELECT file_name AS \"name\",payload AS \"blob_id\" FROM $q WHERE import_id=?",[162])[0];
    $saved=blobInspect162($db,$row['blob_id'],true);
    $source=file_get_contents($path);
    if ($source===false) {throw new RuntimeException('Контрольный CSV недоступен.');}
    // BLOB archive storage is distinct from parsing/accepting product rows.
    $csvStream=tmpfile();
    if ($csvStream===false) {throw new RuntimeException('Не создан поток для разбора CSV.');}
    try {
        if (fwrite($csvStream,$saved['text'])!==strlen($saved['text']) || rewind($csvStream)!==true) {throw new RuntimeException('CSV не подготовлен к разбору.');}
        $savedHeader=fgetcsv($csvStream,0,';','"','');$products=[];$total=0;
        while (($fields=fgetcsv($csvStream,0,';','"',''))!==false) {
            if (count($fields)!==3 || !ctype_digit($fields[0]) || !ctype_digit($fields[2])) {throw new DomainException('Некорректная строка CSV.');}
            $products[]=['id'=>(int)$fields[0],'title'=>$fields[1],'qty'=>(int)$fields[2]];$total+=(int)$fields[2];
        }
    } finally {fclose($csvStream);$csvStream=null;}
    $rows=[['Файл в архиве',$row['name']],['Заголовок сохранён',implode(';',$savedHeader)],['Товарных строк',count($products)],
        ['Название с разделителем',$products[0]['title']],['Нулевой остаток',$products[1]['qty']],['Сумма количеств',$total],
        ['Байт полного файла',$saved['bytes']],['Исходные байты совпали',$saved['text']===$source],['Файл закрыл вызывающий код',$callerStillOwnsFile && $input===null]];
    $checks=['header_checked_before_import'=>$header===['id','title','qty'] && $afterHeader>0,
        'full_import_after_rewind'=>$savedHeader===$header && $endPosition===strlen($source),
        'raw_file_roundtrip'=>$saved['text']===$source && $saved['sha256']===hash('sha256',$source),
        'parsed_rows'=>$products===[['id'=>701,'title'=>'Кабель; USB','qty'=>3],['id'=>702,'title'=>'Клемма','qty'=>0],['id'=>703,'title'=>'Лента','qty'=>12]],
        'quantity_total'=>$total===15,'streams_closed'=>$input===null && $csvStream===null];
    $observations=['file_name'=>'incoming.csv','header'=>$savedHeader,'products'=>$products,'quantity_total'=>$total,
        'source_bytes'=>strlen($source),'saved_bytes'=>$saved['bytes'],'sha256'=>$saved['sha256'],
        'position_after_header'=>$afterHeader,'position_after_import'=>$endPosition,'raw_archive_is_not_product_insert'=>true];

} finally {
    if (function_exists('f162HttpChildrenStopped') && !f162HttpChildrenStopped()) {
        throw new RuntimeException('Дочерний HTTP-процесс ещё работает: учебная таблица сохранена для точного восстановления.');
    }
    if (is_resource($db)) {try {$removed=f162Cleanup($db,$owned);} finally {ibase_close($db);}}
}

f162Report('fb162-import-csv','Архив исходного CSV: проверить заголовок и сохранить файл целиком',$rows,$checks,$observations,$runtime,$owned,$removed);

Файл в архиве — incoming.csv
Заголовок сохранён — id;title;qty
Товарных строк — 3
Название с разделителем — Кабель; USB
Нулевой остаток — 0
Сумма количеств — 15
Байт полного файла — 76
Исходные байты совпали — да
Файл закрыл вызывающий код — да

Самостоятельный CLI-пример: одна своя таблица Firebird, настоящая запись BLOB и чтение после сохранения; result.html/result.json; закрытие ресурсов и удаление таблицы. lab.php, README.txt и нужный CSV приложены.

<?php
declare(strict_types=1);
require __DIR__.'/lab.php';
$db=null;$owned=$removed=$rows=$checks=$observations=[];
try {
    $config=f162Config();$db=f162Connect($config);$runtime=f162Runtime($db,$config);

    function blobWriter162($context) {
        $call=f162Capture(static fn()=>fbird_blob_create($context));
        if (!is_resource($call['value']) || $call['warning']) {f162Failure('Новый BLOB не открыт',$call);}
        return $call['value'];
    }
    function blobAppend162($writer,string $bytes): void {
        $call=f162Capture(static fn()=>fbird_blob_add($writer,$bytes));
        // Successful add returns null, not true; native refusal is false/diagnostic.
        if ($call['value']===false || $call['warning'] || $call['code']!==0) {f162Failure('Порция не записана',$call);}
    }
    function blobFinish162(&$writer): string {
        $call=f162Capture(static fn()=>fbird_blob_close($writer));
        if (!is_string($call['value']) || $call['warning'] || $call['code']!==0) {f162Failure('BLOB не закрыт',$call);}
        $writer=null;
        return $call['value'];
    }
    function blobCancel162(&$writer): bool {
        $call=f162Capture(static fn()=>fbird_blob_cancel($writer));
        if ($call['value']!==true || $call['warning'] || $call['code']!==0) {f162Failure('Черновик BLOB не отменён',$call);}
        $writer=null;
        return true;
    }
    function blobInspect162($context,string $savedId,bool $smallText=false): array {
        // Always use the ID selected from the saved row, not the transient creation ID.
        $call=f162Capture(static fn()=>fbird_blob_open($context,$savedId));
        if (!is_resource($call['value']) || $call['warning']) {f162Failure('Сохранённый BLOB не открыт',$call);}
        $reader=$call['value'];unset($call);
        $bytes=0;$value='';$hash=hash_init('sha256');
        try {
            while (true) {
                $call=f162Capture(static fn()=>fbird_blob_get($reader,4096));
                if (!is_string($call['value']) || $call['warning'] || $call['code']!==0) {f162Failure('BLOB не прочитан',$call);}
                $chunk=$call['value'];
                if ($chunk==='') {break;}
                $bytes+=strlen($chunk);hash_update($hash,$chunk);
                if ($smallText) {
                    if ($bytes>4096) {throw new DomainException('Текст учебного предпросмотра превышает 4096 байт.');}
                    $value.=$chunk;
                }
            }
        } finally {
            $call=f162Capture(static fn()=>fbird_blob_close($reader));$reader=null;
            if ($call['value']===false || $call['warning']) {f162Failure('Читающий BLOB не закрыт',$call);}
        }
        return ['bytes'=>$bytes,'sha256'=>hash_final($hash),'text'=>$value];
    }

    $name=f162OwnTable($db,$owned,'replace','(attachment_id INTEGER NOT NULL PRIMARY KEY,file_name VARCHAR(80) NOT NULL,revision_no INTEGER NOT NULL,payload BLOB SUB_TYPE BINARY)');
    $q=f162Qualified($name);$approved="APPROVED:162\n";
    $writer=blobWriter162($db);
    try {
        blobAppend162($writer,$approved);$id=blobFinish162($writer);
        f162Command($db,"INSERT INTO $q(attachment_id,file_name,revision_no,payload) VALUES(?,?,?,?)",[162,'approved.txt',1,$id]);
        f162Commit($db);
    } finally {if (is_resource($writer)) {blobCancel162($writer);}}
    $expectedNew="NEW-DOCUMENT\nAPPROVED\n";
    $incomingParts=["NEW-DOCUMENT\n","CORRUPTED\n"];
    $writer=blobWriter162($db);$received=0;$hash=hash_init('sha256');$cancelled=false;$replacementApplied=false;$reason='';
    try {
        foreach ($incomingParts as $part) {
            blobAppend162($writer,$part);hash_update($hash,$part);$received+=strlen($part);
        }
        $receivedSha=hash_final($hash);$expectedSha=hash('sha256',$expectedNew);
        if (!hash_equals($expectedSha,$receivedSha)) {throw new DomainException('SHA-256 нового файла не совпал с ожидаемым');}
        $newId=blobFinish162($writer);
        $changed=f162Query($db,"UPDATE $q SET file_name=?,revision_no=2,payload=? WHERE attachment_id=? AND revision_no=?",['replacement.txt',$newId,162,1]);
        if ($changed!==1) {throw new DomainException('Вложение уже изменилось.');}
        f162Commit($db);$replacementApplied=true;
    } catch (DomainException $error) {
        $reason=$error->getMessage();
    } finally {
        if (is_resource($writer)) {$cancelled=blobCancel162($writer);}
        if (!$replacementApplied && ibase_rollback($db)!==true) {f162Failure('Транзакция замены не отменена');}
    }
    $row=f162Read($db,"SELECT file_name AS \"name\",revision_no AS \"revision\",payload AS \"blob_id\" FROM $q WHERE attachment_id=?",[162])[0];
    $saved=blobInspect162($db,$row['blob_id'],true);
    $rows=[['Причина отказа',$reason],['Получено байт нового файла',$received],['Незавершённый BLOB отменён',$cancelled],
        ['UPDATE замены выполнен',$replacementApplied],['Оставшееся вложение',$row['name']],['Редакция вложения',$row['revision']],
        ['Прежнее содержимое',$saved['text']],['Прежний файл не повреждён',$saved['text']===$approved]];
    $checks=['integrity_failure_detected'=>$receivedSha!==$expectedSha && $reason==='SHA-256 нового файла не совпал с ожидаемым',
        'new_bytes_written_before_reject'=>$received===23,'unfinished_writer_cancelled'=>$cancelled && $writer===null,
        'no_replacement_update'=>!$replacementApplied,'old_metadata_preserved'=>$row['name']==='approved.txt' && $row['revision']===1,
        'old_content_preserved'=>$saved['text']===$approved && $saved['sha256']===hash('sha256',$approved)];
    $observations=['failure'=>'checksum_mismatch','incoming_bytes'=>$received,'new_hash'=>$receivedSha,'expected_new_hash'=>$expectedSha,
        'cancelled'=>$cancelled,'replacement_applied'=>$replacementApplied,'remaining_name'=>$row['name'],'remaining_revision'=>$row['revision'],
        'remaining_text'=>$saved['text'],'remaining_sha256'=>$saved['sha256']];

} finally {
    if (function_exists('f162HttpChildrenStopped') && !f162HttpChildrenStopped()) {
        throw new RuntimeException('Дочерний HTTP-процесс ещё работает: учебная таблица сохранена для точного восстановления.');
    }
    if (is_resource($db)) {try {$removed=f162Cleanup($db,$owned);} finally {ibase_close($db);}}
}

f162Report('fb162-cancel-replacement','Неудачная замена вложения: сохранить прежний подтверждённый файл',$rows,$checks,$observations,$runtime,$owned,$removed);

Причина отказа — SHA-256 нового файла не совпал с ожидаемым
Получено байт нового файла — 23
Незавершённый BLOB отменён — да
UPDATE замены выполнен — нет
Оставшееся вложение — approved.txt
Редакция вложения — 1
Прежнее содержимое — APPROVED:162

Прежний файл не повреждён — да

Самостоятельный CLI-пример: одна своя таблица Firebird, настоящая запись BLOB и чтение после сохранения; result.html/result.json; закрытие ресурсов и удаление таблицы. lab.php, README.txt и нужный CSV приложены.