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);

function value171(callable $action) {
    $call=c171Capture($action);
    if ($call['value']===false || $call['value']===null || $call['warning']) {
        c171Failure('Действие с вложением не выполнено',$call);
    }
    return $call['value'];
}
function closeCreated171(&$lob): void {
    if (is_resource($lob)) {
        $call=c171Capture(static function() use ($lob) {return cubrid_lob2_close($lob);});
        $lob=null;
        if ($call['value']!==true || $call['warning']) {c171Failure('Созданный LOB не закрыт',$call);}
    } else {$lob=null;}
}
function saveLob171($db,string $table,int $id,string $title,$lob,string $type): int {
    $request=null;
    try {
        $request=value171(static function() use ($db,$table) {
            return cubrid_prepare($db,'INSERT INTO '.$table.' (id,title,body) VALUES (?,?,?)');
        });
        value171(static function() use ($request,$id) {return cubrid_bind($request,1,$id,'int');});
        value171(static function() use ($request,$title) {return cubrid_bind($request,2,$title,'string');});
        value171(static function() use ($request,$lob,$type) {return cubrid_lob2_bind($request,3,$lob,$type);});
        value171(static function() use ($request) {return cubrid_execute($request);});
        $affected=value171(static function() use ($request) {return cubrid_affected_rows($request);});
        if ($affected!==1) {throw new RuntimeException('Не сохранена одна строка вложения');}
        return $affected;
    } finally {c171Release($request);}
}
function savedLob171($db,string $table,int $id): array {
    $request=null;$row=null;$lob=null;$fetched=null;
    try {
        $request=c171Request($db,'SELECT id,title,body FROM '.$table.' WHERE id=?',[$id]);
        $fetched=c171Capture(static function() use ($request) {
            return cubrid_fetch_array($request,CUBRID_ASSOC|CUBRID_LOB);
        });
        if (!is_array($fetched['value']) || $fetched['warning']) {c171Failure('Вложение не найдено',$fetched);}
        $row=$fetched['value'];
        if ($row['body']===null) {return ['id'=>(int)$row['id'],'title'=>$row['title'],'sql_null'=>true,'bytes'=>null,'bytes64'=>null,'data'=>null];}
        $lob=$row['body'];
        if (!is_resource($lob)) {throw new RuntimeException('Нужен LOB-ресурс результата');}
        $size=value171(static function() use ($lob) {return cubrid_lob2_size($lob);});
        $size64=value171(static function() use ($lob) {return cubrid_lob2_size64($lob);});
        if (!is_int($size) || $size<0 || $size>1048576 || $size64!==(string)$size) {
            throw new RuntimeException('Этот учебный просмотр ограничен одним МиБ');
        }
        $data='';$remaining=$size;
        while ($remaining>0) {
            $amount=min(8192,$remaining);
            $part=value171(static function() use ($lob,$amount) {return cubrid_lob2_read($lob,$amount);});
            if (!is_string($part) || strlen($part)===0 || strlen($part)>$remaining) {throw new RuntimeException('Неполное чтение LOB');}
            $data.=$part;$remaining-=strlen($part);
        }
        return ['id'=>(int)$row['id'],'title'=>$row['title'],'sql_null'=>false,'bytes'=>$size,'bytes64'=>$size64,'data'=>$data];
    } finally {
        // Driver 11.2.0.0002 retains raw pointers in the request.
        // Consume first, release request, then drop every PHP reference.
        c171Release($request);
        $lob=null;$row=null;$fetched=null;
    }
}
function artifact171(string $name,string $data): void {
    if (basename($name)!==$name) {throw new InvalidArgumentException('Нужно простое имя файла');}
    if (file_put_contents(__DIR__.'/'.$name,$data)!==strlen($data)) {throw new RuntimeException('Файл результата не записан');}
}

    $name=c171OwnName($db,$owned,'TABLE','binary_file');$t=c171Qualified($name);
    c171Ddl($db,'CREATE TABLE '.$t.' (id INT PRIMARY KEY,title VARCHAR(80),body BLOB)');c171Commit($db);
    $payload="METER171\0".pack('v*',1250,0,4095)."\nEND\n";
    $lob=null;
    try {
        $lob=value171(static function() use ($db) {return cubrid_lob2_new($db,'BLOB');});
        // One binary PHP string; embedded NUL must not be sent as a string bind.
        $written=value171(static function() use ($lob,$payload) {return cubrid_lob2_write($lob,$payload);});
        $size=value171(static function() use ($lob) {return cubrid_lob2_size($lob);});
        $size64=value171(static function() use ($lob) {return cubrid_lob2_size64($lob);});
        $affected=saveLob171($db,$t,10,'Измерение датчика',$lob,'BLOB');
    } finally {closeCreated171($lob);}
    c171Commit($db);
    $saved=savedLob171($db,$t,10);c171Commit($db);
    artifact171('attachment.bin',$saved['data']);
    $measurements=array_values(unpack('v*',substr($saved['data'],9,6)));
    $rows=[['Карточка',$saved['title']],['Файл','attachment.bin'],['Размер, байт',$saved['bytes']],
        ['Заголовок','METER171 + NUL'],['Три отсчёта',implode('; ',$measurements)],
        ['Содержимое совпало',$saved['data']===$payload],['Размер size64',$saved['bytes64']]];
    $checks=['created_resource_closed'=>$lob===null,'write_true'=>$written===true,'one_row_saved'=>$affected===1,
        'native_size'=>$size===strlen($payload),'size64_string'=>is_string($size64)&&$size64===(string)$size,
        'saved_binary_exact'=>$saved['data']===$payload,'header_exact'=>substr($saved['data'],0,9)==="METER171\0",
        'measurements_exact'=>$measurements===[1250,0,4095],'artifact_exact'=>hash_file('sha256',__DIR__.'/attachment.bin')===hash('sha256',$payload)];
    $observations=['selected_id'=>$saved['id'],'payload_hex'=>bin2hex($saved['data']),'measurements'=>$measurements,
        'sha256'=>hash('sha256',$saved['data']),'source_bytes'=>strlen($payload),'size_type'=>gettype($size),'size64_type'=>gettype($size64)];

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

