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

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

    // Подготовка данных продолжает главу о сохранении LOB.
    function attachmentTable171($db,array &$owned,string $label): string {
        $name=c171OwnName($db,$owned,'TABLE',$label);$table=c171Qualified($name);
        c171Ddl($db,'CREATE TABLE '.$table.' (id INT PRIMARY KEY,title VARCHAR(80),body BLOB,note CLOB)');
        c171Commit($db);return $table;
    }
    function closeOwnedLob171(&$lob): void {
        if(is_resource($lob)) {
            if(cubrid_lob2_close($lob)!==true){throw new RuntimeException('Созданный LOB не закрыт');}
            $lob=null;
        }
    }
    function storeAttachment171($db,string $table,int $id,string $title,string $body,string $note): void {
        $query=$binary=$text=null;
        try {
            $binary=cubrid_lob2_new($db,'BLOB');$text=cubrid_lob2_new($db,'CLOB');
            if(!is_resource($binary)||!is_resource($text)){throw new RuntimeException('LOB не создан');}
            if(cubrid_lob2_write($binary,$body)!==true || cubrid_lob2_write($text,$note)!==true){throw new RuntimeException('LOB не заполнен');}
            $query=cubrid_prepare($db,'INSERT INTO '.$table.' (id,title,body,note) VALUES (?,?,?,?)');
            if($query===false || !cubrid_bind($query,1,$id,'int') || !cubrid_bind($query,2,$title,'string')
                || !cubrid_lob2_bind($query,3,$binary,'BLOB') || !cubrid_lob2_bind($query,4,$text,'CLOB')
                || !cubrid_execute($query)){throw new RuntimeException('Вложение не сохранено');}
        } finally {
            c171Release($query);closeOwnedLob171($binary);closeOwnedLob171($text);
        }
    }
    function selectedAttachment171($db,string $table,int $id) {
        $query=cubrid_prepare($db,'SELECT id,title,body,note FROM '.$table.' WHERE id=?');
        if($query===false){throw new RuntimeException('Запрос вложения не подготовлен');}
        if(!cubrid_bind($query,1,$id,'int') || !cubrid_execute($query)){
            c171Release($query);throw new RuntimeException('Запрос вложения не выполнен');
        }
        return $query;
    }
    function fetchedAttachment171($query): array {
        $row=cubrid_fetch($query,CUBRID_ASSOC|CUBRID_LOB);
        if(!is_array($row)||!is_resource($row['body']??null)||!is_resource($row['note']??null)){
            throw new RuntimeException('Нужна строка с двумя заполненными LOB');
        }
        return $row;
    }
    function readPart171($lob,int $length) {
        if($length<1 || $length>8192){throw new InvalidArgumentException('Допустима порция от 1 до 8192 байт');}
        $call=c171Capture(static function()use($lob,$length){return cubrid_lob2_read($lob,$length);});
        if($call['warning'] || $call['code']!==0 || $call['value']===null){c171Failure('Чтение LOB',$call);}
        if($call['value']!==false && (!is_string($call['value'])||$call['value']==='')){
            throw new RuntimeException('Чтение не продвигается');
        }
        return $call['value'];
    }
    function writeAll171($file,string $data): void {
        for($done=0;$done<strlen($data);){
            $written=fwrite($file,substr($data,$done));
            if($written===false || $written===0){throw new RuntimeException('Файл записан не полностью');}
            $done+=$written;
        }
    }

    $table=attachmentTable171($db,$owned,'export');
    $payload="AEN-ATTACHMENT\0v1\nitem=socket\nqty=3\n\xffEND\n";
    storeAttachment171($db,$table,1,'Данные измерения',$payload,'Паспорт измерения');c171Commit($db);
    $query=selectedAttachment171($db,$table,1);$row=null;
    try {
        $row=fetchedAttachment171($query);$lob=$row['body'];
        if(!cubrid_lob2_seek($lob,4,CUBRID_CURSOR_FIRST)){throw new RuntimeException('Не задана позиция');}
        $before=cubrid_lob2_tell($lob);$before64=cubrid_lob2_tell64($lob);
        $path=__DIR__.'/attachment.bin';
        $export=c171Capture(static function()use($lob,$path){return cubrid_lob2_export($lob,$path);});
        if($export['value']!==true || $export['warning']){c171Failure('Экспорт вложения',$export);}
        $after=cubrid_lob2_tell($lob);$after64=cubrid_lob2_tell64($lob);
        $size=filesize($path);$digest=hash_file('sha256',$path);
        $duplicate=c171Capture(static function()use($lob,$path){return cubrid_lob2_export($lob,$path);});
        clearstatcache(true,$path);
        $unchanged=filesize($path)===$size && hash_file('sha256',$path)===$digest;
        $rows=[['Вложение',$row['title']],['Созданный файл','attachment.bin'],['Размер файла, байт',$size],
            ['Позиция LOB до и после',$before.' → '.$after],['Строковая позиция tell64',$after64],
            ['Существующий файл не перезаписан',$duplicate['value']===false && $unchanged],['SHA-256',$digest]];
        $checks=['export_ok'=>$export['value']===true,'entire_lob'=>$size===strlen($payload) && $digest===hash('sha256',$payload),
            'cursor_unchanged'=>$before===4 && $after===4,'position_string'=>$before64==='4' && $after64==='4',
            'existing_refused'=>$duplicate['value']===false && $duplicate['warning'],'existing_preserved'=>$unchanged];
        $observations=['bytes'=>$size,'sha256'=>$digest,'prefix_hex'=>bin2hex(substr($payload,0,18)),
            'position_before'=>$before,'position_after'=>$after,'position_string'=>$after64,'export'=>$export,'existing_file'=>$duplicate];
    } finally {
        // Для fetched LOB в закреплённом драйвере сначала завершаем запрос.
        c171Release($query);$row=null;$lob=null;
    }

} finally {
    if (is_resource($db)) {try {$removed=c171Cleanup($db,$owned);} finally {c171Close($db);}}
}

