Webエンジニア向けプログラミング解説動画をYouTubeで配信中!
▶ チャンネル登録はこちら

【PHP8.x】CURLINFO_SSL_VERIFYRESULT定数の使い方

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

作成日: 更新日:

基本的な使い方

CURLINFO_SSL_VERIFYRESULT定数は、PHPのcURL拡張機能において、SSL/TLS証明書の検証結果を表す定数です。この定数は、ウェブサイトやAPIなどとのセキュアな通信、特にHTTPS通信を行う際に、接続先のサーバーが提示するSSL証明書が正当であるかをシステムが検証した結果を取得するために使用されます。

具体的には、curl_getinfo()関数にCURLINFO_SSL_VERIFYRESULT定数を引数として渡すことで、直前に行われたcURL転送におけるSSL証明書検証の最終的な結果コードを取得できます。取得される結果コードが0の場合、SSL証明書の検証は成功し、通信相手のサーバーが信頼できるものであると判断されたことを意味します。一方で、0以外の値が返された場合は、検証が失敗したか、何らかの問題が発生したことを示しており、その値は特定のエラーコードに対応します。

システム開発において、外部サービスとの安全なデータ送受信を確立する際、SSL証明書の検証は極めて重要なセキュリティ対策の一つです。この定数を利用することで、プログラムからSSL証明書の検証状況を詳細に把握し、検証が失敗した場合に適切なエラー処理やログ記録を行うことが可能になります。これにより、アプリケーションのセキュリティと信頼性を高める上で、この定数は重要な役割を担っています。

構文(syntax)

1<?php
2
3$ch = curl_init();
4curl_setopt($ch, CURLOPT_URL, "https://www.example.com");
5curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
6
7curl_exec($ch);
8
9// CURLINFO_SSL_VERIFYRESULT 定数を使用して、直前のSSL検証の結果を取得します。
10// 検証が成功した場合は 0 が返され、失敗した場合はエラーコードが返されます。
11$sslVerificationResult = curl_getinfo($ch, CURLINFO_SSL_VERIFYRESULT);
12
13curl_close($ch);
14
15?>

引数(parameters)

引数なし

引数はありません

戻り値(return)

戻り値なし

戻り値はありません

関連コンテンツ