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

<?php
declare(strict_types=1);

$invoice = file_get_contents(__DIR__ . '/invoice.txt');
$privateKey = file_get_contents(__DIR__ . '/publisher-private.pem');
if (!openssl_sign($invoice, $signature, $privateKey, OPENSSL_ALGO_SHA256)) {
    throw new RuntimeException('Не удалось подписать накладную');
}
$publicKey = file_get_contents(__DIR__ . '/publisher-public.pem');
echo openssl_verify($invoice, $signature, $publicKey, OPENSSL_ALGO_SHA256) === 1
    ? "Накладная подписана: Заказ A1: 1200 RUB\n" : "Проверка не пройдена\n";

Накладная подписана: Заказ A1: 1200 RUB

Функция записывает подпись в переменную $signature; её не нужно создавать заранее. Возвращаемое bool говорит об успехе самой операции. Текст накладной остаётся исходным. Закрытый fixture-ключ опубликован только для воспроизводимого урока.

<?php
declare(strict_types=1);

$invoice = file_get_contents(__DIR__ . '/invoice.txt');
$privateKey = file_get_contents(__DIR__ . '/publisher-private.pem');
if (!openssl_sign($invoice, $signature, $privateKey, OPENSSL_ALGO_SHA256, OPENSSL_PKCS1_PSS_PADDING)) {
    throw new RuntimeException('Подпись не создана');
}
if (file_put_contents(__DIR__ . '/invoice.pss.b64', base64_encode($signature)) === false) {
    throw new RuntimeException('Подпись не сохранена');
}
$stored = base64_decode(file_get_contents(__DIR__ . '/invoice.pss.b64'), true);
$publicKey = file_get_contents(__DIR__ . '/publisher-public.pem');
echo openssl_verify($invoice, $stored, $publicKey, OPENSSL_ALGO_SHA256, OPENSSL_PKCS1_PSS_PADDING) === 1
    ? "invoice.pss.b64: сохранённая подпись подтверждает накладную A1\n" : "Подпись файла отклонена\n";

invoice.pss.b64: сохранённая подпись подтверждает накладную A1

PHP 8.5+ добавляет пятый аргумент padding. Обе стороны выбрали RSA-PSS и SHA-256. В файле лежит Base64, а openssl_verify получает декодированные байты. Сама PSS-подпись при повторном запуске может отличаться; проверяем её действие, не придумываем постоянную подпись.

<?php
declare(strict_types=1);

$invoice = file_get_contents(__DIR__ . '/invoice.txt');
$signature = base64_decode(file_get_contents(__DIR__ . '/invoice.sig.b64'), true);
$publicKey = file_get_contents(__DIR__ . '/publisher-public.pem');
$result = openssl_verify($invoice, $signature, $publicKey, OPENSSL_ALGO_SHA256);
echo $result === 1 ? "Принять накладную A1: подпись поставщика верна\n" : "Не принимать накладную\n";

Принять накладную A1: подпись поставщика верна

Возврат сравнивается строго с 1. Если подпись записана Base64, сначала декодируйте её. Открытый ключ должен быть получен независимо от недоверенного сообщения.

<?php
declare(strict_types=1);

$invoice = file_get_contents(__DIR__ . '/invoice.txt');
$signature = base64_decode(file_get_contents(__DIR__ . '/invoice.sig.b64'), true);
$key = file_get_contents(__DIR__ . '/publisher-public.pem');
foreach (['Исходник' => $invoice, 'Сумма 9000' => str_replace('1200', '9000', $invoice)] as $label => $data) {
    $result = openssl_verify($data, $signature, $key, OPENSSL_ALGO_SHA256);
    if ($result === 1) { echo $label, ": принять\n"; }
    elseif ($result === 0) { echo $label, ": отклонить, подпись не подходит\n"; }
    else { throw new RuntimeException('Проверка подписи не выполнена'); }
}

Исходник: принять
Сумма 9000: отклонить, подпись не подходит

Та же подпись проверена по двум наборам байтов. 0 — математически неподходящая подпись; false/-1 — ошибка самой проверки. Не превращайте любой truthy результат в разрешение: -1 тоже truthy.

<?php
declare(strict_types=1);

$options = ['config' => __DIR__ . '/openssl.cnf', 'private_key_type' => OPENSSL_KEYTYPE_RSA, 'private_key_bits' => 2048];

$key = openssl_pkey_new($options);
if ($key === false) { throw new RuntimeException('Ключ не создан'); }
if (!openssl_sign('Накладная A2', $signature, $key, OPENSSL_ALGO_SHA256)) { throw new RuntimeException('Подпись не создана'); }
$public = openssl_pkey_get_details($key)['key'];
echo openssl_verify('Накладная A2', $signature, $public, OPENSSL_ALGO_SHA256) === 1
    ? "Новая пара RSA: накладная A2 проверена\n" : "Проверка не пройдена\n";

Новая пара RSA: накладная A2 проверена

private_key_type выбирает RSA, private_key_bits — размер в битах. Настройки читаются из локального openssl.cnf, входящего в архив. Ключ создаётся заново при каждом запуске; нужный для следующих запусков ключ отдельно экспортируют.

<?php
declare(strict_types=1);

$key = openssl_pkey_new(['config' => __DIR__ . '/openssl.cnf', 'private_key_type' => OPENSSL_KEYTYPE_EC, 'curve_name' => 'prime256v1']);
if ($key === false || !openssl_sign('Остаток A1: 4', $signature, $key, OPENSSL_ALGO_SHA256)) { throw new RuntimeException('EC-подпись не создана'); }
$details = openssl_pkey_get_details($key);
echo 'Кривая издателя: ', $details['ec']['curve_name'], "\n";
echo openssl_verify('Остаток A1: 4', $signature, $details['key'], OPENSSL_ALGO_SHA256) === 1
    ? "Изменение остатка подтверждено\n" : "Проверка не пройдена\n";

Кривая издателя: prime256v1
Изменение остатка подтверждено

Кривая — именованный набор математических параметров, выбранный совместимым протоколом. Не заменяйте имя на произвольное без соглашения с получателем. Доступность имён показывает openssl_get_curve_names.

<?php
declare(strict_types=1);

$key = openssl_pkey_get_public(file_get_contents(__DIR__ . '/publisher-public.pem'));

if ($key === false) { throw new RuntimeException('Открытый ключ не прочитан'); }
$data = file_get_contents(__DIR__ . '/invoice.txt');
$signature = base64_decode(file_get_contents(__DIR__ . '/invoice.sig.b64'), true);
echo openssl_verify($data, $signature, $key, OPENSSL_ALGO_SHA256) === 1
    ? "A1: проверено ключом из publisher-public.pem\n" : "Накладная отклонена\n";

A1: проверено ключом из publisher-public.pem

Объект можно повторно передавать проверяющим функциям. Наличие корректного PEM ещё не устанавливает личность владельца.

<?php
declare(strict_types=1);

$key = openssl_pkey_get_public('file://' . __DIR__ . '/publisher-cert.pem');

if ($key === false) { throw new RuntimeException('Сертификат не дал открытый ключ'); }
$signature = base64_decode(file_get_contents(__DIR__ . '/invoice.sig.b64'), true);
echo openssl_verify(file_get_contents(__DIR__ . '/invoice.txt'), $signature, $key, OPENSSL_ALGO_SHA256) === 1
    ? "A1: подпись соответствует ключу сертификата\n" : "Накладная отклонена\n";

A1: подпись соответствует ключу сертификата

file:// отличает адрес PEM от его содержимого. Здесь извлечён ключ и проверена подпись; цепочка доверия, срок и назначение сертификата ещё не проверялись.

<?php
declare(strict_types=1);

$key = openssl_get_publickey(file_get_contents(__DIR__ . '/publisher-public.pem'));

if ($key === false) { throw new RuntimeException('Открытый ключ не прочитан'); }
$data = file_get_contents(__DIR__ . '/invoice.txt');
$signature = base64_decode(file_get_contents(__DIR__ . '/invoice.sig.b64'), true);
echo openssl_verify($data, $signature, $key, OPENSSL_ALGO_SHA256) === 1
    ? "A1: проверено ключом из publisher-public.pem\n" : "Накладная отклонена\n";

A1: проверено ключом из publisher-public.pem

Объект можно повторно передавать проверяющим функциям. Наличие корректного PEM ещё не устанавливает личность владельца.

<?php
declare(strict_types=1);

$key = openssl_get_publickey('file://' . __DIR__ . '/publisher-cert.pem');

if ($key === false) { throw new RuntimeException('Сертификат не дал открытый ключ'); }
$signature = base64_decode(file_get_contents(__DIR__ . '/invoice.sig.b64'), true);
echo openssl_verify(file_get_contents(__DIR__ . '/invoice.txt'), $signature, $key, OPENSSL_ALGO_SHA256) === 1
    ? "A1: подпись соответствует ключу сертификата\n" : "Накладная отклонена\n";

A1: подпись соответствует ключу сертификата

file:// отличает адрес PEM от его содержимого. Здесь извлечён ключ и проверена подпись; цепочка доверия, срок и назначение сертификата ещё не проверялись.

<?php
declare(strict_types=1);

$key = openssl_pkey_get_private(file_get_contents(__DIR__ . '/publisher-private.pem'));

if ($key === false) { throw new RuntimeException('Ключ издателя не прочитан'); }
if (!openssl_sign('Накладная A3', $signature, $key, OPENSSL_ALGO_SHA256)) { throw new RuntimeException('Подпись не создана'); }
$public = file_get_contents(__DIR__ . '/publisher-public.pem');
echo openssl_verify('Накладная A3', $signature, $public, OPENSSL_ALGO_SHA256) === 1
    ? "A3: ключ прочитан, документ подписан\n" : "Проверка не пройдена\n";

A3: ключ прочитан, документ подписан

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

<?php
declare(strict_types=1);

$original = file_get_contents(__DIR__ . '/publisher-private.pem');
if (!openssl_pkey_export($original, $protected, 'lab-password', ['config' => __DIR__ . '/openssl.cnf'])) { throw new RuntimeException('Экспорт не выполнен'); }
$wrong = openssl_pkey_get_private($protected, 'wrong-password');
$key = openssl_pkey_get_private($protected, 'lab-password');

echo $wrong === false ? "Чужой пароль: ключ не открыт\n" : "Неожиданный результат\n";
if ($key === false || !openssl_sign('A4', $signature, $key, OPENSSL_ALGO_SHA256)) { throw new RuntimeException('Подпись не создана'); }
echo "Верный пароль: A4 подписан\n";

Чужой пароль: ключ не открыт
Верный пароль: A4 подписан

Пароль защищает PEM на хранении. После успешного чтения объект уже пригоден к подписи; передавать пароль каждой операции не нужно. lab-password — известный учебный пароль, не шаблон рабочего секрета.

<?php
declare(strict_types=1);

$key = openssl_get_privatekey(file_get_contents(__DIR__ . '/publisher-private.pem'));

if ($key === false) { throw new RuntimeException('Ключ издателя не прочитан'); }
if (!openssl_sign('Накладная A3', $signature, $key, OPENSSL_ALGO_SHA256)) { throw new RuntimeException('Подпись не создана'); }
$public = file_get_contents(__DIR__ . '/publisher-public.pem');
echo openssl_verify('Накладная A3', $signature, $public, OPENSSL_ALGO_SHA256) === 1
    ? "A3: ключ прочитан, документ подписан\n" : "Проверка не пройдена\n";

A3: ключ прочитан, документ подписан

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

<?php
declare(strict_types=1);

$original = file_get_contents(__DIR__ . '/publisher-private.pem');
if (!openssl_pkey_export($original, $protected, 'lab-password', ['config' => __DIR__ . '/openssl.cnf'])) { throw new RuntimeException('Экспорт не выполнен'); }
$wrong = openssl_get_privatekey($protected, 'wrong-password');
$key = openssl_get_privatekey($protected, 'lab-password');

echo $wrong === false ? "Чужой пароль: ключ не открыт\n" : "Неожиданный результат\n";
if ($key === false || !openssl_sign('A4', $signature, $key, OPENSSL_ALGO_SHA256)) { throw new RuntimeException('Подпись не создана'); }
echo "Верный пароль: A4 подписан\n";

Чужой пароль: ключ не открыт
Верный пароль: A4 подписан

Пароль защищает PEM на хранении. После успешного чтения объект уже пригоден к подписи; передавать пароль каждой операции не нужно. lab-password — известный учебный пароль, не шаблон рабочего секрета.

<?php
declare(strict_types=1);

$key = openssl_pkey_get_private(file_get_contents(__DIR__ . '/publisher-private.pem'));
$details = openssl_pkey_get_details($key);
if ($details === false) { throw new RuntimeException('Параметры ключа не прочитаны'); }
echo 'Назначение: издатель каталога', "\n", 'Тип: ', $details['type'] === OPENSSL_KEYTYPE_RSA ? 'RSA' : 'другой', "\n";
echo 'Размер: ', $details['bits'], " бит\n";
echo strtok($details['key'], "\n"), "\n";

Назначение: издатель каталога
Тип: RSA
Размер: 2048 бит
-----BEGIN PUBLIC KEY-----

Показаны только отобранные несекретные поля. key — публичный PEM даже тогда, когда входной объект содержит закрытую часть. Длина/тип — проверка согласованного формата, не доказательство доверия.

<?php
declare(strict_types=1);

$private = openssl_pkey_get_private(file_get_contents(__DIR__ . '/publisher-private.pem'));
$details = openssl_pkey_get_details($private);
if ($details === false || file_put_contents(__DIR__ . '/public.pem', $details['key']) === false) { throw new RuntimeException('Публичный файл не сохранён'); }
$signature = base64_decode(file_get_contents(__DIR__ . '/invoice.sig.b64'), true);
echo openssl_verify(file_get_contents(__DIR__ . '/invoice.txt'), $signature, file_get_contents(__DIR__ . '/public.pem'), OPENSSL_ALGO_SHA256) === 1
    ? "public.pem: получатель проверил накладную A1\n" : "Накладная отклонена\n";

public.pem: получатель проверил накладную A1

В файл передана только key, не весь массив details и не экспорт закрытого ключа. Передачу public.pem по доверенному каналу организует приложение.

<?php
declare(strict_types=1);

