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

(PECL rar >= 2.0.0) · rar

public static function RarArchive::open(string $filename, string $password = NULL, callable $volume_callback = NULL): RarArchive|false
function rar_open(string $filename, string $password = NULL, callable $volume_callback = NULL): RarArchive|false

Открыть поставку и прочитать чек. open получает путь настоящего input/orders.rar. Результат — объект контейнера; содержимое выбранного документа читается отдельным шагом.

Архив ZIP содержит все входы и полный support.php. readDocument читает не больше 1025 байт, проверяет размер и CRC, затем возвращает настоящий текст. Пошаговый разбор исходников.

<?php
declare(strict_types=1);

require __DIR__ . '/support.php';
$archive = RarArchive::open(__DIR__ . '/input/orders.rar');
if ($archive === false) { throw new RuntimeException('Не открыт архив'); }
$entry = $archive->getEntry('receipt.txt');
if ($entry === false) { throw new RuntimeException('Чек не приложен'); }
echo readDocument($entry);
$archive->close();

Заказ 42
Кисть — 2 шт.
Итого: 300 руб.

Официальный контракт: адаптированная документация PHP Documentation Group, CC BY 3.0 или более поздняя версия. Сохранены правила, параметры, возвраты, ограничения и таблицы; изменены оформление и ссылки, старые условные иллюстрации заменены оригинальными проектами.

Следующая ступень: полный приём документов в новую папку. Результат проверяется отдельным PHP 8.3.35 NTS x64 + PECL rar 4.2.0. Основной PHP 8.5.11 не имеет rar: проверка его синтаксиса не подтверждает выполнение API. Официальная DLL 4.2.0 при старте PHP 8.3 выдаёт предупреждения совместимости __toString/getIterator; они записаны отдельно от результата урока и требуют внимания при выборе окружения.

• PHP: RarArchive::open

(PECL rar >= 2.0.0) · rar

function rar_open(string $filename, string $password = NULL, callable $volume_callback = NULL): RarArchive|false

Процедурная форма RarArchive::open: первый аргумент — имя файла; далее необязательные пароль и функция поиска тома. Остальные аргументы, ошибки, возврат и ограничения доступны в полном договоре метода.

Полный контракт и работающий сценарий RarArchive::open

• PHP: rar_open

(PECL rar >= 2.0.0) · rar

public function RarArchive::close(): bool
function rar_close(RarArchive $rarfile): bool

Закрыть контейнер, сохранив уже открытый поток. Объект RarEntry нельзя использовать как прежде после close, но ранее открытый поток независим. Покажем текст после освобождения контейнера.

Архив ZIP содержит все входы и полный support.php. readDocument читает не больше 1025 байт, проверяет размер и CRC, затем возвращает настоящий текст. Пошаговый разбор исходников.

<?php
declare(strict_types=1);

require __DIR__ . '/bootstrap.php';
$entry = $archive->getEntry('receipt.txt');
if ($entry === false) { throw new RuntimeException('Нет чека'); }
$crc = str_pad(strtolower($entry->getCrc()), 8, '0', STR_PAD_LEFT);
$stream = $entry->getStream();
if ($stream === false) { throw new RuntimeException('Нет потока'); }
$archive->close();
try { $text = stream_get_contents($stream, 1025); }
finally { fclose($stream); }
if ($text === false || !hash_equals($crc, hash('crc32b', $text))) { throw new RuntimeException('Неполный чек'); }
echo "Контейнер закрыт; ранее открытый поток дал:\n", $text;

Контейнер закрыт; ранее открытый поток дал:
Заказ 42
Кисть — 2 шт.
Итого: 300 руб.

Официальный контракт: адаптированная документация PHP Documentation Group, CC BY 3.0 или более поздняя версия. Сохранены правила, параметры, возвраты, ограничения и таблицы; изменены оформление и ссылки, старые условные иллюстрации заменены оригинальными проектами.

Следующая ступень: полный приём документов в новую папку. Результат проверяется отдельным PHP 8.3.35 NTS x64 + PECL rar 4.2.0. Основной PHP 8.5.11 не имеет rar: проверка его синтаксиса не подтверждает выполнение API. Официальная DLL 4.2.0 при старте PHP 8.3 выдаёт предупреждения совместимости __toString/getIterator; они записаны отдельно от результата урока и требуют внимания при выборе окружения.

• PHP: RarArchive::close

(PECL rar >= 2.0.0) · rar

function rar_close(RarArchive $rarfile): bool

Процедурная форма RarArchive::close: первым аргументом передайте открытый RarArchive. Остальные аргументы, ошибки, возврат и ограничения доступны в полном договоре метода.

Полный контракт и работающий сценарий RarArchive::close

• PHP: rar_close

(PECL rar >= 2.0.0) · rar

public function RarArchive::getComment(): string
function rar_comment_get(RarArchive $rarfile): string

Показать сопроводительную заметку и чек. Комментарий относится ко всему архиву. В нашем orders.rar он записан отправителем из comment.txt и поясняет состав поставки.

Архив ZIP содержит все входы и полный support.php. readDocument читает не больше 1025 байт, проверяет размер и CRC, затем возвращает настоящий текст. Пошаговый разбор исходников.

<?php
declare(strict_types=1);

require __DIR__ . '/bootstrap.php';
$comment = $archive->getComment();
echo 'Комментарий: ', $comment ?? '(не приложен)', "\n";
$entry = $archive->getEntry('receipt.txt');
if ($entry === false) { throw new RuntimeException('Чек не приложен'); }
echo readDocument($entry);
$archive->close();

Комментарий: Delivery 42: receipt and notice.

Заказ 42
Кисть — 2 шт.
Итого: 300 руб.

Уточнение формата: старое замечание ниже о комментариях без Unicode относится к прежним вариантам RAR. В спецификации RAR5 комментарий — UTF-8 service header CMT. Наш ASCII-комментарий переносим между вариантами; кодировку произвольного старого архива нельзя угадывать.

Официальный контракт: адаптированная документация PHP Documentation Group, CC BY 3.0 или более поздняя версия. Сохранены правила, параметры, возвраты, ограничения и таблицы; изменены оформление и ссылки, старые условные иллюстрации заменены оригинальными проектами.

Следующая ступень: полный приём документов в новую папку. Результат проверяется отдельным PHP 8.3.35 NTS x64 + PECL rar 4.2.0. Основной PHP 8.5.11 не имеет rar: проверка его синтаксиса не подтверждает выполнение API. Официальная DLL 4.2.0 при старте PHP 8.3 выдаёт предупреждения совместимости __toString/getIterator; они записаны отдельно от результата урока и требуют внимания при выборе окружения.

• PHP: RarArchive::getComment

(PECL rar >= 2.0.0) · rar

function rar_comment_get(RarArchive $rarfile): string

Процедурная форма RarArchive::getComment: первым аргументом передайте открытый RarArchive. Остальные аргументы, ошибки, возврат и ограничения доступны в полном договоре метода.