c171Report('cub171-file-export','Выгрузить вложение целиком, сохранив уже существующий файл',$rows,$checks,$observations,$runtime,$owned,$removed);

Вложение — Данные измерения
Созданный файл — attachment.bin
Размер файла, байт — 41
Позиция LOB до и после — 4 → 4
Строковая позиция tell64 — 4
Существующий файл не перезаписан — да
SHA-256 — 4b4e1163637b8d5fe4aad9f0dff9a587192e50840ac339a1fe68e419f7fb0936

Распакуйте весь 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=c171Config();$db=c171Connect();$runtime=c171Runtime($db);

    // Подготовка данных продолжает главу о сохранении LOB.
    function attachmentTable171($db,array &$owned,string $label): string {
        $name=c171OwnName($db,$owned,'TABLE',$label);$table=c171Qualified($name);
        c171Ddl($db,'CREATE TABLE '.$table.' (id INT PRIMARY KEY,title VARCHAR(80),body BLOB,note CLOB)');
        c171Commit($db);return $table;
    }
    function closeOwnedLob171(&$lob): void {
        if(is_resource($lob)) {
            if(cubrid_lob2_close($lob)!==true){throw new RuntimeException('Созданный LOB не закрыт');}
            $lob=null;
        }
    }
    function storeAttachment171($db,string $table,int $id,string $title,string $body,string $note): void {
        $query=$binary=$text=null;
        try {
            $binary=cubrid_lob2_new($db,'BLOB');$text=cubrid_lob2_new($db,'CLOB');
            if(!is_resource($binary)||!is_resource($text)){throw new RuntimeException('LOB не создан');}
            if(cubrid_lob2_write($binary,$body)!==true || cubrid_lob2_write($text,$note)!==true){throw new RuntimeException('LOB не заполнен');}
            $query=cubrid_prepare($db,'INSERT INTO '.$table.' (id,title,body,note) VALUES (?,?,?,?)');
            if($query===false || !cubrid_bind($query,1,$id,'int') || !cubrid_bind($query,2,$title,'string')
                || !cubrid_lob2_bind($query,3,$binary,'BLOB') || !cubrid_lob2_bind($query,4,$text,'CLOB')
                || !cubrid_execute($query)){throw new RuntimeException('Вложение не сохранено');}
        } finally {
            c171Release($query);closeOwnedLob171($binary);closeOwnedLob171($text);
        }
    }
    function selectedAttachment171($db,string $table,int $id) {
        $query=cubrid_prepare($db,'SELECT id,title,body,note FROM '.$table.' WHERE id=?');
        if($query===false){throw new RuntimeException('Запрос вложения не подготовлен');}
        if(!cubrid_bind($query,1,$id,'int') || !cubrid_execute($query)){
            c171Release($query);throw new RuntimeException('Запрос вложения не выполнен');
        }
        return $query;
    }
    function fetchedAttachment171($query): array {
        $row=cubrid_fetch($query,CUBRID_ASSOC|CUBRID_LOB);
        if(!is_array($row)||!is_resource($row['body']??null)||!is_resource($row['note']??null)){
            throw new RuntimeException('Нужна строка с двумя заполненными LOB');
        }
        return $row;
    }
    function readPart171($lob,int $length) {
        if($length<1 || $length>8192){throw new InvalidArgumentException('Допустима порция от 1 до 8192 байт');}
        $call=c171Capture(static function()use($lob,$length){return cubrid_lob2_read($lob,$length);});
        if($call['warning'] || $call['code']!==0 || $call['value']===null){c171Failure('Чтение LOB',$call);}
        if($call['value']!==false && (!is_string($call['value'])||$call['value']==='')){
            throw new RuntimeException('Чтение не продвигается');
        }
        return $call['value'];
    }
    function writeAll171($file,string $data): void {
        for($done=0;$done<strlen($data);){
            $written=fwrite($file,substr($data,$done));
            if($written===false || $written===0){throw new RuntimeException('Файл записан не полностью');}
            $done+=$written;
        }
    }

    $table=attachmentTable171($db,$owned,'chunks');$created=$insert=null;
    $unit="ITEM=socket;QTY=3;\0\xff\n";$block=str_repeat($unit,32);$expectedHash=hash_init('sha256');$expectedBytes=0;
    try {
        $created=cubrid_lob2_new($db,'BLOB');
        if(!is_resource($created)){throw new RuntimeException('BLOB не создан');}
        for($i=0;$i<65;$i++){
            if(cubrid_lob2_write($created,$block)!==true){throw new RuntimeException('Блок исходника не записан');}
            hash_update($expectedHash,$block);$expectedBytes+=strlen($block);
        }
        $insert=cubrid_prepare($db,'INSERT INTO '.$table.' (id,title,body,note) VALUES (1,?,?,?)');
        if($insert===false || !cubrid_bind($insert,1,'Журнал поставки','string')
            || !cubrid_lob2_bind($insert,2,$created,'BLOB') || !cubrid_lob2_bind($insert,3,'Порционная копия','CLOB')
            || !cubrid_execute($insert)){throw new RuntimeException('Журнал не сохранён');}
    } finally {c171Release($insert);closeOwnedLob171($created);}
    c171Commit($db);$expectedDigest=hash_final($expectedHash);
    $query=selectedAttachment171($db,$table,1);$row=null;$output=null;
    try {
        $row=fetchedAttachment171($query);$lob=$row['body'];
        $output=fopen(__DIR__.'/streamed.bin','xb');
        if($output===false){throw new RuntimeException('Нужен новый выходной файл');}
        $context=hash_init('sha256');$bytes=0;$chunks=0;$largest=0;$lastLength=0;
        while(true){
            $chunk=readPart171($lob,1024);
            if($chunk===false){break;}
            writeAll171($output,$chunk);hash_update($context,$chunk);
            $lastLength=strlen($chunk);$bytes+=$lastLength;$chunks++;$largest=max($largest,$lastLength);
            if($bytes>$expectedBytes){throw new RuntimeException('Прочитано больше ожидаемого');}
        }
        fclose($output);$output=null;
        $digest=hash_final($context);$position=cubrid_lob2_tell64($lob);
        $rows=[['Полученный файл','streamed.bin'],['Перенесено байт',$bytes],['Порций',$chunks],
            ['Максимальная порция, байт',$largest],['Последняя порция, байт',$lastLength],['Позиция после EOF',$position],['SHA-256',$digest]];
        $checks=['all_bytes'=>$bytes===$expectedBytes,'chunk_bound'=>$largest<=1024 && $chunks>1,
            'partial_last'=>$lastLength>0 && $lastLength<1024,'hash_matches'=>$digest===$expectedDigest,
            'file_matches'=>filesize(__DIR__.'/streamed.bin')===$bytes && hash_file('sha256',__DIR__.'/streamed.bin')===$digest,
            'end_position'=>$position===(string)$bytes];
        $observations=['bytes'=>$bytes,'chunks'=>$chunks,'max_chunk'=>$largest,'last_chunk'=>$lastLength,
            'sha256'=>$digest,'tell64'=>$position,'whole_lob_accumulated_in_php'=>false,'fixture_block_bytes'=>strlen($block)];
    } finally {
        if(is_resource($output)){fclose($output);}
        c171Release($query);$row=null;$lob=null;
    }

} finally {
    if (is_resource($db)) {try {$removed=c171Cleanup($db,$owned);} finally {c171Close($db);}}
}

