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

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

    // Fixture creation is explained in the preceding chapter; this chapter teaches reading.
    function f155FixtureBlob($db,array $pieces): string {
        $handle=ibase_blob_create($db);
        if ($handle===false) {f155Failure('Учебный BLOB не создан');}
        try {
            foreach ($pieces as $piece) {
                $add=f155Capture(static fn()=>ibase_blob_add($handle,$piece));
                if ($add['value']===false || $add['warning']) {f155Failure('Порция BLOB не записана',$add);}
            }
            $id=ibase_blob_close($handle);
            if (!is_string($id)) {f155Failure('Записанный BLOB не закрыт');}
            $handle=null;return $id;
        } finally {
            if (is_resource($handle)) {ibase_blob_cancel($handle);$handle=null;}
        }
    }

    $attachments=f155OwnTable($db,$owned,'metadata','(ID INTEGER NOT NULL PRIMARY KEY, FILE_DATA BLOB SUB_TYPE BINARY)');
    $q=f155Qualified($attachments);
    $content="invoice=42\namount=1500\ncurrency=RUB\n";
    $fullId=f155FixtureBlob($db,["invoice=42\n","amount=1500\n","currency=RUB\n"]);
    $emptyId=f155FixtureBlob($db,[]);
    f155Command($db,"INSERT INTO $q (ID,FILE_DATA) VALUES (?,?)",[1,$fullId]);
    f155Command($db,"INSERT INTO $q (ID,FILE_DATA) VALUES (?,?)",[2,$emptyId]);
    f155Command($db,"INSERT INTO $q (ID,FILE_DATA) VALUES (?,?)",[3,null]);
    f155Commit($db);
    $stored=f155Read($db,"SELECT ID,FILE_DATA FROM $q ORDER BY ID");
    $full=ibase_blob_info($db,$stored[0]['FILE_DATA']);
    if ($full===false) {f155Failure('Нет метаданных вложения');}
    $empty=ibase_blob_info($db,$stored[1]['FILE_DATA']);
    if ($empty===false) {f155Failure('Нет метаданных пустого BLOB');}
    $missing=$stored[2]['FILE_DATA']===null;
    $previewLimit=32;
    $previewAllowed=$full['length']<=$previewLimit;
    $rows=[['Размер заполненного вложения, байт',$full['length']],['Лимит предпросмотра, байт',$previewLimit],
        ['Предпросмотр разрешён без отдельного скачивания',$previewAllowed],['Размер пустого BLOB, байт',$empty['length']],
        ['Пустой BLOB имеет признак isnull',$empty['isnull']],['Третий SQL-столбец равен NULL',$missing],
        ['Числовой ключ 0 совпадает с length',$full[0]===$full['length']],['Содержимое вложения читалось для списка',False]];
    $checks=['full_length'=>$full['length']===strlen($content),'preview_budget'=>$previewAllowed===false,
        'empty_is_not_null'=>$empty['length']===0&&$empty['isnull']===false,'sql_null_handled_before_api'=>$missing,
        'numeric_and_named_keys'=>$full[0]===$full['length']&&$full[1]===$full['numseg']&&$full[2]===$full['maxseg']&&$full[3]===$full['stream']&&$full[4]===$full['isnull'],
        'info_did_not_replace_identifier'=>is_string($stored[0]['FILE_DATA'])];
    $observations=['full_blob_metadata'=>$full,'empty_blob_metadata'=>$empty,'sql_null'=>$missing,
        'preview_limit_bytes'=>$previewLimit,'preview_allowed'=>$previewAllowed,'body_read_for_listing'=>false,
        'stored_blob_id_published'=>false,'subtype'=>'BINARY','fixture_bytes'=>strlen($content)];

} finally {
    if (is_resource($db)) {try {$removed=f155Cleanup($db,$owned);} finally {ibase_close($db);}}
}

f155Report('fb155-blob-metadata','Показать размер вложения и отличить пустой файл от отсутствующего',$rows,$checks,$observations,$runtime,$owned,$removed);

