2024 年 PHP Conference Japan

    openssl_pkcs12_export

    (PHP 5 >= 5.2.2, PHP 7, PHP 8)

    openssl_pkcs12_export — 將 PKCS#12 相容的憑證儲存檔案匯出至變數

    說明

    openssl_pkcs12_export(
        OpenSSLCertificate|字串 $certificate,
        字串 &$output,
        #[\SensitiveParameter] OpenSSLAsymmetricKey|OpenSSLCertificate|陣列|字串 $private_key,
        #[\SensitiveParameter] 字串 $passphrase,
        陣列 $options = []
    ): 布林值

    openssl_pkcs12_export() 將 certificate 以 PKCS#12 檔案格式儲存到名為 output 的字串中。

    參數

    x509

    關於有效值的列表，請參閱 金鑰/憑證參數。

    output

    成功時，這將包含 PKCS#12。

    private_key

    PKCS#12 檔案的私鑰組件。關於有效值的列表，請參閱 公鑰/私鑰參數。

    passphrase

    用於解鎖 PKCS#12 檔案的加密密碼。

    options

    可選陣列，其他鍵將被忽略。

    鍵 說明
    "extracerts" 要包含在 PKCS#12 檔案中的額外憑證陣列或單個憑證。
    "friendly_name" 用於提供的憑證和金鑰的字串

    返回值

    成功時返回 true，失敗時返回 false。

    更新日誌

    版本 說明
    8.0.0 certificate 現在接受 OpenSSLCertificate 實例；以前接受類型為 OpenSSL X.509 CSR 的 資源。
    8.0.0 private_key 現在接受 OpenSSLAsymmetricKey 或 OpenSSLCertificate 實例；以前接受類型為 OpenSSL key 或 OpenSSL X.509 的 資源。

    發現問題了嗎？

    學習如何改進此頁面 • 提交拉取請求 • 回報錯誤
    ＋新增註釋

    使用者貢獻的註釋 4 則註釋

    3
    simoncpu was here
    14 年前
    如果您的憑證沒有密碼保護，請使用 null 或空字串。否則，此函式將無法運作。
    1
    Robert
    10 年前
    如果您需要提供多個額外憑證，則 'extracerts' 參數需要是一個每個元素包含一個憑證的陣列。
    <?php
    $args     = array(
    'extracerts' => array(
    0 => '-----BEGIN CERTIFICATE----- cert1 ...',
    1 => '-----BEGIN CERTIFICATE----- cert2 ...',
    // ...
    )
    );
    ?>

    您可以使用這個來準備 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);
    ?>
    1
    ismael at privasy dot org
    10 年前
    要將私鑰匯出為 pkcs12 格式，輸入的憑證必須包含 PEM 格式的私鑰和相關聯的公鑰，

    -----BEGIN RSA PRIVATE KEY-----
    -----END RSA PRIVATE KEY-----

    -----BEGIN CERTIFICATE-----
    -----END CERTIFICATE-----

    否則此函數可能會返回以下錯誤「openssl_pkcs12_export(): cannot get cert from parameter 1」（openssl_pkcs12_export(): 無法從參數 1 取得憑證）
    1
    匿名
    11 年前
    如果您想在 PKCS12 中包含 CA 憑證，可以使用 $args 參數來完成。
    <?php
    $args     = array(
    'extracerts' => $CAcert,
    'friendly_name' => '我的憑證，由 CA 憑證簽署'
    );
    openssl_pkcs12_export($signed_csr, $cerificate_out, $private_key_resource, $passphrase, $args);
    ?>
    ＋新增註釋
    To Top