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

function checked172(callable $action) {
    $call=c172Capture($action);
    if ($call['value']===false || $call['value']===null || $call['warning']) {c172Failure('Действие с вложением не выполнено',$call);}
    return $call['value'];
}
function fixture172($db,array &$owned,string $label,string $type,string $payload): string {
    if (!in_array($type,['BLOB','CLOB'],true)) {throw new InvalidArgumentException('Неизвестный тип вложения');}
    $name=c172OwnName($db,$owned,'TABLE',$label);$table=c172Qualified($name);
    c172Ddl($db,'CREATE TABLE '.$table.' (id INT PRIMARY KEY,title VARCHAR(80),body '.$type.')');c172Commit($db);
    // LOB2 creates our synthetic fixture. Reading below uses the actual legacy API.
    $lob=null;$request=null;
    try {
        $lob=checked172(static function() use ($db,$type) {return cubrid_lob2_new($db,$type);});
        checked172(static function() use ($lob,$payload) {return cubrid_lob2_write($lob,$payload);});
        $request=checked172(static function() use ($db,$table) {return cubrid_prepare($db,'INSERT INTO '.$table.' (id,title,body) VALUES (42,?,?)');});
        checked172(static function() use ($request) {return cubrid_bind($request,1,'Документ поставки 42','string');});
        checked172(static function() use ($request,$lob,$type) {return cubrid_lob2_bind($request,2,$lob,$type);});
        checked172(static function() use ($request) {return cubrid_execute($request);});
        if (cubrid_affected_rows($request)!==1) {throw new RuntimeException('Не создана строка документа');}
    } finally {
        c172Release($request);
        if (is_resource($lob)) {checked172(static function() use ($lob) {return cubrid_lob2_close($lob);});$lob=null;}
    }
    c172Commit($db);return $table;
}
function legacyGet172($db,string $table): array {
    // The table name comes only from our registry; id42 is a fixed lesson value.
    $lobs=checked172(static function() use ($db,$table) {return cubrid_lob_get($db,'SELECT body FROM '.$table.' WHERE id=42');});
    if (!is_array($lobs) || count($lobs)!==1 || !is_resource($lobs[0])) {throw new RuntimeException('Нужен ровно один legacy LOB');}
    return $lobs;
}
function legacySize172($lob): string {
    $size=checked172(static function() use ($lob) {return cubrid_lob_size($lob);});
    if (!is_string($size) || !preg_match('/^(0|[1-9][0-9]*)$/D',$size) || strlen($size)>7 || (int)$size>1048576) {
        throw new RuntimeException('Просмотр ограничен одним МиБ, размер должен быть десятичной строкой');
    }
    return $size;
}
function legacyClose172(&$lobs): void {
    if (is_array($lobs)) {
        $call=c172Capture(static function() use ($lobs) {return cubrid_lob_close($lobs);});
        $lobs=null;
        if ($call['value']!==true || $call['warning']) {c172Failure('Legacy LOB не освобождены',$call);}
    }
}
function writeArtifact172(string $name,string $data): void {
    if (basename($name)!==$name || file_put_contents(__DIR__.'/'.$name,$data)!==strlen($data)) {throw new RuntimeException('Файл результата не записан');}
}

    $payload="CAL172\0".pack('v*',250,500,0)."\n";
    $table=fixture172($db,$owned,'report','BLOB',$payload);
    $lobs=null;
    try {
        $lobs=legacyGet172($db,$table);$size=legacySize172($lobs[0]);
        $exported=checked172(static function() use ($db,$lobs) {return cubrid_lob_export($db,$lobs[0],__DIR__.'/report-source.bin');});
        $actual=file_get_contents(__DIR__.'/report-source.bin');
        if (!is_string($actual) || strlen($actual)!==(int)$size) {throw new RuntimeException('Не получены все байты документа');}
        $decoded=unpack('vfirst/vsecond/vthird',substr($actual,7,6));
        $samples=implode('; ',array_values($decoded));$digest=hash('sha256',$actual);
    } finally {legacyClose172($lobs);}
    c172Commit($db);
    $csv="id,filename,bytes,sha256\n42,calibration.bin,".$size.','.$digest."\n";
    writeArtifact172('attachment-report.csv',$csv);
    $rows=[['Документ',42],['Имя','calibration.bin'],['Размер, байт',(int)$size],['Отсчёты',$samples]];
    $checks=['one_selected_document'=>true,'size_is_decimal_string'=>is_string($size),
        'reported_size_matches'=>strlen($actual)===(int)$size,'header_preserved'=>substr($actual,0,7)==="CAL172\0",
        'payload_exact'=>$actual===$payload,'samples_decoded'=>$samples==='250; 500; 0',
        'csv_written'=>file_get_contents(__DIR__.'/attachment-report.csv')===$csv,'legacy_closed'=>$lobs===null];
    $observations=['api'=>'legacy cubrid_lob_*','size'=>$size,'size_type'=>gettype($size),
        'header_hex'=>bin2hex(substr($actual,0,7)),'samples'=>$decoded,'sha256'=>$digest,'exported'=>$exported];

} finally {

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

c172Report('cub172-attachment-report','Получить паспорт выбранного вложения для оператора',$rows,$checks,$observations,$runtime,$owned,$removed);

Документ — 42
Имя — calibration.bin
Размер, байт — 14
Отсчёты — 250; 500; 0

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

function checked172(callable $action) {
    $call=c172Capture($action);
    if ($call['value']===false || $call['value']===null || $call['warning']) {c172Failure('Действие с вложением не выполнено',$call);}
    return $call['value'];
}
function fixture172($db,array &$owned,string $label,string $type,string $payload): string {
    if (!in_array($type,['BLOB','CLOB'],true)) {throw new InvalidArgumentException('Неизвестный тип вложения');}
    $name=c172OwnName($db,$owned,'TABLE',$label);$table=c172Qualified($name);
    c172Ddl($db,'CREATE TABLE '.$table.' (id INT PRIMARY KEY,title VARCHAR(80),body '.$type.')');c172Commit($db);
    // LOB2 creates our synthetic fixture. Reading below uses the actual legacy API.
    $lob=null;$request=null;
    try {
        $lob=checked172(static function() use ($db,$type) {return cubrid_lob2_new($db,$type);});
        checked172(static function() use ($lob,$payload) {return cubrid_lob2_write($lob,$payload);});
        $request=checked172(static function() use ($db,$table) {return cubrid_prepare($db,'INSERT INTO '.$table.' (id,title,body) VALUES (42,?,?)');});
        checked172(static function() use ($request) {return cubrid_bind($request,1,'Документ поставки 42','string');});
        checked172(static function() use ($request,$lob,$type) {return cubrid_lob2_bind($request,2,$lob,$type);});
        checked172(static function() use ($request) {return cubrid_execute($request);});
        if (cubrid_affected_rows($request)!==1) {throw new RuntimeException('Не создана строка документа');}
    } finally {
        c172Release($request);
        if (is_resource($lob)) {checked172(static function() use ($lob) {return cubrid_lob2_close($lob);});$lob=null;}
    }
    c172Commit($db);return $table;
}
function legacyGet172($db,string $table): array {
    // The table name comes only from our registry; id42 is a fixed lesson value.
    $lobs=checked172(static function() use ($db,$table) {return cubrid_lob_get($db,'SELECT body FROM '.$table.' WHERE id=42');});
    if (!is_array($lobs) || count($lobs)!==1 || !is_resource($lobs[0])) {throw new RuntimeException('Нужен ровно один legacy LOB');}
    return $lobs;
}
function legacySize172($lob): string {
    $size=checked172(static function() use ($lob) {return cubrid_lob_size($lob);});
    if (!is_string($size) || !preg_match('/^(0|[1-9][0-9]*)$/D',$size) || strlen($size)>7 || (int)$size>1048576) {
        throw new RuntimeException('Просмотр ограничен одним МиБ, размер должен быть десятичной строкой');
    }
    return $size;
}
function legacyClose172(&$lobs): void {
    if (is_array($lobs)) {
        $call=c172Capture(static function() use ($lobs) {return cubrid_lob_close($lobs);});
        $lobs=null;
        if ($call['value']!==true || $call['warning']) {c172Failure('Legacy LOB не освобождены',$call);}
    }
}
function writeArtifact172(string $name,string $data): void {
    if (basename($name)!==$name || file_put_contents(__DIR__.'/'.$name,$data)!==strlen($data)) {throw new RuntimeException('Файл результата не записан');}
}

    $payload="BATCH172\n".str_repeat("\x00\x7f\x80\xff",4096)."\nEND\n";
    $table=fixture172($db,$owned,'export_file','BLOB',$payload);
    $path=__DIR__.'/exported-attachment.bin';writeArtifact172('exported-attachment.bin',"OLD COPY\n");
    $before=hash_file('sha256',$path);$lobs=null;
    try {
        $lobs=legacyGet172($db,$table);$size=legacySize172($lobs[0]);
        $ok=checked172(static function() use ($db,$lobs,$path) {return cubrid_lob_export($db,$lobs[0],$path);});
    } finally {legacyClose172($lobs);}
    c172Commit($db);clearstatcache(true,$path);
    $bytes=filesize($path);$digest=hash_file('sha256',$path);
    $file=fopen($path,'rb');if (!is_resource($file)) {throw new RuntimeException('Нет выгруженного файла');}
    try {$prefix=fread($file,13);fseek($file,-5,SEEK_END);$ending=fread($file,5);} finally {fclose($file);}
    $rows=[['Файл','exported-attachment.bin'],['Размер, байт',$bytes],['Прежняя копия заменена',$before!==$digest],['Побайтная проверка',$digest===hash('sha256',$payload)]];
    $checks=['export_succeeded'=>$ok===true,'file_size_matches'=>$bytes===strlen($payload)&&$size===(string)$bytes,
        'old_copy_replaced'=>$before!==$digest,'full_hash_matches'=>$digest===hash('sha256',$payload),
        'binary_prefix_preserved'=>$prefix==="BATCH172\n\x00\x7f\x80\xff",'ending_preserved'=>$ending==="\nEND\n",'legacy_closed'=>$lobs===null];
    $observations=['legacy_export'=>true,'existing_destination'=>true,'before_sha256'=>$before,'after_sha256'=>$digest,
        'prefix_hex'=>bin2hex($prefix),'ending_hex'=>bin2hex($ending),'bytes'=>$bytes];

} finally {

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

c172Report('cub172-file-export','Обновить локальную копию файла поставки и проверить её целиком',$rows,$checks,$observations,$runtime,$owned,$removed);

Файл — exported-attachment.bin
Размер, байт — 16398
Прежняя копия заменена — да
Побайтная проверка — да

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

function checked172(callable $action) {
    $call=c172Capture($action);
    if ($call['value']===false || $call['value']===null || $call['warning']) {c172Failure('Действие с вложением не выполнено',$call);}
    return $call['value'];
}
function fixture172($db,array &$owned,string $label,string $type,string $payload): string {
    if (!in_array($type,['BLOB','CLOB'],true)) {throw new InvalidArgumentException('Неизвестный тип вложения');}
    $name=c172OwnName($db,$owned,'TABLE',$label);$table=c172Qualified($name);
    c172Ddl($db,'CREATE TABLE '.$table.' (id INT PRIMARY KEY,title VARCHAR(80),body '.$type.')');c172Commit($db);
    // LOB2 creates our synthetic fixture. Reading below uses the actual legacy API.
    $lob=null;$request=null;
    try {
        $lob=checked172(static function() use ($db,$type) {return cubrid_lob2_new($db,$type);});
        checked172(static function() use ($lob,$payload) {return cubrid_lob2_write($lob,$payload);});
        $request=checked172(static function() use ($db,$table) {return cubrid_prepare($db,'INSERT INTO '.$table.' (id,title,body) VALUES (42,?,?)');});
        checked172(static function() use ($request) {return cubrid_bind($request,1,'Документ поставки 42','string');});
        checked172(static function() use ($request,$lob,$type) {return cubrid_lob2_bind($request,2,$lob,$type);});
        checked172(static function() use ($request) {return cubrid_execute($request);});
        if (cubrid_affected_rows($request)!==1) {throw new RuntimeException('Не создана строка документа');}
    } finally {
        c172Release($request);
        if (is_resource($lob)) {checked172(static function() use ($lob) {return cubrid_lob2_close($lob);});$lob=null;}
    }
    c172Commit($db);return $table;
}
function legacyGet172($db,string $table): array {
    // The table name comes only from our registry; id42 is a fixed lesson value.
    $lobs=checked172(static function() use ($db,$table) {return cubrid_lob_get($db,'SELECT body FROM '.$table.' WHERE id=42');});
    if (!is_array($lobs) || count($lobs)!==1 || !is_resource($lobs[0])) {throw new RuntimeException('Нужен ровно один legacy LOB');}
    return $lobs;
}
function legacySize172($lob): string {
    $size=checked172(static function() use ($lob) {return cubrid_lob_size($lob);});
    if (!is_string($size) || !preg_match('/^(0|[1-9][0-9]*)$/D',$size) || strlen($size)>7 || (int)$size>1048576) {
        throw new RuntimeException('Просмотр ограничен одним МиБ, размер должен быть десятичной строкой');
    }
    return $size;
}
function legacyClose172(&$lobs): void {
    if (is_array($lobs)) {
        $call=c172Capture(static function() use ($lobs) {return cubrid_lob_close($lobs);});
        $lobs=null;
        if ($call['value']!==true || $call['warning']) {c172Failure('Legacy LOB не освобождены',$call);}
    }
}
function writeArtifact172(string $name,string $data): void {
    if (basename($name)!==$name || file_put_contents(__DIR__.'/'.$name,$data)!==strlen($data)) {throw new RuntimeException('Файл результата не записан');}
}

    $payload="Инструкция №42\n1. Проверить O'Reilly.\n2. Сохранить акт ✓.\n";
    $table=fixture172($db,$owned,'text_extract','CLOB',$payload);$lobs=null;
    try {
        $lobs=legacyGet172($db,$table);$size=legacySize172($lobs[0]);
        ob_start();
        try {$call=c172Capture(static function() use ($db,$lobs) {return cubrid_lob_send($db,$lobs[0]);});$received=ob_get_contents();}
        finally {ob_end_clean();}
        if ($call['value']!==true || $call['warning'] || !is_string($received)) {c172Failure('Текст не передан в output',$call);}
    } finally {legacyClose172($lobs);}
    c172Commit($db);writeArtifact172('extracted-instruction.txt',$received);
    $lines=explode("\n",rtrim($received,"\n"));
    $rows=[['Заголовок',$lines[0]],['Первый шаг',$lines[1]],['Второй шаг',$lines[2]],['Размер UTF-8, байт',strlen($received)]];
    $checks=['send_returned_true'=>$call['value']===true,'text_exact'=>$received===$payload,'byte_size_matches'=>$size===(string)strlen($received),
        'three_lines'=>count($lines)===3,'utf8_valid'=>preg_match('//u',$received)===1,'apostrophe_preserved'=>strpos($received,"O'Reilly")!==false,
        'file_exact'=>file_get_contents(__DIR__.'/extracted-instruction.txt')===$payload,'legacy_closed'=>$lobs===null];
    $observations=['transport'=>'captured PHP output in CLI, not HTTP','return_type'=>gettype($call['value']),
        'size'=>$size,'utf8_lines'=>$lines,'sha256'=>hash('sha256',$received),'captured_bytes'=>strlen($received)];

} finally {

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

c172Report('cub172-text-extraction','Получить UTF-8-инструкцию из прежнего CLOB без лишнего вывода',$rows,$checks,$observations,$runtime,$owned,$removed);

Заголовок — Инструкция №42
Первый шаг — 1. Проверить O'Reilly.
Второй шаг — 2. Сохранить акт ✓.
Размер UTF-8, байт — 93

Распакуйте весь 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=[];
require __DIR__.'/http-lab.php';
startHttp172();
try {
    $config=c172Config();$db=c172Connect();$runtime=c172Runtime($db);

function checked172(callable $action) {
    $call=c172Capture($action);
    if ($call['value']===false || $call['value']===null || $call['warning']) {c172Failure('Действие с вложением не выполнено',$call);}
    return $call['value'];
}
function fixture172($db,array &$owned,string $label,string $type,string $payload): string {
    if (!in_array($type,['BLOB','CLOB'],true)) {throw new InvalidArgumentException('Неизвестный тип вложения');}
    $name=c172OwnName($db,$owned,'TABLE',$label);$table=c172Qualified($name);
    c172Ddl($db,'CREATE TABLE '.$table.' (id INT PRIMARY KEY,title VARCHAR(80),body '.$type.')');c172Commit($db);
    // LOB2 creates our synthetic fixture. Reading below uses the actual legacy API.
    $lob=null;$request=null;
    try {
        $lob=checked172(static function() use ($db,$type) {return cubrid_lob2_new($db,$type);});
        checked172(static function() use ($lob,$payload) {return cubrid_lob2_write($lob,$payload);});
        $request=checked172(static function() use ($db,$table) {return cubrid_prepare($db,'INSERT INTO '.$table.' (id,title,body) VALUES (42,?,?)');});
        checked172(static function() use ($request) {return cubrid_bind($request,1,'Документ поставки 42','string');});
        checked172(static function() use ($request,$lob,$type) {return cubrid_lob2_bind($request,2,$lob,$type);});
        checked172(static function() use ($request) {return cubrid_execute($request);});
        if (cubrid_affected_rows($request)!==1) {throw new RuntimeException('Не создана строка документа');}
    } finally {
        c172Release($request);
        if (is_resource($lob)) {checked172(static function() use ($lob) {return cubrid_lob2_close($lob);});$lob=null;}
    }
    c172Commit($db);return $table;
}
function legacyGet172($db,string $table): array {
    // The table name comes only from our registry; id42 is a fixed lesson value.
    $lobs=checked172(static function() use ($db,$table) {return cubrid_lob_get($db,'SELECT body FROM '.$table.' WHERE id=42');});
    if (!is_array($lobs) || count($lobs)!==1 || !is_resource($lobs[0])) {throw new RuntimeException('Нужен ровно один legacy LOB');}
    return $lobs;
}
function legacySize172($lob): string {
    $size=checked172(static function() use ($lob) {return cubrid_lob_size($lob);});
    if (!is_string($size) || !preg_match('/^(0|[1-9][0-9]*)$/D',$size) || strlen($size)>7 || (int)$size>1048576) {
        throw new RuntimeException('Просмотр ограничен одним МиБ, размер должен быть десятичной строкой');
    }
    return $size;
}
function legacyClose172(&$lobs): void {
    if (is_array($lobs)) {
        $call=c172Capture(static function() use ($lobs) {return cubrid_lob_close($lobs);});
        $lobs=null;
        if ($call['value']!==true || $call['warning']) {c172Failure('Legacy LOB не освобождены',$call);}
    }
}
function writeArtifact172(string $name,string $data): void {
    if (basename($name)!==$name || file_put_contents(__DIR__.'/'.$name,$data)!==strlen($data)) {throw new RuntimeException('Файл результата не записан');}
}

    $payload="CHECK172\0\x01\x02\x03\xff\n";
    $table=fixture172($db,$owned,'download','BLOB',$payload);$lobs=null;
    try {
        $lobs=legacyGet172($db,$table);$size=legacySize172($lobs[0]);
        checked172(static function() use ($db,$lobs) {return cubrid_lob_export($db,$lobs[0],__DIR__.'/download-source.bin');});
    } finally {legacyClose172($lobs);}
    c172Commit($db);
    $actual=hash_file('sha256',__DIR__.'/download-source.bin');
    if ($actual!==hash('sha256',$payload)) {throw new RuntimeException('Файл для выдачи не совпал с документом');}
    saveHttpProof172('download-handoff.json',['record_id'=>42,'file'=>'download-source.bin','bytes'=>(int)$size,'sha256'=>$actual]);
    $allowed=getHttp172(42,1);$denied=getHttp172(99,2);$worker=stopHttp172();
    writeArtifact172('download-response.bin',$allowed['body']);
    $headers=$allowed['proof']['headers'];
    $rows=[['Разрешённый документ: HTTP',$allowed['proof']['status']],['Получено байт',strlen($allowed['body'])],
        ['Другой ID: HTTP',$denied['proof']['status']],['HTTP-worker остановлен',$worker['stopped']]];
    $checks=['allowed_200'=>$allowed['proof']['status']===200,'body_exact'=>$allowed['body']===$payload,
        'length_header_exact'=>($headers['content-length']??null)===(string)strlen($payload),
        'binary_content_type'=>($headers['content-type']??null)==='application/octet-stream',
        'attachment_name'=>($headers['content-disposition']??null)==='attachment; filename="calibration-42.bin"',
        'nosniff'=>($headers['x-content-type-options']??null)==='nosniff','other_id_denied'=>$denied['proof']['status']===403&&$denied['body']==="denied\n",
        'two_http_requests'=>$worker['http_requests']===2,'worker_stopped'=>$worker['stopped']&&!$worker['final_running']&&!$worker['forced_stop'],
        'saved_response_exact'=>file_get_contents(__DIR__.'/download-response.bin')===$payload,'legacy_closed'=>$lobs===null];
    $observations=['delivery'=>'legacy export to file, then core PHP HTTP file delivery',
        'http'=>['responses'=>[$allowed['proof'],$denied['proof']],'worker_stopped'=>$worker['stopped'],'http_requests'=>$worker['http_requests']],
        'body_sha256'=>hash('sha256',$allowed['body']),'body_hex'=>bin2hex($allowed['body'])];

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

c172Report('cub172-download-response','Выдать выбранное вложение реальным HTTP-ответом и отказать чужому ID',$rows,$checks,$observations,$runtime,$owned,$removed);

Разрешённый документ: HTTP — 200
Получено байт — 14
Другой ID: HTTP — 403
HTTP-worker остановлен — да

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