c171Report('cub171-chunked-read','Перенести вложение порциями и проверить каждый записанный байт',$rows,$checks,$observations,$runtime,$owned,$removed);

Полученный файл — streamed.bin
Перенесено байт — 43680
Порций — 43
Максимальная порция, байт — 1024
Последняя порция, байт — 672
Позиция после EOF — 43680
SHA-256 — 03ce209e1b6f0dfe21ae78dd9d4462c6c51dad0f5ed1630ea80125a886a4d811

Распакуйте весь 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=c171Config();$db=c171Connect();$runtime=c171Runtime($db);

    // Подготовка данных продолжает главу о сохранении LOB.
    function attachmentTable171($db,array &$owned,string $label): string {
        $name=c171OwnName($db,$owned,'TABLE',$label);$table=c171Qualified($name);
        c171Ddl($db,'CREATE TABLE '.$table.' (id INT PRIMARY KEY,title VARCHAR(80),body BLOB,note CLOB)');
        c171Commit($db);return $table;
    }
    function closeOwnedLob171(&$lob): void {
        if(is_resource($lob)) {
            if(cubrid_lob2_close($lob)!==true){throw new RuntimeException('Созданный LOB не закрыт');}
            $lob=null;
        }
    }
    function storeAttachment171($db,string $table,int $id,string $title,string $body,string $note): void {
        $query=$binary=$text=null;
        try {
            $binary=cubrid_lob2_new($db,'BLOB');$text=cubrid_lob2_new($db,'CLOB');
            if(!is_resource($binary)||!is_resource($text)){throw new RuntimeException('LOB не создан');}
            if(cubrid_lob2_write($binary,$body)!==true || cubrid_lob2_write($text,$note)!==true){throw new RuntimeException('LOB не заполнен');}
            $query=cubrid_prepare($db,'INSERT INTO '.$table.' (id,title,body,note) VALUES (?,?,?,?)');
            if($query===false || !cubrid_bind($query,1,$id,'int') || !cubrid_bind($query,2,$title,'string')
                || !cubrid_lob2_bind($query,3,$binary,'BLOB') || !cubrid_lob2_bind($query,4,$text,'CLOB')
                || !cubrid_execute($query)){throw new RuntimeException('Вложение не сохранено');}
        } finally {
            c171Release($query);closeOwnedLob171($binary);closeOwnedLob171($text);
        }
    }
    function selectedAttachment171($db,string $table,int $id) {
        $query=cubrid_prepare($db,'SELECT id,title,body,note FROM '.$table.' WHERE id=?');
        if($query===false){throw new RuntimeException('Запрос вложения не подготовлен');}
        if(!cubrid_bind($query,1,$id,'int') || !cubrid_execute($query)){
            c171Release($query);throw new RuntimeException('Запрос вложения не выполнен');
        }
        return $query;
    }
    function fetchedAttachment171($query): array {
        $row=cubrid_fetch($query,CUBRID_ASSOC|CUBRID_LOB);
        if(!is_array($row)||!is_resource($row['body']??null)||!is_resource($row['note']??null)){
            throw new RuntimeException('Нужна строка с двумя заполненными LOB');
        }
        return $row;
    }
    function readPart171($lob,int $length) {
        if($length<1 || $length>8192){throw new InvalidArgumentException('Допустима порция от 1 до 8192 байт');}
        $call=c171Capture(static function()use($lob,$length){return cubrid_lob2_read($lob,$length);});
        if($call['warning'] || $call['code']!==0 || $call['value']===null){c171Failure('Чтение LOB',$call);}
        if($call['value']!==false && (!is_string($call['value'])||$call['value']==='')){
            throw new RuntimeException('Чтение не продвигается');
        }
        return $call['value'];
    }
    function writeAll171($file,string $data): void {
        for($done=0;$done<strlen($data);){
            $written=fwrite($file,substr($data,$done));
            if($written===false || $written===0){throw new RuntimeException('Файл записан не полностью');}
            $done+=$written;
        }
    }

    $table=attachmentTable171($db,$owned,'preview');
    $source="HEADER|Заказ 17\nBODY|Проверить O'Reilly\nTAIL|OK\n";
    storeAttachment171($db,$table,1,'Служебная карточка',$source,'Предпросмотр');c171Commit($db);
    $query=selectedAttachment171($db,$table,1);$row=null;
    try {
        $row=fetchedAttachment171($query);$lob=$row['body'];
        if(!cubrid_lob2_seek($lob,0,CUBRID_CURSOR_FIRST)){throw new RuntimeException('Нет начала LOB');}
        $magic=readPart171($lob,7);$p7=cubrid_lob2_tell($lob);
        $header=readPart171($lob,strlen('Заказ 17'));$headerEnd=cubrid_lob2_tell64($lob);
        if(!cubrid_lob2_seek($lob,1,CUBRID_CURSOR_CURRENT)){throw new RuntimeException('Не пропущен перевод строки');}
        $bodyOffset=cubrid_lob2_tell64($lob);
        if(!is_string($bodyOffset) || !preg_match('/^[0-9]+$/D',$bodyOffset)){throw new RuntimeException('Нет строковой позиции');}
        $bodyMarker=readPart171($lob,5);
        $bodyText=readPart171($lob,strlen("Проверить O'Reilly"));
        if(!cubrid_lob2_seek64($lob,$bodyOffset,CUBRID_CURSOR_FIRST)){throw new RuntimeException('Не восстановлена закладка');}
        $again=readPart171($lob,5);
        if(!cubrid_lob2_seek64($lob,'8',CUBRID_CURSOR_LAST)){throw new RuntimeException('Нет хвоста');}
        $tail=readPart171($lob,8);$end=cubrid_lob2_tell64($lob);
        $bad=c171Capture(static function()use($lob){return cubrid_lob2_seek($lob,-1,CUBRID_CURSOR_FIRST);});
        $afterBad=cubrid_lob2_tell64($lob);
        $preview='Заголовок: '.$header."\nФрагмент: ".$bodyText."\nКонец: ".rtrim($tail,"\n")."\n";
        $output=fopen(__DIR__.'/preview.txt','xb');
        if($output===false){throw new RuntimeException('Предпросмотр уже существует');}
        try{writeAll171($output,$preview);}finally{fclose($output);}
        $rows=[['Маркер',$magic],['Позиция после маркера',$p7],['Заголовок',$header],
            ['Закладка BODY как строка',$bodyOffset],['Выбранный текст',$bodyText],['Хвост',rtrim($tail,"\n")],
            ['Позиция в конце',$end],['Выход перед началом отклонён',$bad['value']===false && $bad['warning']]];
        $checks=['header'=>$magic==='HEADER|' && $p7===7 && $header==='Заказ 17',
            'utf8_byte_position'=>$headerEnd===(string)strlen('HEADER|Заказ 17'),
            'bookmark_string'=>is_string($bodyOffset) && $bodyOffset===(string)strlen("HEADER|Заказ 17\n"),
            'same_bookmark'=>$bodyMarker==='BODY|' && $again===$bodyMarker,
            'utf8_apostrophe'=>$bodyText==="Проверить O'Reilly",
            'tail'=>$tail==="TAIL|OK\n" && $end===(string)strlen($source),
            'before_start_refused'=>$bad['value']===false && $bad['warning'] && $afterBad===$end,
            'preview_exact'=>$preview==="Заголовок: Заказ 17\nФрагмент: Проверить O'Reilly\nКонец: TAIL|OK\n"];
        $observations=['header'=>$header,'header_end'=>$headerEnd,'body_offset'=>$bodyOffset,'body'=>$bodyText,
            'tail'=>$tail,'end'=>$end,'invalid_seek'=>$bad,'after_invalid'=>$afterBad,'preview'=>$preview];
    } finally {c171Release($query);$row=null;$lob=null;}

} finally {
    if (is_resource($db)) {try {$removed=c171Cleanup($db,$owned);} finally {c171Close($db);}}
}

