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

<?php
declare(strict_types=1);
require __DIR__.'/lab.php';
$db=null;$owned=$removed=$rows=$checks=$observations=[];

try {
    $config=c172Config();$db=c172Connect();$runtime=c172Runtime($db);

    // These fixtures are a synthetic export, not data read from a real GLO server.
    function step172(callable $action) {
        $call=c172Capture($action);
        if($call['value']===false || $call['value']===null || $call['warning']) {c172Failure('Действие миграции не выполнено',$call);}
        return $call['value'];
    }
    function migrationTable172($db,array &$owned,string $label): string {
        $name=c172OwnName($db,$owned,'TABLE',$label);$table=c172Qualified($name);
        c172Ddl($db,'CREATE TABLE '.$table.' (business_id INT PRIMARY KEY,old_oid VARCHAR(40) UNIQUE,title VARCHAR(80),revision INT NOT NULL,body BLOB)');
        c172Commit($db);return $table;
    }
    function sourcePath172(string $file): string {
        if(!preg_match('/^[a-z0-9][a-z0-9-]*\.txt$/D',$file)){throw new InvalidArgumentException('Недопустимое имя исходного файла');}
        $base=realpath(__DIR__);$path=realpath(__DIR__.'/'.$file);
        if($base===false || $path===false || dirname($path)!==$base || !is_file($path) || !is_readable($path)) {
            throw new RuntimeException('Нет допустимого исходного файла');
        }
        if(filesize($path)>4096){throw new RuntimeException('Учебный файл превышает лимит');}
        return $path;
    }
    function manifest172(string $filename): array {
        $file=fopen(__DIR__.'/'.$filename,'rb');if($file===false){throw new RuntimeException('Нет ведомости');}
        try {
            if(fgetcsv($file,0,';')!==['old_oid','business_id','file','bytes','sha256']){throw new RuntimeException('Неверный заголовок ведомости');}
            $items=[];$ids=[];$oldIds=[];
            while(($cells=fgetcsv($file,0,';'))!==false){
                if(count($cells)!==5 || !preg_match('/^synthetic-glo-[0-9]+$/D',$cells[0])
                    || !preg_match('/^[1-9][0-9]{0,5}$/D',$cells[1]) || !preg_match('/^[0-9]+$/D',$cells[3])
                    || !preg_match('/^[0-9a-f]{64}$/D',$cells[4])){throw new RuntimeException('Неверная строка ведомости');}
                $id=(int)$cells[1];
                if(isset($ids[$id]) || isset($oldIds[$cells[0]])){throw new RuntimeException('Повтор ключа в ведомости');}
                $ids[$id]=true;$oldIds[$cells[0]]=true;
                $items[]=['old_oid'=>$cells[0],'business_id'=>$id,'file'=>$cells[2],'bytes'=>(int)$cells[3],'sha256'=>$cells[4]];
                if(count($items)>4){throw new RuntimeException('Учебная ведомость ограничена четырьмя файлами');}
            }
            return $items;
        } finally {fclose($file);}
    }
    function checkedSource172(array $item): string {
        $path=sourcePath172($item['file']);
        if(filesize($path)!==$item['bytes'] || hash_file('sha256',$path)!==$item['sha256']){
            throw new RuntimeException('Размер или полный SHA256 исходника не совпадает');
        }
        return $path;
    }
    function storeFile172($db,string $table,array $item,string $title,int $revision,bool $replace=false): void {
        $path=checkedSource172($item);$lob=$request=null;
        try {
            $lob=step172(static function()use($db){return cubrid_lob2_new($db,'BLOB');});
            step172(static function()use($lob,$path){return cubrid_lob2_import($lob,$path);});
            $sql=$replace?'UPDATE '.$table.' SET body=?,revision=? WHERE business_id=?'
                :'INSERT INTO '.$table.' (body,revision,business_id,old_oid,title) VALUES (?,?,?,?,?)';
            $request=step172(static function()use($db,$sql){return cubrid_prepare($db,$sql);});
            step172(static function()use($request,$lob){return cubrid_lob2_bind($request,1,$lob,'BLOB');});
            step172(static function()use($request,$revision){return cubrid_bind($request,2,$revision,'int');});
            $id=$item['business_id'];
            step172(static function()use($request,$id){return cubrid_bind($request,3,$id,'int');});
            if(!$replace){
                $old=$item['old_oid'];
                step172(static function()use($request,$old){return cubrid_bind($request,4,$old,'string');});
                step172(static function()use($request,$title){return cubrid_bind($request,5,$title,'string');});
            }
            step172(static function()use($request){return cubrid_execute($request);});
            $affected=cubrid_affected_rows($request);
            if($affected!==1){throw new RuntimeException('Изменена не одна запись документа');}
        } finally {
            c172Release($request);
            if(is_resource($lob)){
                $closed=cubrid_lob2_close($lob);$lob=null;
                if($closed!==true){throw new RuntimeException('Созданный LOB не закрыт');}
            }
        }
    }
    function storedDocument172($db,string $table,int $id): array {
        $request=$row=$lob=$call=null;
        try {
            $request=c172Request($db,'SELECT business_id,old_oid,title,revision,body FROM '.$table.' WHERE business_id=?',[$id]);
            $call=c172Capture(static function()use($request){return cubrid_fetch_array($request,CUBRID_ASSOC|CUBRID_LOB);});
            if($call['warning'] || $call['code']!==0 || $call['value']===null){c172Failure('Документ не прочитан',$call);}
            if($call['value']===false){return ['found'=>false];}
            $row=$call['value'];$value=['found'=>true,'business_id'=>(int)$row['business_id'],'old_oid'=>$row['old_oid'],
                'title'=>$row['title'],'revision'=>(int)$row['revision'],'sql_null'=>$row['body']===null,'data'=>null];
            if($row['body']===null){return $value;}
            $lob=$row['body'];
            $size=step172(static function()use($lob){return cubrid_lob2_size($lob);});
            if(!is_int($size)||$size<0||$size>4096){throw new RuntimeException('Недопустимый размер учебного документа');}
            $data='';
            while(strlen($data)<$size){
                $amount=min(512,$size-strlen($data));
                $part=step172(static function()use($lob,$amount){return cubrid_lob2_read($lob,$amount);});
                if(!is_string($part)||$part===''){throw new RuntimeException('Неполное чтение документа');}
                $data.=$part;
            }
            $value['data']=$data;$value['bytes']=strlen($data);$value['sha256']=hash('sha256',$data);return $value;
        } finally {
            // Keep all fetched references until the request drops its native locator list.
            c172Release($request);$row=$lob=$call=null;
        }
    }
    function writeCsv172(string $filename,array $rows): void {
        $file=fopen(__DIR__.'/'.$filename,'xb');if($file===false){throw new RuntimeException('Новый CSV не открыт');}
        try {foreach($rows as $row){if(fputcsv($file,$row,';','"','\\')===false){throw new RuntimeException('CSV не записан');}}}
        finally{fclose($file);}
    }

    $table=migrationTable172($db,$owned,'manifest');$items=manifest172('manifest.csv');
    $rejected=false;
    try {sourcePath172('../receipt-701.txt');}catch(InvalidArgumentException $e){$rejected=true;}
    $receipt=[['business_id','old_oid','bytes','sha256','status']];$documents=[];
    foreach($items as $item){storeFile172($db,$table,$item,'Документ '.$item['business_id'],1);}
    c172Commit($db);
    foreach($items as $item){
        $saved=storedDocument172($db,$table,$item['business_id']);
        if(!$saved['found']||$saved['sql_null']||$saved['sha256']!==$item['sha256']||$saved['bytes']!==$item['bytes']){
            throw new RuntimeException('Импортированный документ не прошёл сверку');
        }
        $receipt[]=[$saved['business_id'],$saved['old_oid'],$saved['bytes'],$saved['sha256'],'imported'];
        $documents[]=['business_id'=>$saved['business_id'],'old_oid'=>$saved['old_oid'],'text'=>$saved['data'],'sha256'=>$saved['sha256']];
    }
    writeCsv172('migration-import.csv',$receipt);
    $rows=[['Документ 701',$documents[0]['text']],['Документ 702',$documents[1]['text']],['Импортировано',count($documents)],
        ['Связь старого ключа','synthetic-glo-701 → 701; synthetic-glo-702 → 702'],['Выход из папки отвергнут',$rejected],['Квитанция','migration-import.csv']];
    $checks=['two_documents'=>count($documents)===2,'business_mapping'=>$documents[0]['business_id']===701&&$documents[1]['business_id']===702,
        'old_mapping'=>$documents[0]['old_oid']==='synthetic-glo-701'&&$documents[1]['old_oid']==='synthetic-glo-702',
        'first_text'=>$documents[0]['text']==="Заказ 701\nКабель: 3\n",'second_text'=>$documents[1]['text']==="Кабель O'Reilly\nПроверить маркировку.\n",
        'safe_path'=>$rejected,'all_hashes'=>array_column($documents,'sha256')===array_column($items,'sha256')];
    $observations=['fixture_origin'=>'synthetic export, not extracted from GLO','documents'=>$documents,'manifest_rows'=>count($items),'receipt'=>$receipt];

} finally {

    if (is_resource($db)) {try {$removed=c172Cleanup($db,$owned);} finally {c172Close($db);}}
}