Полный контракт и работающий сценарий RarArchive::getComment

• PHP: rar_comment_get

(PECL rar >= 2.0.0) · rar

public function RarArchive::getEntries(): array|false
function rar_list(RarArchive $rarfile): array|false

Показать все документы поставки. getEntries возвращает массив RarEntry. foreach получает каждый объект, getName выбирает подпись, readDocument возвращает проверенные байты.

Архив ZIP содержит все входы и полный support.php. readDocument читает не больше 1025 байт, проверяет размер и CRC, затем возвращает настоящий текст. Пошаговый разбор исходников.

<?php
declare(strict_types=1);

require __DIR__ . '/bootstrap.php';
$entries = $archive->getEntries();
if ($entries === false) { throw new RuntimeException('Не прочитан перечень'); }
foreach ($entries as $entry) {
    if ($entry->isDirectory()) { continue; }
    echo $entry->getName(), ":\n", readDocument($entry);
}
$archive->close();

receipt.txt:
Заказ 42
Кисть — 2 шт.
Итого: 300 руб.
notice.txt:
Получить заказ в пункте № 3.

Официальный контракт: адаптированная документация PHP Documentation Group, CC BY 3.0 или более поздняя версия. Сохранены правила, параметры, возвраты, ограничения и таблицы; изменены оформление и ссылки, старые условные иллюстрации заменены оригинальными проектами.

Следующая ступень: полный приём документов в новую папку. Результат проверяется отдельным PHP 8.3.35 NTS x64 + PECL rar 4.2.0. Основной PHP 8.5.11 не имеет rar: проверка его синтаксиса не подтверждает выполнение API. Официальная DLL 4.2.0 при старте PHP 8.3 выдаёт предупреждения совместимости __toString/getIterator; они записаны отдельно от результата урока и требуют внимания при выборе окружения.

• PHP: RarArchive::getEntries

(PECL rar >= 2.0.0) · rar

function rar_list(RarArchive $rarfile): array|false

Процедурная форма RarArchive::getEntries: первым аргументом передайте открытый RarArchive. Остальные аргументы, ошибки, возврат и ограничения доступны в полном договоре метода.

Полный контракт и работающий сценарий RarArchive::getEntries

• PHP: rar_list

(PECL rar >= 2.0.0) · rar

public function RarArchive::getEntry(string $entryname): RarEntry|false
function rar_entry_get(RarArchive $rarfile, string $entryname): RarEntry|false

Получить определённый чек и сообщить об отсутствии счёта. Имя receipt.txt — точное имя внутри контейнера. Это не путь к уже извлечённому файлу на диске.

Архив ZIP содержит все входы и полный support.php. readDocument читает не больше 1025 байт, проверяет размер и CRC, затем возвращает настоящий текст. Пошаговый разбор исходников.

<?php
declare(strict_types=1);

require __DIR__ . '/bootstrap.php';
$entry = $archive->getEntry('receipt.txt');
if ($entry === false) { throw new RuntimeException('Чек не приложен'); }
echo readDocument($entry);
try { $archive->getEntry('invoice.txt'); }
catch (RarException $error) { echo "Счёт invoice.txt не приложен\n"; }
$archive->close();

Заказ 42
Кисть — 2 шт.
Итого: 300 руб.
Счёт invoice.txt не приложен

Официальный контракт: адаптированная документация PHP Documentation Group, CC BY 3.0 или более поздняя версия. Сохранены правила, параметры, возвраты, ограничения и таблицы; изменены оформление и ссылки, старые условные иллюстрации заменены оригинальными проектами.

Следующая ступень: полный приём документов в новую папку. Результат проверяется отдельным PHP 8.3.35 NTS x64 + PECL rar 4.2.0. Основной PHP 8.5.11 не имеет rar: проверка его синтаксиса не подтверждает выполнение API. Официальная DLL 4.2.0 при старте PHP 8.3 выдаёт предупреждения совместимости __toString/getIterator; они записаны отдельно от результата урока и требуют внимания при выборе окружения.

• PHP: RarArchive::getEntry

(PECL rar >= 2.0.0) · rar

function rar_entry_get(RarArchive $rarfile, string $entryname): RarEntry|false

Процедурная форма RarArchive::getEntry: первым аргументом передайте открытый RarArchive. Остальные аргументы, ошибки, возврат и ограничения доступны в полном договоре метода.

Полный контракт и работающий сценарий RarArchive::getEntry

• PHP: rar_entry_get

(PECL rar >= 2.0.0) · rar

public function RarArchive::isSolid(): bool
function rar_solid_is(RarArchive $rarfile): bool

Показать документы из сплошного архива. В solid-архиве распаковка позднего файла может зависеть от предыдущих записей. Проверка нужна для выбора последовательной выдачи, а не для вывода bool.

Архив ZIP содержит все входы и полный support.php. readDocument читает не больше 1025 байт, проверяет размер и CRC, затем возвращает настоящий текст. Пошаговый разбор исходников.

<?php
declare(strict_types=1);

require __DIR__ . '/support.php';
$archive = RarArchive::open(__DIR__ . '/input/solid.rar');
if ($archive === false) { throw new RuntimeException('Не открыт архив'); }
if ($archive->isSolid()) { echo "Сплошной архив: читаем документы последовательно\n"; }
foreach ($archive as $entry) { echo $entry->getName(), ":\n", readDocument($entry); }
$archive->close();

Сплошной архив: читаем документы последовательно
receipt.txt:
Заказ 42
Кисть — 2 шт.
Итого: 300 руб.
notice.txt:
Получить заказ в пункте № 3.

Официальный контракт: адаптированная документация PHP Documentation Group, CC BY 3.0 или более поздняя версия. Сохранены правила, параметры, возвраты, ограничения и таблицы; изменены оформление и ссылки, старые условные иллюстрации заменены оригинальными проектами.

Следующая ступень: полный приём документов в новую папку. Результат проверяется отдельным PHP 8.3.35 NTS x64 + PECL rar 4.2.0. Основной PHP 8.5.11 не имеет rar: проверка его синтаксиса не подтверждает выполнение API. Официальная DLL 4.2.0 при старте PHP 8.3 выдаёт предупреждения совместимости __toString/getIterator; они записаны отдельно от результата урока и требуют внимания при выборе окружения.

• PHP: RarArchive::isSolid

(PECL rar >= 2.0.0) · rar

function rar_solid_is(RarArchive $rarfile): bool

Процедурная форма RarArchive::isSolid: первым аргументом передайте открытый RarArchive. Остальные аргументы, ошибки, возврат и ограничения доступны в полном договоре метода.

Полный контракт и работающий сценарий RarArchive::isSolid

• PHP: rar_solid_is

(PECL rar >= 3.0.0) · rar

public function RarArchive::isBroken(): bool
function rar_broken_is(RarArchive $rarfile): bool