$private = file_get_contents(__DIR__ . '/publisher-private.pem');
if (!openssl_pkey_export($private, $pem, 'lab-password', ['config' => __DIR__ . '/openssl.cnf'])) { throw new RuntimeException('Ключ не экспортирован'); }

echo strtok($pem, "\n"), "\n";
$loaded = openssl_pkey_get_private($pem, 'lab-password');
if ($loaded === false || !openssl_sign('A5', $signature, $loaded, OPENSSL_ALGO_SHA256)) { throw new RuntimeException('Экспорт не удалось использовать'); }
echo "A5 подписан повторно прочитанным ключом\n";

-----BEGIN ENCRYPTED PRIVATE KEY-----
A5 подписан повторно прочитанным ключом

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

<?php
declare(strict_types=1);

$private = openssl_pkey_get_private(file_get_contents(__DIR__ . '/publisher-private.pem'));
if (!openssl_pkey_export($private, $pem, 'lab-password', ['config' => __DIR__ . '/openssl.cnf'])) { throw new RuntimeException('Ключ не экспортирован'); }

$protectedKey = openssl_pkey_get_private($pem, 'lab-password');
if (!openssl_pkey_export($protectedKey, $rotated, 'new-lab-password', ['config' => __DIR__ . '/openssl.cnf'])) { throw new RuntimeException('Повторный экспорт не удался'); }

$loaded = openssl_pkey_get_private($rotated, 'new-lab-password');
if ($loaded === false || !openssl_sign('A6', $signature, $loaded, OPENSSL_ALGO_SHA256)) { throw new RuntimeException('Новый пароль не открыл ключ'); }
echo openssl_verify('A6', $signature, file_get_contents(__DIR__ . '/publisher-public.pem'), OPENSSL_ALGO_SHA256) === 1
    ? "Пароль хранения изменён; прежний открытый ключ проверяет A6\n" : "Ключи не соответствуют\n";

Пароль хранения изменён; прежний открытый ключ проверяет A6

Меняется пароль оболочки, а не математическая пара. Для настоящей ротации ключевой пары нужно создать новый ключ и согласованно обновить доверие у получателей. В примере используются отдельные файлы/переменные, рабочий ключ не перезаписывается.

<?php
declare(strict_types=1);

$private = file_get_contents(__DIR__ . '/publisher-private.pem');
if (!openssl_pkey_export_to_file($private, __DIR__ . '/protected.pem', 'lab-password', ['config' => __DIR__ . '/openssl.cnf'])) { throw new RuntimeException('Ключ не экспортирован'); }
$pem = file_get_contents(__DIR__ . '/protected.pem');

echo strtok($pem, "\n"), "\n";
$loaded = openssl_pkey_get_private($pem, 'lab-password');
if ($loaded === false || !openssl_sign('A5', $signature, $loaded, OPENSSL_ALGO_SHA256)) { throw new RuntimeException('Экспорт не удалось использовать'); }
echo "A5 подписан повторно прочитанным ключом\n";

-----BEGIN ENCRYPTED PRIVATE KEY-----
A5 подписан повторно прочитанным ключом

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

<?php
declare(strict_types=1);

$private = openssl_pkey_get_private(file_get_contents(__DIR__ . '/publisher-private.pem'));
if (!openssl_pkey_export_to_file($private, __DIR__ . '/protected.pem', 'lab-password', ['config' => __DIR__ . '/openssl.cnf'])) { throw new RuntimeException('Ключ не экспортирован'); }
$pem = file_get_contents(__DIR__ . '/protected.pem');

$protectedKey = openssl_pkey_get_private($pem, 'lab-password');
if (!openssl_pkey_export_to_file($protectedKey, __DIR__ . '/rotated.pem', 'new-lab-password', ['config' => __DIR__ . '/openssl.cnf'])) { throw new RuntimeException('Повторный экспорт не удался'); }
$rotated = file_get_contents(__DIR__ . '/rotated.pem');

$loaded = openssl_pkey_get_private($rotated, 'new-lab-password');
if ($loaded === false || !openssl_sign('A6', $signature, $loaded, OPENSSL_ALGO_SHA256)) { throw new RuntimeException('Новый пароль не открыл ключ'); }
echo openssl_verify('A6', $signature, file_get_contents(__DIR__ . '/publisher-public.pem'), OPENSSL_ALGO_SHA256) === 1
    ? "Пароль хранения изменён; прежний открытый ключ проверяет A6\n" : "Ключи не соответствуют\n";

Пароль хранения изменён; прежний открытый ключ проверяет A6

Меняется пароль оболочки, а не математическая пара. Для настоящей ротации ключевой пары нужно создать новый ключ и согласованно обновить доверие у получателей. В примере используются отдельные файлы/переменные, рабочий ключ не перезаписывается.

<?php
declare(strict_types=1);

$key = openssl_pkey_get_private(file_get_contents(__DIR__ . '/publisher-private.pem'));
set_error_handler(static function (int $level): bool {
    if ($level === E_DEPRECATED) { echo "Устаревший вызов: объект освобождается автоматически\n"; return true; }
    return false;
});
try { openssl_pkey_free($key); } finally { restore_error_handler(); }
if (!openssl_sign('A7', $signature, $key, OPENSSL_ALGO_SHA256)) { throw new RuntimeException('Подпись не создана'); }
echo "После free объект всё ещё подписывает A7\n";

Устаревший вызов: объект освобождается автоматически
После free объект всё ещё подписывает A7

Это воспроизведение для миграции старого кода, не рекомендуемый жизненный цикл. Предупреждение перехвачено и объяснено. Начиная с PHP 8 вызов не закрывает объект и не отзывает ключ.

<?php
declare(strict_types=1);

function signInvoice(string $text): string {
    $key = openssl_pkey_get_private(file_get_contents(__DIR__ . '/publisher-private.pem'));
    if ($key === false || !openssl_sign($text, $signature, $key, OPENSSL_ALGO_SHA256)) { throw new RuntimeException('Подпись не создана'); }
    return $signature;
}
$signature = signInvoice('A8');
echo openssl_verify('A8', $signature, file_get_contents(__DIR__ . '/publisher-public.pem'), OPENSSL_ALGO_SHA256) === 1
    ? "Функция завершилась; подпись A8 доступна получателю\n" : "Подпись не подходит\n";

Функция завершилась; подпись A8 доступна получателю

Локальная ссылка на key исчезает при выходе, а возвращённые байты подписи остаются. Если объект хранится ещё где-то, другой владелец продолжает им пользоваться. PHP управляет временем жизни ссылок автоматически.

<?php
declare(strict_types=1);

$key = openssl_pkey_get_private(file_get_contents(__DIR__ . '/publisher-private.pem'));
set_error_handler(static function (int $level): bool {
    if ($level === E_DEPRECATED) { echo "Устаревший вызов: объект освобождается автоматически\n"; return true; }
    return false;
});
try { openssl_free_key($key); } finally { restore_error_handler(); }
if (!openssl_sign('A7', $signature, $key, OPENSSL_ALGO_SHA256)) { throw new RuntimeException('Подпись не создана'); }
echo "После free объект всё ещё подписывает A7\n";

Устаревший вызов: объект освобождается автоматически
После free объект всё ещё подписывает A7

Это воспроизведение для миграции старого кода, не рекомендуемый жизненный цикл. Предупреждение перехвачено и объяснено. Начиная с PHP 8 вызов не закрывает объект и не отзывает ключ.

<?php
declare(strict_types=1);

function signInvoice(string $text): string {
    $key = openssl_pkey_get_private(file_get_contents(__DIR__ . '/publisher-private.pem'));
    if ($key === false || !openssl_sign($text, $signature, $key, OPENSSL_ALGO_SHA256)) { throw new RuntimeException('Подпись не создана'); }
    return $signature;
}
$signature = signInvoice('A8');
echo openssl_verify('A8', $signature, file_get_contents(__DIR__ . '/publisher-public.pem'), OPENSSL_ALGO_SHA256) === 1
    ? "Функция завершилась; подпись A8 доступна получателю\n" : "Подпись не подходит\n";

Функция завершилась; подпись A8 доступна получателю

Локальная ссылка на key исчезает при выходе, а возвращённые байты подписи остаются. Если объект хранится ещё где-то, другой владелец продолжает им пользоваться. PHP управляет временем жизни ссылок автоматически.

<?php
declare(strict_types=1);

$key = random_bytes(32);
$iv = random_bytes(12);
$encrypted = openssl_encrypt('Встреча: склад Север, 10:00', 'aes-256-gcm', $key, OPENSSL_RAW_DATA, $iv, $tag);
if ($encrypted === false) { throw new RuntimeException('Сообщение не зашифровано'); }
$plain = openssl_decrypt($encrypted, 'aes-256-gcm', $key, OPENSSL_RAW_DATA, $iv, $tag);
if ($plain === false) { throw new RuntimeException('Сообщение не прошло проверку'); }
echo $plain, "\n";

Встреча: склад Север, 10:00

Вызов encrypt возвращает ciphertext, отдельно заполняя tag. Текст и параметры связываются одной операцией; получатель должен получить все необходимые несекретные части.

<?php
declare(strict_types=1);

$key = random_bytes(32);
$iv = random_bytes(12);
$aad = 'delivery:A1';
$encrypted = openssl_encrypt('Курьер: вход со двора', 'aes-256-gcm', $key, OPENSSL_RAW_DATA, $iv, $tag, $aad, 16);
if ($encrypted === false) { throw new RuntimeException('Шифрование не выполнено'); }
$package = ['iv' => base64_encode($iv), 'tag' => base64_encode($tag), 'ciphertext' => base64_encode($encrypted)];
if (file_put_contents(__DIR__ . '/delivery.json', json_encode($package, JSON_THROW_ON_ERROR)) === false) { throw new RuntimeException('Файл не записан'); }
$stored = json_decode(file_get_contents(__DIR__ . '/delivery.json'), true, flags: JSON_THROW_ON_ERROR);
$plain = openssl_decrypt(base64_decode($stored['ciphertext'], true), 'aes-256-gcm', $key, OPENSSL_RAW_DATA, base64_decode($stored['iv'], true), base64_decode($stored['tag'], true), $aad);
if ($plain === false) { throw new RuntimeException('Файл не прошёл проверку'); }
echo 'delivery.json → ', $plain, "\n";
echo "Назначение A1 проверено вместе с текстом\n";

delivery.json → Курьер: вход со двора
Назначение A1 проверено вместе с текстом

Base64 позволяет хранить двоичные части в JSON без порчи UTF-8. key в JSON не записан: в этой локальной демонстрации он живёт в памяти. AAD приходит из ожидаемого назначения доставки; слепо доверять любому AAD из чужого файла нельзя. Для чужого пакета сначала проверяют его структуру/длины, как в следующей карточке.

<?php
declare(strict_types=1);

$message = json_decode(file_get_contents(__DIR__ . '/message.json'), true, flags: JSON_THROW_ON_ERROR);
$key = base64_decode(file_get_contents(__DIR__ . '/message-key.b64'), true);
$iv = base64_decode($message['iv'], true);
$tag = base64_decode($message['tag'], true);
$encrypted = base64_decode($message['ciphertext'], true);

if ($key === false || strlen($key) !== 32 || $iv === false || strlen($iv) !== 12 || $tag === false || strlen($tag) !== 16 || $encrypted === false) {
    throw new UnexpectedValueException('Неверный формат учебного пакета');
}
$plain = openssl_decrypt($encrypted, 'aes-256-gcm', $key, OPENSSL_RAW_DATA, $iv, $tag, 'delivery:A1');
if ($plain === false) { throw new RuntimeException('Заметка отклонена'); }
echo $plain, "\n";

Встреча: склад Север, 10:00

message.json и message-key.b64 созданы отдельно и входят в архив. Мы используем сохранённые IV/tag, а не генерируем новые при чтении. Это известная структура fixture; для произвольного JSON дополнительно проверяют обязательные поля и типы до base64_decode.

<?php
declare(strict_types=1);

$message = json_decode(file_get_contents(__DIR__ . '/message.json'), true, flags: JSON_THROW_ON_ERROR);
$key = base64_decode(file_get_contents(__DIR__ . '/message-key.b64'), true);
$iv = base64_decode($message['iv'], true);
$tag = base64_decode($message['tag'], true);
$encrypted = base64_decode($message['ciphertext'], true);

if ($key === false || $iv === false || $tag === false || $encrypted === false) { throw new RuntimeException('Повреждён Base64'); }
$changed = $encrypted;
$changed[0] = chr(ord($changed[0]) ^ 1);
foreach (['Исходник' => [$encrypted, $tag], 'Подмена' => [$changed, $tag], 'Короткий tag' => [$encrypted, substr($tag, 0, 8)]] as $label => [$bytes, $candidateTag]) {
    if (strlen($key) !== 32 || strlen($iv) !== 12 || strlen($candidateTag) !== 16) {
        echo $label, ": отклонить формат до расшифровки\n"; continue;
    }
    $plain = openssl_decrypt($bytes, 'aes-256-gcm', $key, OPENSSL_RAW_DATA, $iv, $candidateTag, 'delivery:A1');
    echo $label, ': ', $plain === false ? 'отклонить, целостность не подтверждена' : $plain, "\n";
}

Исходник: Встреча: склад Север, 10:00
Подмена: отклонить, целостность не подтверждена
Короткий tag: отклонить формат до расшифровки

Операция XOR ^1 меняет один бит первого байта. Длина tag проверяется самим приложением: PHP не требует исходную длину и может проверить только переданный префикс, поэтому пропуск такой проверки ослабил бы наш контракт.

<?php
declare(strict_types=1);

$length = openssl_cipher_key_length('aes-256-gcm');
if ($length === false) { throw new RuntimeException('Шифр неизвестен'); }
echo 'Для aes-256-gcm ключ: ', $length, " байт\n";

Для aes-256-gcm ключ: 32 байт

Размер относится к байтам PHP-строки. key_length и iv_length отвечают на разные вопросы; 256 в имени AES — число бит ключа.

<?php
declare(strict_types=1);

$size = openssl_cipher_key_length('aes-256-gcm');
if ($size === false) { throw new RuntimeException('Шифр недоступен'); }
$key = random_bytes($size);
$iv = random_bytes(12);
$encrypted = openssl_encrypt('Встреча: склад Север, 10:00', 'aes-256-gcm', $key, OPENSSL_RAW_DATA, $iv, $tag);
if ($encrypted === false) { throw new RuntimeException('Сообщение не зашифровано'); }
$plain = openssl_decrypt($encrypted, 'aes-256-gcm', $key, OPENSSL_RAW_DATA, $iv, $tag);
if ($plain === false) { throw new RuntimeException('Сообщение не прошло проверку'); }
echo $plain, "\n";

