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

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

    // The preceding writing chapter explains fixture creation; the lesson below teaches reading.
    function f162FixtureBlob($db,array $pieces): string {
        $handle=fbird_blob_create($db);
        if ($handle===false) {f162Failure('Учебный BLOB не создан');}
        try {
            foreach($pieces as $piece) {
                $call=f162Capture(static fn()=>fbird_blob_add($handle,$piece));
                if($call['value']===false || $call['warning'])f162Failure('Учебные байты не записаны',$call);
            }
            $id=fbird_blob_close($handle);
            if(!is_string($id))f162Failure('Запись BLOB не закрыта');
            $handle=null;return $id;
        }finally{if(is_resource($handle)){fbird_blob_cancel($handle);$handle=null;}}
    }

    $name=f162OwnTable($db,$owned,'listing','(ID INTEGER NOT NULL PRIMARY KEY, FILE_NAME VARCHAR(40) NOT NULL, FILE_DATA BLOB SUB_TYPE BINARY)');
    $q=f162Qualified($name);
    $receipt=f162FixtureBlob($db,["Заказ 42: принят\n"]);
    $empty=f162FixtureBlob($db,[]);
    $binary=f162FixtureBlob($db,[str_repeat("\x00\xFF",64)]);
    foreach([[1,'receipt-42.txt',$receipt],[2,'draft.txt',$empty],[3,'pending.pdf',null],[4,'report.bin',$binary]] as $entry) {
        f162Command($db,"INSERT INTO $q (ID,FILE_NAME,FILE_DATA) VALUES (?,?,?)",$entry);
    }
    f162Commit($db);
    $records=f162Read($db,"SELECT ID,FILE_NAME,FILE_DATA FROM $q ORDER BY ID");
    $listing=[];$total=0;$downloadable=0;$infoCalls=0;$keysAgree=true;
    foreach($records as $record) {
        if($record['FILE_DATA']===null) {
            $listing[]=['name'=>$record['FILE_NAME'],'bytes'=>null,'action'=>'Файл ещё не приложен'];
            continue;
        }
        $info=fbird_blob_info($db,$record['FILE_DATA']);++$infoCalls;
        if($info===false)f162Failure('Метаданные вложения не прочитаны');
        $keysAgree=$keysAgree && $info[0]===$info['length'] && $info[1]===$info['numseg']
            && $info[2]===$info['maxseg'] && $info[3]===$info['stream'] && $info[4]===$info['isnull'];
        if($info['isnull'])throw new RuntimeException('Ожидался сохранённый BLOB');
        $listing[]=['name'=>$record['FILE_NAME'],'bytes'=>$info['length'],'action'=>$info['length']===0?'Скачать пустой файл':'Скачать'];
        $total+=$info['length'];++$downloadable;
    }
    $expected=[['name'=>'receipt-42.txt','bytes'=>28,'action'=>'Скачать'],['name'=>'draft.txt','bytes'=>0,'action'=>'Скачать пустой файл'],
        ['name'=>'pending.pdf','bytes'=>null,'action'=>'Файл ещё не приложен'],['name'=>'report.bin','bytes'=>128,'action'=>'Скачать']];
    $rows=[];
    foreach($listing as $item)$rows[]=[$item['name'],($item['bytes']===null?'нет BLOB':$item['bytes'].' байт').'; '.$item['action']];
    $rows[]=['Доступных вложений',$downloadable];$rows[]=['Общий размер, байт',$total];
    $rows[]=['Вызовов чтения тела при построении списка',0];
    $checks=['visible_listing'=>$listing===$expected,'null_not_empty'=>$listing[1]['bytes']===0&&$listing[2]['bytes']===null,
        'three_existing_blobs'=>$infoCalls===3&&$downloadable===3,'aggregate_size'=>$total===156,
        'metadata_alias_keys'=>$keysAgree,'blob_identifier_not_body'=>is_string($records[0]['FILE_DATA'])&&$records[0]['FILE_DATA']!=="Заказ 42: принят\n"];
    $observations=['listing'=>$listing,'existing_blobs'=>$downloadable,'total_bytes'=>$total,'metadata_calls'=>$infoCalls,
        'body_read_calls_during_listing'=>0,'raw_blob_ids_published'=>false,'counting_scope'=>'This count excludes preparation writes and concerns only the listing loop.'];

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

