openssl_pkey_get_private

Get a private key

Description

OpenSSLAsymmetricKeyfalse openssl_pkey_get_private(#[\SensitiveParameter]OpenSSLAsymmetricKeyOpenSSLCertificatearraystring $private_key, #[\SensitiveParameter]stringnull $passphrase = null)

openssl_pkey_get_private parses private_key and prepares it for use by other functions.

Parameters

private_key

private_key can be one of the following:

  1. a string having the format file://path/to/file.pem. The named file must contain a PEM encoded certificate/private key (it may contain both).
  2. A PEM formatted private key.

passphrase

The optional parameter passphrase must be used if the specified key is encrypted (protected by a passphrase).

Return Values

Returns an OpenSSLAsymmetricKey instance on success, or false on error.

Changelog

Version Description
8.0.0 On success, this function returns an OpenSSLAsymmetricKey instance now; previously, a resource of type OpenSSL key was returned.
8.0.0 private_key accepts an OpenSSLAsymmetricKey or OpenSSLCertificate instance now; previously, a resource of type OpenSSL key or OpenSSL X.509 was accepted.
8.0.0 passphrase is nullable now.