Размер заполненного вложения, байт — 36
Лимит предпросмотра, байт — 32
Предпросмотр разрешён без отдельного скачивания — нет
Размер пустого BLOB, байт — 0
Пустой BLOB имеет признак isnull — нет
Третий SQL-столбец равен NULL — да
Числовой ключ 0 совпадает с length — да
Содержимое вложения читалось для списка — нет

Запустите example.php по README.txt в отдельной учебной базе. Программа создаёт одну собственную таблицу, получает данные, сохраняет result.html/result.json/metrics.json и удаляет свою таблицу. Код вспомогательного lab.php открыт; операции записи тестового BLOB разобраны в предыдущей главе.

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

    // Fixture creation is explained in the preceding chapter; this chapter teaches reading.
    function f155FixtureBlob($db,array $pieces): string {
        $handle=ibase_blob_create($db);
        if ($handle===false) {f155Failure('Учебный BLOB не создан');}
        try {
            foreach ($pieces as $piece) {
                $add=f155Capture(static fn()=>ibase_blob_add($handle,$piece));
                if ($add['value']===false || $add['warning']) {f155Failure('Порция BLOB не записана',$add);}
            }
            $id=ibase_blob_close($handle);
            if (!is_string($id)) {f155Failure('Записанный BLOB не закрыт');}
            $handle=null;return $id;
        } finally {
            if (is_resource($handle)) {ibase_blob_cancel($handle);$handle=null;}
        }
    }

    $notes=f155OwnTable($db,$owned,'note','(ID INTEGER NOT NULL PRIMARY KEY, NOTE_TEXT BLOB SUB_TYPE TEXT CHARACTER SET UTF8)');
    $q=f155Qualified($notes);
    $expected="Заявка #42\nПроверить <кабель> & разъём.\n";
    $blobId=f155FixtureBlob($db,[$expected]);
    f155Command($db,"INSERT INTO $q (ID,NOTE_TEXT) VALUES (?,?)",[42,$blobId]);
    f155Commit($db);
    $record=f155Read($db,"SELECT ID,NOTE_TEXT FROM $q WHERE ID=?",[42])[0];
    if ($record['NOTE_TEXT']===null) {throw new RuntimeException('Для этой заявки нужна заметка');}
    $info=ibase_blob_info($db,$record['NOTE_TEXT']);
    if ($info===false) {f155Failure('Размер заметки недоступен');}
    $limit=4096;
    if ($info['length']>$limit) {throw new RuntimeException('Заметка превышает предел предпросмотра');}
    $handle=ibase_blob_open($db,$record['NOTE_TEXT']);
    if ($handle===false) {f155Failure('Заметка не открыта');}
    $note='';$chunks=0;$eof=false;
    try {
        while (true) {
            $part=ibase_blob_get($handle,7);
            if ($part===false) {f155Failure('Порция заметки не прочитана');}
            if ($part==='') {$eof=true;break;}
            $note.=$part;++$chunks;
            if (strlen($note)>$limit) {throw new RuntimeException('Превышен предел собранного текста');}
        }
    } finally {
        if (ibase_blob_close($handle)===false) {f155Failure('Чтение заметки не закрыто');}
        $handle=null;
    }
    $escaped=htmlspecialchars($note,ENT_QUOTES|ENT_SUBSTITUTE,'UTF-8');
    $rows=[['Прочитано байт',strlen($note)],['Размер одной запрошенной порции, байт',7],['Непустых порций',$chunks],
        ['Пустая строка обозначила конец BLOB',$eof],['Собранный текст совпал с исходным',$note===$expected],
        ['Текст заметки',$note],['Текст после HTML-экранирования',$escaped]];
    $checks=['complete_note'=>$note===$expected,'bytes_match_metadata'=>strlen($note)===$info['length'],
        'multiple_reads'=>$chunks===10,'eof_is_empty_string'=>$eof,'preview_within_budget'=>strlen($note)<=$limit,
        'html_specials_escaped'=>str_contains($escaped,'&lt;кабель&gt;')&&str_contains($escaped,'&amp;'),
        'reader_handle_released'=>$handle===null];
    $observations=['note_text'=>$note,'escaped_for_html'=>$escaped,'bytes'=>strlen($note),'chunk_request_bytes'=>7,
        'nonempty_chunks'=>$chunks,'preview_limit_bytes'=>$limit,'eof_return'=>'','charset'=>'UTF8',
        'escape_applied_after_reassembly'=>true,'handle_closed'=>true];

} finally {
    if (is_resource($db)) {try {$removed=f155Cleanup($db,$owned);} finally {ibase_close($db);}}
}