c171Report('cub171-binary-attachment','Сохранить файл измерения и вернуть его без потери нулевых байтов',$rows,$checks,$observations,$runtime,$owned,$removed);

Карточка — Измерение датчика
Файл — attachment.bin
Размер, байт — 20
Заголовок — METER171 + NUL
Три отсчёта — 1250; 0; 4095
Содержимое совпало — да
Размер size64 — 20

Распакуйте весь 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);

function value171(callable $action) {
    $call=c171Capture($action);
    if ($call['value']===false || $call['value']===null || $call['warning']) {
        c171Failure('Действие с вложением не выполнено',$call);
    }
    return $call['value'];
}
function closeCreated171(&$lob): void {
    if (is_resource($lob)) {
        $call=c171Capture(static function() use ($lob) {return cubrid_lob2_close($lob);});
        $lob=null;
        if ($call['value']!==true || $call['warning']) {c171Failure('Созданный LOB не закрыт',$call);}
    } else {$lob=null;}
}
function saveLob171($db,string $table,int $id,string $title,$lob,string $type): int {
    $request=null;
    try {
        $request=value171(static function() use ($db,$table) {
            return cubrid_prepare($db,'INSERT INTO '.$table.' (id,title,body) VALUES (?,?,?)');
        });
        value171(static function() use ($request,$id) {return cubrid_bind($request,1,$id,'int');});
        value171(static function() use ($request,$title) {return cubrid_bind($request,2,$title,'string');});
        value171(static function() use ($request,$lob,$type) {return cubrid_lob2_bind($request,3,$lob,$type);});
        value171(static function() use ($request) {return cubrid_execute($request);});
        $affected=value171(static function() use ($request) {return cubrid_affected_rows($request);});
        if ($affected!==1) {throw new RuntimeException('Не сохранена одна строка вложения');}
        return $affected;
    } finally {c171Release($request);}
}
function savedLob171($db,string $table,int $id): array {
    $request=null;$row=null;$lob=null;$fetched=null;
    try {
        $request=c171Request($db,'SELECT id,title,body FROM '.$table.' WHERE id=?',[$id]);
        $fetched=c171Capture(static function() use ($request) {
            return cubrid_fetch_array($request,CUBRID_ASSOC|CUBRID_LOB);
        });
        if (!is_array($fetched['value']) || $fetched['warning']) {c171Failure('Вложение не найдено',$fetched);}
        $row=$fetched['value'];
        if ($row['body']===null) {return ['id'=>(int)$row['id'],'title'=>$row['title'],'sql_null'=>true,'bytes'=>null,'bytes64'=>null,'data'=>null];}
        $lob=$row['body'];
        if (!is_resource($lob)) {throw new RuntimeException('Нужен LOB-ресурс результата');}
        $size=value171(static function() use ($lob) {return cubrid_lob2_size($lob);});
        $size64=value171(static function() use ($lob) {return cubrid_lob2_size64($lob);});
        if (!is_int($size) || $size<0 || $size>1048576 || $size64!==(string)$size) {
            throw new RuntimeException('Этот учебный просмотр ограничен одним МиБ');
        }
        $data='';$remaining=$size;
        while ($remaining>0) {
            $amount=min(8192,$remaining);
            $part=value171(static function() use ($lob,$amount) {return cubrid_lob2_read($lob,$amount);});
            if (!is_string($part) || strlen($part)===0 || strlen($part)>$remaining) {throw new RuntimeException('Неполное чтение LOB');}
            $data.=$part;$remaining-=strlen($part);
        }
        return ['id'=>(int)$row['id'],'title'=>$row['title'],'sql_null'=>false,'bytes'=>$size,'bytes64'=>$size64,'data'=>$data];
    } finally {
        // Driver 11.2.0.0002 retains raw pointers in the request.
        // Consume first, release request, then drop every PHP reference.
        c171Release($request);
        $lob=null;$row=null;$fetched=null;
    }
}
function artifact171(string $name,string $data): void {
    if (basename($name)!==$name) {throw new InvalidArgumentException('Нужно простое имя файла');}
    if (file_put_contents(__DIR__.'/'.$name,$data)!==strlen($data)) {throw new RuntimeException('Файл результата не записан');}
}

    $name=c171OwnName($db,$owned,'TABLE','instructions');$t=c171Qualified($name);
    c171Ddl($db,'CREATE TABLE '.$t.' (id INT PRIMARY KEY,title VARCHAR(80),body CLOB)');c171Commit($db);
    $lines=["Кабель O'Reilly\n","1. Отключить питание.\n","2. Проверить маркировку ✓.\n"];
    $source=implode('',$lines);$lob=null;$calls=0;
    try {
        $lob=value171(static function() use ($db) {return cubrid_lob2_new($db,'CLOB');});
        foreach($lines as $line) {
            value171(static function() use ($lob,$line) {return cubrid_lob2_write($lob,$line);});$calls++;
        }
        $size=value171(static function() use ($lob) {return cubrid_lob2_size($lob);});
        $size64=value171(static function() use ($lob) {return cubrid_lob2_size64($lob);});
        $affected=saveLob171($db,$t,7,"Кабель O'Reilly",$lob,'CLOB');
    } finally {closeCreated171($lob);}
    c171Commit($db);$saved=savedLob171($db,$t,7);c171Commit($db);
    artifact171('instruction.txt',$saved['data']);
    $decoded=preg_split('//u',$saved['data'],-1,PREG_SPLIT_NO_EMPTY);
    if ($decoded===false) {throw new RuntimeException('Инструкция не является UTF-8');}
    $rows=[['Товар',$saved['title']],['Записано частей',$calls],['Размер UTF-8, байт',$saved['bytes']],
        ['Кодовых точек Unicode',count($decoded)],['Текст совпал',$saved['data']===$source],['Файл','instruction.txt']];
    $checks=['three_writes'=>$calls===3,'one_row_saved'=>$affected===1,'created_resource_closed'=>$lob===null,
        'utf8_exact'=>$saved['data']===$source,'byte_length'=>$size===strlen($source)&&$saved['bytes']===$size,
        'decimal_size'=>$size64===(string)$size,'bytes_not_characters'=>$size>count($decoded),
        'apostrophe_preserved'=>strpos($saved['data'],"O'Reilly")!==false,
        'check_mark_preserved'=>strpos($saved['data'],'✓')!==false,
        'artifact_exact'=>hash_file('sha256',__DIR__.'/instruction.txt')===hash('sha256',$source)];
    $observations=['instruction'=>$saved['data'],'line_bytes'=>array_map('strlen',$lines),'characters'=>count($decoded),
        'size64'=>$size64,'sha256'=>hash('sha256',$saved['data']),'charset'=>$runtime['charset']];

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