Встреча: склад Север, 10:00

Вычисленный размер используется непосредственно при генерации. Нельзя брать размер IV как размер ключа или наоборот; каждый принадлежит выбранному параметру.

<?php
declare(strict_types=1);

$length = openssl_cipher_iv_length('aes-256-gcm');
if ($length === false) { throw new RuntimeException('Шифр неизвестен'); }
echo 'Для aes-256-gcm IV: ', $length, " байт\n";

Для aes-256-gcm IV: 12 байт

Размер относится к байтам PHP-строки. key_length и iv_length отвечают на разные вопросы; 256 в имени AES — число бит ключа.

<?php
declare(strict_types=1);

$size = openssl_cipher_iv_length('aes-256-gcm');
if ($size === false) { throw new RuntimeException('Шифр недоступен'); }
$key = random_bytes(32);
$iv = random_bytes($size);
$encrypted = openssl_encrypt('Встреча: склад Север, 10:00', 'aes-256-gcm', $key, OPENSSL_RAW_DATA, $iv, $tag);
if ($encrypted === false) { throw new RuntimeException('Сообщение не зашифровано'); }
$plain = openssl_decrypt($encrypted, 'aes-256-gcm', $key, OPENSSL_RAW_DATA, $iv, $tag);
if ($plain === false) { throw new RuntimeException('Сообщение не прошло проверку'); }
echo $plain, "\n";

Встреча: склад Север, 10:00

Вычисленный размер используется непосредственно при генерации. Нельзя брать размер IV как размер ключа или наоборот; каждый принадлежит выбранному параметру.

<?php
declare(strict_types=1);

$bytes = file_get_contents(__DIR__ . '/invoice.txt');
$digest = openssl_digest($bytes, 'sha256');
if ($digest === false) { throw new RuntimeException('Хеш не вычислен'); }
echo 'invoice.txt: ', $digest, "\n";

invoice.txt: 77a66c9361fd30e59e1eb1f0311f0a26944659b4cfbc994593426081d320f185

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

<?php
declare(strict_types=1);

$expected = trim(file_get_contents(__DIR__ . '/manifest.sha256'));
$invoice = file_get_contents(__DIR__ . '/invoice.txt');
foreach (['Исходник' => $invoice, 'Подмена' => str_replace('1200', '9000', $invoice)] as $name => $data) {
    $actual = openssl_digest($data, 'sha256', true);
    if ($actual === false) { throw new RuntimeException('Хеш не вычислен'); }
    echo $name, ': ', hash_equals($expected, bin2hex($actual)) ? 'байты соответствуют манифесту' : 'файл изменён', "\n";
}

Исходник: байты соответствуют манифесту
Подмена: файл изменён

true возвращает двоичные байты. bin2hex превращает их в запись для сравнения с текстовым манифестом. Манифест должен быть получен по независимому доверенному каналу; возможность изменить одновременно файл и его хеш разрушает такую проверку.

<?php
declare(strict_types=1);

$available = openssl_get_cipher_methods();
foreach (['aes-128-gcm', 'aes-256-gcm'] as $name) {
    echo $name, in_array($name, $available, true) ? ": доступен\n" : ": отсутствует\n";
}

aes-128-gcm: доступен
aes-256-gcm: доступен

Мы показываем только два алгоритма конкретного договора, а не случайно выбираем первый из длинного списка. Вывод относится к проверенной сборке; фактический список зависит от OpenSSL и провайдеров.

<?php
declare(strict_types=1);

$available = openssl_get_cipher_methods(true);
foreach (['aes-256-gcm', 'partner-unknown-v9'] as $requested) {
    if (!in_array($requested, ['aes-256-gcm'], true) || !in_array($requested, $available, true)) {
        echo $requested, ": формат не согласован, файл не обрабатываем\n"; continue;
    }
    echo $requested, ": можно обработать накладную\n";
}

aes-256-gcm: можно обработать накладную
partner-unknown-v9: формат не согласован, файл не обрабатываем

Первый список — политика приложения, второй — возможности библиотеки. aliases=true включает альтернативные имена, но не расширяет автоматически разрешённую политику. Удалённый отправитель не должен выбирать произвольный алгоритм лишь потому, что он есть в OpenSSL.

<?php
declare(strict_types=1);

$available = openssl_get_md_methods();
foreach (['sha256', 'sha512'] as $name) {
    echo $name, in_array($name, $available, true) ? ": доступен\n" : ": отсутствует\n";
}

sha256: доступен
sha512: доступен

Мы показываем только два алгоритма конкретного договора, а не случайно выбираем первый из длинного списка. Вывод относится к проверенной сборке; фактический список зависит от OpenSSL и провайдеров.

<?php
declare(strict_types=1);

$available = openssl_get_md_methods(true);
foreach (['sha256', 'partner-unknown-v9'] as $requested) {
    if (!in_array($requested, ['sha256'], true) || !in_array($requested, $available, true)) {
        echo $requested, ": формат не согласован, файл не обрабатываем\n"; continue;
    }
    echo $requested, ": можно обработать накладную\n";
}

sha256: можно обработать накладную
partner-unknown-v9: формат не согласован, файл не обрабатываем

Первый список — политика приложения, второй — возможности библиотеки. aliases=true включает альтернативные имена, но не расширяет автоматически разрешённую политику. Удалённый отправитель не должен выбирать произвольный алгоритм лишь потому, что он есть в OpenSSL.

<?php
declare(strict_types=1);

$names = openssl_get_curve_names();
if ($names === false) { throw new RuntimeException('Список кривых недоступен'); }
foreach (['prime256v1' => 'P-256', 'secp384r1' => 'P-384'] as $name => $label) {
    echo $label, in_array($name, $names, true) ? ": доступна\n" : ": отсутствует\n";
}

P-256: доступна
P-384: доступна

Читаемые обозначения P-256/P-384 сопоставлены с именами OpenSSL. Это проверка возможностей среды; конкретную кривую заранее задаёт протокол.

<?php
declare(strict_types=1);

$curve = 'prime256v1';
$names = openssl_get_curve_names();
if ($names === false || !in_array($curve, $names, true)) { throw new RuntimeException('Кривая протокола недоступна'); }
$key = openssl_pkey_new(['config' => __DIR__ . '/openssl.cnf', 'private_key_type' => OPENSSL_KEYTYPE_EC, 'curve_name' => $curve]);
if ($key === false || !openssl_sign('Остаток A1: 4', $signature, $key, OPENSSL_ALGO_SHA256)) { throw new RuntimeException('Подпись не создана'); }
echo openssl_verify('Остаток A1: 4', $signature, openssl_pkey_get_details($key)['key'], OPENSSL_ALGO_SHA256) === 1
    ? "P-256: изменение остатка A1 подтверждено\n" : "Подпись отклонена\n";

P-256: изменение остатка A1 подтверждено

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

<?php
declare(strict_types=1);

$token = bin2hex(openssl_random_pseudo_bytes(32, $strong));
if (!$strong) { throw new RuntimeException('Источник случайности не подходит'); }
$documents = [$token => 'invoice.txt'];
$requestedToken = $token;
echo file_get_contents(__DIR__ . '/' . $documents[$requestedToken]);

Заказ A1: 1200 RUB

random создаёт байты, bin2hex переводит их в удобный печатный токен. Массив связывает этот непрозрачный идентификатор с разрешённым файлом; строка токена не становится произвольным путём. Это локальная модель поиска, не проверенный HTTP-сервис.

<?php
declare(strict_types=1);

$key = openssl_random_pseudo_bytes(32, $strong);
if (!$strong) { throw new RuntimeException('Источник случайности не подходит'); }
$iv = random_bytes(12);
$encrypted = openssl_encrypt('Курьер: заказ A1 готов', 'aes-256-gcm', $key, OPENSSL_RAW_DATA, $iv, $tag);
if ($encrypted === false) { throw new RuntimeException('Заметка не зашифрована'); }
$plain = openssl_decrypt($encrypted, 'aes-256-gcm', $key, OPENSSL_RAW_DATA, $iv, $tag);
if ($plain === false) { throw new RuntimeException('Заметка отклонена'); }
echo $plain, "\n";

Курьер: заказ A1 готов

Секретные случайные байты применены как ключ точной длины. Они не должны совпадать между запусками, поэтому результат урока — успешно восстановленное сообщение, а не фиктивная постоянная случайная строка.

<?php
declare(strict_types=1);

while (openssl_error_string() !== false) {}
$key = openssl_pkey_get_private('это не PEM-ключ');
if ($key === false) {
    $messages = [];
    while (($message = openssl_error_string()) !== false) { $messages[] = $message; }
    if ($messages === []) { throw new RuntimeException('Ожидалась диагностика OpenSSL'); }
    file_put_contents(__DIR__ . '/openssl-errors.log', implode("\n", $messages));
    echo "Ключ не прочитан: проверьте PEM; подробности в openssl-errors.log\n";
}

Ключ не прочитан: проверьте PEM; подробности в openssl-errors.log

Полный реальный текст ошибки записан в учебный файл. Его формулировка зависит от OpenSSL, поэтому не закреплена как постоянный бизнес-код. Перед отдельной попыткой очередь очищена, чтобы не приписать ей старую ошибку.

<?php
declare(strict_types=1);

while (openssl_error_string() !== false) {}
foreach (['Ошибочный файл' => 'not a PEM', 'Исправный файл' => file_get_contents(__DIR__ . '/publisher-private.pem')] as $label => $pem) {
    $key = openssl_pkey_get_private($pem);
    echo $label, ': ', $key === false ? 'подпись не выполняем' : 'ключ готов к подписи', "\n";
    while (openssl_error_string() !== false) {}
}

Ошибочный файл: подпись не выполняем
Исправный файл: ключ готов к подписи

Решение принимает прямой результат операции; наличие старых сообщений в очереди не превращает успешный ключ в отказ. Очередь читают до строгого false. PHP Warning и исключения — отдельные каналы, error_string не перехватывает их.

<?php
declare(strict_types=1);

$salt = random_bytes(16);
$key = openssl_pbkdf2('учебный пароль', $salt, 32, 600000, 'sha256');
$again = openssl_pbkdf2('учебный пароль', $salt, 32, 600000, 'sha256');
if ($key === false || $again === false) { throw new RuntimeException('KDF не выполнен'); }
echo hash_equals($key, $again) ? "Пароль и соль восстановили ключ файла\n" : "Ключи различаются\n";

Пароль и соль восстановили ключ файла

Соль — случайные несекретные байты; её сохраняют вместе с зашифрованным файлом. Для повторного получения ключа нужны точно те же пароль, соль, размер, число итераций и дайджест. PBKDF2 не хранит эти параметры внутри возвращённых байтов.

<?php
declare(strict_types=1);

$salt = random_bytes(16); $iv = random_bytes(12);
$key = openssl_pbkdf2('учебный пароль', $salt, 32, 600000, 'sha256');
if ($key === false) { throw new RuntimeException('KDF не выполнен'); }
$encrypted = openssl_encrypt('Заметка к A1: звонок за час', 'aes-256-gcm', $key, OPENSSL_RAW_DATA, $iv, $tag);
if ($encrypted === false) { throw new RuntimeException('Шифрование не выполнено'); }
foreach (['Верный пароль' => 'учебный пароль', 'Другой пароль' => 'ошибочный пароль'] as $label => $password) {
    $candidate = openssl_pbkdf2($password, $salt, 32, 600000, 'sha256');
    if ($candidate === false) { throw new RuntimeException('KDF не выполнен'); }
    $plain = openssl_decrypt($encrypted, 'aes-256-gcm', $candidate, OPENSSL_RAW_DATA, $iv, $tag);
    echo $label, ': ', $plain === false ? 'заметка не открыта' : $plain, "\n";
}

Верный пароль: Заметка к A1: звонок за час
Другой пароль: заметка не открыта

Этот локальный пример показывает две роли: PBKDF2 получает ключ, GCM подтверждает целостность заметки. Это не готовый переносимый файловый протокол. Для рабочего формата выбирают библиотеку, ограничивают входные параметры KDF и хранят версию/соль/стоимость/IV/tag по договору.

<?php
declare(strict_types=1);

$key = openssl_pkey_get_private(file_get_contents(__DIR__ . '/publisher-private.pem'));
$csr = openssl_csr_new(['commonName' => 'catalog.example.test'], $key, ['config' => __DIR__ . '/openssl.cnf', 'digest_alg' => 'sha256']);
if (!$csr instanceof OpenSSLCertificateSigningRequest) { throw new RuntimeException('Подписанный CSR не создан'); }
echo 'Запрошен сертификат для: ', openssl_csr_get_subject($csr)['CN'], "\n";

Запрошен сертификат для: catalog.example.test

commonName — заявленное имя, не доказательство владения доменом. Конфигурация добавляет SAN для того же учебного имени. Существующий закрытый ключ остаётся у заявителя; CSR содержит его открытую часть.

<?php
declare(strict_types=1);

$key = null;
$csr = openssl_csr_new(['commonName' => 'catalog.example.test', 'organizationalUnitName' => ['Warehouse', 'Exports']], $key,
    ['config' => __DIR__ . '/openssl.cnf', 'config_section_name' => 'req', 'private_key_bits' => 2048, 'digest_alg' => 'sha256'],
    ['unstructuredName' => 'catalog-import']);
if (!$csr instanceof OpenSSLCertificateSigningRequest) { throw new RuntimeException('CSR не создан'); }
$subject = openssl_csr_get_subject($csr, false);
echo 'Подразделения: ', implode(', ', $subject['organizationalUnitName']), "\n";
if (!openssl_sign('Накладная заявки', $signature, $key, OPENSSL_ALGO_SHA256)) { throw new RuntimeException('Ключ заявки недоступен'); }
echo openssl_verify('Накладная заявки', $signature, openssl_csr_get_public_key($csr), OPENSSL_ALGO_SHA256) === 1
    ? "Новый ключ соответствует открытой части CSR\n" : "Ключ не соответствует CSR\n";