Остановить приём при отсутствии следующих томов. Вложен только первый том собственного набора. Обработчик возвращает null: других частей в этой поставке нет, повторно искать неизвестный путь не нужно.

Третий аргумент open — функция поиска следующего тома. Параметр $missing содержит ожидаемый путь; возвращённый null сообщает, что подходящего локального файла нет. Функция не обращается к сети.

<?php
declare(strict_types=1);

require __DIR__ . '/support.php';
$archive = RarArchive::open(__DIR__ . '/input/missing.part01.rar', null, static function (string $missing): ?string { return null; });
if ($archive === false) { throw new RuntimeException('Не открыт первый том'); }
if ($archive->isBroken()) { echo "Поставка неполная: запросите все тома; результат не создан\n"; }
else { throw new RuntimeException('Ожидался неполный вход'); }
$archive->close();

Поставка неполная: запросите все тома; результат не создан

Официальный контракт: адаптированная документация PHP Documentation Group, CC BY 3.0 или более поздняя версия. Сохранены правила, параметры, возвраты, ограничения и таблицы; изменены оформление и ссылки, старые условные иллюстрации заменены оригинальными проектами.

Следующая ступень: полный приём документов в новую папку. Результат проверяется отдельным PHP 8.3.35 NTS x64 + PECL rar 4.2.0. Основной PHP 8.5.11 не имеет rar: проверка его синтаксиса не подтверждает выполнение API. Официальная DLL 4.2.0 при старте PHP 8.3 выдаёт предупреждения совместимости __toString/getIterator; они записаны отдельно от результата урока и требуют внимания при выборе окружения.

• PHP: RarArchive::isBroken

(PECL rar >= 3.0.0) · rar

function rar_broken_is(RarArchive $rarfile): bool

Процедурная форма RarArchive::isBroken: первым аргументом передайте открытый RarArchive. Остальные аргументы, ошибки, возврат и ограничения доступны в полном договоре метода.

Полный контракт и работающий сценарий RarArchive::isBroken

• PHP: rar_broken_is

(PECL rar >= 3.0.0) · rar

public function RarArchive::setAllowBroken(bool $allow_broken): bool
function rar_allow_broken_set(RarArchive $rarfile, bool $allow_broken): bool

Из неполной поставки спасти только целый чек. Иногда нужен отдельный режим восстановления. Разрешение чтения повреждённого архива не чинит его: сохранять можно только найденный документ, успешно прошедший проверку.

Архив ZIP содержит все входы и полный support.php. readDocument читает не больше 1025 байт, проверяет размер и CRC, затем возвращает настоящий текст. Пошаговый разбор исходников.

<?php
declare(strict_types=1);

require __DIR__ . '/support.php';
$archive = RarArchive::open(__DIR__ . '/input/missing.part01.rar', null, static function (string $missing): ?string { return null; });
if ($archive === false) { throw new RuntimeException('Не открыт первый том'); }
$archive->setAllowBroken(true);
$entries = $archive->getEntries();
if ($entries === false) { throw new RuntimeException('Даже частичный перечень недоступен'); }
foreach ($entries as $entry) {
    if ($entry->getName() !== 'receipt.txt') { continue; }
    $text = readDocument($entry);
    if (file_put_contents(__DIR__ . '/recovered-receipt.txt', $text) !== strlen($text)) { throw new RuntimeException('Не сохранён чек'); }
    echo "Восстановлен recovered-receipt.txt; вся поставка остаётся неполной:\n", $text;
}
$archive->close();

Восстановлен recovered-receipt.txt; вся поставка остаётся неполной:
Заказ 42
Кисть — 2 шт.
Итого: 300 руб.

Официальный контракт: адаптированная документация PHP Documentation Group, CC BY 3.0 или более поздняя версия. Сохранены правила, параметры, возвраты, ограничения и таблицы; изменены оформление и ссылки, старые условные иллюстрации заменены оригинальными проектами.

Следующая ступень: полный приём документов в новую папку. Результат проверяется отдельным PHP 8.3.35 NTS x64 + PECL rar 4.2.0. Основной PHP 8.5.11 не имеет rar: проверка его синтаксиса не подтверждает выполнение API. Официальная DLL 4.2.0 при старте PHP 8.3 выдаёт предупреждения совместимости __toString/getIterator; они записаны отдельно от результата урока и требуют внимания при выборе окружения.

• PHP: RarArchive::setAllowBroken

(PECL rar >= 3.0.0) · rar

function rar_allow_broken_set(RarArchive $rarfile, bool $allow_broken): bool

Процедурная форма RarArchive::setAllowBroken: первым аргументом передайте открытый RarArchive. Остальные аргументы, ошибки, возврат и ограничения доступны в полном договоре метода.

Полный контракт и работающий сценарий RarArchive::setAllowBroken

• PHP: rar_allow_broken_set

(PECL rar >= 2.0.0) · rar

public function RarArchive::__toString(): string

Оставить диагностическое описание отдельно от выдаваемого чека. Приведение (string) вызывает __toString. Оно удобно для журнала, но не является стабильным форматом данных приложения.

Архив ZIP содержит все входы и полный support.php. readDocument читает не больше 1025 байт, проверяет размер и CRC, затем возвращает настоящий текст. Пошаговый разбор исходников.

<?php
declare(strict_types=1);

require __DIR__ . '/bootstrap.php';
$before = (string) $archive;
$entry = $archive->getEntry('receipt.txt');
if ($entry === false) { throw new RuntimeException('Чек не приложен'); }
echo readDocument($entry);
$archive->close();
$after = (string) $archive;
file_put_contents(__DIR__ . '/archive-diagnostic.txt', $before . "\n" . $after . "\n");
echo "Описание до и после закрытия сохранено в archive-diagnostic.txt\n";

Заказ 42
Кисть — 2 шт.
Итого: 300 руб.
Описание до и после закрытия сохранено в archive-diagnostic.txt

Официальный контракт: адаптированная документация PHP Documentation Group, CC BY 3.0 или более поздняя версия. Сохранены правила, параметры, возвраты, ограничения и таблицы; изменены оформление и ссылки, старые условные иллюстрации заменены оригинальными проектами.

Следующая ступень: полный приём документов в новую папку. Результат проверяется отдельным PHP 8.3.35 NTS x64 + PECL rar 4.2.0. Основной PHP 8.5.11 не имеет rar: проверка его синтаксиса не подтверждает выполнение API. Официальная DLL 4.2.0 при старте PHP 8.3 выдаёт предупреждения совместимости __toString/getIterator; они записаны отдельно от результата урока и требуют внимания при выборе окружения.

• PHP: RarArchive::__toString

(PECL rar >= 0.1) · rar

public function RarEntry::extract( string $dir, string $filepath = "", string $password = NULL, bool $extended_data = false): bool