c172Report('cub172-glo-manifest-import','Перенести два файла по ведомости и сохранить связь со старым ключом',$rows,$checks,$observations,$runtime,$owned,$removed);

Документ 701 — Заказ 701
Кабель: 3

Документ 702 — Кабель O'Reilly
Проверить маркировку.

Импортировано — 2
Связь старого ключа — synthetic-glo-701 → 701; synthetic-glo-702 → 702
Выход из папки отвергнут — да
Квитанция — migration-import.csv

Распакуйте весь ZIP и прочитайте README.txt. example.php содержит действия урока, lab.php — подключение к отдельной учебной базе, создание только собственной таблицы и очистку. Запускается CLI-проект с native-расширением cubrid, не публичный обработчик сайта. После запуска result.html показывает результат, result.json — наблюдения, а отдельный файл ниже содержит полученные данные.

<?php
declare(strict_types=1);
require __DIR__.'/lab.php';
$db=null;$owned=$removed=$rows=$checks=$observations=[];

try {
    $config=c172Config();$db=c172Connect();$runtime=c172Runtime($db);

    // These fixtures are a synthetic export, not data read from a real GLO server.
    function step172(callable $action) {
        $call=c172Capture($action);
        if($call['value']===false || $call['value']===null || $call['warning']) {c172Failure('Действие миграции не выполнено',$call);}
        return $call['value'];
    }
    function migrationTable172($db,array &$owned,string $label): string {
        $name=c172OwnName($db,$owned,'TABLE',$label);$table=c172Qualified($name);
        c172Ddl($db,'CREATE TABLE '.$table.' (business_id INT PRIMARY KEY,old_oid VARCHAR(40) UNIQUE,title VARCHAR(80),revision INT NOT NULL,body BLOB)');
        c172Commit($db);return $table;
    }
    function sourcePath172(string $file): string {
        if(!preg_match('/^[a-z0-9][a-z0-9-]*\.txt$/D',$file)){throw new InvalidArgumentException('Недопустимое имя исходного файла');}
        $base=realpath(__DIR__);$path=realpath(__DIR__.'/'.$file);
        if($base===false || $path===false || dirname($path)!==$base || !is_file($path) || !is_readable($path)) {
            throw new RuntimeException('Нет допустимого исходного файла');
        }
        if(filesize($path)>4096){throw new RuntimeException('Учебный файл превышает лимит');}
        return $path;
    }
    function manifest172(string $filename): array {
        $file=fopen(__DIR__.'/'.$filename,'rb');if($file===false){throw new RuntimeException('Нет ведомости');}
        try {
            if(fgetcsv($file,0,';')!==['old_oid','business_id','file','bytes','sha256']){throw new RuntimeException('Неверный заголовок ведомости');}
            $items=[];$ids=[];$oldIds=[];
            while(($cells=fgetcsv($file,0,';'))!==false){
                if(count($cells)!==5 || !preg_match('/^synthetic-glo-[0-9]+$/D',$cells[0])
                    || !preg_match('/^[1-9][0-9]{0,5}$/D',$cells[1]) || !preg_match('/^[0-9]+$/D',$cells[3])
                    || !preg_match('/^[0-9a-f]{64}$/D',$cells[4])){throw new RuntimeException('Неверная строка ведомости');}
                $id=(int)$cells[1];
                if(isset($ids[$id]) || isset($oldIds[$cells[0]])){throw new RuntimeException('Повтор ключа в ведомости');}
                $ids[$id]=true;$oldIds[$cells[0]]=true;
                $items[]=['old_oid'=>$cells[0],'business_id'=>$id,'file'=>$cells[2],'bytes'=>(int)$cells[3],'sha256'=>$cells[4]];
                if(count($items)>4){throw new RuntimeException('Учебная ведомость ограничена четырьмя файлами');}
            }
            return $items;
        } finally {fclose($file);}
    }
    function checkedSource172(array $item): string {
        $path=sourcePath172($item['file']);
        if(filesize($path)!==$item['bytes'] || hash_file('sha256',$path)!==$item['sha256']){
            throw new RuntimeException('Размер или полный SHA256 исходника не совпадает');
        }
        return $path;
    }
    function storeFile172($db,string $table,array $item,string $title,int $revision,bool $replace=false): void {
        $path=checkedSource172($item);$lob=$request=null;
        try {
            $lob=step172(static function()use($db){return cubrid_lob2_new($db,'BLOB');});
            step172(static function()use($lob,$path){return cubrid_lob2_import($lob,$path);});
            $sql=$replace?'UPDATE '.$table.' SET body=?,revision=? WHERE business_id=?'
                :'INSERT INTO '.$table.' (body,revision,business_id,old_oid,title) VALUES (?,?,?,?,?)';
            $request=step172(static function()use($db,$sql){return cubrid_prepare($db,$sql);});
            step172(static function()use($request,$lob){return cubrid_lob2_bind($request,1,$lob,'BLOB');});
            step172(static function()use($request,$revision){return cubrid_bind($request,2,$revision,'int');});
            $id=$item['business_id'];
            step172(static function()use($request,$id){return cubrid_bind($request,3,$id,'int');});
            if(!$replace){
                $old=$item['old_oid'];
                step172(static function()use($request,$old){return cubrid_bind($request,4,$old,'string');});
                step172(static function()use($request,$title){return cubrid_bind($request,5,$title,'string');});
            }
            step172(static function()use($request){return cubrid_execute($request);});
            $affected=cubrid_affected_rows($request);
            if($affected!==1){throw new RuntimeException('Изменена не одна запись документа');}
        } finally {
            c172Release($request);
            if(is_resource($lob)){
                $closed=cubrid_lob2_close($lob);$lob=null;
                if($closed!==true){throw new RuntimeException('Созданный LOB не закрыт');}
            }
        }
    }
    function storedDocument172($db,string $table,int $id): array {
        $request=$row=$lob=$call=null;
        try {
            $request=c172Request($db,'SELECT business_id,old_oid,title,revision,body FROM '.$table.' WHERE business_id=?',[$id]);
            $call=c172Capture(static function()use($request){return cubrid_fetch_array($request,CUBRID_ASSOC|CUBRID_LOB);});
            if($call['warning'] || $call['code']!==0 || $call['value']===null){c172Failure('Документ не прочитан',$call);}
            if($call['value']===false){return ['found'=>false];}
            $row=$call['value'];$value=['found'=>true,'business_id'=>(int)$row['business_id'],'old_oid'=>$row['old_oid'],
                'title'=>$row['title'],'revision'=>(int)$row['revision'],'sql_null'=>$row['body']===null,'data'=>null];
            if($row['body']===null){return $value;}
            $lob=$row['body'];
            $size=step172(static function()use($lob){return cubrid_lob2_size($lob);});
            if(!is_int($size)||$size<0||$size>4096){throw new RuntimeException('Недопустимый размер учебного документа');}
            $data='';
            while(strlen($data)<$size){
                $amount=min(512,$size-strlen($data));
                $part=step172(static function()use($lob,$amount){return cubrid_lob2_read($lob,$amount);});
                if(!is_string($part)||$part===''){throw new RuntimeException('Неполное чтение документа');}
                $data.=$part;
            }
            $value['data']=$data;$value['bytes']=strlen($data);$value['sha256']=hash('sha256',$data);return $value;
        } finally {
            // Keep all fetched references until the request drops its native locator list.
            c172Release($request);$row=$lob=$call=null;
        }
    }
    function writeCsv172(string $filename,array $rows): void {
        $file=fopen(__DIR__.'/'.$filename,'xb');if($file===false){throw new RuntimeException('Новый CSV не открыт');}
        try {foreach($rows as $row){if(fputcsv($file,$row,';','"','\\')===false){throw new RuntimeException('CSV не записан');}}}
        finally{fclose($file);}
    }

    $table=migrationTable172($db,$owned,'text_migrate');$items=manifest172('manifest.csv');$item=$items[0];
    $path=checkedSource172($item);$original=file_get_contents($path);
    if(!is_string($original)||preg_match('//u',$original)!==1){throw new RuntimeException('Исходник не является согласованным UTF-8');}
    storeFile172($db,$table,$item,"Кабель O'Reilly",1);c172Commit($db);
    $saved=storedDocument172($db,$table,702);
    if(!$saved['found']||$saved['sql_null']||preg_match('//u',$saved['data'])!==1){throw new RuntimeException('Текст не получен');}
    $target=__DIR__.'/instruction-migrated.txt';
    if(file_put_contents($target,$saved['data'])!==strlen($saved['data'])){throw new RuntimeException('Текст результата не записан');}
    $lines=explode("\n",rtrim($saved['data'],"\n"));
    $points=preg_split('//u',$saved['data'],-1,PREG_SPLIT_NO_EMPTY);
    $rows=[['Товар',$lines[0]],['Инструкция',$lines[1]],['Байт UTF-8',$saved['bytes']],['Кодовых точек',count($points)],
        ['Текст совпал',$saved['data']===$original],['Файл','instruction-migrated.txt']];
    $checks=['selected_business'=>$saved['business_id']===702,'valid_utf8'=>preg_match('//u',$saved['data'])===1,
        'apostrophe'=>strpos($saved['data'],"O'Reilly")!==false,'exact_text'=>$saved['data']===$original,
        'two_lines'=>count($lines)===2,'bytes_not_characters'=>$saved['bytes']>count($points),
        'output_hash'=>hash_file('sha256',$target)===$item['sha256']];
    $observations=['business_id'=>702,'text'=>$saved['data'],'encoding'=>'UTF-8 verified, not guessed','sha256'=>$saved['sha256'],
        'source_file'=>$item['file'],'characters'=>count($points),'bytes'=>$saved['bytes']];

} finally {

    if (is_resource($db)) {try {$removed=c172Cleanup($db,$owned);} finally {c172Close($db);}}
}