Подразделения: Warehouse, Exports
Новый ключ соответствует открытой части CSR

null передан в переменной по ссылке: функция создаёт ключ и заполняет $key. СPHP8.4 одно поле DN может содержать несколько значений. extra_attributes — атрибуты самого CSR, не дополнительные поля DN; здесь указан маркер catalog-import, а не секрет.

<?php
declare(strict_types=1);

$csr = file_get_contents(__DIR__ . '/publisher.csr.pem');
if (!openssl_csr_export($csr, $pem)) { throw new RuntimeException('CSR не экспортирован'); }

echo strtok($pem, "\n"), "\n";
echo 'Заявка: ', openssl_csr_get_subject($pem)['CN'], "\n";

-----BEGIN CERTIFICATE REQUEST-----
Заявка: catalog.example.test

Показаны тип PEM и фактически прочитанное из результата имя. Длинная Base64-часть вносит мало пользы в экранный вывод; полный созданный PEM доступен в переменной/учебном файле.

<?php
declare(strict_types=1);

$csr = file_get_contents(__DIR__ . '/publisher.csr.pem');
if (!openssl_csr_export($csr, $verbose, false)) { throw new RuntimeException('Подробный экспорт не выполнен'); }

$subject = openssl_csr_get_subject($verbose, false);
if ($subject === false) { throw new RuntimeException('Экспорт перестал быть читаемым CSR'); }
echo 'Читаемое описание добавлено: ', str_contains($verbose, 'Certificate Request:') ? 'да' : 'нет', "\n";
echo 'Имя из сохранённого CSR: ', $subject['commonName'], "\n";

Читаемое описание добавлено: да
Имя из сохранённого CSR: catalog.example.test

Третий аргумент false включает дополнительный текст перед PEM. Партнёру нужен согласованный формат: если он ожидает только PEM, используйте default true. Это текстовое описание запроса, не выдача сертификата.

<?php
declare(strict_types=1);

$csr = file_get_contents(__DIR__ . '/publisher.csr.pem');
if (!openssl_csr_export_to_file($csr, __DIR__ . '/request.pem')) { throw new RuntimeException('CSR не экспортирован'); }
$pem = file_get_contents(__DIR__ . '/request.pem');

echo strtok($pem, "\n"), "\n";
echo 'Заявка: ', openssl_csr_get_subject($pem)['CN'], "\n";

-----BEGIN CERTIFICATE REQUEST-----
Заявка: catalog.example.test

Показаны тип PEM и фактически прочитанное из результата имя. Длинная Base64-часть вносит мало пользы в экранный вывод; полный созданный PEM доступен в переменной/учебном файле.

<?php
declare(strict_types=1);

$csr = file_get_contents(__DIR__ . '/publisher.csr.pem');
if (!openssl_csr_export_to_file($csr, __DIR__ . '/request-readable.pem', false)) { throw new RuntimeException('Подробный экспорт не выполнен'); }
$verbose = file_get_contents(__DIR__ . '/request-readable.pem');

$subject = openssl_csr_get_subject($verbose, false);
if ($subject === false) { throw new RuntimeException('Экспорт перестал быть читаемым CSR'); }
echo 'Читаемое описание добавлено: ', str_contains($verbose, 'Certificate Request:') ? 'да' : 'нет', "\n";
echo 'Имя из сохранённого CSR: ', $subject['commonName'], "\n";

Читаемое описание добавлено: да
Имя из сохранённого CSR: catalog.example.test

Третий аргумент false включает дополнительный текст перед PEM. Партнёру нужен согласованный формат: если он ожидает только PEM, используйте default true. Это текстовое описание запроса, не выдача сертификата.

<?php
declare(strict_types=1);

$subject = openssl_csr_get_subject(file_get_contents(__DIR__ . '/publisher.csr.pem'));
if ($subject === false) { throw new RuntimeException('Заявка не разобрана'); }
echo 'Имя: ', $subject['CN'], "\n", 'Организация: ', $subject['O'], "\n";

Имя: catalog.example.test
Организация: PHP Manual Lab

При default short_names=true используются CN/O. Поля прочитаны из содержимого заявки; это заявление заявителя, а не подтверждённая внешним центром личность.

<?php
declare(strict_types=1);

foreach (['publisher.csr.pem', 'recipient.csr.pem'] as $file) {
    $subject = openssl_csr_get_subject(file_get_contents(__DIR__ . '/' . $file), false);
    if ($subject === false) { throw new RuntimeException('CSR не прочитан'); }
    $name = $subject['commonName'] ?? '';
    echo $name, ': ', $name === 'catalog.example.test' ? 'передать в очередь проверки каталога' : 'проверить назначение вручную', "\n";
}

catalog.example.test: передать в очередь проверки каталога
warehouse.example.test: проверить назначение вручную

false даёт длинные имена ключей. Сравнение commonName используется только для маршрутизации заявки, не для подтверждения домена и не для полноценной проверки TLS.

<?php
declare(strict_types=1);

$public = openssl_csr_get_public_key(file_get_contents(__DIR__ . '/publisher.csr.pem'));
if ($public === false) { throw new RuntimeException('Открытый ключ CSR не извлечён'); }
$signature = base64_decode(file_get_contents(__DIR__ . '/invoice.sig.b64'), true);
echo openssl_verify(file_get_contents(__DIR__ . '/invoice.txt'), $signature, $public, OPENSSL_ALGO_SHA256) === 1
    ? "Накладная A1 соответствует ключу заявки\n" : "Ключ заявки не подтверждает A1\n";

Накладная A1 соответствует ключу заявки

Ключ CSR использован в реальной операции. Само извлечение открытой части не превращает запрос в доверенный сертификат.

<?php
declare(strict_types=1);

$public = openssl_csr_get_public_key('file://' . __DIR__ . '/publisher.csr.pem', false);
if ($public === false) { throw new RuntimeException('Ключ не извлечён'); }
$details = openssl_pkey_get_details($public);
if ($details === false || file_put_contents(__DIR__ . '/request-public.pem', $details['key']) === false) { throw new RuntimeException('Публичный файл не записан'); }
echo strtok(file_get_contents(__DIR__ . '/request-public.pem'), "\n"), "\n";
echo "request-public.pem содержит открытую часть заявки каталога\n";

-----BEGIN PUBLIC KEY-----
request-public.pem содержит открытую часть заявки каталога

short_names сохранён в сигнатуре для совместимости, но функция его игнорирует: результат — объект, не DN-массив. Вывод показывает созданный тип файла, а не секретные компоненты.

<?php
declare(strict_types=1);

$csr = file_get_contents(__DIR__ . '/publisher.csr.pem');
$private = file_get_contents(__DIR__ . '/publisher-private.pem');
$certificate = openssl_csr_sign($csr, null, $private, 30, ['config' => __DIR__ . '/openssl.cnf', 'digest_alg' => 'sha256', 'x509_extensions' => 'publisher'], 1100);
if ($certificate === false) { throw new RuntimeException('Сертификат не создан'); }
$info = openssl_x509_parse($certificate);
echo 'Владелец: ', $info['subject']['CN'], "\n", 'Издатель: ', $info['issuer']['CN'], "\n";
echo "Самоподпись не добавляет доверие в браузере\n";

Владелец: catalog.example.test
Издатель: catalog.example.test
Самоподпись не добавляет доверие в браузере

null вместо CA означает самоподпись.30 задаёт срок в днях; это не настройка браузера и не реальный TLS-тест. Имена берутся из фактически выпущенного сертификата.

<?php
declare(strict_types=1);

$certificate = openssl_csr_sign(file_get_contents(__DIR__ . '/publisher.csr.pem'), 'file://' . __DIR__ . '/lab-ca.pem',
    'file://' . __DIR__ . '/lab-ca-private.pem', 30,
    ['config' => __DIR__ . '/openssl.cnf', 'digest_alg' => 'sha256', 'x509_extensions' => 'publisher'], 7, 'ABCD1001');
if ($certificate === false || !openssl_x509_export_to_file($certificate, __DIR__ . '/issued.pem')) { throw new RuntimeException('Выпуск не завершён'); }
$info = openssl_x509_parse(file_get_contents(__DIR__ . '/issued.pem'));
echo 'Издатель: ', $info['issuer']['CN'], "\n", 'Серийный номер: ', $info['serialNumberHex'], "\n";

Издатель: PHP Manual Lab CA
Серийный номер: ABCD1001

serial_hex с PHP 8.4 имеет приоритет над целым serial=7. Центр выбирает расширения publisher из своего локального договора. В учебном наборе все ключи публичны, системное доверие к CA не устанавливается.

<?php
declare(strict_types=1);

$certificate = openssl_x509_read(file_get_contents(__DIR__ . '/publisher-cert.pem'));
if ($certificate === false) { throw new RuntimeException('Сертификат не прочитан'); }
$info = openssl_x509_parse($certificate);
echo 'Владелец: ', $info['subject']['CN'], "\n";
echo 'Издатель: ', $info['issuer']['CN'], "\n";

Владелец: catalog.example.test
Издатель: PHP Manual Lab CA

Это чтение полей сертификата: сам факт успешного разбора ещё не говорит о доверии, сроке, назначении или доступности TLS-сервера.

<?php
declare(strict_types=1);

$certificate = openssl_x509_read('file://' . __DIR__ . '/publisher-cert.pem');
if ($certificate === false) { throw new RuntimeException('Сертификат не прочитан'); }
$public = openssl_pkey_get_public($certificate);
$signature = base64_decode(file_get_contents(__DIR__ . '/invoice.sig.b64'), true);
echo openssl_verify(file_get_contents(__DIR__ . '/invoice.txt'), $signature, $public, OPENSSL_ALGO_SHA256) === 1
    ? "A1: подпись соответствует открытому ключу прочитанного сертификата\n" : "Накладная отклонена\n";

A1: подпись соответствует открытому ключу прочитанного сертификата

Объект сертификата передаётся другой функции. Доверие к владельцу сертификата устанавливают отдельно; подпись накладной и подпись самого сертификата — разные проверки.

<?php
declare(strict_types=1);

$info = openssl_x509_parse(file_get_contents(__DIR__ . '/publisher-cert.pem'));
if ($info === false) { throw new RuntimeException('Сертификат не разобран'); }
echo 'Кому: ', $info['subject']['CN'], "\n";
echo 'Кем: ', $info['issuer']['CN'], "\n";
echo 'SAN: ', $info['extensions']['subjectAltName'], "\n";
echo 'Номер: ', $info['serialNumber'], "\n";

Кому: catalog.example.test
Кем: PHP Manual Lab CA
SAN: DNS:catalog.example.test, email:publisher@example.test
Номер: 1001

Карточка использует конкретные поля нашей проверенной сборки; PHP Manual намеренно не закрепляет всю структуру массива как неизменный контракт. SAN и commonName показаны отдельно.

<?php
declare(strict_types=1);

$info = openssl_x509_parse(file_get_contents(__DIR__ . '/publisher-cert.pem'), false);
if ($info === false) { throw new RuntimeException('Сертификат не разобран'); }
$inside = $info['validFrom_time_t'] + 60;
$after = $info['validTo_time_t'] + 1;
foreach (['Минута после выпуска' => $inside, 'После срока' => $after] as $label => $time) {
    $valid = $time >= $info['validFrom_time_t'] && $time <= $info['validTo_time_t'];
    echo $info['subject']['commonName'], ' / ', $label, ': ', $valid ? 'срок соблюдён' : 'срок нарушен', "\n";
}

catalog.example.test / Минута после выпуска: срок соблюдён
catalog.example.test / После срока: срок нарушен

Использованы две явно вычисленные учебные даты, поэтому результат не зависит от текущего дня. Это проверка интервала для объяснения; она не заменяет стандартное построение цепочки/проверку TLS.

<?php
declare(strict_types=1);

$certificate = openssl_x509_read(file_get_contents(__DIR__ . '/publisher-cert.pem'));
if (!openssl_x509_export($certificate, $pem)) { throw new RuntimeException('Экспорт не выполнен'); }

echo strtok($pem, "\n"), "\n";
echo 'В копии: ', openssl_x509_parse($pem)['subject']['CN'], "\n";

-----BEGIN CERTIFICATE-----
В копии: catalog.example.test

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

<?php
declare(strict_types=1);

$certificate = file_get_contents(__DIR__ . '/publisher-cert.pem');
if (!openssl_x509_export($certificate, $pem, false)) { throw new RuntimeException('Экспорт не выполнен'); }

echo str_contains($pem, 'Certificate:') ? "Описание сертификата включено\n" : "Описания нет\n";
echo 'Издатель из PEM: ', openssl_x509_parse($pem)['issuer']['CN'], "\n";

Описание сертификата включено
Издатель из PEM: PHP Manual Lab CA

no_text=false добавляет человеческий текст. PEM внутри остаётся читаемым; потребителю, ожидающему только PEM-блок, передают вариант с default true.

<?php
declare(strict_types=1);

$certificate = openssl_x509_read(file_get_contents(__DIR__ . '/publisher-cert.pem'));
if (!openssl_x509_export_to_file($certificate, __DIR__ . '/copy-cert.pem')) { throw new RuntimeException('Экспорт не выполнен'); }
$pem = file_get_contents(__DIR__ . '/copy-cert.pem');

echo strtok($pem, "\n"), "\n";
echo 'В копии: ', openssl_x509_parse($pem)['subject']['CN'], "\n";

-----BEGIN CERTIFICATE-----
В копии: catalog.example.test

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

<?php
declare(strict_types=1);

$certificate = file_get_contents(__DIR__ . '/publisher-cert.pem');
if (!openssl_x509_export_to_file($certificate, __DIR__ . '/copy-cert.pem', false)) { throw new RuntimeException('Экспорт не выполнен'); }
$pem = file_get_contents(__DIR__ . '/copy-cert.pem');

echo str_contains($pem, 'Certificate:') ? "Описание сертификата включено\n" : "Описания нет\n";
echo 'Издатель из PEM: ', openssl_x509_parse($pem)['issuer']['CN'], "\n";

Описание сертификата включено
Издатель из PEM: PHP Manual Lab CA

no_text=false добавляет человеческий текст. PEM внутри остаётся читаемым; потребителю, ожидающему только PEM-блок, передают вариант с default true.

<?php
declare(strict_types=1);

