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

<?php
$path = __DIR__ . '/message.gz';
$context = stream_context_create(['zlib' => ['level' => 9]]);
$written = file_put_contents('compress.zlib://' . $path, "Заказ готов\n", 0, $context);
if ($written === false) {
    throw new RuntimeException('Не удалось создать gzip');
}

$text = file_get_contents('compress.zlib://' . $path);
echo $text;
unlink($path);

Заказ готов

Опция zlib.level принимает целое от 0 до 9 и применяется при записи: 0 не сжимает, 9 тратит больше работы ради максимального сжатия. Уровень не меняет распакованный текст. Эта context option доступна с PHP 7.3.

<?php
$context = stream_context_create([
    'zip' => ['password' => getenv('ARCHIVE_PASSWORD') ?: ''],
]);

$report = file_get_contents(
    'zip://' . __DIR__ . '/private.zip#report.csv',
    false,
    $context,
);
if ($report === false) {
    throw new RuntimeException('Элемент ZIP не прочитан');
}
echo $report;

Контекстный пример требует ext-zip, подготовленный архив и пароль из защищённого окружения. Опция zip.password появилась в PHP 7.2 / PECL zip 1.14.0. Она помогает открыть архив, но слабое ZIP-шифрование не превращается в безопасное хранилище секретов.

<?php
$events = [];
$context = stream_context_create();

stream_context_set_params($context, [
    'notification' => static function (
        int $code,
        int $severity,
        ?string $message,
        int $messageCode,
        int $bytesTransferred,
        int $bytesMax,
    ) use (&$events): void {
        $events[] = [$code, $bytesTransferred, $bytesMax];
    },
]);

$params = stream_context_get_params($context);
echo is_callable($params['notification']) ? "Callback установлен\n" : "Callback отсутствует\n";

Callback установлен

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

<?php
$context = stream_context_create([
    'phar' => [
        'compress' => Phar::GZ,
        'metadata' => ['project' => 'catalog', 'version' => 3],
    ],
]);

$options = stream_context_get_options($context);
echo $options['phar']['metadata']['project'], "\n";
echo $options['phar']['metadata']['version'], "\n";

catalog
3

compress принимает одну из поддерживаемых Phar-констант сжатия, а metadata — произвольные метаданные архива. Опыт показывает форму настроек и ничего не записывает на диск.

<?php
$context = stream_context_create([
    'ftp' => [
        'resume_pos' => 4096,
        'proxy' => 'tcp://proxy.internal:8080',
        'overwrite' => false,
    ],
]);

$options = stream_context_get_options($context)['ftp'];
echo $options['resume_pos'], "\n";
echo $options['overwrite'] ? "Перезапись включена\n" : "Перезапись запрещена\n";

4096
Перезапись запрещена

Опыт не соединяется с FTP и только показывает типы опций. resume_pos задаёт позицию чтения, proxy применяется к чтению через HTTP-прокси, overwrite разрешает перезапись при записи; по умолчанию она запрещена.

<?php
$context = stream_context_create([
    'socket' => [
        'bindto' => '0:0',
        'tcp_nodelay' => true,
        'so_reuseport' => false,
    ],
]);

$options = stream_context_get_options($context)['socket'];
echo $options['bindto'], "\n";
echo $options['tcp_nodelay'] ? "TCP_NODELAY включён\n" : "TCP_NODELAY выключен\n";

0:0
TCP_NODELAY включён

bindto выбирает локальный адрес/порт, а tcp_nodelay отключает алгоритм Нейгла для подходящего TCP-соединения. Контекст не открывает socket сам: он лишь передаётся в stream_socket_client/server.