c172Report('cub172-glo-text-migration','Перенести текстовую инструкцию без незаметной смены кодировки',$rows,$checks,$observations,$runtime,$owned,$removed);

Товар — Кабель O'Reilly
Инструкция — Проверить маркировку.
Байт UTF-8 — 63
Кодовых точек — 38
Текст совпал — да
Файл — instruction-migrated.txt

Распакуйте весь ZIP и прочитайте README.txt. example.php содержит действия урока, lab.php — подключение к отдельной учебной базе, создание только собственной таблицы и очистку. Запускается CLI-проект с native-расширением cubrid, не публичный обработчик сайта. После запуска result.html показывает результат, result.json — наблюдения, а отдельный файл ниже содержит полученные данные.

<?php
declare(strict_types=1);
require __DIR__.'/lab.php';
$db=null;$owned=$removed=$rows=$checks=$observations=[];

try {
    $config=c172Config();$db=c172Connect();$runtime=c172Runtime($db);

    // These fixtures are a synthetic export, not data read from a real GLO server.
    function step172(callable $action) {
        $call=c172Capture($action);
        if($call['value']===false || $call['value']===null || $call['warning']) {c172Failure('Действие миграции не выполнено',$call);}
        return $call['value'];
    }
    function migrationTable172($db,array &$owned,string $label): string {
        $name=c172OwnName($db,$owned,'TABLE',$label);$table=c172Qualified($name);
        c172Ddl($db,'CREATE TABLE '.$table.' (business_id INT PRIMARY KEY,old_oid VARCHAR(40) UNIQUE,title VARCHAR(80),revision INT NOT NULL,body BLOB)');
        c172Commit($db);return $table;
    }
    function sourcePath172(string $file): string {
        if(!preg_match('/^[a-z0-9][a-z0-9-]*\.txt$/D',$file)){throw new InvalidArgumentException('Недопустимое имя исходного файла');}
        $base=realpath(__DIR__);$path=realpath(__DIR__.'/'.$file);
        if($base===false || $path===false || dirname($path)!==$base || !is_file($path) || !is_readable($path)) {
            throw new RuntimeException('Нет допустимого исходного файла');
        }
        if(filesize($path)>4096){throw new RuntimeException('Учебный файл превышает лимит');}
        return $path;
    }
    function manifest172(string $filename): array {
        $file=fopen(__DIR__.'/'.$filename,'rb');if($file===false){throw new RuntimeException('Нет ведомости');}
        try {
            if(fgetcsv($file,0,';')!==['old_oid','business_id','file','bytes','sha256']){throw new RuntimeException('Неверный заголовок ведомости');}
            $items=[];$ids=[];$oldIds=[];
            while(($cells=fgetcsv($file,0,';'))!==false){
                if(count($cells)!==5 || !preg_match('/^synthetic-glo-[0-9]+$/D',$cells[0])
                    || !preg_match('/^[1-9][0-9]{0,5}$/D',$cells[1]) || !preg_match('/^[0-9]+$/D',$cells[3])
                    || !preg_match('/^[0-9a-f]{64}$/D',$cells[4])){throw new RuntimeException('Неверная строка ведомости');}
                $id=(int)$cells[1];
                if(isset($ids[$id]) || isset($oldIds[$cells[0]])){throw new RuntimeException('Повтор ключа в ведомости');}
                $ids[$id]=true;$oldIds[$cells[0]]=true;
                $items[]=['old_oid'=>$cells[0],'business_id'=>$id,'file'=>$cells[2],'bytes'=>(int)$cells[3],'sha256'=>$cells[4]];
                if(count($items)>4){throw new RuntimeException('Учебная ведомость ограничена четырьмя файлами');}
            }
            return $items;
        } finally {fclose($file);}
    }
    function checkedSource172(array $item): string {
        $path=sourcePath172($item['file']);
        if(filesize($path)!==$item['bytes'] || hash_file('sha256',$path)!==$item['sha256']){
            throw new RuntimeException('Размер или полный SHA256 исходника не совпадает');
        }
        return $path;
    }
    function storeFile172($db,string $table,array $item,string $title,int $revision,bool $replace=false): void {
        $path=checkedSource172($item);$lob=$request=null;
        try {
            $lob=step172(static function()use($db){return cubrid_lob2_new($db,'BLOB');});
            step172(static function()use($lob,$path){return cubrid_lob2_import($lob,$path);});
            $sql=$replace?'UPDATE '.$table.' SET body=?,revision=? WHERE business_id=?'
                :'INSERT INTO '.$table.' (body,revision,business_id,old_oid,title) VALUES (?,?,?,?,?)';
            $request=step172(static function()use($db,$sql){return cubrid_prepare($db,$sql);});
            step172(static function()use($request,$lob){return cubrid_lob2_bind($request,1,$lob,'BLOB');});
            step172(static function()use($request,$revision){return cubrid_bind($request,2,$revision,'int');});
            $id=$item['business_id'];
            step172(static function()use($request,$id){return cubrid_bind($request,3,$id,'int');});
            if(!$replace){
                $old=$item['old_oid'];
                step172(static function()use($request,$old){return cubrid_bind($request,4,$old,'string');});
                step172(static function()use($request,$title){return cubrid_bind($request,5,$title,'string');});
            }
            step172(static function()use($request){return cubrid_execute($request);});
            $affected=cubrid_affected_rows($request);
            if($affected!==1){throw new RuntimeException('Изменена не одна запись документа');}
        } finally {
            c172Release($request);
            if(is_resource($lob)){
                $closed=cubrid_lob2_close($lob);$lob=null;
                if($closed!==true){throw new RuntimeException('Созданный LOB не закрыт');}
            }
        }
    }
    function storedDocument172($db,string $table,int $id): array {
        $request=$row=$lob=$call=null;
        try {
            $request=c172Request($db,'SELECT business_id,old_oid,title,revision,body FROM '.$table.' WHERE business_id=?',[$id]);
            $call=c172Capture(static function()use($request){return cubrid_fetch_array($request,CUBRID_ASSOC|CUBRID_LOB);});
            if($call['warning'] || $call['code']!==0 || $call['value']===null){c172Failure('Документ не прочитан',$call);}
            if($call['value']===false){return ['found'=>false];}
            $row=$call['value'];$value=['found'=>true,'business_id'=>(int)$row['business_id'],'old_oid'=>$row['old_oid'],
                'title'=>$row['title'],'revision'=>(int)$row['revision'],'sql_null'=>$row['body']===null,'data'=>null];
            if($row['body']===null){return $value;}
            $lob=$row['body'];
            $size=step172(static function()use($lob){return cubrid_lob2_size($lob);});
            if(!is_int($size)||$size<0||$size>4096){throw new RuntimeException('Недопустимый размер учебного документа');}
            $data='';
            while(strlen($data)<$size){
                $amount=min(512,$size-strlen($data));
                $part=step172(static function()use($lob,$amount){return cubrid_lob2_read($lob,$amount);});
                if(!is_string($part)||$part===''){throw new RuntimeException('Неполное чтение документа');}
                $data.=$part;
            }
            $value['data']=$data;$value['bytes']=strlen($data);$value['sha256']=hash('sha256',$data);return $value;
        } finally {
            // Keep all fetched references until the request drops its native locator list.
            c172Release($request);$row=$lob=$call=null;
        }
    }
    function writeCsv172(string $filename,array $rows): void {
        $file=fopen(__DIR__.'/'.$filename,'xb');if($file===false){throw new RuntimeException('Новый CSV не открыт');}
        try {foreach($rows as $row){if(fputcsv($file,$row,';','"','\\')===false){throw new RuntimeException('CSV не записан');}}}
        finally{fclose($file);}
    }

    $table=migrationTable172($db,$owned,'replacement');
    $old=manifest172('version-one.csv')[0];$new=manifest172('version-two.csv')[0];
    storeFile172($db,$table,$old,'Заказ 701',1);c172Commit($db);
    $before=storedDocument172($db,$table,701);c172Commit($db);
    storeFile172($db,$table,$new,'Заказ 701',2,true);
    $pending=storedDocument172($db,$table,701);
    c172Rollback($db);
    $afterRollback=storedDocument172($db,$table,701);c172Commit($db);
    // A different fresh LOB is imported for the confirmed attempt.
    storeFile172($db,$table,$new,'Заказ 701',2,true);c172Commit($db);
    $afterCommit=storedDocument172($db,$table,701);
    $audit=[['stage','business_id','revision','sha256'],['before',701,$before['revision'],$before['sha256']],
        ['after_rollback',701,$afterRollback['revision'],$afterRollback['sha256']],['after_commit',701,$afterCommit['revision'],$afterCommit['sha256']]];
    writeCsv172('replacement-audit.csv',$audit);
    $rows=[['До замены',$before['data']],['Неподтверждённая версия',$pending['revision']],['После rollback',$afterRollback['data']],
        ['После commit',$afterCommit['data']],['Исходный файл сохранён',hash_file('sha256',sourcePath172('version-one.txt'))===$old['sha256']],['Журнал','replacement-audit.csv']];
    $checks=['before_v1'=>$before['revision']===1&&$before['data']==="Заказ 701\nВерсия: 1\n",
        'pending_v2'=>$pending['revision']===2&&$pending['sha256']===$new['sha256'],
        'rollback_reference'=>$afterRollback['revision']===1&&$afterRollback['sha256']===$old['sha256'],
        'commit_reference'=>$afterCommit['revision']===2&&$afterCommit['sha256']===$new['sha256'],
        'old_source_untouched'=>hash_file('sha256',sourcePath172('version-one.txt'))===$old['sha256'],
        'same_business'=>$before['business_id']===$afterCommit['business_id']&&$afterCommit['business_id']===701];
    $observations=['audit'=>$audit,'before'=>$before['data'],'after_rollback'=>$afterRollback['data'],'after_commit'=>$afterCommit['data'],
        'rollback_scope'=>'SQL reference and revision; no claim that external LOB bytes are undone'];

} finally {

    if (is_resource($db)) {try {$removed=c172Cleanup($db,$owned);} finally {c172Close($db);}}
}