$fingerprint = openssl_x509_fingerprint(file_get_contents(__DIR__ . '/publisher-cert.pem'), 'sha256');
if ($fingerprint === false) { throw new RuntimeException('Отпечаток не получен'); }
echo 'catalog.example.test / SHA-256: ', $fingerprint, "\n";

catalog.example.test / SHA-256: 8561deb722fe9151cdd14e2240af490d82b8a83d5e5c7f8faa69e4aab287775b

Отпечаток относится к структуре сертификата, а не к пробелам/перено сам его PEM-оболочки. При новом выпуске сертификата он изменится; это требует согласованного обновления ожидаемого значения.

<?php
declare(strict_types=1);

$expected = trim(file_get_contents(__DIR__ . '/certificate.sha256'));
foreach (['publisher-cert.pem', 'recipient-cert.pem'] as $file) {
    $raw = openssl_x509_fingerprint(file_get_contents(__DIR__ . '/' . $file), 'sha256', true);
    if ($raw === false) { throw new RuntimeException('Отпечаток не вычислен'); }
    echo $file, ': ', hash_equals($expected, bin2hex($raw)) ? 'известный сертификат' : 'другой сертификат, остановиться', "\n";
}

publisher-cert.pem: известный сертификат
recipient-cert.pem: другой сертификат, остановиться

Ожидаемое значение хранится отдельно от входного сертификата. Такое закрепление требует плана обновления и не является полной заменой всех требований TLS.

<?php
declare(strict_types=1);

$certificate = file_get_contents(__DIR__ . '/publisher-cert.pem');
foreach (['publisher-private.pem', 'recipient-private.pem'] as $file) {
    $key = openssl_pkey_get_private(file_get_contents(__DIR__ . '/' . $file));
    if ($key === false) { throw new RuntimeException('Закрытый ключ не прочитан'); }
    echo $file, ': ', openssl_x509_check_private_key($certificate, $key) ? 'пара совпала' : 'ключ от другого сертификата', "\n";
}

publisher-private.pem: пара совпала
recipient-private.pem: ключ от другого сертификата

Так можно обнаружить ошибочно подобранные файлы перед запуском сервиса. Прочитать закрытый ключ и сопоставить его открытые параметры — отдельные действия.

<?php
declare(strict_types=1);

$certificate = file_get_contents(__DIR__ . '/publisher-cert.pem');
$publicOnly = openssl_pkey_get_public(file_get_contents(__DIR__ . '/publisher-public.pem'));
$publicWarning = false;
set_error_handler(static function (int $level, string $message) use (&$publicWarning): bool {
    if ($level === E_WARNING && str_contains($message, 'is a public key')) {
        $publicWarning = true; return true;
    }
    return false;
});
try { $result = openssl_x509_check_private_key($certificate, $publicOnly); }
finally { restore_error_handler(); }
if ($result !== false || !$publicWarning) { throw new RuntimeException('Поведение сборки изменилось'); }
echo "Открытый объект: PHP отказал до сопоставления\n";
echo "Для подписи нужен успешно прочитанный закрытый ключ\n";

Открытый объект: PHP отказал до сопоставления
Для подписи нужен успешно прочитанный закрытый ключ

В PHP 8.5.11 обёртка требует закрытый ключ и выдаёт E_WARNING для открытого объекта. Ожидаемое предупреждение обработано явно; любое другое предупреждение остаётся видимым. Оговорка Manual о сопоставлении открытых компонентов не означает, что этот конкретный вызов обязан пройти.

<?php
declare(strict_types=1);

$certificate = file_get_contents(__DIR__ . '/publisher-cert.pem');
$issuer = openssl_pkey_get_public(file_get_contents(__DIR__ . '/lab-ca.pem'));
$result = openssl_x509_verify($certificate, $issuer);
echo $result === 1 ? "Сертификат каталога подписан ключом PHP Manual Lab CA\n" : "Подпись сертификата не подтверждена\n";

Сертификат каталога подписан ключом PHP Manual Lab CA

Проверена именно подпись внутри сертификата. Это не построение полной цепочки и не подтверждение сетевого соединения.

<?php
declare(strict_types=1);

$certificate = file_get_contents(__DIR__ . '/publisher-cert.pem');
foreach (['Ключ CA' => 'lab-ca-public.pem', 'Ключ самого сайта' => 'publisher-public.pem'] as $label => $file) {
    $result = openssl_x509_verify($certificate, file_get_contents(__DIR__ . '/' . $file));
    echo $label, ': ', $result === 1 ? 'подпись подтверждена' : 'сертификат не принимаем', "\n";
}

Ключ CA: подпись подтверждена
Ключ самого сайта: сертификат не принимаем

Владелец сертификата и его издатель могут иметь разные ключи. Любое значение кроме 1 означает, что дальнейшая обработка не разрешена; подробная диагностика различает 0 и−1.

<?php
declare(strict_types=1);

$certificate = file_get_contents(__DIR__ . '/publisher-cert.pem');
$result = openssl_x509_checkpurpose($certificate, X509_PURPOSE_SSL_SERVER, [__DIR__ . '/lab-ca.pem']);
if ($result === -1) { throw new RuntimeException('Проверка назначения не выполнена'); }
echo $result === true ? "Цепочка к Lab CA и назначение TLS-сервера приняты\n" : "Сертификат не подходит\n";

Цепочка к Lab CA и назначение TLS-сервера приняты

Доверенный CA выбран явным локальным файлом, системное хранилище не меняется. Функция не получила имя ожидаемого хоста и не выполняла TLS-рукопожатие; эти проверки здесь не заявлены.

<?php
declare(strict_types=1);

$certificate = file_get_contents(__DIR__ . '/publisher-cert.pem');
foreach (['Сервер' => X509_PURPOSE_SSL_SERVER, 'Клиент' => X509_PURPOSE_SSL_CLIENT] as $label => $purpose) {
    $result = openssl_x509_checkpurpose($certificate, $purpose, [__DIR__ . '/lab-ca.pem']);
    if ($result === -1) { throw new RuntimeException('Не удалось проверить назначение'); }
    echo $label, ': ', $result === true ? 'назначение разрешено' : 'назначение не разрешено', "\n";
}

Сервер: назначение разрешено
Клиент: назначение не разрешено

Учебный сертификат содержит serverAuth/emailProtection, но не clientAuth. Назначение — одно значение, константы нельзя смешивать побитовым OR. Проверка времени использует реальное текущее время: fixture выдан на 10 лет, после его срока набор следует перевыпустить.

<?php
declare(strict_types=1);

$certificate = openssl_x509_read(file_get_contents(__DIR__ . '/publisher-cert.pem'));
set_error_handler(static function (int $level): bool {
    if ($level === E_DEPRECATED) { echo "Устарело: сертификат освобождается автоматически\n"; return true; }
    return false;
});
try { openssl_x509_free($certificate); } finally { restore_error_handler(); }
echo 'После free: ', openssl_x509_parse($certificate)['subject']['CN'], "\n";

Устарело: сертификат освобождается автоматически
После free: catalog.example.test

Демонстрация нужна для миграции PHP 7-кода: функция больше не закрывает объект. Она также не отзывает сертификат.

<?php
declare(strict_types=1);

function certificateOwner(string $pem): string {
    $certificate = openssl_x509_read($pem);
    if ($certificate === false) { throw new RuntimeException('Сертификат не прочитан'); }
    return openssl_x509_parse($certificate)['subject']['CN'];
}
echo 'Настроен сертификат: ', certificateOwner(file_get_contents(__DIR__ . '/publisher-cert.pem')), "\n";

Настроен сертификат: catalog.example.test

Функция возвращает нужную строку, локальная ссылка на объект перестаёт быть нужна. Дополнительный free в новом PHP не требуется.

<?php
declare(strict_types=1);

$locations = openssl_get_cert_locations();
echo 'Переменная для CA-файла: ', $locations['default_cert_file_env'], "\n";
echo 'Переменная для CA-каталога: ', $locations['default_cert_dir_env'], "\n";
echo "Настройки PHP: openssl.cafile и openssl.capath\n";

Переменная для CA-файла: SSL_CERT_FILE
Переменная для CA-каталога: SSL_CERT_DIR
Настройки PHP: openssl.cafile и openssl.capath

Метод показывает конфигурационные ориентиры. Имя переменной среды отличается от её значения, а прописанный путь — от реально существующего файла. Полный массив в вашей среде покажет default_cert_file/dir и ini_cafile/capath.

<?php
declare(strict_types=1);

$locations = openssl_get_cert_locations();
$variable = $locations['default_cert_file_env'];
$previous = getenv($variable);
putenv($variable . '=' . __DIR__ . '/lab-ca.pem');
try {
    $path = getenv($variable);
    if ($path === false || !is_file($path)) { throw new RuntimeException('CA-файл не найден'); }
    $result = openssl_x509_checkpurpose(file_get_contents(__DIR__ . '/publisher-cert.pem'), X509_PURPOSE_SSL_SERVER, [$path]);
    echo basename($path), ': ', $result === true ? 'цепочка сертификата каталога подтверждена' : 'цепочка отклонена', "\n";
} finally {
    putenv($previous === false ? $variable : $variable . '=' . $previous);
}

lab-ca.pem: цепочка сертификата каталога подтверждена

Переменная изменяется только в процессе примера и затем восстанавливается. Для наглядности путь передан checkpurpose явно: этот запуск не доказывает, что другой процесс/веб-сервер уже подхватил ту же среду, и не выполняет TLS.

<?php
declare(strict_types=1);

$public = file_get_contents(__DIR__ . '/publisher-public.pem');
if (!openssl_public_encrypt('Код ячейки: B17', $ciphertext, $public, OPENSSL_PKCS1_OAEP_PADDING, 'sha256')) { throw new RuntimeException('Сообщение не зашифровано'); }
file_put_contents(__DIR__ . '/cell.b64', base64_encode($ciphertext));
if (!openssl_private_decrypt($ciphertext, $text, file_get_contents(__DIR__ . '/publisher-private.pem'), OPENSSL_PKCS1_OAEP_PADDING, 'sha256')) { throw new RuntimeException('Проверка не пройдена'); }
echo $text, "\n";

Код ячейки: B17

Бинарный блок хранится в Base64 только ради переносимого текстового файла. Base64 не добавляет шифрование. Закрытый ключ опубликован лишь для воспроизводимости лаборатории.

<?php
declare(strict_types=1);

$public = file_get_contents(__DIR__ . '/publisher-public.pem');
$longDocument = str_repeat('Строка накладной A1. ', 20);
$bytes = intdiv(openssl_pkey_get_details(openssl_pkey_get_public($public))['bits'], 8);
$limit = $bytes - 2 * 32 - 2;
if (strlen($longDocument) > $limit) {
    echo 'Документ длиннее ', $limit, " байт: выбираем контейнер CMS\n";
} else {
    openssl_public_encrypt($longDocument, $ciphertext, $public, OPENSSL_PKCS1_OAEP_PADDING, 'sha256');
}

Документ длиннее 190 байт: выбираем контейнер CMS

Отказ не превращается в пустое успешное сообщение. Для сетевого сервиса не возвращайте подробности внутренних ошибок расшифрования клиенту; единое поведение задаёт протокол.

<?php
declare(strict_types=1);

$ciphertext = base64_decode(file_get_contents(__DIR__ . '/rsa-message.b64'), true);
$key = file_get_contents(__DIR__ . '/publisher-private.pem');
if (!openssl_private_decrypt($ciphertext, $text, $key, OPENSSL_PKCS1_OAEP_PADDING, 'sha256')) { throw new RuntimeException('Сообщение не открыто'); }
echo $text, "\n";

Код ячейки: B17

Бинарный блок хранится в Base64 только ради переносимого текстового файла. Base64 не добавляет шифрование. Закрытый ключ опубликован лишь для воспроизводимости лаборатории.

<?php
declare(strict_types=1);

$ciphertext = base64_decode(file_get_contents(__DIR__ . '/rsa-message.b64'), true);
foreach (['recipient-private.pem', 'publisher-private.pem'] as $file) {
    $ok = openssl_private_decrypt($ciphertext, $text, file_get_contents(__DIR__ . '/' . $file), OPENSSL_PKCS1_OAEP_PADDING, 'sha256');
    echo $file, ': ', $ok ? $text : 'отказ, данные не использовать', "\n";
}

recipient-private.pem: отказ, данные не использовать
publisher-private.pem: Код ячейки: B17

Отказ не превращается в пустое успешное сообщение. Для сетевого сервиса не возвращайте подробности внутренних ошибок расшифрования клиенту; единое поведение задаёт протокол.

<?php
declare(strict_types=1);

$public = file_get_contents(__DIR__ . '/publisher-public.pem');
$private = file_get_contents(__DIR__ . '/publisher-private.pem');
if (!openssl_private_encrypt('legacy-record:A1', $block, $private, OPENSSL_PKCS1_PADDING)) { throw new RuntimeException('Старый блок не создан'); }

if (!openssl_public_decrypt($block, $record, $public, OPENSSL_PKCS1_PADDING)) { throw new RuntimeException('Старый блок не прочитан'); }
echo $record, "\n";

legacy-record:A1

Это совместимость со старым специально заданным форматом. Любой обладатель открытого ключа прочтёт запись: конфиденциальности здесь нет.

<?php
declare(strict_types=1);

$record = 'legacy-record:A1';
$private = file_get_contents(__DIR__ . '/publisher-private.pem');
if (!openssl_sign($record, $signature, $private, OPENSSL_ALGO_SHA256)) { throw new RuntimeException('Подпись не создана'); }
$public = file_get_contents(__DIR__ . '/publisher-public.pem');
echo openssl_verify($record, $signature, $public, OPENSSL_ALGO_SHA256) === 1
    ? "A1: современная подпись проверена\n" : "A1: отказ\n";

A1: современная подпись проверена

Переход меняет формат подписи и требует обновить обе стороны. Нельзя просто поменять имя функции и сохранить прежние блоки.

<?php
declare(strict_types=1);

$public = file_get_contents(__DIR__ . '/publisher-public.pem');
$block = base64_decode(file_get_contents(__DIR__ . '/legacy-rsa.b64'), true);

if (!openssl_public_decrypt($block, $record, $public, OPENSSL_PKCS1_PADDING)) { throw new RuntimeException('Старый блок не прочитан'); }
echo $record, "\n";

legacy-record:A1

