If your certificate is not password-protected, just use null or a blank string. Otherwise, this function won't work.
(PHP 5 >= 5.2.2, PHP 7, PHP 8)
openssl_pkcs12_export — Экспортирует совместимый с PKCS#12 файл хранилища сертификатов в переменную
$certificate
,&$output
,$private_key
,$passphrase
,$options
= []
Функция openssl_pkcs12_export() сохраняет
x509
в переменную
out
в формате PKCS#12.
x509
Для списка корректных значений смотрите Параметры ключей или сертификатов.
output
В случае успешного выполнения будет содержать PKCS#12.
private_key
Компонент закрытого ключа файла PKCS#12. Список допустимых значений смотрите на странице параметров открытого/закрытого ключа.
passphrase
Пароль для шифрования файла PKCS#12.
options
Массив опций. Не описанные здесь ключи будут проигнорированы.
Ключ | Описание |
---|---|
"extracerts" |
массив дополнительных сертификатов или один сертификат для включения в файл PKCS#12. |
"friendly_name" |
строка для использования сертификатом и ключом |
Функция возвращает true
в случае успешного выполнения или false
, если возникла ошибка.
Версия | Описание |
---|---|
8.0.0 |
Параметр certificate теперь принимает экземпляр OpenSSLCertificate;
ранее принимался ресурс (resource) типа OpenSSL X.509 CSR .
|
8.0.0 |
Параметр private_key теперь принимает экземпляр OpenSSLAsymmetricKey
или OpenSSLCertificate;
раньше принимался ресурс (resource) типа OpenSSL key или OpenSSL X.509 .
|
If your certificate is not password-protected, just use null or a blank string. Otherwise, this function won't work.
If you need to provide multiple additional certificates, the 'extracerts' argument needs to be an array with one certificate per element:
<?php
$args = array(
'extracerts' => array(
0 => '-----BEGIN CERTIFICATE----- cert1 ...',
1 => '-----BEGIN CERTIFICATE----- cert2 ...',
// ...
)
);
?>
You can use this to prepare a PEM.
<?php
$pemChain = '...';
preg_match_all('/(-----BEGIN CERTIFICATE-----.*?-----END CERTIFICATE-----)/si', $pemChain, $matches);
$args = array('extracerts' => $matches[0]);
openssl_pkcs12_export($signed_csr, $cerificate_out, $private_key_resource, $passphrase, $args);
?>
in order to export a private key to pkcs12 format, the input certificate must contain both private and associated public key in PEM format ,
-----BEGIN RSA PRIVATE KEY-----
-----END RSA PRIVATE KEY-----
-----BEGIN CERTIFICATE-----
-----END CERTIFICATE-----
else this function might return the following error "openssl_pkcs12_export(): cannot get cert from parameter 1"
If you want to include CA-Certificates in the PKCS12 it can be accomplished by using the $args parameter.
<?php
$args = array(
'extracerts' => $CAcert,
'friendly_name' => 'My signed cert by CA certificate'
);
openssl_pkcs12_export($signed_csr, $cerificate_out, $private_key_resource, $passphrase, $args);
?>