Openssl x509 free: примеры (PHP)

Типичные ошибки при использовании

<?php
$cert = openssl_x509_read($certData);
openssl_x509_free($cert);

// Ошибка: ресурс уже освобожден
$details = openssl_x509_parse($cert);
?>

Warning: openssl_x509_parse(): supplied resource is not a valid OpenSSL X.509 resource

<?php
$cert = 'not a resource';
// Ошибка: ожидается ресурс
openssl_x509_free($cert);
?>

Warning: openssl_x509_free(): supplied argument is not a valid OpenSSL X.509 resource

<?php
$cert = openssl_x509_read($certData);
openssl_x509_free($cert);
// Вторая попытка освобождения того же ресурса
openssl_x509_free($cert); // Ошибка
?>

Warning: openssl_x509_free(): supplied argument is not a valid OpenSSL X.509 resource

<?php
// CSR и приватный ключ
$csr = openssl_csr_new($dn, $privkey);
$cert = openssl_csr_sign($csr, null, $privkey, 365);

// Правильное использование
openssl_x509_free($cert);
?>

Изменения в последних версиях PHP

В PHP 8.0.0 произошли значительные изменения в работе с ресурсами OpenSSL. Вместо ресурсов теперь используются объекты:

• Функции OpenSSL теперь возвращают объекты OpenSSLCertificate, OpenSSLCertificateSigningRequest и OpenSSLAsymmetricKey вместо ресурсов
• Для объектов не требуется явный вызов openssl_x509_free() - управление памятью осуществляется автоматически
• Функция openssl_x509_free() продолжает работать для обратной совместимости, но вызывает предупреждение при использовании с объектами

<?php
// В PHP 8.0+
$cert = openssl_x509_read($certData);
var_dump($cert); // object(OpenSSLCertificate)#1

// Вызов openssl_x509_free() необязателен
// но возможен для обратной совместимости
?>

object(OpenSSLCertificate)#1 (0) {
}

В PHP 8.2.0 улучшена обработка объектов OpenSSL и добавлены дополнительные методы валидации. Функция openssl_x509_free() формально объявлена устаревшей для использования с объектами, но продолжает функционировать.

Расширенные примеры использования

<?php
function processCertificateChain($chainPem) {
    $certs = [];
    $currentPos = 0;
    
    // Разделение цепочки на отдельные сертификаты
    while (($certPos = strpos($chainPem, '-----BEGIN CERTIFICATE-----', $currentPos)) !== false) {
        $endPos = strpos($chainPem, '-----END CERTIFICATE-----', $certPos);
        if ($endPos === false) break;
        
        $endPos += 25; // Длина '-----END CERTIFICATE-----'
        $singleCert = substr($chainPem, $certPos, $endPos - $certPos);
        
        $certResource = openssl_x509_read($singleCert);
        if ($certResource !== false) {
            $certs[] = $certResource;
        }
        
        $currentPos = $endPos;
    }
    
    // Обработка каждого сертификата в цепочке
    foreach ($certs as $index => $cert) {
        $parsed = openssl_x509_parse($cert);
        echo "Сертификат #" . ($index + 1) . ": " . $parsed['name'] . "\n";
        echo "Действителен до: " . date('Y-m-d', $parsed['validTo_time_t']) . "\n\n";
        
        // Освобождение ресурса после обработки
        openssl_x509_free($cert);
    }
    
    return count($certs);
}

$chain = file_get_contents('chain.pem');
$count = processCertificateChain($chain);
echo "Обработано сертификатов: $count\n";
?>

Сертификат #1: /C=RU/O=Example Corp/CN=example.com
Действителен до: 2024-12-31

Сертификат #2: /C=US/O=Intermediate CA/CN=CA Intermediate
Действителен до: 2026-12-31

Сертификат #3: /C=US/O=Root CA/CN=Global Root
Действителен до: 2030-12-31

Обработано сертификатов: 3

<?php
function signDataWithTempCertificate($data, $privateKey, $certContent) {
    // Создание временного файла для сертификата
    $tempCertFile = tempnam(sys_get_temp_dir(), 'cert_');
    file_put_contents($tempCertFile, $certContent);
    
    // Подпись данных
    $tempInfile = tempnam(sys_get_temp_dir(), 'in_');
    $tempOutfile = tempnam(sys_get_temp_dir(), 'out_');
    file_put_contents($tempInfile, $data);
    
    if (openssl_pkcs7_sign($tempInfile, $tempOutfile, 
                          $tempCertFile, $privateKey, [], PKCS7_DETACHED)) {
        $signedData = file_get_contents($tempOutfile);
    } else {
        $signedData = false;
    }
    
    // Очистка временных файлов
    unlink($tempCertFile);
    unlink($tempInfile);
    unlink($tempOutfile);
    
    return $signedData;
}

// Альтернативный подход с openssl_x509_read и openssl_x509_free
function signDataInMemory($data, $privateKey, $certContent) {
    $cert = openssl_x509_read($certContent);
    
    if ($cert === false) {
        return false;
    }
    
    // В реальном приложении здесь была бы подпись
    $certInfo = openssl_x509_parse($cert);
    
    // Освобождение ресурса сертификата
    openssl_x509_free($cert);
    
    return [
        'signed' => true,
        'cert_info' => $certInfo['name'],
        'timestamp' => time()
    ];
}

// Пример использования
$result = signDataInMemory('Test data', $privKey, $certPem);
print_r($result);
?>

Array
(
    [signed] => 1
    [cert_info] => /C=RU/O=Test Company/CN=test.example.com
    [timestamp] => 1678891234
)

<?php
class CertificateBatchProcessor {
    private $maxMemoryUsage;
    
    public function __construct($maxMemoryMB = 50) {
        $this->maxMemoryUsage = $maxMemoryMB * 1024 * 1024;
    }
    
    public function processBatch($certificatePaths) {
        $results = [];
        
        foreach ($certificatePaths as $path) {
            if (!file_exists($path)) {
                $results[$path] = 'Файл не найден';
                continue;
            }
            
            $certData = file_get_contents($path);
            $cert = openssl_x509_read($certData);
            
            if ($cert === false) {
                $results[$path] = 'Неверный формат сертификата';
                continue;
            }
            
            $info = openssl_x509_parse($cert);
            $results[$path] = [
                'subject' => $info['name'],
                'valid_to' => date('Y-m-d', $info['validTo_time_t']),
                'is_expired' => time() > $info['validTo_time_t']
            ];
            
            // Явное освобождение ресурса
            openssl_x509_free($cert);
            
            // Контроль использования памяти
            if (memory_get_usage(true) > $this->maxMemoryUsage) {
                gc_collect_cycles(); // Принудительный сбор мусора
            }
        }
        
        return $results;
    }
}

// Использование
$processor = new CertificateBatchProcessor(10); // Лимит 10MB
$certFiles = glob('/path/to/certificates/*.crt');
$results = $processor->processBatch(array_slice($certFiles, 0, 100));

echo "Обработано: " . count($results) . " сертификатов\n";
echo "Использовано памяти: " . round(memory_get_peak_usage(true) / 1024 / 1024, 2) . " MB\n";
?>

Обработано: 100 сертификатов
Использовано памяти: 8.42 MB