【PHP8.x】openssl_x509_read関数の使い方

openssl_x509_read関数の使い方について、初心者にもわかりやすく解説します。

作成日: 2025年09月11日更新日: 2025年09月29日

基本的な使い方

openssl_x509_read関数は、X.509形式のデジタル証明書を読み込み、PHPアプリケーションで扱える形式に変換するための関数です。X.509証明書とは、Webサイトの身元確認やデータの暗号化、デジタル署名などに使われる国際標準の電子証明書であり、インターネットの安全な通信（SSL/TLS通信、HTTPSなど）において重要な役割を果たします。

この関数は、ファイルパスで指定された証明書ファイルを読み込んだり、あるいはPEM形式などの文字列として提供された証明書データを解析したりする際に利用されます。例えば、外部から受け取った証明書の内容を検証したり、自身のアプリケーションが利用する証明書をプログラム的に管理したりするような場面で役立ちます。

成功した場合、openssl_x509_read関数は読み込んだX.509証明書を表す特殊なリソース型を返します。このリソースは、証明書の発行者、有効期限、公開鍵などの詳細情報を取り出すための、他のOpenSSL関連関数（例えば openssl_x509_parse）と組み合わせて利用することができます。これにより、証明書の正当性を確認したり、そこに含まれる公開鍵を利用してデータの暗号化や署名の検証を行ったりすることが可能になります。

もし証明書の読み込みや解析に失敗した場合は、この関数は false を返しますので、エラー発生時には戻り値を確認し、適切なエラー処理を行うことがシステムエンジニアにとって非常に重要です。この関数を利用するには、PHPのOpenSSL拡張がサーバーにインストールされ、有効になっている必要があります。セキュリティに関わる重要な処理の基盤となる、基本的な機能を提供する関数です。

構文(syntax)


1<?php
2$certificateDataString = '-----BEGIN CERTIFICATE-----...-----END CERTIFICATE-----';
3$certificateResource = openssl_x509_read($certificateDataString);
4?>

引数(parameters)

OpenSSLCertificate|string $certificate

OpenSSLCertificate|string $certificate: X.509証明書を読み込むための証明書データ。OpenSSL証明書リソースまたは証明書の内容を表す文字列で指定します。

戻り値(return)

OpenSSLCertificate|false

openssl_x509_read関数は、PEM形式またはDER形式でエンコードされたX.509証明書を読み込み、OpenSSL証明書オブジェクトを返します。証明書の読み込みに失敗した場合はfalseを返します。

サンプルコード

PHP openssl_x509_readで証明書を読み込む


1<?php
2
3// 証明書ファイルへのパス
4$certificateFile = 'path/to/your/certificate.pem';
5
6// 証明書ファイルを読み込む
7$certificateData = file_get_contents($certificateFile);
8
9if ($certificateData === false) {
10    echo "証明書ファイルの読み込みに失敗しました。\n";
11    exit(1);
12}
13
14// 証明書を読み込む
15$certificate = openssl_x509_read($certificateData);
16
17if ($certificate === false) {
18    echo "証明書の読み込みに失敗しました。\n";
19    // エラー理由を出力 (デバッグ用)
20    echo "OpenSSL エラー: " . openssl_error_string() . "\n";
21    exit(1);
22}
23
24// 証明書が正常に読み込まれた場合の処理
25echo "証明書の読み込みに成功しました。\n";
26
27// 証明書リソースを解放する
28openssl_x509_free($certificate);
29
30?>

openssl_x509_read関数は、PHPのOpenSSL拡張に含まれる関数で、X.509形式の証明書を読み込むために使用します。引数$certificateには、証明書データそのもの（文字列）またはOpenSSLCertificateリソースを指定します。この関数は、指定された証明書データを解析し、証明書リソース (OpenSSLCertificateオブジェクト) を返します。

サンプルコードでは、まずfile_get_contents関数を使って、指定されたパスにある証明書ファイルの内容を文字列として読み込んでいます。証明書ファイルの読み込みに失敗した場合は、エラーメッセージを表示してスクリプトを終了します。

次に、openssl_x509_read関数に、読み込んだ証明書データを渡して証明書の解析を試みます。関数の戻り値がfalseの場合、証明書の読み込みに失敗したことを意味します。この場合、エラーメッセージとOpenSSLのエラー内容（デバッグ用）を表示してスクリプトを終了します。

証明書の読み込みに成功した場合、成功メッセージを表示します。最後に、openssl_x509_free関数を呼び出して、使用済みの証明書リソースを解放します。リソースを解放することで、メモリリークを防ぐことができます。

この関数を利用することで、PHPでX.509証明書に関する様々な処理を行うための準備ができます。例えば、証明書の情報を取得したり、署名を検証したりすることが可能になります。

openssl_x509_read関数を使う際の注意点です。引数には、証明書データそのもの（文字列）またはOpenSSLCertificateオブジェクトを渡します。ファイルパスを直接指定するのではなく、file_get_contentsなどでファイルの内容を読み込んでから渡す必要があります。関数の戻り値は、成功時はOpenSSLCertificateオブジェクト、失敗時はfalseです。必ず戻り値を確認し、エラーハンドリングを行いましょう。openssl_error_string()関数でOpenSSLのエラー内容を取得できます。読み込んだ証明書リソースは、openssl_x509_free関数で明示的に解放することが推奨されます。特にループ処理などで繰り返し証明書を読み込む場合は、リソースリークを防ぐために重要です。