c171Report('cub171-text-instructions','Собрать инструкцию UTF-8 по шагам и сохранить как CLOB',$rows,$checks,$observations,$runtime,$owned,$removed);

Товар — Кабель O'Reilly
Записано частей — 3
Размер UTF-8, байт — 108
Кодовых точек Unicode — 65
Текст совпал — да
Файл — instruction.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=c171Config();$db=c171Connect();$runtime=c171Runtime($db);

function value171(callable $action) {
    $call=c171Capture($action);
    if ($call['value']===false || $call['value']===null || $call['warning']) {
        c171Failure('Действие с вложением не выполнено',$call);
    }
    return $call['value'];
}
function closeCreated171(&$lob): void {
    if (is_resource($lob)) {
        $call=c171Capture(static function() use ($lob) {return cubrid_lob2_close($lob);});
        $lob=null;
        if ($call['value']!==true || $call['warning']) {c171Failure('Созданный LOB не закрыт',$call);}
    } else {$lob=null;}
}
function saveLob171($db,string $table,int $id,string $title,$lob,string $type): int {
    $request=null;
    try {
        $request=value171(static function() use ($db,$table) {
            return cubrid_prepare($db,'INSERT INTO '.$table.' (id,title,body) VALUES (?,?,?)');
        });
        value171(static function() use ($request,$id) {return cubrid_bind($request,1,$id,'int');});
        value171(static function() use ($request,$title) {return cubrid_bind($request,2,$title,'string');});
        value171(static function() use ($request,$lob,$type) {return cubrid_lob2_bind($request,3,$lob,$type);});
        value171(static function() use ($request) {return cubrid_execute($request);});
        $affected=value171(static function() use ($request) {return cubrid_affected_rows($request);});
        if ($affected!==1) {throw new RuntimeException('Не сохранена одна строка вложения');}
        return $affected;
    } finally {c171Release($request);}
}
function savedLob171($db,string $table,int $id): array {
    $request=null;$row=null;$lob=null;$fetched=null;
    try {
        $request=c171Request($db,'SELECT id,title,body FROM '.$table.' WHERE id=?',[$id]);
        $fetched=c171Capture(static function() use ($request) {
            return cubrid_fetch_array($request,CUBRID_ASSOC|CUBRID_LOB);
        });
        if (!is_array($fetched['value']) || $fetched['warning']) {c171Failure('Вложение не найдено',$fetched);}
        $row=$fetched['value'];
        if ($row['body']===null) {return ['id'=>(int)$row['id'],'title'=>$row['title'],'sql_null'=>true,'bytes'=>null,'bytes64'=>null,'data'=>null];}
        $lob=$row['body'];
        if (!is_resource($lob)) {throw new RuntimeException('Нужен LOB-ресурс результата');}
        $size=value171(static function() use ($lob) {return cubrid_lob2_size($lob);});
        $size64=value171(static function() use ($lob) {return cubrid_lob2_size64($lob);});
        if (!is_int($size) || $size<0 || $size>1048576 || $size64!==(string)$size) {
            throw new RuntimeException('Этот учебный просмотр ограничен одним МиБ');
        }
        $data='';$remaining=$size;
        while ($remaining>0) {
            $amount=min(8192,$remaining);
            $part=value171(static function() use ($lob,$amount) {return cubrid_lob2_read($lob,$amount);});
            if (!is_string($part) || strlen($part)===0 || strlen($part)>$remaining) {throw new RuntimeException('Неполное чтение LOB');}
            $data.=$part;$remaining-=strlen($part);
        }
        return ['id'=>(int)$row['id'],'title'=>$row['title'],'sql_null'=>false,'bytes'=>$size,'bytes64'=>$size64,'data'=>$data];
    } finally {
        // Driver 11.2.0.0002 retains raw pointers in the request.
        // Consume first, release request, then drop every PHP reference.
        c171Release($request);
        $lob=null;$row=null;$fetched=null;
    }
}
function artifact171(string $name,string $data): void {
    if (basename($name)!==$name) {throw new InvalidArgumentException('Нужно простое имя файла');}
    if (file_put_contents(__DIR__.'/'.$name,$data)!==strlen($data)) {throw new RuntimeException('Файл результата не записан');}
}

    $name=c171OwnName($db,$owned,'TABLE','supplier_file');$t=c171Qualified($name);
    c171Ddl($db,'CREATE TABLE '.$t.' (id INT PRIMARY KEY,title VARCHAR(80),body BLOB)');c171Commit($db);
    $input=__DIR__.'/supplier-input.csv';
    if (!is_file($input)||!is_readable($input)||filesize($input)>1048576) {throw new RuntimeException('Нет допустимого входного CSV');}
    $source=file_get_contents($input);if (!is_string($source)) {throw new RuntimeException('Входной CSV не прочитан');}
    $lob=null;
    try {
        // Always a NEW empty LOB: import is not a truncate/replace operation.
        $lob=value171(static function() use ($db) {return cubrid_lob2_new($db,'BLOB');});
        $imported=value171(static function() use ($lob,$input) {return cubrid_lob2_import($lob,$input);});
        $size=value171(static function() use ($lob) {return cubrid_lob2_size($lob);});
        $position=value171(static function() use ($lob) {return cubrid_lob2_tell($lob);});
        $affected=saveLob171($db,$t,21,'Поставка CAB-7 / CLP-2',$lob,'BLOB');
    } finally {closeCreated171($lob);}
    c171Commit($db);$saved=savedLob171($db,$t,21);c171Commit($db);
    artifact171('supplier.csv',$saved['data']);
    $file=fopen(__DIR__.'/supplier.csv','rb');if ($file===false) {throw new RuntimeException('Копия CSV не открыта');}
    try {$header=fgetcsv($file);$products=[];while(($row=fgetcsv($file))!==false) {$products[]=$row;}} finally {fclose($file);}
    $rows=[['Поставка',$saved['title']],['Товарных строк',count($products)],['Первый товар',$products[0][1]],
        ['Байт в исходном файле',$size],['Позиция после import',$position],['Копия совпала',$saved['data']===$source],['Файл','supplier.csv']];
    $checks=['import_true'=>$imported===true,'one_row_saved'=>$affected===1,'created_resource_closed'=>$lob===null,
        'import_did_not_move_cursor'=>$position===0,'file_length'=>$size===strlen($source),
        'header_exact'=>$header===['sku','title','qty'],'two_products'=>count($products)===2,
        'values_exact'=>$products===[["CAB-7","Кабель O'Reilly","3"],["CLP-2","Хомут","0"]],
        'stored_exact'=>$saved['data']===$source,'artifact_exact'=>hash_file('sha256',__DIR__.'/supplier.csv')===hash('sha256',$source)];
    $observations=['products'=>$products,'header'=>$header,'sha256'=>hash('sha256',$saved['data']),
        'bytes'=>$size,'position_after_import'=>$position,'source_filename'=>'supplier-input.csv'];

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