Записать чек под своим именем и прочитать файл. Получателю нужен обычный файл received/customer-receipt.txt. Второй аргумент задаёт полный путь и переопределяет исходное имя записи.

Архив ZIP содержит все входы и полный support.php. readDocument читает не больше 1025 байт, проверяет размер и CRC, затем возвращает настоящий текст. Пошаговый разбор исходников.

<?php
declare(strict_types=1);

require __DIR__ . '/bootstrap.php';
$entry = $archive->getEntry('receipt.txt');
if ($entry === false) { throw new RuntimeException('Нет чека'); }
$folder = __DIR__ . '/received';
if (file_exists($folder) || !mkdir($folder, 0700)) { throw new RuntimeException('Нужна новая папка'); }
$target = $folder . '/customer-receipt.txt';
if (!$entry->extract('', $target, null, false)) { throw new RuntimeException('Не извлечён чек'); }
echo "received/customer-receipt.txt:\n", file_get_contents($target);
$archive->close();

received/customer-receipt.txt:
Заказ 42
Кисть — 2 шт.
Итого: 300 руб.

Официальный контракт: адаптированная документация PHP Documentation Group, CC BY 3.0 или более поздняя версия. Сохранены правила, параметры, возвраты, ограничения и таблицы; изменены оформление и ссылки, старые условные иллюстрации заменены оригинальными проектами.

Следующая ступень: полный приём документов в новую папку. Результат проверяется отдельным PHP 8.3.35 NTS x64 + PECL rar 4.2.0. Основной PHP 8.5.11 не имеет rar: проверка его синтаксиса не подтверждает выполнение API. Официальная DLL 4.2.0 при старте PHP 8.3 выдаёт предупреждения совместимости __toString/getIterator; они записаны отдельно от результата урока и требуют внимания при выборе окружения.

• PHP: RarEntry::extract

(PECL rar >= 2.0.0) · rar

public function RarEntry::getStream(string $password = ?): resource|false

Прочитать чек без извлечения и проверить CRC. getStream даёт ресурс для последовательного чтения. Само получение потока и даже успешное чтение не проверяют, что пароль/байты правильные.

Ресурс $stream — открытый канал чтения; stream_get_contents возвращает байты, fclose освобождает его. finally выполняется при успехе и исключении. hash("crc32b", $text) вычисляет контрольную сумму прочитанного текста; hash_equals сравнивает её с записью архива.

<?php
declare(strict_types=1);

require __DIR__ . '/bootstrap.php';
$entry = $archive->getEntry('receipt.txt');
if ($entry === false) { throw new RuntimeException('Нет чека'); }
$stream = $entry->getStream();
if ($stream === false) { throw new RuntimeException('Не открыт поток'); }
try { $text = stream_get_contents($stream, 1025); }
finally { fclose($stream); }
$crc = str_pad(strtolower($entry->getCrc()), 8, '0', STR_PAD_LEFT);
if ($text === false || strlen($text) !== $entry->getUnpackedSize() || !hash_equals($crc, hash('crc32b', $text))) {
    throw new RuntimeException('Не выдаём неполный или повреждённый чек');
}
echo $text;
$archive->close();

Заказ 42
Кисть — 2 шт.
Итого: 300 руб.

Официальный контракт: адаптированная документация PHP Documentation Group, CC BY 3.0 или более поздняя версия. Сохранены правила, параметры, возвраты, ограничения и таблицы; изменены оформление и ссылки, старые условные иллюстрации заменены оригинальными проектами.

Следующая ступень: полный приём документов в новую папку. Результат проверяется отдельным PHP 8.3.35 NTS x64 + PECL rar 4.2.0. Основной PHP 8.5.11 не имеет rar: проверка его синтаксиса не подтверждает выполнение API. Официальная DLL 4.2.0 при старте PHP 8.3 выдаёт предупреждения совместимости __toString/getIterator; они записаны отдельно от результата урока и требуют внимания при выборе окружения.

• PHP: RarEntry::getStream

(PECL rar >= 0.1) · rar

public function RarEntry::getName(): string

Использовать внутреннее имя как подпись документа. getName возвращает UTF-8 имя записи, а не извлечённый путь. Поэтому file_get_contents($entry->getName()) не прочитает архив.

Архив ZIP содержит все входы и полный support.php. readDocument читает не больше 1025 байт, проверяет размер и CRC, затем возвращает настоящий текст. Пошаговый разбор исходников.

<?php
declare(strict_types=1);

require __DIR__ . '/bootstrap.php';
$entry = $archive->getEntry('receipt.txt');
if ($entry === false) { throw new RuntimeException('Нет чека'); }
echo 'Документ ', $entry->getName(), ":\n", readDocument($entry);
$archive->close();

Документ receipt.txt:
Заказ 42
Кисть — 2 шт.
Итого: 300 руб.

Официальный контракт: адаптированная документация PHP Documentation Group, CC BY 3.0 или более поздняя версия. Сохранены правила, параметры, возвраты, ограничения и таблицы; изменены оформление и ссылки, старые условные иллюстрации заменены оригинальными проектами.

Следующая ступень: полный приём документов в новую папку. Результат проверяется отдельным PHP 8.3.35 NTS x64 + PECL rar 4.2.0. Основной PHP 8.5.11 не имеет rar: проверка его синтаксиса не подтверждает выполнение API. Официальная DLL 4.2.0 при старте PHP 8.3 выдаёт предупреждения совместимости __toString/getIterator; они записаны отдельно от результата урока и требуют внимания при выборе окружения.

• PHP: RarEntry::getName

(PECL rar >= 0.1) · rar

public function RarEntry::getAttr(): int

Не переносить чужие права при выдаче документа. Атрибуты имеют смысл только вместе с исходной ОС. Наш вход создан в Linux; выберем только обычный Unix-файл и сохраним копию с собственной политикой прав.

Архив ZIP содержит все входы и полный support.php. readDocument читает не больше 1025 байт, проверяет размер и CRC, затем возвращает настоящий текст. Пошаговый разбор исходников.

<?php
declare(strict_types=1);

require __DIR__ . '/bootstrap.php';
$entry = $archive->getEntry('receipt.txt');
if ($entry === false) { throw new RuntimeException('Нет чека'); }
$host = $entry->getHostOs();
$attributes = $entry->getAttr();
if ($host !== RarEntry::HOST_UNIX || ($attributes & 0170000) !== 0100000) { throw new RuntimeException('Ожидался обычный Unix-файл'); }
$text = readDocument($entry);
file_put_contents(__DIR__ . '/customer-receipt.txt', $text);
echo "Обычный файл из Unix; исходные права не назначаем получателю:\n", $text;
$archive->close();

Обычный файл из Unix; исходные права не назначаем получателю:
Заказ 42
Кисть — 2 шт.
Итого: 300 руб.