f162Report('fb162-attachment-list','Составить список вложений: имя, размер и доступное действие',$rows,$checks,$observations,$runtime,$owned,$removed);

receipt-42.txt — 28 байт; Скачать
draft.txt — 0 байт; Скачать пустой файл
pending.pdf — нет BLOB; Файл ещё не приложен
report.bin — 128 байт; Скачать
Доступных вложений — 3
Общий размер, байт — 156
Вызовов чтения тела при построении списка — 0

Распакуйте все файлы и запустите example.php по README.txt. Исходник ниже включает подготовку искусственного содержимого, чтение, проверки и finally. lab.php ограничивает работу отдельной базой и собственной FB162-таблицей. result.html показывает фактические строки, result.json хранит наблюдения, metrics.json — проверки и очистку. Все открытые чтения завершаются до удаления таблицы. Для HTTP-проекта README дополнительно описывает единственный временный локальный PHP-сервер; он запускается и останавливается автоматически.

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

    // The preceding writing chapter explains fixture creation; the lesson below teaches reading.
    function f162FixtureBlob($db,array $pieces): string {
        $handle=fbird_blob_create($db);
        if ($handle===false) {f162Failure('Учебный BLOB не создан');}
        try {
            foreach($pieces as $piece) {
                $call=f162Capture(static fn()=>fbird_blob_add($handle,$piece));
                if($call['value']===false || $call['warning'])f162Failure('Учебные байты не записаны',$call);
            }
            $id=fbird_blob_close($handle);
            if(!is_string($id))f162Failure('Запись BLOB не закрыта');
            $handle=null;return $id;
        }finally{if(is_resource($handle)){fbird_blob_cancel($handle);$handle=null;}}
    }

    $name=f162OwnTable($db,$owned,'preview','(ID INTEGER NOT NULL PRIMARY KEY, NOTE_TEXT BLOB SUB_TYPE TEXT CHARACTER SET UTF8)');
    $q=f162Qualified($name);
    $expected="Заказ #42\nПроверить <кабель> & разъём.\n";
    $smallId=f162FixtureBlob($db,[$expected]);
    $largeId=f162FixtureBlob($db,[str_repeat('Подробности заказа. ',20)]);
    f162Command($db,"INSERT INTO $q (ID,NOTE_TEXT) VALUES (?,?)",[42,$smallId]);
    f162Command($db,"INSERT INTO $q (ID,NOTE_TEXT) VALUES (?,?)",[43,$largeId]);f162Commit($db);
    $records=f162Read($db,"SELECT ID,NOTE_TEXT FROM $q ORDER BY ID");
    $limit=96;$chunkBytes=7;$previews=[];$opened=0;$chunks=0;$largeSkipped=false;
    foreach($records as $record) {
        if($record['NOTE_TEXT']===null)throw new RuntimeException('В учебной заявке ожидается заметка');
        $info=fbird_blob_info($db,$record['NOTE_TEXT']);
        if($info===false)f162Failure('Размер заметки неизвестен');
        if($info['length']>$limit) {
            $previews[]=['id'=>$record['ID'],'mode'=>'Отдельное скачивание','text'=>null];$largeSkipped=true;continue;
        }
        $handle=fbird_blob_open($db,$record['NOTE_TEXT']);
        if($handle===false)f162Failure('Заметка не открыта');
        ++$opened;$value='';
        try {
            while(true) {
                $part=fbird_blob_get($handle,$chunkBytes);
                if($part===false)f162Failure('Порция заметки не прочитана');
                if($part==='')break;
                if(strlen($value)+strlen($part)>$limit)throw new RuntimeException('Превышен лимит собранного текста');
                $value.=$part;++$chunks;
            }
        }finally{if(fbird_blob_close($handle)===false)f162Failure('Чтение не закрыто');$handle=null;}
        if(preg_match('//u',$value)!==1)throw new RuntimeException('Заметка не является корректным UTF-8');
        $previews[]=['id'=>$record['ID'],'mode'=>'Предпросмотр','text'=>$value];
    }
    $note=$previews[0]['text'];$escaped=htmlspecialchars($note,ENT_QUOTES|ENT_SUBSTITUTE,'UTF-8');
    $rows=[['Режим заявки 42',$previews[0]['mode']],['Текст заявки 42',$note],['Текст для HTML',$escaped],
        ['Прочитано байт',strlen($note)],['Предел предпросмотра, байт',$limit],['Запрошено байт за один шаг',$chunkBytes],
        ['Непустых порций',$chunks],['Режим заявки 43',$previews[1]['mode']],['BLOB большой заметки открывался для чтения',false]];
    $checks=['small_exact_text'=>$note===$expected,'small_bytes'=>strlen($note)===65,'bounded_memory_policy'=>strlen($note)<=$limit,
        'chunked_alias_read'=>$chunks===10,'large_not_opened'=>$largeSkipped&&$opened===1&&$previews[1]['text']===null,
        'utf8_reassembled'=>preg_match('//u',$note)===1,'escaped_only_after_reassembly'=>str_contains($escaped,'&lt;кабель&gt; &amp; разъём.'),
        'reader_released'=>$handle===null];
    $observations=['previews'=>$previews,'text_bytes'=>strlen($note),'limit_bytes'=>$limit,'chunk_bytes'=>$chunkBytes,'nonempty_chunks'=>$chunks,
        'opened_blob_count'=>$opened,'large_blob_body_read'=>false,'html_text'=>$escaped,'encoding'=>'UTF8','eof_value'=>''];

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