c171Report('cub171-file-import','Архивировать исходный CSV поставщика и вернуть проверенную копию',$rows,$checks,$observations,$runtime,$owned,$removed);

Поставка — Поставка CAB-7 / CLP-2
Товарных строк — 2
Первый товар — Кабель O'Reilly
Байт в исходном файле — 63
Позиция после import — 0
Копия совпала — да
Файл — supplier.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=c171Config();$db=c171Connect();$runtime=c171Runtime($db);

function value171(callable $action) {
    $call=c171Capture($action);
    if ($call['value']===false || $call['value']===null || $call['warning']) {
        c171Failure('Действие с вложением не выполнено',$call);
    }
    return $call['value'];
}
function closeCreated171(&$lob): void {
    if (is_resource($lob)) {
        $call=c171Capture(static function() use ($lob) {return cubrid_lob2_close($lob);});
        $lob=null;
        if ($call['value']!==true || $call['warning']) {c171Failure('Созданный LOB не закрыт',$call);}
    } else {$lob=null;}
}
function saveLob171($db,string $table,int $id,string $title,$lob,string $type): int {
    $request=null;
    try {
        $request=value171(static function() use ($db,$table) {
            return cubrid_prepare($db,'INSERT INTO '.$table.' (id,title,body) VALUES (?,?,?)');
        });
        value171(static function() use ($request,$id) {return cubrid_bind($request,1,$id,'int');});
        value171(static function() use ($request,$title) {return cubrid_bind($request,2,$title,'string');});
        value171(static function() use ($request,$lob,$type) {return cubrid_lob2_bind($request,3,$lob,$type);});
        value171(static function() use ($request) {return cubrid_execute($request);});
        $affected=value171(static function() use ($request) {return cubrid_affected_rows($request);});
        if ($affected!==1) {throw new RuntimeException('Не сохранена одна строка вложения');}
        return $affected;
    } finally {c171Release($request);}
}
function savedLob171($db,string $table,int $id): array {
    $request=null;$row=null;$lob=null;$fetched=null;
    try {
        $request=c171Request($db,'SELECT id,title,body FROM '.$table.' WHERE id=?',[$id]);
        $fetched=c171Capture(static function() use ($request) {
            return cubrid_fetch_array($request,CUBRID_ASSOC|CUBRID_LOB);
        });
        if (!is_array($fetched['value']) || $fetched['warning']) {c171Failure('Вложение не найдено',$fetched);}
        $row=$fetched['value'];
        if ($row['body']===null) {return ['id'=>(int)$row['id'],'title'=>$row['title'],'sql_null'=>true,'bytes'=>null,'bytes64'=>null,'data'=>null];}
        $lob=$row['body'];
        if (!is_resource($lob)) {throw new RuntimeException('Нужен LOB-ресурс результата');}
        $size=value171(static function() use ($lob) {return cubrid_lob2_size($lob);});
        $size64=value171(static function() use ($lob) {return cubrid_lob2_size64($lob);});
        if (!is_int($size) || $size<0 || $size>1048576 || $size64!==(string)$size) {
            throw new RuntimeException('Этот учебный просмотр ограничен одним МиБ');
        }
        $data='';$remaining=$size;
        while ($remaining>0) {
            $amount=min(8192,$remaining);
            $part=value171(static function() use ($lob,$amount) {return cubrid_lob2_read($lob,$amount);});
            if (!is_string($part) || strlen($part)===0 || strlen($part)>$remaining) {throw new RuntimeException('Неполное чтение LOB');}
            $data.=$part;$remaining-=strlen($part);
        }
        return ['id'=>(int)$row['id'],'title'=>$row['title'],'sql_null'=>false,'bytes'=>$size,'bytes64'=>$size64,'data'=>$data];
    } finally {
        // Driver 11.2.0.0002 retains raw pointers in the request.
        // Consume first, release request, then drop every PHP reference.
        c171Release($request);
        $lob=null;$row=null;$fetched=null;
    }
}
function artifact171(string $name,string $data): void {
    if (basename($name)!==$name) {throw new InvalidArgumentException('Нужно простое имя файла');}
    if (file_put_contents(__DIR__.'/'.$name,$data)!==strlen($data)) {throw new RuntimeException('Файл результата не записан');}
}

    $name=c171OwnName($db,$owned,'TABLE','file_states');$t=c171Qualified($name);
    c171Ddl($db,'CREATE TABLE '.$t.' (id INT PRIMARY KEY,title VARCHAR(80),body BLOB NULL)');c171Commit($db);
    c171Command($db,'INSERT INTO '.$t.' (id,title,body) VALUES (?,?,NULL)',[10,'Нет документа']);
    foreach([[20,'Пустой шаблон',''],[30,'Готовая квитанция',"OK\n"]] as $input) {
        $lob=null;
        try {
            $lob=value171(static function() use ($db) {return cubrid_lob2_new($db,'BLOB');});
            if ($input[2]!=='') {
                $data=$input[2];value171(static function() use ($lob,$data) {return cubrid_lob2_write($lob,$data);});
            }
            saveLob171($db,$t,$input[0],$input[1],$lob,'BLOB');
        } finally {closeCreated171($lob);}
    }
    c171Commit($db);$states=[];$csv="id,status,bytes\n";
    foreach([10,20,30] as $id) {
        $saved=savedLob171($db,$t,$id);
        $status=$saved['sql_null']?'missing':($saved['bytes']===0?'empty':'ready');
        $states[]=['id'=>$id,'status'=>$status,'bytes'=>$saved['bytes'],'bytes64'=>$saved['bytes64'],
            'data_hex'=>$saved['data']===null?null:bin2hex($saved['data'])];
        $csv.=$id.','.$status.','.($saved['bytes']===null?'':(string)$saved['bytes'])."\n";
    }
    c171Commit($db);artifact171('attachment-states.csv',$csv);
    $rows=[['id=10','Файл не приложен (SQL NULL)'],['id=20','Пустой файл, 0 байт'],['id=30','Готовая квитанция, 3 байта'],
        ['Разных состояний',count(array_unique(array_column($states,'status')))],['Файл','attachment-states.csv']];
    $checks=['three_rows'=>count($states)===3,'null_distinct'=>$states[0]['bytes']===null&&$states[0]['bytes64']===null,
        'empty_distinct'=>$states[1]['bytes']===0&&$states[1]['bytes64']==='0'&&$states[1]['data_hex']==='',
        'data_exact'=>$states[2]['bytes']===3&&$states[2]['data_hex']==='4f4b0a',
        'three_states'=>array_column($states,'status')===['missing','empty','ready'],
        'resource_closed'=>$lob===null,'artifact_rows'=>substr_count($csv,"\n")===4,
        'artifact_written'=>file_get_contents(__DIR__.'/attachment-states.csv')===$csv];
    $observations=['states'=>$states,'policy'=>['missing'=>'Запросить файл','empty'=>'Уточнить пустой шаблон','ready'=>'Разрешить просмотр после проверки прав']];

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

c171Report('cub171-attachment-states','Различить отсутствующий файл, пустой BLOB и готовое вложение',$rows,$checks,$observations,$runtime,$owned,$removed);

id=10 — Файл не приложен (SQL NULL)
id=20 — Пустой файл, 0 байт
id=30 — Готовая квитанция, 3 байта
Разных состояний — 3
Файл — attachment-states.csv

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