Официальный контракт: адаптированная документация PHP Documentation Group, CC BY 3.0 или более поздняя версия. Сохранены правила, параметры, возвраты, ограничения и таблицы; изменены оформление и ссылки, старые условные иллюстрации заменены оригинальными проектами.

Следующая ступень: полный приём документов в новую папку. Результат проверяется отдельным PHP 8.3.35 NTS x64 + PECL rar 4.2.0. Основной PHP 8.5.11 не имеет rar: проверка его синтаксиса не подтверждает выполнение API. Официальная DLL 4.2.0 при старте PHP 8.3 выдаёт предупреждения совместимости __toString/getIterator; они записаны отдельно от результата урока и требуют внимания при выборе окружения.

• PHP: RarEntry::getAttr

(PECL rar >= 0.1) · rar

public function RarEntry::getHostOs(): int

Не переносить чужие права при выдаче документа. Атрибуты имеют смысл только вместе с исходной ОС. Наш вход создан в Linux; выберем только обычный Unix-файл и сохраним копию с собственной политикой прав.

Архив ZIP содержит все входы и полный support.php. readDocument читает не больше 1025 байт, проверяет размер и CRC, затем возвращает настоящий текст. Пошаговый разбор исходников.

<?php
declare(strict_types=1);

require __DIR__ . '/bootstrap.php';
$entry = $archive->getEntry('receipt.txt');
if ($entry === false) { throw new RuntimeException('Нет чека'); }
$host = $entry->getHostOs();
$attributes = $entry->getAttr();
if ($host !== RarEntry::HOST_UNIX || ($attributes & 0170000) !== 0100000) { throw new RuntimeException('Ожидался обычный Unix-файл'); }
$text = readDocument($entry);
file_put_contents(__DIR__ . '/customer-receipt.txt', $text);
echo "Обычный файл из Unix; исходные права не назначаем получателю:\n", $text;
$archive->close();

Обычный файл из Unix; исходные права не назначаем получателю:
Заказ 42
Кисть — 2 шт.
Итого: 300 руб.

Официальный контракт: адаптированная документация PHP Documentation Group, CC BY 3.0 или более поздняя версия. Сохранены правила, параметры, возвраты, ограничения и таблицы; изменены оформление и ссылки, старые условные иллюстрации заменены оригинальными проектами.

Следующая ступень: полный приём документов в новую папку. Результат проверяется отдельным PHP 8.3.35 NTS x64 + PECL rar 4.2.0. Основной PHP 8.5.11 не имеет rar: проверка его синтаксиса не подтверждает выполнение API. Официальная DLL 4.2.0 при старте PHP 8.3 выдаёт предупреждения совместимости __toString/getIterator; они записаны отдельно от результата урока и требуют внимания при выборе окружения.

• PHP: RarEntry::getHostOs

(PECL rar >= 0.1) · rar

public function RarEntry::getCrc(): string

Сверить байты чека с контрольной суммой. Контрольная сумма нужна для решения, можно ли выдавать прочитанный документ. Выведем сам чек только после совпадения.

Архив ZIP содержит все входы и полный support.php. readDocument читает не больше 1025 байт, проверяет размер и CRC, затем возвращает настоящий текст. Пошаговый разбор исходников.

<?php
declare(strict_types=1);

require __DIR__ . '/bootstrap.php';
$entry = $archive->getEntry('receipt.txt');
if ($entry === false) { throw new RuntimeException('Нет чека'); }
$expectedCrc = str_pad(strtolower($entry->getCrc()), 8, '0', STR_PAD_LEFT);
$text = readDocument($entry);
echo 'CRC ', $expectedCrc, " совпал; получатель читает:\n", $text;
$archive->close();

CRC ac0a4bdf совпал; получатель читает:
Заказ 42
Кисть — 2 шт.
Итого: 300 руб.

Официальный контракт: адаптированная документация PHP Documentation Group, CC BY 3.0 или более поздняя версия. Сохранены правила, параметры, возвраты, ограничения и таблицы; изменены оформление и ссылки, старые условные иллюстрации заменены оригинальными проектами.

Следующая ступень: полный приём документов в новую папку. Результат проверяется отдельным PHP 8.3.35 NTS x64 + PECL rar 4.2.0. Основной PHP 8.5.11 не имеет rar: проверка его синтаксиса не подтверждает выполнение API. Официальная DLL 4.2.0 при старте PHP 8.3 выдаёт предупреждения совместимости __toString/getIterator; они записаны отдельно от результата урока и требуют внимания при выборе окружения.

• PHP: RarEntry::getCrc

(PECL rar >= 0.1) · rar

public function RarEntry::getFileTime(): string

Подписать документ временем из архива. Человек видит, какую редакцию ему прислали. Исходный чек получил время 2026-10-14 09:30:00 UTC. Наша Windows в часовом поясе UTC+3 возвращает из RAR строку12:30:00; ниже зафиксирован именно этот наблюдаемый результат.

Архив ZIP содержит все входы и полный support.php. readDocument читает не больше 1025 байт, проверяет размер и CRC, затем возвращает настоящий текст. Пошаговый разбор исходников.

<?php
declare(strict_types=1);

require __DIR__ . '/bootstrap.php';
$entry = $archive->getEntry('receipt.txt');
if ($entry === false) { throw new RuntimeException('Нет чека'); }
echo 'Изменён у отправителя: ', $entry->getFileTime(), "\n", readDocument($entry);
$archive->close();

Изменён у отправителя: 2026-10-14 12:30:00
Заказ 42
Кисть — 2 шт.
Итого: 300 руб.

Официальный контракт: адаптированная документация PHP Documentation Group, CC BY 3.0 или более поздняя версия. Сохранены правила, параметры, возвраты, ограничения и таблицы; изменены оформление и ссылки, старые условные иллюстрации заменены оригинальными проектами.

Следующая ступень: полный приём документов в новую папку. Результат проверяется отдельным PHP 8.3.35 NTS x64 + PECL rar 4.2.0. Основной PHP 8.5.11 не имеет rar: проверка его синтаксиса не подтверждает выполнение API. Официальная DLL 4.2.0 при старте PHP 8.3 выдаёт предупреждения совместимости __toString/getIterator; они записаны отдельно от результата урока и требуют внимания при выборе окружения.

• PHP: RarEntry::getFileTime

(PECL rar >= 0.1) · rar

public function RarEntry::getPackedSize(): int

Проверить лимит перед чтением и выдать документ. Размер хранения и размер после распаковки — разные числа. В нашем orders.rar выбран режим без сжатия; оба размера равны длине UTF-8 чека, но для сжатого входа это не общее правило.

Архив ZIP содержит все входы и полный support.php. readDocument читает не больше 1025 байт, проверяет размер и CRC, затем возвращает настоящий текст. Пошаговый разбор исходников.

<?php
declare(strict_types=1);