Это совместимость со старым специально заданным форматом. Любой обладатель открытого ключа прочтёт запись: конфиденциальности здесь нет.

<?php
declare(strict_types=1);

$record = 'legacy-record:A1';
$private = file_get_contents(__DIR__ . '/publisher-private.pem');
if (!openssl_sign($record, $signature, $private, OPENSSL_ALGO_SHA256)) { throw new RuntimeException('Подпись не создана'); }
$public = file_get_contents(__DIR__ . '/publisher-public.pem');
echo openssl_verify($record, $signature, $public, OPENSSL_ALGO_SHA256) === 1
    ? "A1: современная подпись проверена\n" : "A1: отказ\n";

A1: современная подпись проверена

Переход меняет формат подписи и требует обновить обе стороны. Нельзя просто поменять имя функции и сохранить прежние блоки.

<?php
declare(strict_types=1);

$public = openssl_pkey_get_public(file_get_contents(__DIR__ . '/recipient-public.pem'));
if (openssl_seal('Склад: принять A1', $sealed, $keys, [$public], 'aes-256-cbc', $iv) === false) { throw new RuntimeException('Конверт не создан'); }
if (!openssl_open($sealed, $text, $keys[0], file_get_contents(__DIR__ . '/recipient-private.pem'), 'aes-256-cbc', $iv)) { throw new RuntimeException('Конверт не открыт'); }
echo $text, "\n";

Склад: принять A1

keys[0] соответствует первому ключу в массиве получателей; в готовом пакете лаборатории склад — второй адресат с индексом 1. IV передаётся вместе с данными.

<?php
declare(strict_types=1);

$names = ['publisher', 'recipient'];
$public = array_map(static fn(string $name) => openssl_pkey_get_public(file_get_contents(__DIR__ . '/' . $name . '-public.pem')), $names);
if (openssl_seal('Склад: принять A1', $sealed, $keys, $public, 'aes-256-cbc', $iv) === false) { throw new RuntimeException('Конверт не создан'); }
foreach ($names as $index => $name) {
    $private = file_get_contents(__DIR__ . '/' . $name . '-private.pem');
    if (!openssl_open($sealed, $text, $keys[$index], $private, 'aes-256-cbc', $iv)) { throw new RuntimeException('Конверт не открыт'); }
    echo $name, ': ', $text, "\n";
}

publisher: Склад: принять A1
recipient: Склад: принять A1

Получатели используют один ciphertext, но разные encrypted_keys. Имена и индексы должны быть частью согласованного формата, чтобы копии ключей не перепутались.

<?php
declare(strict_types=1);

$packet = json_decode(file_get_contents(__DIR__ . '/envelope.json'), true, 512, JSON_THROW_ON_ERROR);
$sealed = base64_decode($packet['ciphertext'], true);
$iv = base64_decode($packet['iv'], true);

$envelopeKey = base64_decode($packet['keys'][1], true);
$private = file_get_contents(__DIR__ . '/recipient-private.pem');
if (!openssl_open($sealed, $text, $envelopeKey, $private, 'aes-256-cbc', $iv)) { throw new RuntimeException('Конверт не открыт'); }
echo $text, "\n";

Склад: принять A1

keys[0] соответствует первому ключу в массиве получателей; в готовом пакете лаборатории склад — второй адресат с индексом 1. IV передаётся вместе с данными.

<?php
declare(strict_types=1);

$names = ['publisher', 'recipient'];
$public = array_map(static fn(string $name) => openssl_pkey_get_public(file_get_contents(__DIR__ . '/' . $name . '-public.pem')), $names);
if (openssl_seal('Склад: принять A1', $sealed, $keys, $public, 'aes-256-cbc', $iv) === false) { throw new RuntimeException('Конверт не создан'); }
foreach ($names as $index => $name) {
    $private = file_get_contents(__DIR__ . '/' . $name . '-private.pem');
    if (!openssl_open($sealed, $text, $keys[$index], $private, 'aes-256-cbc', $iv)) { throw new RuntimeException('Конверт не открыт'); }
    echo $name, ': ', $text, "\n";
}

publisher: Склад: принять A1
recipient: Склад: принять A1

Получатели используют один ciphertext, но разные encrypted_keys. Имена и индексы должны быть частью согласованного формата, чтобы копии ключей не перепутались.

<?php
declare(strict_types=1);

$alicePrivate = file_get_contents(__DIR__ . '/alice-dh-private.pem');
$bobPrivate = file_get_contents(__DIR__ . '/bob-dh-private.pem');
$alice = openssl_pkey_derive(file_get_contents(__DIR__ . '/bob-dh-public.pem'), $alicePrivate);
$bob = openssl_pkey_derive(file_get_contents(__DIR__ . '/alice-dh-public.pem'), $bobPrivate);
if ($alice === false || $bob === false) { throw new RuntimeException('Согласование не выполнено'); }
echo hash_equals($alice, $bob) ? "Алиса и Боб получили общий секрет; его байты не публикуем\n" : "Согласование нарушено\n";

Алиса и Боб получили общий секрет; его байты не публикуем

Порядок аргументов важен: чужая открытая часть, затем собственная закрытая. Сам секрет не выводится; показано, смогут ли стороны продолжить протокол.

<?php
declare(strict_types=1);

$options = ['config' => __DIR__ . '/openssl.cnf', 'private_key_type' => OPENSSL_KEYTYPE_EC, 'curve_name' => 'prime256v1'];
$aliceKey = openssl_pkey_new($options); $bobKey = openssl_pkey_new($options);
if ($aliceKey === false || $bobKey === false) { throw new RuntimeException('Ключи не созданы'); }
$alice = openssl_pkey_derive(openssl_pkey_get_details($bobKey)['key'], $aliceKey);
$bob = openssl_pkey_derive(openssl_pkey_get_details($aliceKey)['key'], $bobKey);
if ($alice === false || $bob === false) { throw new RuntimeException('Согласование не выполнено'); }
echo hash_equals($alice, $bob) ? "ECDH prime256v1: общий секрет согласован\n" : "Согласование нарушено\n";

ECDH prime256v1: общий секрет согласован

Ключи создаются заново, норезультат проверки согласованности стабилен. Это изолированная демонстрация; идентичность удалённой стороны здесь не задана.

<?php
declare(strict_types=1);

$aliceKey = openssl_pkey_get_private(file_get_contents(__DIR__ . '/alice-dh-private.pem'));
$bobRaw = hex2bin(trim(file_get_contents(__DIR__ . '/bob-dh-public.hex')));
$secret = openssl_dh_compute_key($bobRaw, $aliceKey);
$reference = openssl_pkey_derive(file_get_contents(__DIR__ . '/alice-dh-public.pem'), file_get_contents(__DIR__ . '/bob-dh-private.pem'));
if ($secret === false || $reference === false) { throw new RuntimeException('DH не выполнен'); }
echo hash_equals($secret, $reference) ? "Открытое DH-число Боба прочитано: общий секрет согласован\n" : "Параметры не совпали\n";

Открытое DH-число Боба прочитано: общий секрет согласован

Первый аргумент — бинарное DH-число pub_key, а не PEM. hex2bin лишь восстанавливает это число из переносимой текстовой записи.

<?php
declare(strict_types=1);

$ec = openssl_pkey_new(['config' => __DIR__ . '/openssl.cnf', 'private_key_type' => OPENSSL_KEYTYPE_EC, 'curve_name' => 'prime256v1']);
if ($ec === false) { throw new RuntimeException('Ключ не создан'); }
$detail = openssl_pkey_get_details($ec);
$point = "\x04" . str_pad($detail['ec']['x'], 32, "\0", STR_PAD_LEFT) . str_pad($detail['ec']['y'], 32, "\0", STR_PAD_LEFT);
echo openssl_dh_compute_key($point, $ec) === false
    ? "PHP 8.5: этот интерфейс отверг EC; для ECDH используем pkey_derive\n" : "Поведение сборки изменилось\n";

PHP 8.5: этот интерфейс отверг EC; для ECDH используем pkey_derive

Это целевой тест границы API: текущий php-src проверяет тип EVP_PKEY_DH и возвращает false для EC. Здесь не строится собственный криптографический протокол.

<?php
declare(strict_types=1);

$certificate = file_get_contents(__DIR__ . '/publisher-cert.pem');
$private = file_get_contents(__DIR__ . '/publisher-private.pem');
if (!openssl_pkcs12_export($certificate, $container, $private, 'lab-password')) { throw new RuntimeException('Контейнер не создан'); }

if (!openssl_pkcs12_read($container, $parts, 'lab-password')) { throw new RuntimeException('Контейнер не открыт'); }
echo 'Переносим сертификат: ', openssl_x509_parse($parts['cert'])['subject']['CN'], "\n";

Переносим сертификат: catalog.example.test

Экспорт вернул bool, а бинарные данные оказались в переменной $container. Читаем только имя сертификата, не выводим закрытый ключ.

<?php
declare(strict_types=1);

$certificate = file_get_contents(__DIR__ . '/publisher-cert.pem');
$private = file_get_contents(__DIR__ . '/publisher-private.pem');
if (!openssl_pkcs12_export($certificate, $container, $private, 'lab-password', ['friendly_name' => 'Catalog publisher', 'extracerts' => file_get_contents(__DIR__ . '/lab-ca.pem')])) { throw new RuntimeException('Контейнер не создан'); }

if (!openssl_pkcs12_read($container, $parts, 'lab-password')) { throw new RuntimeException('Контейнер не открыт'); }
if (!openssl_sign('A5', $signature, $parts['pkey'], OPENSSL_ALGO_SHA256)) { throw new RuntimeException('Подпись не создана'); }
echo openssl_verify('A5', $signature, $parts['cert'], OPENSSL_ALGO_SHA256) === 1 ? "A5: перенесённый ключ подписывает документ\n" : "A5: отказ\n";
echo 'Дополнительный сертификат: ', openssl_x509_parse($parts['extracerts'][0])['subject']['CN'], "\n";

A5: перенесённый ключ подписывает документ
Дополнительный сертификат: PHP Manual Lab CA

friendly_name — удобная подпись контейнера, не доказательство личности. Дополнительный CA включён для построения цепочки; доверять ему приложение должно по отдельному решению.

<?php
declare(strict_types=1);

$certificate = file_get_contents(__DIR__ . '/publisher-cert.pem');
$private = file_get_contents(__DIR__ . '/publisher-private.pem');
if (!openssl_pkcs12_export_to_file($certificate, __DIR__ . '/publisher.p12', $private, 'lab-password')) { throw new RuntimeException('Контейнер не создан'); }
$container = file_get_contents(__DIR__ . '/publisher.p12');

if (!openssl_pkcs12_read($container, $parts, 'lab-password')) { throw new RuntimeException('Контейнер не открыт'); }
echo 'Переносим сертификат: ', openssl_x509_parse($parts['cert'])['subject']['CN'], "\n";

Переносим сертификат: catalog.example.test

Экспорт вернул bool, а бинарные данные оказались в реальном файле publisher.p12. Читаем только имя сертификата, не выводим закрытый ключ.

<?php
declare(strict_types=1);

$certificate = file_get_contents(__DIR__ . '/publisher-cert.pem');
$private = file_get_contents(__DIR__ . '/publisher-private.pem');
if (!openssl_pkcs12_export_to_file($certificate, __DIR__ . '/publisher.p12', $private, 'lab-password', ['friendly_name' => 'Catalog publisher', 'extracerts' => file_get_contents(__DIR__ . '/lab-ca.pem')])) { throw new RuntimeException('Контейнер не создан'); }
$container = file_get_contents(__DIR__ . '/publisher.p12');

if (!openssl_pkcs12_read($container, $parts, 'lab-password')) { throw new RuntimeException('Контейнер не открыт'); }
if (!openssl_sign('A5', $signature, $parts['pkey'], OPENSSL_ALGO_SHA256)) { throw new RuntimeException('Подпись не создана'); }
echo openssl_verify('A5', $signature, $parts['cert'], OPENSSL_ALGO_SHA256) === 1 ? "A5: перенесённый ключ подписывает документ\n" : "A5: отказ\n";
echo 'Дополнительный сертификат: ', openssl_x509_parse($parts['extracerts'][0])['subject']['CN'], "\n";

A5: перенесённый ключ подписывает документ
Дополнительный сертификат: PHP Manual Lab CA

friendly_name — удобная подпись контейнера, не доказательство личности. Дополнительный CA включён для построения цепочки; доверять ему приложение должно по отдельному решению.

<?php
declare(strict_types=1);

$container = base64_decode(file_get_contents(__DIR__ . '/publisher.p12.b64'), true);
if (!openssl_pkcs12_read($container, $parts, 'lab-password')) { throw new RuntimeException('Контейнер не открыт'); }
echo 'Владелец: ', openssl_x509_parse($parts['cert'])['subject']['CN'], "\n";
echo openssl_x509_check_private_key($parts['cert'], $parts['pkey']) ? "Ключ соответствует сертификату\n" : "Пара не совпала\n";

Владелец: catalog.example.test
Ключ соответствует сертификату

Передаётся содержимое контейнера, а не имя файла. Base64 здесь нужна только для текстовой упаковки учебного fixture; обычный .p12 читают сразу file_get_contents.

<?php
declare(strict_types=1);

$container = base64_decode(file_get_contents(__DIR__ . '/publisher.p12.b64'), true);
if (openssl_pkcs12_read($container, $wrongParts, 'wrong-password')) { throw new RuntimeException('Неверный пароль неожиданно принят'); }
echo "Неверный пароль: импорт остановлен\n";
while (openssl_error_string() !== false) {}
if (!openssl_pkcs12_read($container, $parts, 'lab-password')) { throw new RuntimeException('Контейнер не открыт'); }
if (!openssl_sign('A6', $signature, $parts['pkey'], OPENSSL_ALGO_SHA256)) { throw new RuntimeException('Подпись не создана'); }
echo openssl_verify('A6', $signature, $parts['cert'], OPENSSL_ALGO_SHA256) === 1 ? "Верный пароль: A6 подписан\n" : "A6: отказ\n";

Неверный пароль: импорт остановлен
Верный пароль: A6 подписан

Две независимые попытки используют разные выходные переменные; данные неуспешной попытки не считаются импортированными. Очередь ошибки первой попытки очищается перед второй.

<?php
declare(strict_types=1);