f162Report('fb162-bounded-text','Показать маленькую заметку целиком, а большой текст направить в скачивание',$rows,$checks,$observations,$runtime,$owned,$removed);

Режим заявки 42 — Предпросмотр
Текст заявки 42 — Заказ #42
Проверить <кабель> & разъём.

Текст для HTML — Заказ #42
Проверить &lt;кабель&gt; &amp; разъём.

Прочитано байт — 65
Предел предпросмотра, байт — 96
Запрошено байт за один шаг — 7
Непустых порций — 10
Режим заявки 43 — Отдельное скачивание
BLOB большой заметки открывался для чтения — нет

Распакуйте все файлы и запустите example.php по README.txt. Исходник ниже включает подготовку искусственного содержимого, чтение, проверки и finally. lab.php ограничивает работу отдельной базой и собственной FB162-таблицей. result.html показывает фактические строки, result.json хранит наблюдения, metrics.json — проверки и очистку. Все открытые чтения завершаются до удаления таблицы. Для HTTP-проекта README дополнительно описывает единственный временный локальный PHP-сервер; он запускается и останавливается автоматически.

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

    // The preceding writing chapter explains fixture creation; the lesson below teaches reading.
    function f162FixtureBlob($db,array $pieces): string {
        $handle=fbird_blob_create($db);
        if ($handle===false) {f162Failure('Учебный BLOB не создан');}
        try {
            foreach($pieces as $piece) {
                $call=f162Capture(static fn()=>fbird_blob_add($handle,$piece));
                if($call['value']===false || $call['warning'])f162Failure('Учебные байты не записаны',$call);
            }
            $id=fbird_blob_close($handle);
            if(!is_string($id))f162Failure('Запись BLOB не закрыта');
            $handle=null;return $id;
        }finally{if(is_resource($handle)){fbird_blob_cancel($handle);$handle=null;}}
    }

    $name=f162OwnTable($db,$owned,'csv_export','(ID INTEGER NOT NULL PRIMARY KEY, FILE_DATA BLOB SUB_TYPE BINARY)');
    $q=f162Qualified($name);
    $expected="sku;title;qty\r\nCAB-01;\"Кабель; 2 м\";3\r\nCLP-02;Хомут;0\r\n";
    $expectedHash=hash('sha256',$expected);
    $blobId=f162FixtureBlob($db,str_split($expected,11));
    f162Command($db,"INSERT INTO $q (ID,FILE_DATA) VALUES (?,?)",[1,$blobId]);f162Commit($db);
    $record=f162Read($db,"SELECT FILE_DATA FROM $q WHERE ID=?",[1])[0];
    $info=fbird_blob_info($db,$record['FILE_DATA']);if($info===false)f162Failure('Размер CSV неизвестен');
    if($info['length']>1048576)throw new RuntimeException('Учебный CSV слишком велик');
    $handle=fbird_blob_open($db,$record['FILE_DATA']);if($handle===false)f162Failure('CSV не открыт');
    $path=__DIR__.'/export.csv';$out=null;$written=0;$chunks=0;$complete=false;
    try {
        $out=fopen($path,'wb');if($out===false)throw new RuntimeException('Файл CSV не создан');
        while(true) {
            $part=fbird_blob_get($handle,13);
            if($part===false)f162Failure('Порция CSV не прочитана');
            if($part==='')break;
            ++$chunks;$offset=0;$length=strlen($part);
            if($written+$length>1048576)throw new RuntimeException('Превышен предел выгрузки');
            while($offset<$length) {
                $n=fwrite($out,substr($part,$offset));
                if($n===false||$n===0)throw new RuntimeException('CSV записан не полностью');
                $offset+=$n;$written+=$n;
            }
        }
        $complete=$written===$info['length'];
        if(!$complete)throw new RuntimeException('Число выгруженных байт не совпало');
    }finally{
        if(is_resource($out)){fclose($out);$out=null;}
        if(fbird_blob_close($handle)===false)f162Failure('Ресурс CSV не закрыт');$handle=null;
        if(!$complete&&is_file($path))unlink($path);
    }
    $actualHash=hash_file('sha256',$path);
    if($actualHash!==$expectedHash){unlink($path);throw new RuntimeException('Контрольная сумма CSV не совпала');}
    $input=fopen($path,'rb');if($input===false)throw new RuntimeException('Выгрузка не открыта для разбора');
    $parsed=[];
    try{while(($row=fgetcsv($input,0,';','"',''))!==false)$parsed[]=$row;}
    finally{fclose($input);$input=null;}
    $expectedRows=[['sku','title','qty'],['CAB-01','Кабель; 2 м','3'],['CLP-02','Хомут','0']];
    $rows=[['Файл','export.csv'],['Заголовок',implode(' | ',$parsed[0])],['Товар 1',implode(' | ',$parsed[1])],
        ['Товар 2',implode(' | ',$parsed[2])],['Байт в выгрузке',$written],['Непустых порций',$chunks],
        ['SHA256 файла',$actualHash],['Кавычки сохранили точку с запятой внутри названия',$parsed[1][1]==='Кабель; 2 м']];
    $checks=['exact_export_hash'=>$actualHash===$expectedHash,'export_size'=>$written===67,
        'multiple_bounded_chunks'=>$chunks===6,'csv_rows'=>$parsed===$expectedRows,
        'quoted_field_preserved'=>$parsed[1][1]==='Кабель; 2 м','zero_is_data'=>$parsed[2][2]==='0',
        'resources_closed'=>$handle===null&&$out===null&&$input===null];
    $observations=['export_file'=>'export.csv','bytes'=>$written,'sha256'=>$actualHash,'expected_sha256'=>$expectedHash,
        'chunk_bytes'=>13,'chunks'=>$chunks,'parsed_csv'=>$parsed,'encoding'=>'UTF-8','bom'=>false,'newline'=>'CRLF',
        'partial_writes_handled'=>true,'body_assembled_during_export'=>false,'fixture_preparation_in_memory'=>true];

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