require __DIR__ . '/bootstrap.php';
$entry = $archive->getEntry('receipt.txt');
if ($entry === false) { throw new RuntimeException('Нет чека'); }
$stored = $entry->getPackedSize();
$unpacked = $entry->getUnpackedSize();
if ($stored > 32768 || $unpacked > 1024) { throw new RuntimeException('Превышен лимит документа'); }
echo 'Чек: ', $stored, ' байт хранения, ', $unpacked, " байт текста\n", readDocument($entry);
$archive->close();

Чек: 61 байт хранения, 61 байт текста
Заказ 42
Кисть — 2 шт.
Итого: 300 руб.

Версионное уточнение: оговорка старого текста о Windows x64 и 32-битных целых не описывает современный PHP x64. Проверяйте PHP_INT_SIZE/PHP_INT_MAX конкретного процесса; наш PHP 8.3.35 x64 использует 64-битный int. Это не отменяет лимитов памяти и квот распаковки.

Официальный контракт: адаптированная документация PHP Documentation Group, CC BY 3.0 или более поздняя версия. Сохранены правила, параметры, возвраты, ограничения и таблицы; изменены оформление и ссылки, старые условные иллюстрации заменены оригинальными проектами.

Следующая ступень: полный приём документов в новую папку. Результат проверяется отдельным PHP 8.3.35 NTS x64 + PECL rar 4.2.0. Основной PHP 8.5.11 не имеет rar: проверка его синтаксиса не подтверждает выполнение API. Официальная DLL 4.2.0 при старте PHP 8.3 выдаёт предупреждения совместимости __toString/getIterator; они записаны отдельно от результата урока и требуют внимания при выборе окружения.

• PHP: RarEntry::getPackedSize

(PECL rar >= 0.1) · rar

public function RarEntry::getUnpackedSize(): int

Проверить лимит перед чтением и выдать документ. Размер хранения и размер после распаковки — разные числа. В нашем orders.rar выбран режим без сжатия; оба размера равны длине UTF-8 чека, но для сжатого входа это не общее правило.

Архив ZIP содержит все входы и полный support.php. readDocument читает не больше 1025 байт, проверяет размер и CRC, затем возвращает настоящий текст. Пошаговый разбор исходников.

<?php
declare(strict_types=1);

require __DIR__ . '/bootstrap.php';
$entry = $archive->getEntry('receipt.txt');
if ($entry === false) { throw new RuntimeException('Нет чека'); }
$stored = $entry->getPackedSize();
$unpacked = $entry->getUnpackedSize();
if ($stored > 32768 || $unpacked > 1024) { throw new RuntimeException('Превышен лимит документа'); }
echo 'Чек: ', $stored, ' байт хранения, ', $unpacked, " байт текста\n", readDocument($entry);
$archive->close();

Чек: 61 байт хранения, 61 байт текста
Заказ 42
Кисть — 2 шт.
Итого: 300 руб.

Версионное уточнение: оговорка старого текста о Windows x64 и 32-битных целых не описывает современный PHP x64. Проверяйте PHP_INT_SIZE/PHP_INT_MAX конкретного процесса; наш PHP 8.3.35 x64 использует 64-битный int. Это не отменяет лимитов памяти и квот распаковки.

Официальный контракт: адаптированная документация PHP Documentation Group, CC BY 3.0 или более поздняя версия. Сохранены правила, параметры, возвраты, ограничения и таблицы; изменены оформление и ссылки, старые условные иллюстрации заменены оригинальными проектами.

Следующая ступень: полный приём документов в новую папку. Результат проверяется отдельным PHP 8.3.35 NTS x64 + PECL rar 4.2.0. Основной PHP 8.5.11 не имеет rar: проверка его синтаксиса не подтверждает выполнение API. Официальная DLL 4.2.0 при старте PHP 8.3 выдаёт предупреждения совместимости __toString/getIterator; они записаны отдельно от результата урока и требуют внимания при выборе окружения.

• PHP: RarEntry::getUnpackedSize

(PECL rar >= 0.1) · rar

public function RarEntry::getMethod(): int

Сохранить данные для диагностики совместимости. Если другой получатель не может открыть документ, полезны номер способа сжатия и минимальная версия RAR. Сохраняем фактические поля рядом с успешно прочитанным чеком.

Архив ZIP содержит все входы и полный support.php. readDocument читает не больше 1025 байт, проверяет размер и CRC, затем возвращает настоящий текст. Пошаговый разбор исходников.

<?php
declare(strict_types=1);

require __DIR__ . '/bootstrap.php';
$entry = $archive->getEntry('receipt.txt');
if ($entry === false) { throw new RuntimeException('Нет чека'); }
$method = $entry->getMethod();
$version = $entry->getVersion();
file_put_contents(__DIR__ . '/decoder-report.json', json_encode(['method' => $method, 'minimum_rar_version' => $version], JSON_THROW_ON_ERROR));
echo "Параметры декодера сохранены в decoder-report.json; документ прочитан:\n", readDocument($entry);
$archive->close();

Параметры декодера сохранены в decoder-report.json; документ прочитан:
Заказ 42
Кисть — 2 шт.
Итого: 300 руб.

Официальный контракт: адаптированная документация PHP Documentation Group, CC BY 3.0 или более поздняя версия. Сохранены правила, параметры, возвраты, ограничения и таблицы; изменены оформление и ссылки, старые условные иллюстрации заменены оригинальными проектами.

Следующая ступень: полный приём документов в новую папку. Результат проверяется отдельным PHP 8.3.35 NTS x64 + PECL rar 4.2.0. Основной PHP 8.5.11 не имеет rar: проверка его синтаксиса не подтверждает выполнение API. Официальная DLL 4.2.0 при старте PHP 8.3 выдаёт предупреждения совместимости __toString/getIterator; они записаны отдельно от результата урока и требуют внимания при выборе окружения.

• PHP: RarEntry::getMethod

(PECL rar >= 0.1) · rar

public function RarEntry::getVersion(): int

Сохранить данные для диагностики совместимости. Если другой получатель не может открыть документ, полезны номер способа сжатия и минимальная версия RAR. Сохраняем фактические поля рядом с успешно прочитанным чеком.

Архив ZIP содержит все входы и полный support.php. readDocument читает не больше 1025 байт, проверяет размер и CRC, затем возвращает настоящий текст. Пошаговый разбор исходников.

<?php
declare(strict_types=1);

require __DIR__ . '/bootstrap.php';
$entry = $archive->getEntry('receipt.txt');
if ($entry === false) { throw new RuntimeException('Нет чека'); }
$method = $entry->getMethod();
$version = $entry->getVersion();
file_put_contents(__DIR__ . '/decoder-report.json', json_encode(['method' => $method, 'minimum_rar_version' => $version], JSON_THROW_ON_ERROR));
echo "Параметры декодера сохранены в decoder-report.json; документ прочитан:\n", readDocument($entry);
$archive->close();

Параметры декодера сохранены в decoder-report.json; документ прочитан:
Заказ 42
Кисть — 2 шт.
Итого: 300 руб.