$key = openssl_pkey_get_private(file_get_contents(__DIR__ . '/publisher-private.pem'));
if ($key === false) { throw new RuntimeException('Ключ не прочитан'); }
$request = openssl_spki_new($key, 'enrollment:A1', OPENSSL_ALGO_SHA256);
if ($request === false) { throw new RuntimeException('Запрос не создан'); }
if (str_starts_with($request, 'SPKAC=')) { $request = substr($request, 6); }
if (!openssl_spki_verify($request)) { throw new RuntimeException('Запрос не создан'); }
echo 'Запрос подписан; challenge: ', openssl_spki_export_challenge($request), "\n";

Запрос подписан; challenge: enrollment:A1

SHA-256 передан явно: исторический default MD5 не используется. Подписывает закрытая часть, в структуру помещается открытая.

<?php
declare(strict_types=1);

$key = openssl_pkey_get_private(file_get_contents(__DIR__ . '/publisher-private.pem'));
$request = openssl_spki_new($key, 'enrollment:A2', OPENSSL_ALGO_SHA256);
if ($request === false) { throw new RuntimeException('Запрос не создан'); }
file_put_contents(__DIR__ . '/enrollment.spkac', $request);
$saved = trim(file_get_contents(__DIR__ . '/enrollment.spkac'));
if (str_starts_with($saved, 'SPKAC=')) { $saved = substr($saved, 6); }
$public = openssl_spki_export($saved);
echo $public === file_get_contents(__DIR__ . '/publisher-public.pem') ? "enrollment.spkac: открытый ключ издателя сохранён\n" : "Ключ не совпал\n";

enrollment.spkac: открытый ключ издателя сохранён

В файл попал запрос с открытой частью; закрытый PEM остаётся отдельным. Сравнение идентичного PEM уместно именно для данных этой лаборатории; произвольные представления одного ключа могут различаться.

<?php
declare(strict_types=1);

$request = trim(file_get_contents(__DIR__ . '/request.spkac'));
if (str_starts_with($request, 'SPKAC=')) { $request = substr($request, 6); }

echo openssl_spki_verify($request) ? "Подпись запроса регистрации цела\n" : "Запрос отклонён\n";

Подпись запроса регистрации цела

Сохранённый запрос создан открытой учебной парой; чтение его поля не устанавливает доверие к произвольному отправителю.

<?php
declare(strict_types=1);

$request = trim(file_get_contents(__DIR__ . '/request.spkac'));
if (str_starts_with($request, 'SPKAC=')) { $request = substr($request, 6); }

if (!openssl_spki_verify($request)) { throw new RuntimeException('Подпись запроса нарушена'); }
$challenge = openssl_spki_export_challenge($request);
foreach (['enrollment:A1', 'enrollment:A2'] as $expected) {
    echo $expected, ': ', is_string($challenge) && hash_equals($expected, $challenge)
        ? 'challenge подходит; дальше проверяем срок и одноразовость' : 'другая регистрация, отказ', "\n";
}

enrollment:A1: challenge подходит; дальше проверяем срок и одноразовость
enrollment:A2: другая регистрация, отказ

Подпись и ожидаемый challenge проверяются отдельно. В реальном сервисе ожидаемое значение связано с сессией на сервере и погашается после успешного завершения.

<?php
declare(strict_types=1);

$request = trim(file_get_contents(__DIR__ . '/request.spkac'));
if (str_starts_with($request, 'SPKAC=')) { $request = substr($request, 6); }

$public = openssl_spki_export($request);
if ($public === false) { throw new RuntimeException('Ключ не извлечён'); }
echo strtok($public, "\n"), "\n";
$signature = base64_decode(file_get_contents(__DIR__ . '/invoice.sig.b64'), true);
echo openssl_verify(file_get_contents(__DIR__ . '/invoice.txt'), $signature, $public, OPENSSL_ALGO_SHA256) === 1 ? "A1: ключ запроса подходит к подписи накладной\n" : "A1: отказ\n";

-----BEGIN PUBLIC KEY-----
A1: ключ запроса подходит к подписи накладной

Сохранённый запрос создан открытой учебной парой; чтение его поля не устанавливает доверие к произвольному отправителю.

<?php
declare(strict_types=1);

$request = trim(file_get_contents(__DIR__ . '/request.spkac'));
if (str_starts_with($request, 'SPKAC=')) { $request = substr($request, 6); }

if (!openssl_spki_verify($request)) { throw new RuntimeException('Подпись запроса нарушена'); }
$challenge = openssl_spki_export_challenge($request);
foreach (['enrollment:A1', 'enrollment:A2'] as $expected) {
    echo $expected, ': ', is_string($challenge) && hash_equals($expected, $challenge)
        ? 'challenge подходит; дальше проверяем срок и одноразовость' : 'другая регистрация, отказ', "\n";
}

enrollment:A1: challenge подходит; дальше проверяем срок и одноразовость
enrollment:A2: другая регистрация, отказ

Подпись и ожидаемый challenge проверяются отдельно. В реальном сервисе ожидаемое значение связано с сессией на сервере и погашается после успешного завершения.

<?php
declare(strict_types=1);

$request = trim(file_get_contents(__DIR__ . '/request.spkac'));
if (str_starts_with($request, 'SPKAC=')) { $request = substr($request, 6); }

$challenge = openssl_spki_export_challenge($request);
if ($challenge === false) { throw new RuntimeException('Challenge не извлечён'); }
echo 'Регистрация: ', $challenge, "\n";

Регистрация: enrollment:A1

Сохранённый запрос создан открытой учебной парой; чтение его поля не устанавливает доверие к произвольному отправителю.

<?php
declare(strict_types=1);

$request = trim(file_get_contents(__DIR__ . '/request.spkac'));
if (str_starts_with($request, 'SPKAC=')) { $request = substr($request, 6); }

if (!openssl_spki_verify($request)) { throw new RuntimeException('Подпись запроса нарушена'); }
$challenge = openssl_spki_export_challenge($request);
foreach (['enrollment:A1', 'enrollment:A2'] as $expected) {
    echo $expected, ': ', is_string($challenge) && hash_equals($expected, $challenge)
        ? 'challenge подходит; дальше проверяем срок и одноразовость' : 'другая регистрация, отказ', "\n";
}

enrollment:A1: challenge подходит; дальше проверяем срок и одноразовость
enrollment:A2: другая регистрация, отказ

Подпись и ожидаемый challenge проверяются отдельно. В реальном сервисе ожидаемое значение связано с сессией на сервере и погашается после успешного завершения.

<?php
declare(strict_types=1);

$hash = openssl_password_hash('argon2id', 'учебный пароль кабинета', ['memory_cost' => 65536, 'time_cost' => 3, 'threads' => 1]);
echo openssl_password_verify('argon2id', 'учебный пароль кабинета', $hash)
    ? "Кабинет: пароль подтверждён\n" : "Кабинет: вход отклонён\n";

Кабинет: пароль подтверждён

Хеш меняется между запусками благодаря соли, результат проверки остаётся тем же. Параметры примера демонстрируют расход ресурсов; рабочие значения выбирают с измерением нагрузки сервиса, не копированием универсального числа.

<?php
declare(strict_types=1);

$record = ['login' => 'warehouse', 'algorithm' => 'argon2id', 'hash' => openssl_password_hash('argon2id', 'пароль лаборатории', ['memory_cost' => 65536, 'time_cost' => 3, 'threads' => 1])];
file_put_contents(__DIR__ . '/account.json', json_encode($record, JSON_THROW_ON_ERROR));
$saved = json_decode(file_get_contents(__DIR__ . '/account.json'), true, 512, JSON_THROW_ON_ERROR);
foreach (['ошибка', 'пароль лаборатории'] as $input) {
    echo $saved['login'], ': ', openssl_password_verify($saved['algorithm'], $input, $saved['hash']) ? 'вход разрешён' : 'вход отклонён', "\n";
}

warehouse: вход отклонён
warehouse: вход разрешён

Файл нужен для наглядной изолированной лаборатории. В сервисе запись хранится в закрытом хранилище пользователей, исходный пароль не записывается в неё и не выводится в лог.

<?php
declare(strict_types=1);

$hash = openssl_password_hash('argon2id', 'учебный пароль кабинета', ['memory_cost' => 65536, 'time_cost' => 3, 'threads' => 1]);
echo openssl_password_verify('argon2id', 'учебный пароль кабинета', $hash)
    ? "Кабинет: пароль подтверждён\n" : "Кабинет: вход отклонён\n";

Кабинет: пароль подтверждён

Хеш меняется между запусками благодаря соли, результат проверки остаётся тем же. Параметры примера демонстрируют расход ресурсов; рабочие значения выбирают с измерением нагрузки сервиса, не копированием универсального числа.

<?php
declare(strict_types=1);

$record = ['login' => 'warehouse', 'algorithm' => 'argon2id', 'hash' => openssl_password_hash('argon2id', 'пароль лаборатории', ['memory_cost' => 65536, 'time_cost' => 3, 'threads' => 1])];
file_put_contents(__DIR__ . '/account.json', json_encode($record, JSON_THROW_ON_ERROR));
$saved = json_decode(file_get_contents(__DIR__ . '/account.json'), true, 512, JSON_THROW_ON_ERROR);
foreach (['ошибка', 'пароль лаборатории'] as $input) {
    echo $saved['login'], ': ', openssl_password_verify($saved['algorithm'], $input, $saved['hash']) ? 'вход разрешён' : 'вход отклонён', "\n";
}

warehouse: вход отклонён
warehouse: вход разрешён

Файл нужен для наглядной изолированной лаборатории. В сервисе запись хранится в закрытом хранилище пользователей, исходный пароль не записывается в неё и не выводится в лог.

<?php
declare(strict_types=1);

$certificate = file_get_contents(__DIR__ . '/publisher-cert.pem');
$key = file_get_contents(__DIR__ . '/publisher-private.pem');
if (!openssl_pkcs7_sign(__DIR__ . '/invoice.txt', __DIR__ . '/out.signed.eml', $certificate, $key, [], PKCS7_BINARY)) { throw new RuntimeException('Документ не подписан'); }
if (openssl_pkcs7_verify(__DIR__ . '/out.signed.eml', PKCS7_BINARY, null, [__DIR__ . '/lab-ca.pem'], null, __DIR__ . '/verified.txt') !== true) { throw new RuntimeException('Подпись не принята'); }
echo file_get_contents(__DIR__ . '/verified.txt');

Заказ A1: 1200 RUB

Закрытый ключ подписывает данные, сертификат сопровождает подпись. Доверие задано отдельным lab-ca.pem. Показан текст, извлечённый только после успешной проверки.

<?php
declare(strict_types=1);

$certificate = file_get_contents(__DIR__ . '/publisher-cert.pem');
$key = file_get_contents(__DIR__ . '/publisher-private.pem');
$headers = ['Subject' => 'Invoice A1', 'From: publisher@example.test'];
if (!openssl_pkcs7_sign(__DIR__ . '/invoice.txt', __DIR__ . '/mail.eml', $certificate, $key, $headers, PKCS7_BINARY | PKCS7_DETACHED, __DIR__ . '/lab-ca.pem')) { throw new RuntimeException('Подпись не создана'); }
$ok = openssl_pkcs7_verify(__DIR__ . '/mail.eml', PKCS7_BINARY, __DIR__ . '/signer.pem', [__DIR__ . '/lab-ca.pem']);
if ($ok !== true) { throw new RuntimeException('Подпись не принята'); }
echo 'Подписант: ', openssl_x509_parse(file_get_contents(__DIR__ . '/signer.pem'))['subject']['CN'], "\n";
echo strtok(file_get_contents(__DIR__ . '/mail.eml'), "\n"), "\n";

Подписант: catalog.example.test
Subject: Invoice A1

Показаны обе формы headers: ключ=>значение и полная строка. Эти внешние почтовые заголовки добавляются после подписи и не становятся подписанным текстом. Не допускайте пользовательских CR/LF в них. Для этого S/MIME-примера исходный текст архива явно хранится с CRLF: подпись относится к согласованным байтам строк.

<?php
declare(strict_types=1);

$ok = openssl_pkcs7_verify(__DIR__ . '/invoice.signed.eml', PKCS7_BINARY, __DIR__ . '/signer.pem', [__DIR__ . '/lab-ca.pem'], null, __DIR__ . '/verified.txt');
if ($ok !== true) { throw new RuntimeException('Подпись не принята'); }
echo file_get_contents(__DIR__ . '/verified.txt');
echo 'Подписант: ', openssl_x509_parse(file_get_contents(__DIR__ . '/signer.pem'))['subject']['CN'], "\n";

Заказ A1: 1200 RUB
Подписант: catalog.example.test

Отдельно показаны проверенные данные и извлечённый подписант. CA-файл получен заранее; сертификат из самого входного контейнера автоматически доверенным не становится.

<?php
declare(strict_types=1);

$original = file_get_contents(__DIR__ . '/invoice.signed.eml');
$changed = str_replace('1200', '9900', $original);
if ($changed === $original) { throw new RuntimeException('Текст для изменения не найден'); }
file_put_contents(__DIR__ . '/changed.eml', $changed);
foreach (['invoice.signed.eml', 'changed.eml'] as $file) {
    $ok = openssl_pkcs7_verify(__DIR__ . '/' . $file, PKCS7_BINARY, null, [__DIR__ . '/lab-ca.pem']);
    echo $file, ': ', $ok === true ? 'документ принят' : 'подпись не подтверждена', "\n";
}

invoice.signed.eml: документ принят
changed.eml: подпись не подтверждена

Изменённые данные сохранены в новом файле, оригинал остаётся для сравнения. Выходной content-файл после отказа нельзя использовать даже если он существует или частично записан. Готовая отделённая подпись была создана для CRLF-оригинала: архив сохраняет именно эти байты; замена CRLF на LF также нарушила бы подпись.

<?php
declare(strict_types=1);

$certificate = file_get_contents(__DIR__ . '/recipient-cert.pem');
if (!openssl_pkcs7_encrypt(__DIR__ . '/invoice.txt', __DIR__ . '/encrypted.eml', $certificate, [], PKCS7_BINARY, OPENSSL_CIPHER_AES_256_CBC)) { throw new RuntimeException('Шифрование не выполнено'); }
if (!openssl_pkcs7_decrypt(__DIR__ . '/encrypted.eml', __DIR__ . '/opened.txt', $certificate, file_get_contents(__DIR__ . '/recipient-private.pem'))) { throw new RuntimeException('Документ не открыт'); }
echo file_get_contents(__DIR__ . '/opened.txt');