f155Report('fb155-read-note','Прочитать заметку UTF8 порциями и показать её как текст',$rows,$checks,$observations,$runtime,$owned,$removed);

Прочитано байт — 67
Размер одной запрошенной порции, байт — 7
Непустых порций — 10
Пустая строка обозначила конец BLOB — да
Собранный текст совпал с исходным — да
Текст заметки — Заявка #42
Проверить <кабель> & разъём.

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

Запустите example.php по README.txt в отдельной учебной базе. Программа создаёт одну собственную таблицу, получает данные, сохраняет result.html/result.json/metrics.json и удаляет свою таблицу. Код вспомогательного lab.php открыт; операции записи тестового BLOB разобраны в предыдущей главе.

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

    // Fixture creation is explained in the preceding chapter; this chapter teaches reading.
    function f155FixtureBlob($db,array $pieces): string {
        $handle=ibase_blob_create($db);
        if ($handle===false) {f155Failure('Учебный BLOB не создан');}
        try {
            foreach ($pieces as $piece) {
                $add=f155Capture(static fn()=>ibase_blob_add($handle,$piece));
                if ($add['value']===false || $add['warning']) {f155Failure('Порция BLOB не записана',$add);}
            }
            $id=ibase_blob_close($handle);
            if (!is_string($id)) {f155Failure('Записанный BLOB не закрыт');}
            $handle=null;return $id;
        } finally {
            if (is_resource($handle)) {ibase_blob_cancel($handle);$handle=null;}
        }
    }

    $files=f155OwnTable($db,$owned,'export','(ID INTEGER NOT NULL PRIMARY KEY, FILE_DATA BLOB SUB_TYPE BINARY)');
    $q=f155Qualified($files);
    $fixture=str_repeat("FB155\x00\xFF\r\n",9000);
    $expectedBytes=strlen($fixture);$expectedHash=hash('sha256',$fixture);
    $blobId=f155FixtureBlob($db,str_split($fixture,12000));
    f155Command($db,"INSERT INTO $q (ID,FILE_DATA) VALUES (?,?)",[1,$blobId]);
    f155Commit($db);unset($fixture);
    $record=f155Read($db,"SELECT FILE_DATA FROM $q WHERE ID=?",[1])[0];
    $info=ibase_blob_info($db,$record['FILE_DATA']);
    if ($info===false) {f155Failure('Размер вложения недоступен');}
    $handle=ibase_blob_open($db,$record['FILE_DATA']);
    if ($handle===false) {f155Failure('Вложение не открыто');}
    $out=null;$bytes=0;$chunks=0;$maximumChunk=0;
    $path=__DIR__.'/export.bin';
    try {
        // This generated name is fixed by the lesson, never taken from a request or BLOB ID.
        $out=fopen($path,'wb');
        if ($out===false) {throw new RuntimeException('Не удалось создать export.bin');}
        while (true) {
            $part=ibase_blob_get($handle,8192);
            if ($part===false) {f155Failure('Не удалось прочитать порцию вложения');}
            if ($part==='') {break;}
            $length=strlen($part);$offset=0;
            while ($offset<$length) {
                $written=fwrite($out,substr($part,$offset));
                if ($written===false || $written===0) {throw new RuntimeException('Файл записан не полностью');}
                $offset+=$written;
            }
            $bytes+=$length;++$chunks;$maximumChunk=max($maximumChunk,$length);
        }
        if (fflush($out)!==true) {throw new RuntimeException('Файл не сброшен в поток');}
    } finally {
        if (is_resource($out)) {fclose($out);$out=null;}
        if (ibase_blob_close($handle)===false) {f155Failure('Чтение вложения не закрыто');}
        $handle=null;
    }
    $actualHash=hash_file('sha256',$path);
    if (!is_string($actualHash)) {throw new RuntimeException('Не удалось вычислить хеш выгрузки');}
    $prefix=file_get_contents($path,false,null,0,9);
    $rows=[['Созданный файл','export.bin'],['Записано байт',$bytes],['Непустых порций чтения',$chunks],
        ['Самая большая порция, байт',$maximumChunk],['Размер совпал с metadata',$bytes===$info['length']],
        ['SHA256 файла совпал с исходником',$actualHash===$expectedHash],['Первые 9 байт в hex',bin2hex($prefix)],
        ['SHA256 выгруженного файла',$actualHash]];
    $checks=['expected_byte_count'=>$bytes===81000&&$bytes===$expectedBytes,'metadata_length_matches'=>$bytes===$info['length'],
        'bounded_chunks'=>$maximumChunk<=8192&&$chunks===10,'hash_matches'=>$actualHash===$expectedHash,
        'binary_bytes_preserved'=>$prefix==="FB155\x00\xFF\r\n",'file_size_matches'=>filesize($path)===$bytes,
        'both_handles_released'=>$handle===null&&$out===null];
    $observations=['file'=>'export.bin','bytes'=>$bytes,'metadata_bytes'=>$info['length'],'chunk_request_bytes'=>8192,
        'nonempty_chunks'=>$chunks,'maximum_chunk_bytes'=>$maximumChunk,'sha256'=>$actualHash,'expected_sha256'=>$expectedHash,
        'prefix_hex'=>bin2hex($prefix),'entire_blob_accumulated_during_export'=>false,'fixture_created_in_memory_before_export'=>true];

} finally {
    if (is_resource($db)) {try {$removed=f155Cleanup($db,$owned);} finally {ibase_close($db);}}
}