Официальный контракт: адаптированная документация PHP Documentation Group, CC BY 3.0 или более поздняя версия. Сохранены правила, параметры, возвраты, ограничения и таблицы; изменены оформление и ссылки, старые условные иллюстрации заменены оригинальными проектами.

Следующая ступень: полный приём документов в новую папку. Результат проверяется отдельным PHP 8.3.35 NTS x64 + PECL rar 4.2.0. Основной PHP 8.5.11 не имеет rar: проверка его синтаксиса не подтверждает выполнение API. Официальная DLL 4.2.0 при старте PHP 8.3 выдаёт предупреждения совместимости __toString/getIterator; они записаны отдельно от результата урока и требуют внимания при выборе окружения.

• PHP: RarEntry::getVersion

(PECL rar >= 2.0.0) · rar

public function RarEntry::isDirectory(): bool

Показать папку и отдельно её документы. directories.rar содержит пустую acts и чек. Каталог не читают как текст: выводим его назначение, а для файла получаем содержимое.

Архив ZIP содержит все входы и полный support.php. readDocument читает не больше 1025 байт, проверяет размер и CRC, затем возвращает настоящий текст. Пошаговый разбор исходников.

<?php
declare(strict_types=1);

require __DIR__ . '/support.php';
$archive = RarArchive::open(__DIR__ . '/input/directories.rar');
if ($archive === false) { throw new RuntimeException('Не открыт вход'); }
foreach ($archive as $entry) {
    if ($entry->isDirectory()) { echo 'Папка для документов: ', $entry->getName(), "\n"; }
    else { echo $entry->getName(), ":\n", readDocument($entry); }
}
$archive->close();

receipt.txt:
Заказ 42
Кисть — 2 шт.
Итого: 300 руб.
Папка для документов: acts

Официальный контракт: адаптированная документация PHP Documentation Group, CC BY 3.0 или более поздняя версия. Сохранены правила, параметры, возвраты, ограничения и таблицы; изменены оформление и ссылки, старые условные иллюстрации заменены оригинальными проектами.

<?php
//...
//Откроем файл, получим запись и сохраним в переменной $e...
//...

$isDirectory = (bool) ((($e->getHostOs() == RAR_HOST_WIN32) && ($e->getAttr() & 0x10)) ||
    (($e->getHostOs() == RAR_HOST_UNIX) && (($e->getAttr() & 0xf000) == 0x4000)));
?>

Следующая ступень: полный приём документов в новую папку. Результат проверяется отдельным PHP 8.3.35 NTS x64 + PECL rar 4.2.0. Основной PHP 8.5.11 не имеет rar: проверка его синтаксиса не подтверждает выполнение API. Официальная DLL 4.2.0 при старте PHP 8.3 выдаёт предупреждения совместимости __toString/getIterator; они записаны отдельно от результата урока и требуют внимания при выборе окружения.

• PHP: RarEntry::isDirectory

(PECL rar >= 2.0.0) · rar

public function RarEntry::isEncrypted(): bool

Запросить пароль для защищённого чека. В encrypted.rar имя видно без пароля, но байты защищены. Проверка выбирает путь с учебным паролем, extract выполняет проверку внутри декодера, а полученный файл дополнительно сравнивается с нашим оригиналом.

Архив ZIP содержит все входы и полный support.php. readDocument читает не больше 1025 байт, проверяет размер и CRC, затем возвращает настоящий текст. Пошаговый разбор исходников.

<?php
declare(strict_types=1);

require __DIR__ . '/support.php';
$archive = RarArchive::open(__DIR__ . '/input/encrypted.rar');
if ($archive === false) { throw new RuntimeException('Не открыт вход'); }
$entry = $archive->getEntry('receipt.txt');
if ($entry === false) { throw new RuntimeException('Нет чека'); }
if (!$entry->isEncrypted()) { throw new RuntimeException('Ожидался защищённый чек'); }
$target = __DIR__ . '/protected-receipt.txt';
if (file_exists($target) || !$entry->extract('', $target, 'Lesson42', false)) { throw new RuntimeException('Не извлечён защищённый чек'); }
$text = file_get_contents($target);
if ($text !== file_get_contents(__DIR__ . '/input/receipt.txt')) { throw new RuntimeException('Не совпал исходный документ'); }
echo "Для чека нужен пароль; после его ввода получено:\n", $text;
$archive->close();

Для чека нужен пароль; после его ввода получено:
Заказ 42
Кисть — 2 шт.
Итого: 300 руб.

Официальный контракт: адаптированная документация PHP Documentation Group, CC BY 3.0 или более поздняя версия. Сохранены правила, параметры, возвраты, ограничения и таблицы; изменены оформление и ссылки, старые условные иллюстрации заменены оригинальными проектами.

Следующая ступень: полный приём документов в новую папку. Результат проверяется отдельным PHP 8.3.35 NTS x64 + PECL rar 4.2.0. Основной PHP 8.5.11 не имеет rar: проверка его синтаксиса не подтверждает выполнение API. Официальная DLL 4.2.0 при старте PHP 8.3 выдаёт предупреждения совместимости __toString/getIterator; они записаны отдельно от результата урока и требуют внимания при выборе окружения.

• PHP: RarEntry::isEncrypted

(PECL rar >= 2.0.0) · rar

public function RarEntry::__toString(): string

Сохранить описание записи и выдать её содержимое. Строковое представление полезно в диагностике. Содержимое документа читается отдельным API и не подменяется строкой RarEntry for file.

Архив ZIP содержит все входы и полный support.php. readDocument читает не больше 1025 байт, проверяет размер и CRC, затем возвращает настоящий текст. Пошаговый разбор исходников.

<?php
declare(strict_types=1);

require __DIR__ . '/bootstrap.php';
$entry = $archive->getEntry('receipt.txt');
if ($entry === false) { throw new RuntimeException('Нет чека'); }
file_put_contents(__DIR__ . '/entry-diagnostic.txt', (string) $entry . "\n");
echo "Описание записи сохранено в entry-diagnostic.txt; сам чек:\n", readDocument($entry);
$archive->close();

Описание записи сохранено в entry-diagnostic.txt; сам чек:
Заказ 42
Кисть — 2 шт.
Итого: 300 руб.

Официальный контракт: адаптированная документация PHP Documentation Group, CC BY 3.0 или более поздняя версия. Сохранены правила, параметры, возвраты, ограничения и таблицы; изменены оформление и ссылки, старые условные иллюстрации заменены оригинальными проектами.

Следующая ступень: полный приём документов в новую папку. Результат проверяется отдельным PHP 8.3.35 NTS x64 + PECL rar 4.2.0. Основной PHP 8.5.11 не имеет rar: проверка его синтаксиса не подтверждает выполнение API. Официальная DLL 4.2.0 при старте PHP 8.3 выдаёт предупреждения совместимости __toString/getIterator; они записаны отдельно от результата урока и требуют внимания при выборе окружения.