Заказ A1: 1200 RUB

Симметричный ключ создаёт контейнер; переданный сертификат выбирает получателя. AES-CBC скрывает содержимое, но этот пример не подтверждает автора; подпись добавляется отдельным этапом ниже.

<?php
declare(strict_types=1);

$names = ['publisher', 'recipient'];
$certificates = array_map(static fn(string $name) => file_get_contents(__DIR__ . '/' . $name . '-cert.pem'), $names);
if (!openssl_pkcs7_encrypt(__DIR__ . '/invoice.txt', __DIR__ . '/encrypted.eml', $certificates, [], PKCS7_BINARY, OPENSSL_CIPHER_AES_256_CBC)) { throw new RuntimeException('Шифрование не выполнено'); }

foreach ($names as $index => $name) {
    if (!openssl_pkcs7_decrypt(__DIR__ . '/encrypted.eml', __DIR__ . '/opened.txt', $certificates[$index], file_get_contents(__DIR__ . '/' . $name . '-private.pem'))) { throw new RuntimeException('Получатель не открыл документ'); }

    echo $name, ': ', trim(file_get_contents(__DIR__ . '/opened.txt')), "\n";
}

publisher: Заказ A1: 1200 RUB
recipient: Заказ A1: 1200 RUB

Массив сертификатов задаёт получателей одного контейнера. У PKCS7 cipher_algo остаётся целочисленной OPENSSL_CIPHER_* константой.

<?php
declare(strict_types=1);

$certificate = file_get_contents(__DIR__ . '/recipient-cert.pem');
$key = file_get_contents(__DIR__ . '/recipient-private.pem');
if (!openssl_pkcs7_decrypt(__DIR__ . '/invoice.encrypted.eml', __DIR__ . '/opened.txt', $certificate, $key)) { throw new RuntimeException('Документ не открыт'); }
echo file_get_contents(__DIR__ . '/opened.txt');

Заказ A1: 1200 RUB

Сертификат помогает контейнеру выбрать запись получателя, закрытый ключ открывает её. Данные появляются в выходном файле, а не в bool результата.

<?php
declare(strict_types=1);

foreach (['publisher', 'recipient'] as $name) {
    $certificate = file_get_contents(__DIR__ . '/' . $name . '-cert.pem');
    $key = file_get_contents(__DIR__ . '/' . $name . '-private.pem');
    $ok = openssl_pkcs7_decrypt(__DIR__ . '/invoice.encrypted.eml', __DIR__ . '/candidate.txt', $certificate, $key);

    echo $name, ': ', $ok ? trim(file_get_contents(__DIR__ . '/candidate.txt')) : 'не адресат, документ не использовать', "\n";
}

publisher: не адресат, документ не использовать
recipient: Заказ A1: 1200 RUB

Контейнер адресован только складу. Путь candidate.txt может быть создан до неуспеха, поэтому читать его допустимо лишь после true; имена файлов сами по себе успех не обозначают.

<?php
declare(strict_types=1);

$data = file_get_contents(__DIR__ . '/certificates.p7b.pem');
if (!openssl_pkcs7_read($data, $certificates)) { throw new RuntimeException('Контейнер не разобран'); }

foreach ($certificates as $pem) {
    echo 'Вложен сертификат: ', openssl_x509_parse($pem)['subject']['CN'], "\n";
}

Вложен сертификат: catalog.example.test

Чтение сертификатов не проверяет подписанный документ. Закрытых ключей из SignedData не извлекают: их там быть не должно.

<?php
declare(strict_types=1);

if (openssl_pkcs7_read(__DIR__ . '/certificates.p7b.pem', $wrong) !== false) { throw new RuntimeException('Поведение сборки изменилось'); }
echo "Имя файла вместо содержимого: отказ\n";
$data = file_get_contents(__DIR__ . '/certificates.p7b.pem');
if (!openssl_pkcs7_read($data, $certificates)) { throw new RuntimeException('Контейнер не разобран'); }

foreach ($certificates as $pem) {
    echo 'Вложен сертификат: ', openssl_x509_parse($pem)['subject']['CN'], "\n";
}
file_put_contents(__DIR__ . '/extracted.pem', $certificates[0]);
echo "extracted.pem сохранён; доверие проверяем отдельно\n";

Имя файла вместо содержимого: отказ
Вложен сертификат: catalog.example.test
extracted.pem сохранён; доверие проверяем отдельно

У CMS аргумент называется input_filename, но PHP 8.5 читает переданную строку через memoryBIO как PEM. Это проверено запуском и подтверждено исходниками; слепая передача пути не работает.

<?php
declare(strict_types=1);

$certificate = file_get_contents(__DIR__ . '/publisher-cert.pem');
$key = file_get_contents(__DIR__ . '/publisher-private.pem');
if (!openssl_cms_sign(__DIR__ . '/invoice.txt', __DIR__ . '/out.cms.pem', $certificate, $key, [], OPENSSL_CMS_BINARY, OPENSSL_ENCODING_PEM)) { throw new RuntimeException('Документ не подписан'); }
if (openssl_cms_verify(__DIR__ . '/out.cms.pem', OPENSSL_CMS_BINARY, null, [__DIR__ . '/lab-ca.pem'], null, __DIR__ . '/verified.txt', null, null, OPENSSL_ENCODING_PEM) !== true) { throw new RuntimeException('Подпись не принята'); }
echo file_get_contents(__DIR__ . '/verified.txt');

Заказ A1: 1200 RUB

Закрытый ключ подписывает данные, сертификат сопровождает подпись. Доверие задано отдельным lab-ca.pem. Показан текст, извлечённый только после успешной проверки.

<?php
declare(strict_types=1);

$certificate = file_get_contents(__DIR__ . '/publisher-cert.pem');
$key = file_get_contents(__DIR__ . '/publisher-private.pem');
$flags = OPENSSL_CMS_BINARY | OPENSSL_CMS_DETACHED;
if (!openssl_cms_sign(__DIR__ . '/invoice.txt', __DIR__ . '/invoice.sig.der', $certificate, $key, [], $flags, OPENSSL_ENCODING_DER)) { throw new RuntimeException('Подпись не создана'); }
$ok = openssl_cms_verify(__DIR__ . '/invoice.txt', $flags, null, [__DIR__ . '/lab-ca.pem'], null, null, null, __DIR__ . '/invoice.sig.der', OPENSSL_ENCODING_DER);
echo $ok ? "invoice.txt + invoice.sig.der: отделённая подпись подтверждена\n" : "Документ отклонён\n";

invoice.txt + invoice.sig.der: отделённая подпись подтверждена

Два файла имеют разные роли: input_filename содержит оригинал, sigfile у verify — входную подпись. DER задаётся явно; почтовые headers к DER не добавляются. Для этого S/MIME-примера исходный текст архива явно хранится с CRLF: подпись относится к согласованным байтам строк.

<?php
declare(strict_types=1);

$ok = openssl_cms_verify(__DIR__ . '/invoice.cms.pem', OPENSSL_CMS_BINARY, __DIR__ . '/signer.pem', [__DIR__ . '/lab-ca.pem'], null, __DIR__ . '/verified.txt', null, null, OPENSSL_ENCODING_PEM);
if ($ok !== true) { throw new RuntimeException('Подпись не принята'); }
echo file_get_contents(__DIR__ . '/verified.txt');
echo 'Подписант: ', openssl_x509_parse(file_get_contents(__DIR__ . '/signer.pem'))['subject']['CN'], "\n";

Заказ A1: 1200 RUB
Подписант: catalog.example.test

Отдельно показаны проверенные данные и извлечённый подписант. CA-файл получен заранее; сертификат из самого входного контейнера автоматически доверенным не становится.

<?php
declare(strict_types=1);

file_put_contents(__DIR__ . '/signature.der', base64_decode(file_get_contents(__DIR__ . '/invoice.detached.der.b64'), true));
file_put_contents(__DIR__ . '/changed.txt', str_replace('1200', '9900', file_get_contents(__DIR__ . '/invoice.txt')));
foreach (['invoice.txt', 'changed.txt'] as $file) {
    $ok = openssl_cms_verify(__DIR__ . '/' . $file, OPENSSL_CMS_BINARY | OPENSSL_CMS_DETACHED, null, [__DIR__ . '/lab-ca.pem'], null, null, null, __DIR__ . '/signature.der', OPENSSL_ENCODING_DER);
    echo $file, ': ', $ok === true ? 'документ принят' : 'подпись не подтверждена', "\n";
}

invoice.txt: документ принят
changed.txt: подпись не подтверждена

Изменённые данные сохранены в новом файле, оригинал остаётся для сравнения. Выходной content-файл после отказа нельзя использовать даже если он существует или частично записан. Готовая отделённая подпись была создана для CRLF-оригинала: архив сохраняет именно эти байты; замена CRLF на LF также нарушила бы подпись.

<?php
declare(strict_types=1);

$certificate = file_get_contents(__DIR__ . '/recipient-cert.pem');
if (!openssl_cms_encrypt(__DIR__ . '/invoice.txt', __DIR__ . '/encrypted.pem', $certificate, [], OPENSSL_CMS_BINARY, OPENSSL_ENCODING_PEM, OPENSSL_CIPHER_AES_256_CBC)) { throw new RuntimeException('Шифрование не выполнено'); }
if (!openssl_cms_decrypt(__DIR__ . '/encrypted.pem', __DIR__ . '/opened.txt', $certificate, file_get_contents(__DIR__ . '/recipient-private.pem'), OPENSSL_ENCODING_PEM)) { throw new RuntimeException('Документ не открыт'); }
echo file_get_contents(__DIR__ . '/opened.txt');

Заказ A1: 1200 RUB

Симметричный ключ создаёт контейнер; переданный сертификат выбирает получателя. AES-CBC скрывает содержимое, но этот пример не подтверждает автора; подпись добавляется отдельным этапом ниже.

<?php
declare(strict_types=1);

$names = ['publisher', 'recipient'];
$certificates = array_map(static fn(string $name) => file_get_contents(__DIR__ . '/' . $name . '-cert.pem'), $names);
if (!openssl_cms_encrypt(__DIR__ . '/invoice.txt', __DIR__ . '/encrypted.pem', $certificates, [], OPENSSL_CMS_BINARY, OPENSSL_ENCODING_PEM, 'aes-256-cbc')) { throw new RuntimeException('Шифрование не выполнено'); }

foreach ($names as $index => $name) {
    if (!openssl_cms_decrypt(__DIR__ . '/encrypted.pem', __DIR__ . '/opened.txt', $certificates[$index], file_get_contents(__DIR__ . '/' . $name . '-private.pem'), OPENSSL_ENCODING_PEM)) { throw new RuntimeException('Получатель не открыл документ'); }

    echo $name, ': ', trim(file_get_contents(__DIR__ . '/opened.txt')), "\n";
}

publisher: Заказ A1: 1200 RUB
recipient: Заказ A1: 1200 RUB

Массив сертификатов задаёт получателей одного контейнера. Строковое имя cipher_algo поддерживается с PHP 8.5; ранее нужен целочисленный идентификатор.

<?php
declare(strict_types=1);

$certificate = file_get_contents(__DIR__ . '/recipient-cert.pem');
$key = file_get_contents(__DIR__ . '/recipient-private.pem');
if (!openssl_cms_decrypt(__DIR__ . '/invoice.cms.encrypted.pem', __DIR__ . '/opened.txt', $certificate, $key, OPENSSL_ENCODING_PEM)) { throw new RuntimeException('Документ не открыт'); }
echo file_get_contents(__DIR__ . '/opened.txt');

Заказ A1: 1200 RUB

Сертификат помогает контейнеру выбрать запись получателя, закрытый ключ открывает её. Данные появляются в выходном файле, а не в bool результата.

<?php
declare(strict_types=1);

foreach (['publisher', 'recipient'] as $name) {
    $certificate = file_get_contents(__DIR__ . '/' . $name . '-cert.pem');
    $key = file_get_contents(__DIR__ . '/' . $name . '-private.pem');
    $ok = openssl_cms_decrypt(__DIR__ . '/invoice.cms.encrypted.pem', __DIR__ . '/candidate.txt', $certificate, $key, OPENSSL_ENCODING_PEM);

    echo $name, ': ', $ok ? trim(file_get_contents(__DIR__ . '/candidate.txt')) : 'не адресат, документ не использовать', "\n";
}

publisher: не адресат, документ не использовать
recipient: Заказ A1: 1200 RUB

Контейнер адресован только складу. Путь candidate.txt может быть создан до неуспеха, поэтому читать его допустимо лишь после true; имена файлов сами по себе успех не обозначают.

<?php
declare(strict_types=1);

$data = file_get_contents(__DIR__ . '/invoice.cms.pem');
if (!openssl_cms_read($data, $certificates)) { throw new RuntimeException('Контейнер не разобран'); }

foreach ($certificates as $pem) {
    echo 'Вложен сертификат: ', openssl_x509_parse($pem)['subject']['CN'], "\n";
}

Вложен сертификат: catalog.example.test

Чтение сертификатов не проверяет подписанный документ. Закрытых ключей из SignedData не извлекают: их там быть не должно.

<?php
declare(strict_types=1);

if (openssl_cms_read(__DIR__ . '/invoice.cms.pem', $wrong) !== false) { throw new RuntimeException('Поведение сборки изменилось'); }
echo "Имя файла вместо содержимого: отказ\n";
$data = file_get_contents(__DIR__ . '/invoice.cms.pem');
if (!openssl_cms_read($data, $certificates)) { throw new RuntimeException('Контейнер не разобран'); }

foreach ($certificates as $pem) {
    echo 'Вложен сертификат: ', openssl_x509_parse($pem)['subject']['CN'], "\n";
}
file_put_contents(__DIR__ . '/extracted.pem', $certificates[0]);
echo "extracted.pem сохранён; доверие проверяем отдельно\n";

Имя файла вместо содержимого: отказ
Вложен сертификат: catalog.example.test
extracted.pem сохранён; доверие проверяем отдельно

У CMS аргумент называется input_filename, но PHP 8.5 читает переданную строку через memoryBIO как PEM. Это проверено запуском и подтверждено исходниками; слепая передача пути не работает.