Home/ Manual/ openssl / functions/ openssl_x509_fingerprint

openssl_x509_fingerprint

PHP function Edit on GitHub ✎

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

Calculates the fingerprint, or digest, of a given X.509 certificate

Description

openssl_x509_fingerprint(OpenSSLCertificate|string $certificate, string $digest_algo = "sha1", bool $binary = false): string|false

openssl_x509_fingerprint() returns the digest of certificate as a string.

Parameters

digest_algo: The digest method or hash algorithm to use, e.g. "sha256", one of openssl_get_md_methods().
binary: When set to true, outputs raw binary data. false outputs lowercase hexits.

Return Values

Returns a string containing the calculated certificate fingerprint as lowercase hexits unless binary is set to true in which case the raw binary representation of the message digest is returned.

Returns false on failure.

Changelog

Version	Description
8.0.0	`certificate` accepts an `OpenSSLCertificate` instance now; previously, a Resource of type `OpenSSL X.509` was accepted.

Source: reference/openssl/functions/openssl-x509-fingerprint.xml · from the official PHP manual (php/doc-en)