c172Report('cub172-glo-replacement','Заменить ссылку на документ целиком: отмена и подтверждение',$rows,$checks,$observations,$runtime,$owned,$removed);

До замены — Заказ 701
Версия: 1

Неподтверждённая версия — 2
После rollback — Заказ 701
Версия: 1

После commit — Заказ 701
Версия: 2

Исходный файл сохранён — да
Журнал — replacement-audit.csv

Распакуйте весь ZIP и прочитайте README.txt. example.php содержит действия урока, lab.php — подключение к отдельной учебной базе, создание только собственной таблицы и очистку. Запускается CLI-проект с native-расширением cubrid, не публичный обработчик сайта. После запуска result.html показывает результат, result.json — наблюдения, а отдельный файл ниже содержит полученные данные.

<?php
declare(strict_types=1);
require __DIR__.'/lab.php';
$db=null;$owned=$removed=$rows=$checks=$observations=[];

try {
    $config=c172Config();$db=c172Connect();$runtime=c172Runtime($db);

    // These fixtures are a synthetic export, not data read from a real GLO server.
    function step172(callable $action) {
        $call=c172Capture($action);
        if($call['value']===false || $call['value']===null || $call['warning']) {c172Failure('Действие миграции не выполнено',$call);}
        return $call['value'];
    }
    function migrationTable172($db,array &$owned,string $label): string {
        $name=c172OwnName($db,$owned,'TABLE',$label);$table=c172Qualified($name);
        c172Ddl($db,'CREATE TABLE '.$table.' (business_id INT PRIMARY KEY,old_oid VARCHAR(40) UNIQUE,title VARCHAR(80),revision INT NOT NULL,body BLOB)');
        c172Commit($db);return $table;
    }
    function sourcePath172(string $file): string {
        if(!preg_match('/^[a-z0-9][a-z0-9-]*\.txt$/D',$file)){throw new InvalidArgumentException('Недопустимое имя исходного файла');}
        $base=realpath(__DIR__);$path=realpath(__DIR__.'/'.$file);
        if($base===false || $path===false || dirname($path)!==$base || !is_file($path) || !is_readable($path)) {
            throw new RuntimeException('Нет допустимого исходного файла');
        }
        if(filesize($path)>4096){throw new RuntimeException('Учебный файл превышает лимит');}
        return $path;
    }
    function manifest172(string $filename): array {
        $file=fopen(__DIR__.'/'.$filename,'rb');if($file===false){throw new RuntimeException('Нет ведомости');}
        try {
            if(fgetcsv($file,0,';')!==['old_oid','business_id','file','bytes','sha256']){throw new RuntimeException('Неверный заголовок ведомости');}
            $items=[];$ids=[];$oldIds=[];
            while(($cells=fgetcsv($file,0,';'))!==false){
                if(count($cells)!==5 || !preg_match('/^synthetic-glo-[0-9]+$/D',$cells[0])
                    || !preg_match('/^[1-9][0-9]{0,5}$/D',$cells[1]) || !preg_match('/^[0-9]+$/D',$cells[3])
                    || !preg_match('/^[0-9a-f]{64}$/D',$cells[4])){throw new RuntimeException('Неверная строка ведомости');}
                $id=(int)$cells[1];
                if(isset($ids[$id]) || isset($oldIds[$cells[0]])){throw new RuntimeException('Повтор ключа в ведомости');}
                $ids[$id]=true;$oldIds[$cells[0]]=true;
                $items[]=['old_oid'=>$cells[0],'business_id'=>$id,'file'=>$cells[2],'bytes'=>(int)$cells[3],'sha256'=>$cells[4]];
                if(count($items)>4){throw new RuntimeException('Учебная ведомость ограничена четырьмя файлами');}
            }
            return $items;
        } finally {fclose($file);}
    }
    function checkedSource172(array $item): string {
        $path=sourcePath172($item['file']);
        if(filesize($path)!==$item['bytes'] || hash_file('sha256',$path)!==$item['sha256']){
            throw new RuntimeException('Размер или полный SHA256 исходника не совпадает');
        }
        return $path;
    }
    function storeFile172($db,string $table,array $item,string $title,int $revision,bool $replace=false): void {
        $path=checkedSource172($item);$lob=$request=null;
        try {
            $lob=step172(static function()use($db){return cubrid_lob2_new($db,'BLOB');});
            step172(static function()use($lob,$path){return cubrid_lob2_import($lob,$path);});
            $sql=$replace?'UPDATE '.$table.' SET body=?,revision=? WHERE business_id=?'
                :'INSERT INTO '.$table.' (body,revision,business_id,old_oid,title) VALUES (?,?,?,?,?)';
            $request=step172(static function()use($db,$sql){return cubrid_prepare($db,$sql);});
            step172(static function()use($request,$lob){return cubrid_lob2_bind($request,1,$lob,'BLOB');});
            step172(static function()use($request,$revision){return cubrid_bind($request,2,$revision,'int');});
            $id=$item['business_id'];
            step172(static function()use($request,$id){return cubrid_bind($request,3,$id,'int');});
            if(!$replace){
                $old=$item['old_oid'];
                step172(static function()use($request,$old){return cubrid_bind($request,4,$old,'string');});
                step172(static function()use($request,$title){return cubrid_bind($request,5,$title,'string');});
            }
            step172(static function()use($request){return cubrid_execute($request);});
            $affected=cubrid_affected_rows($request);
            if($affected!==1){throw new RuntimeException('Изменена не одна запись документа');}
        } finally {
            c172Release($request);
            if(is_resource($lob)){
                $closed=cubrid_lob2_close($lob);$lob=null;
                if($closed!==true){throw new RuntimeException('Созданный LOB не закрыт');}
            }
        }
    }
    function storedDocument172($db,string $table,int $id): array {
        $request=$row=$lob=$call=null;
        try {
            $request=c172Request($db,'SELECT business_id,old_oid,title,revision,body FROM '.$table.' WHERE business_id=?',[$id]);
            $call=c172Capture(static function()use($request){return cubrid_fetch_array($request,CUBRID_ASSOC|CUBRID_LOB);});
            if($call['warning'] || $call['code']!==0 || $call['value']===null){c172Failure('Документ не прочитан',$call);}
            if($call['value']===false){return ['found'=>false];}
            $row=$call['value'];$value=['found'=>true,'business_id'=>(int)$row['business_id'],'old_oid'=>$row['old_oid'],
                'title'=>$row['title'],'revision'=>(int)$row['revision'],'sql_null'=>$row['body']===null,'data'=>null];
            if($row['body']===null){return $value;}
            $lob=$row['body'];
            $size=step172(static function()use($lob){return cubrid_lob2_size($lob);});
            if(!is_int($size)||$size<0||$size>4096){throw new RuntimeException('Недопустимый размер учебного документа');}
            $data='';
            while(strlen($data)<$size){
                $amount=min(512,$size-strlen($data));
                $part=step172(static function()use($lob,$amount){return cubrid_lob2_read($lob,$amount);});
                if(!is_string($part)||$part===''){throw new RuntimeException('Неполное чтение документа');}
                $data.=$part;
            }
            $value['data']=$data;$value['bytes']=strlen($data);$value['sha256']=hash('sha256',$data);return $value;
        } finally {
            // Keep all fetched references until the request drops its native locator list.
            c172Release($request);$row=$lob=$call=null;
        }
    }
    function writeCsv172(string $filename,array $rows): void {
        $file=fopen(__DIR__.'/'.$filename,'xb');if($file===false){throw new RuntimeException('Новый CSV не открыт');}
        try {foreach($rows as $row){if(fputcsv($file,$row,';','"','\\')===false){throw new RuntimeException('CSV не записан');}}}
        finally{fclose($file);}
    }

    $table=migrationTable172($db,$owned,'reconcile');$items=manifest172('manifest.csv');
    storeFile172($db,$table,$items[0],'Документ 701',1);
    $wrong=['old_oid'=>'synthetic-glo-702','business_id'=>702,'file'=>'wrong-702.txt','bytes'=>filesize(sourcePath172('wrong-702.txt')),
        'sha256'=>hash_file('sha256',sourcePath172('wrong-702.txt'))];
    storeFile172($db,$table,$wrong,'Документ 702',1);
    c172Command($db,'INSERT INTO '.$table.' (business_id,old_oid,title,revision,body) VALUES (?,?,?,?,NULL)',[704,'synthetic-glo-704','Документ 704',1]);
    c172Commit($db);$findings=[];$csv=[['business_id','status','action']];
    foreach($items as $item){
        $saved=storedDocument172($db,$table,$item['business_id']);
        if(!$saved['found']){$status='missing_row';$action='import_after_review';}
        elseif($saved['sql_null']){$status='null_body';$action='review_missing_document';}
        elseif($saved['sha256']!==$item['sha256']||$saved['bytes']!==$item['bytes']){$status='hash_mismatch';$action='review_source';}
        else{$status='matched';$action='keep';}
        $findings[]=['business_id'=>$item['business_id'],'status'=>$status,'action'=>$action,'expected_sha256'=>$item['sha256'],
            'actual_sha256'=>isset($saved['sha256'])?$saved['sha256']:null];
        $csv[]=[$item['business_id'],$status,$action];
    }
    writeCsv172('reconciliation.csv',$csv);
    $count=c172Read($db,'SELECT COUNT(*) AS n FROM '.$table);
    $rows=[['701','Совпадает: оставить'],['702','Другие байты: сверить исходник'],['703','Нет строки: проверить перед импортом'],
        ['704','SQL NULL: выяснить отсутствие документа'],['Проверено по ведомости',count($findings)],['Строк в базе после сверки',(int)$count[0]['n']],['Файл','reconciliation.csv']];
    $checks=['four_statuses'=>array_column($findings,'status')===['matched','hash_mismatch','missing_row','null_body'],
        'full_hash_match'=>$findings[0]['actual_sha256']===$findings[0]['expected_sha256'],
        'mismatch_detected'=>$findings[1]['actual_sha256']!==$findings[1]['expected_sha256'],
        'missing_not_null'=>$findings[2]['status']!==$findings[3]['status'],
        'no_automatic_repair'=>(int)$count[0]['n']===3,'all_business_keys'=>array_column($findings,'business_id')===[701,702,703,704]];
    $observations=['findings'=>$findings,'policy'=>'report only, no repair or deletion','expected_count'=>4,'actual_count'=>3];

} finally {

    if (is_resource($db)) {try {$removed=c172Cleanup($db,$owned);} finally {c172Close($db);}}
}

c172Report('cub172-glo-reconciliation','Сверить перенесённые документы и отделить четыре разных результата',$rows,$checks,$observations,$runtime,$owned,$removed);

701 — Совпадает: оставить
702 — Другие байты: сверить исходник
703 — Нет строки: проверить перед импортом
704 — SQL NULL: выяснить отсутствие документа
Проверено по ведомости — 4
Строк в базе после сверки — 3
Файл — reconciliation.csv

Распакуйте весь ZIP и прочитайте README.txt. example.php содержит действия урока, lab.php — подключение к отдельной учебной базе, создание только собственной таблицы и очистку. Запускается CLI-проект с native-расширением cubrid, не публичный обработчик сайта. После запуска result.html показывает результат, result.json — наблюдения, а отдельный файл ниже содержит полученные данные.