f162Report('fb162-export-csv','Выгрузить сохранённый CSV и проверить, что его поля не потерялись',$rows,$checks,$observations,$runtime,$owned,$removed);

Файл — export.csv
Заголовок — sku | title | qty
Товар 1 — CAB-01 | Кабель; 2 м | 3
Товар 2 — CLP-02 | Хомут | 0
Байт в выгрузке — 67
Непустых порций — 6
SHA256 файла — a0e0108b39fabbd340e0d020acfa25feabfbd6071f89256a181eaa2bd73a9e75
Кавычки сохранили точку с запятой внутри названия — да

Распакуйте все файлы и запустите example.php по README.txt. Исходник ниже включает подготовку искусственного содержимого, чтение, проверки и finally. lab.php ограничивает работу отдельной базой и собственной FB162-таблицей. result.html показывает фактические строки, result.json хранит наблюдения, metrics.json — проверки и очистку. Все открытые чтения завершаются до удаления таблицы. Для HTTP-проекта README дополнительно описывает единственный временный локальный PHP-сервер; он запускается и останавливается автоматически.

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

    // The preceding writing chapter explains fixture creation; the lesson below teaches reading.
    function f162FixtureBlob($db,array $pieces): string {
        $handle=fbird_blob_create($db);
        if ($handle===false) {f162Failure('Учебный BLOB не создан');}
        try {
            foreach($pieces as $piece) {
                $call=f162Capture(static fn()=>fbird_blob_add($handle,$piece));
                if($call['value']===false || $call['warning'])f162Failure('Учебные байты не записаны',$call);
            }
            $id=fbird_blob_close($handle);
            if(!is_string($id))f162Failure('Запись BLOB не закрыта');
            $handle=null;return $id;
        }finally{if(is_resource($handle)){fbird_blob_cancel($handle);$handle=null;}}
    }

    require __DIR__.'/http-lab.php';
    $name=f162OwnTable($db,$owned,'download','(ID INTEGER NOT NULL PRIMARY KEY, FILE_DATA BLOB SUB_TYPE BINARY)');
    $q=f162Qualified($name);
    $payload="Акт приёмки №42\nКабель: 3 шт.\nСтатус: принят\n";
    $expectedHash=hash('sha256',$payload);
    $blobId=f162FixtureBlob($db,str_split($payload,9));
    f162Command($db,"INSERT INTO $q (ID,FILE_DATA) VALUES (?,?)",[42,$blobId]);f162Commit($db);
    if(fbird_close($db)!==true)f162Failure('Родительское подключение не закрыто');$db=null;
    try{$response=f162HttpDownload($name);}
    finally{if(f162HttpChildrenStopped())$db=f162Connect($config);}
    $body=$response['body'];$headers=$response['headers'];$bytes=strlen($body);$sha=hash('sha256',$body);
    if(file_put_contents(__DIR__.'/downloaded.bin',$body)!==$bytes)throw new RuntimeException('Полученный файл не сохранён');
    $rows=[['HTTP-статус',$response['status']],['Имя скачиваемого файла','receipt-42.txt'],
        ['Content-Type',$headers['content-type']??''],['Content-Disposition',$headers['content-disposition']??''],
        ['Полученное содержимое акта',$body],['Получено байт',$bytes],['SHA256 полученного файла',$sha],
        ['Ответ совпал с исходным актом',$body===$payload],['Дочерний сервер остановлен',$response['server_stopped']]];
    $checks=['http_200'=>$response['status']===200,'text_content_type'=>($headers['content-type']??'')==='text/plain; charset=UTF-8',
        'download_filename'=>($headers['content-disposition']??'')==='attachment; filename="receipt-42.txt"',
        'content_length'=>($headers['content-length']??'')==='77'&&$bytes===77,
        'exact_received_text'=>$body===$payload,'received_hash'=>$sha===$expectedHash,
        'no_sniff'=>($headers['x-content-type-options']??'')==='nosniff',
        'same_runtime'=>($headers['x-phpman-php']??'')===PHP_VERSION&&($headers['x-phpman-interbase']??'')===phpversion('interbase'),
        'local_child_stopped'=>$response['server_started']&&$response['server_stopped']&&f162HttpChildrenStopped(),
        'downloaded_file_exact'=>hash_file('sha256',__DIR__.'/downloaded.bin')===$expectedHash];
    $observations=['http'=>['status'=>$response['status'],'bytes'=>$bytes,'sha256'=>$sha,'headers'=>$headers,
        'server_started'=>$response['server_started'],'server_stopped'=>$response['server_stopped'],'http_requests'=>1],
        'body_text'=>$body,'client_saved_file'=>'downloaded.bin','browser_filename'=>'receipt-42.txt','expected_sha256'=>$expectedHash,
        'transport'=>'real HTTP over 127.0.0.1','private_token_published'=>false,'cli_output_buffer_used_as_http_test'=>false];

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

f162Report('fb162-http-download','Получить акт по HTTP с именем файла и исходными русскими буквами',$rows,$checks,$observations,$runtime,$owned,$removed);

HTTP-статус — 200
Имя скачиваемого файла — receipt-42.txt
Content-Type — text/plain; charset=UTF-8
Content-Disposition — attachment; filename="receipt-42.txt"
Полученное содержимое акта — Акт приёмки №42
Кабель: 3 шт.
Статус: принят

Получено байт — 77
SHA256 полученного файла — 3dd5720e3950207d628873762554cb18809e73ca5f7a89d007554ef3b1c5b7bd
Ответ совпал с исходным актом — да
Дочерний сервер остановлен — да

Распакуйте все файлы и запустите example.php по README.txt. Исходник ниже включает подготовку искусственного содержимого, чтение, проверки и finally. lab.php ограничивает работу отдельной базой и собственной FB162-таблицей. result.html показывает фактические строки, result.json хранит наблюдения, metrics.json — проверки и очистку. Все открытые чтения завершаются до удаления таблицы. Для HTTP-проекта README дополнительно описывает единственный временный локальный PHP-сервер; он запускается и останавливается автоматически.