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() は、
certificate
を PKCS#12 ファイルフォーマットにしたものを
output
で指定した文字列に格納します。
x509
使用できる値の一覧は キー/証明書パラメータ を参照ください。
output
成功した場合に、ここに PKCS#12 が保存されます。
private_key
PKCS#12 ファイルのプライベートキーコンポーネント。 正しい値の一覧については、Public/Private Key parameters を参照ください。
passphrase
PKCS#12 ファイルのロックを解除するためのパスワード。
options
オプションの配列。以下に示すキー以外は無視されます。
キー | 説明 |
---|---|
"extracerts" |
PKCS#12 ファイルに含まれる単一の証明書、または 外部の証明書の配列 |
"friendly_name" |
与えられた証明書とキーで使われる文字列 |
バージョン | 説明 |
---|---|
8.0.0 |
certificate は、
OpenSSLCertificate クラスのインスタンスを受け入れるようになりました。
これより前のバージョンでは、
OpenSSL X.509 CSR 型のリソースを受け入れていました。
|
8.0.0 |
private_key は、
OpenSSLAsymmetricKey または
OpenSSLCertificate インスタンスを受け入れるようになりました。
これより前のバージョンでは、
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);
?>