f155Report('fb155-export-file','Выгрузить бинарное вложение в файл без накопления всего BLOB',$rows,$checks,$observations,$runtime,$owned,$removed);

Созданный файл — export.bin
Записано байт — 81000
Непустых порций чтения — 10
Самая большая порция, байт — 8192
Размер совпал с metadata — да
SHA256 файла совпал с исходником — да
Первые 9 байт в hex — 464231353500ff0d0a
SHA256 выгруженного файла — 8797cedecc25674df8d7c2204744a22c05338efb4c269311ef5194ea7d93ab9e

Запустите example.php по README.txt в отдельной учебной базе. Программа создаёт одну собственную таблицу, получает данные, сохраняет result.html/result.json/metrics.json и удаляет свою таблицу. Код вспомогательного lab.php открыт; операции записи тестового BLOB разобраны в предыдущей главе.

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

    // Fixture creation is explained in the preceding chapter; this chapter teaches reading.
    function f155FixtureBlob($db,array $pieces): string {
        $handle=ibase_blob_create($db);
        if ($handle===false) {f155Failure('Учебный BLOB не создан');}
        try {
            foreach ($pieces as $piece) {
                $add=f155Capture(static fn()=>ibase_blob_add($handle,$piece));
                if ($add['value']===false || $add['warning']) {f155Failure('Порция BLOB не записана',$add);}
            }
            $id=ibase_blob_close($handle);
            if (!is_string($id)) {f155Failure('Записанный BLOB не закрыт');}
            $handle=null;return $id;
        } finally {
            if (is_resource($handle)) {ibase_blob_cancel($handle);$handle=null;}
        }
    }

    require __DIR__.'/http-lab.php';
    $attachments=f155OwnTable($db,$owned,'http','(ID INTEGER NOT NULL PRIMARY KEY, FILE_DATA BLOB SUB_TYPE BINARY)');
    $q=f155Qualified($attachments);
    $payload="attachment-155\r\n".str_repeat("\x00\xFFab",20000);
    $expectedHash=hash('sha256',$payload);
    $blobId=f155FixtureBlob($db,str_split($payload,10000));
    f155Command($db,"INSERT INTO $q (ID,FILE_DATA) VALUES (?,?)",[1,$blobId]);
    f155Commit($db);
    // The embedded fixture is released before the separate PHP HTTP process opens it.
    if (ibase_close($db)!==true) {f155Failure('Родительское соединение не закрыто');}
    $db=null;
    try {$response=f155HttpDownload($attachments);}
    finally {$db=f155Connect($config);}
    $headers=$response['headers'];$body=$response['body'];
    $bodyBytes=strlen($body);$actualHash=hash('sha256',$body);
    $contentType=$headers['content-type']??'';
    $disposition=$headers['content-disposition']??'';
    $declaredLength=$headers['content-length']??'';
    $sameBytes=$body===$payload;
    $saved=file_put_contents(__DIR__.'/downloaded.bin',$body);
    if ($saved!==$bodyBytes) {throw new RuntimeException('Локальная копия HTTP-ответа не сохранена');}
    $rows=[['HTTP-статус',$response['status']],['Content-Type',$contentType],['Content-Disposition',$disposition],
        ['Получено байт по HTTP',$bodyBytes],['Content-Length совпал с телом',$declaredLength===(string)$bodyBytes],
        ['Полученные байты совпали с исходником',$sameBytes],['SHA256 полученного вложения',$actualHash],
        ['Дочерний HTTP-сервер остановлен',$response['server_stopped']],['Копия файла у клиента','downloaded.bin']];
    $checks=['http_status'=>$response['status']===200,'binary_content_type'=>$contentType==='application/octet-stream',
        'attachment_name'=>$disposition==='attachment; filename="firebird-attachment.bin"',
        'content_length'=>$declaredLength==='80016'&&$bodyBytes===80016,'response_exact_bytes'=>$sameBytes,
        'response_sha256'=>$actualHash===$expectedHash,'no_sniff'=>($headers['x-content-type-options']??'')==='nosniff',
        'real_server_stopped'=>$response['server_started']===true&&$response['server_stopped']===true,
        'same_php_and_driver'=>($headers['x-phpman-php']??'')===PHP_VERSION&&($headers['x-phpman-interbase']??'')===phpversion('interbase'),
        'saved_client_copy'=>hash_file('sha256',__DIR__.'/downloaded.bin')===$expectedHash];
    $observations=['transport'=>'real HTTP over 127.0.0.1','http_status'=>$response['status'],
        'content_type'=>$contentType,'content_disposition'=>$disposition,'content_length'=>$declaredLength,
        'received_bytes'=>$bodyBytes,'received_sha256'=>$actualHash,'expected_sha256'=>$expectedHash,
        'exact_bytes_match'=>$sameBytes,'php_header'=>$headers['x-phpman-php']??null,
        'interbase_header'=>$headers['x-phpman-interbase']??null,'server_started'=>$response['server_started'],
        'server_stopped'=>$response['server_stopped'],'http_requests'=>1,'client_saved_file'=>'downloaded.bin',
        'private_token_published'=>false,'cli_output_buffer_used_as_http_test'=>false];

} finally {
    if (is_resource($db)) {try {$removed=f155Cleanup($db,$owned);} finally {ibase_close($db);}}
}

f155Report('fb155-http-download','Скачать BLOB отдельным HTTP-ответом и проверить полученные байты',$rows,$checks,$observations,$runtime,$owned,$removed);

HTTP-статус — 200
Content-Type — application/octet-stream
Content-Disposition — attachment; filename="firebird-attachment.bin"
Получено байт по HTTP — 80016
Content-Length совпал с телом — да
Полученные байты совпали с исходником — да
SHA256 полученного вложения — 1fa505ea1e8fe687f0f4e56b0be50fd330cd2af624cf9e25b55a3e85a70115ac
Дочерний HTTP-сервер остановлен — да
Копия файла у клиента — downloaded.bin

Запустите example.php по README.txt в отдельной учебной базе. Программа создаёт одну собственную таблицу, получает данные, сохраняет result.html/result.json/metrics.json и удаляет свою таблицу. Код вспомогательного lab.php открыт; операции записи тестового BLOB разобраны в предыдущей главе.