• PHP: RarEntry::__toString

(PECL rar >= 2.0.0) · rar

public static function RarException::setUsingExceptions(bool $using_exceptions): void

Превратить ошибку открытия в понятное сообщение. Режим исключений позволяет остановить ошибочный путь и показать человеку действие: выбрать существующий файл. В конце восстанавливаем прежний режим библиотеки.

Архив ZIP содержит все входы и полный support.php. readDocument читает не больше 1025 байт, проверяет размер и CRC, затем возвращает настоящий текст. Пошаговый разбор исходников.

<?php
declare(strict_types=1);

require __DIR__ . '/support.php';
$previous = RarException::isUsingExceptions();
RarException::setUsingExceptions(true);
try {
    RarArchive::open(__DIR__ . '/input/absent.rar');
} catch (RarException $error) {
    file_put_contents(__DIR__ . '/rar-error.txt', $error->getMessage());
    echo "Файл поставки отсутствует; уточните путь. Диагностика — rar-error.txt\n";
} finally { RarException::setUsingExceptions($previous); }
$archive = RarArchive::open(__DIR__ . '/input/orders.rar');
if ($archive === false) { throw new RuntimeException('Нет исправного входа'); }
$entry = $archive->getEntry('receipt.txt');
if ($entry === false) { throw new RuntimeException('Чек не приложен'); }
echo readDocument($entry);
$archive->close();

Файл поставки отсутствует; уточните путь. Диагностика — rar-error.txt
Заказ 42
Кисть — 2 шт.
Итого: 300 руб.

Официальный контракт: адаптированная документация PHP Documentation Group, CC BY 3.0 или более поздняя версия. Сохранены правила, параметры, возвраты, ограничения и таблицы; изменены оформление и ссылки, старые условные иллюстрации заменены оригинальными проектами.

Следующая ступень: полный приём документов в новую папку. Результат проверяется отдельным PHP 8.3.35 NTS x64 + PECL rar 4.2.0. Основной PHP 8.5.11 не имеет rar: проверка его синтаксиса не подтверждает выполнение API. Официальная DLL 4.2.0 при старте PHP 8.3 выдаёт предупреждения совместимости __toString/getIterator; они записаны отдельно от результата урока и требуют внимания при выборе окружения.

• PHP: RarException::setUsingExceptions

(PECL rar >= 2.0.0) · rar

public static function RarException::isUsingExceptions(): bool

Превратить ошибку открытия в понятное сообщение. Режим исключений позволяет остановить ошибочный путь и показать человеку действие: выбрать существующий файл. В конце восстанавливаем прежний режим библиотеки.

Архив ZIP содержит все входы и полный support.php. readDocument читает не больше 1025 байт, проверяет размер и CRC, затем возвращает настоящий текст. Пошаговый разбор исходников.

<?php
declare(strict_types=1);

require __DIR__ . '/support.php';
$previous = RarException::isUsingExceptions();
RarException::setUsingExceptions(true);
try {
    RarArchive::open(__DIR__ . '/input/absent.rar');
} catch (RarException $error) {
    file_put_contents(__DIR__ . '/rar-error.txt', $error->getMessage());
    echo "Файл поставки отсутствует; уточните путь. Диагностика — rar-error.txt\n";
} finally { RarException::setUsingExceptions($previous); }
$archive = RarArchive::open(__DIR__ . '/input/orders.rar');
if ($archive === false) { throw new RuntimeException('Нет исправного входа'); }
$entry = $archive->getEntry('receipt.txt');
if ($entry === false) { throw new RuntimeException('Чек не приложен'); }
echo readDocument($entry);
$archive->close();

Файл поставки отсутствует; уточните путь. Диагностика — rar-error.txt
Заказ 42
Кисть — 2 шт.
Итого: 300 руб.

Официальный контракт: адаптированная документация PHP Documentation Group, CC BY 3.0 или более поздняя версия. Сохранены правила, параметры, возвраты, ограничения и таблицы; изменены оформление и ссылки, старые условные иллюстрации заменены оригинальными проектами.

Следующая ступень: полный приём документов в новую папку. Результат проверяется отдельным PHP 8.3.35 NTS x64 + PECL rar 4.2.0. Основной PHP 8.5.11 не имеет rar: проверка его синтаксиса не подтверждает выполнение API. Официальная DLL 4.2.0 при старте PHP 8.3 выдаёт предупреждения совместимости __toString/getIterator; они записаны отдельно от результата урока и требуют внимания при выборе окружения.

• PHP: RarException::isUsingExceptions

(PECL rar >= 3.0.0) · rar

function rar_wrapper_cache_stats(): string

Снять диагностические показания около реального чтения. Функция помогает наблюдать внутренний кеш обёртки. Полезная операция — чтение нашего чека через rar://; диагностический формат не используется в логике выдачи.

Архив ZIP содержит все входы и полный support.php. readDocument читает не больше 1025 байт, проверяет размер и CRC, затем возвращает настоящий текст. Пошаговый разбор исходников.

<?php
declare(strict_types=1);

require __DIR__ . '/support.php';
$path = __DIR__ . '/input/orders.rar';
$url = 'rar://' . rawurlencode($path) . '#' . rawurlencode('receipt.txt');
$before = rar_wrapper_cache_stats();
$text = file_get_contents($url);
if ($text === false || $text !== file_get_contents(__DIR__ . '/input/receipt.txt')) { throw new RuntimeException('Не получен исходный чек'); }
$after = rar_wrapper_cache_stats();
file_put_contents(__DIR__ . '/wrapper-cache.txt', $before . "\n" . $after . "\n");
echo "Чек прочитан через rar://; диагностика кеша — wrapper-cache.txt:\n", $text;

Чек прочитан через rar://; диагностика кеша — wrapper-cache.txt:
Заказ 42
Кисть — 2 шт.
Итого: 300 руб.

Официальная страница пока не описывает формат результата. Поэтому пример сохраняет диагностическую строку как непрозрачный текст, не разбирает её на обещанные поля и проверяет полезный результат отдельным чтением документа.

Официальный контракт: адаптированная документация PHP Documentation Group, CC BY 3.0 или более поздняя версия. Сохранены правила, параметры, возвраты, ограничения и таблицы; изменены оформление и ссылки, старые условные иллюстрации заменены оригинальными проектами.

Следующая ступень: полный приём документов в новую папку. Результат проверяется отдельным PHP 8.3.35 NTS x64 + PECL rar 4.2.0. Основной PHP 8.5.11 не имеет rar: проверка его синтаксиса не подтверждает выполнение API. Официальная DLL 4.2.0 при старте PHP 8.3 выдаёт предупреждения совместимости __toString/getIterator; они записаны отдельно от результата урока и требуют внимания при выборе окружения.

• PHP: rar_wrapper_cache_stats