c171Report('cub171-seek-preview','Прочитать заголовок, выбранный фрагмент и хвост без выгрузки всего LOB',$rows,$checks,$observations,$runtime,$owned,$removed);

Маркер — HEADER|
Позиция после маркера — 7
Заголовок — Заказ 17
Закладка BODY как строка — 21
Выбранный текст — Проверить O'Reilly
Хвост — TAIL|OK
Позиция в конце — 62
Выход перед началом отклонён — да

Распакуйте весь 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=c171Config();$db=c171Connect();$runtime=c171Runtime($db);

    // Подготовка данных продолжает главу о сохранении LOB.
    function attachmentTable171($db,array &$owned,string $label): string {
        $name=c171OwnName($db,$owned,'TABLE',$label);$table=c171Qualified($name);
        c171Ddl($db,'CREATE TABLE '.$table.' (id INT PRIMARY KEY,title VARCHAR(80),body BLOB,note CLOB)');
        c171Commit($db);return $table;
    }
    function closeOwnedLob171(&$lob): void {
        if(is_resource($lob)) {
            if(cubrid_lob2_close($lob)!==true){throw new RuntimeException('Созданный LOB не закрыт');}
            $lob=null;
        }
    }
    function storeAttachment171($db,string $table,int $id,string $title,string $body,string $note): void {
        $query=$binary=$text=null;
        try {
            $binary=cubrid_lob2_new($db,'BLOB');$text=cubrid_lob2_new($db,'CLOB');
            if(!is_resource($binary)||!is_resource($text)){throw new RuntimeException('LOB не создан');}
            if(cubrid_lob2_write($binary,$body)!==true || cubrid_lob2_write($text,$note)!==true){throw new RuntimeException('LOB не заполнен');}
            $query=cubrid_prepare($db,'INSERT INTO '.$table.' (id,title,body,note) VALUES (?,?,?,?)');
            if($query===false || !cubrid_bind($query,1,$id,'int') || !cubrid_bind($query,2,$title,'string')
                || !cubrid_lob2_bind($query,3,$binary,'BLOB') || !cubrid_lob2_bind($query,4,$text,'CLOB')
                || !cubrid_execute($query)){throw new RuntimeException('Вложение не сохранено');}
        } finally {
            c171Release($query);closeOwnedLob171($binary);closeOwnedLob171($text);
        }
    }
    function selectedAttachment171($db,string $table,int $id) {
        $query=cubrid_prepare($db,'SELECT id,title,body,note FROM '.$table.' WHERE id=?');
        if($query===false){throw new RuntimeException('Запрос вложения не подготовлен');}
        if(!cubrid_bind($query,1,$id,'int') || !cubrid_execute($query)){
            c171Release($query);throw new RuntimeException('Запрос вложения не выполнен');
        }
        return $query;
    }
    function fetchedAttachment171($query): array {
        $row=cubrid_fetch($query,CUBRID_ASSOC|CUBRID_LOB);
        if(!is_array($row)||!is_resource($row['body']??null)||!is_resource($row['note']??null)){
            throw new RuntimeException('Нужна строка с двумя заполненными LOB');
        }
        return $row;
    }
    function readPart171($lob,int $length) {
        if($length<1 || $length>8192){throw new InvalidArgumentException('Допустима порция от 1 до 8192 байт');}
        $call=c171Capture(static function()use($lob,$length){return cubrid_lob2_read($lob,$length);});
        if($call['warning'] || $call['code']!==0 || $call['value']===null){c171Failure('Чтение LOB',$call);}
        if($call['value']!==false && (!is_string($call['value'])||$call['value']==='')){
            throw new RuntimeException('Чтение не продвигается');
        }
        return $call['value'];
    }
    function writeAll171($file,string $data): void {
        for($done=0;$done<strlen($data);){
            $written=fwrite($file,substr($data,$done));
            if($written===false || $written===0){throw new RuntimeException('Файл записан не полностью');}
            $done+=$written;
        }
    }

    $table=attachmentTable171($db,$owned,'catalog');
    storeAttachment171($db,$table,1,'Кабель',"BIN\0A","Кабель O'Reilly");
    storeAttachment171($db,$table,2,'Хомут','0','Хомут');c171Commit($db);
    $query=cubrid_prepare($db,'SELECT id,title,body,note FROM '.$table.' WHERE id IN (1,2) ORDER BY id LIMIT 2');
    if($query===false || !cubrid_execute($query)){throw new RuntimeException('Каталог не выбран');}
    $output=null;$row=null;$held=[];$catalog=[];
    try {
        $output=fopen(__DIR__.'/attachment-catalog.csv','xb');
        if($output===false){throw new RuntimeException('Нужен новый CSV');}
        if(fputcsv($output,['id','title','bytes','note'],';','"','\\')===false){throw new RuntimeException('Не записан заголовок');}
        while(true){
            $call=c171Capture(static function()use($query){return cubrid_fetch($query,CUBRID_ASSOC|CUBRID_LOB);});
            if($call['warning'] || $call['code']!==0 || $call['value']===null){c171Failure('Чтение строки',$call);}
            if($call['value']===false){break;}
            $row=$call['value'];unset($call);
            if(!is_resource($row['body']) || !is_resource($row['note'])){throw new RuntimeException('Нет двух LOB');}
            // Держим PHP-ссылки до завершения запроса; старые LOB больше не читаем.
            $held[]=$row['body'];$held[]=$row['note'];
            $bytes=0;$digest=hash_init('sha256');
            while(($part=readPart171($row['body'],32))!==false){$bytes+=strlen($part);hash_update($digest,$part);}
            $note='';
            while(($part=readPart171($row['note'],32))!==false){
                if(strlen($note)+strlen($part)>128){throw new RuntimeException('Подпись слишком длинная');}
                $note.=$part;
            }
            $record=[(int)$row['id'],$row['title'],$bytes,$note];
            if(fputcsv($output,$record,';','"','\\')===false){throw new RuntimeException('Не записана строка CSV');}
            $catalog[]=['id'=>$record[0],'title'=>$record[1],'bytes'=>$record[2],'note'=>$record[3],'sha256'=>hash_final($digest)];
        }
        fclose($output);$output=null;
    } finally {
        if(is_resource($output)){fclose($output);}
        c171Release($query);$row=null;$call=null;$held=[];
    }
    $expected="id;title;bytes;note\n1;Кабель;5;\"Кабель O'Reilly\"\n2;Хомут;1;Хомут\n";
    $rows=[['Кабель',$catalog[0]['bytes'].' байт; '.$catalog[0]['note']],['Хомут',$catalog[1]['bytes'].' байт; '.$catalog[1]['note']],
        ['Строк в каталоге',count($catalog)],['Файл','attachment-catalog.csv'],['Строка 0 не потеряна',$catalog[1]['sha256']===hash('sha256','0')]];
    $checks=['two_rows'=>count($catalog)===2,'first_payload'=>$catalog[0]['bytes']===5 && $catalog[0]['sha256']===hash('sha256',"BIN\0A"),
        'utf8_apostrophe'=>$catalog[0]['note']==="Кабель O'Reilly",'second_text'=>$catalog[1]['note']==='Хомут',
        'zero_is_data'=>$catalog[1]['bytes']===1 && $catalog[1]['sha256']===hash('sha256','0'),
        'exact_csv'=>filesize(__DIR__.'/attachment-catalog.csv')===strlen($expected) && hash_file('sha256',__DIR__.'/attachment-catalog.csv')===hash('sha256',$expected),
        'request_released'=>$query===null && $held===[]];
    $observations=['catalog'=>$catalog,'csv'=>$expected,'selected_rows'=>2,'lob_handles_per_row'=>2,
        'lifecycle'=>'consume current row; retain resource references; finish request; release references'];

} finally {
    if (is_resource($db)) {try {$removed=c171Cleanup($db,$owned);} finally {c171Close($db);}}
}

c171Report('cub171-attachment-catalog','Составить CSV двух вложений, потребляя LOB в пределах текущей строки',$rows,$checks,$observations,$runtime,$owned,$removed);

Кабель — 5 байт; Кабель O'Reilly
Хомут — 1 байт; Хомут
Строк в каталоге — 2
Файл — attachment-catalog.csv
Строка 0 не потеряна — да

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