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

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

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

作成日: 更新日:

基本的な使い方

CURL_VERSION_HSTS定数は、libcurlライブラリがHTTP Strict Transport Security (HSTS) のサポートを含んでいるかどうかを示すビットマスクを表す定数です。

HSTSは、ウェブサイトがクライアントに対して、今後常にHTTPS接続を使用するよう強制するためのセキュリティ機構です。これにより、中間者攻撃や、意図しないHTTPへのダウングレードを防ぎ、通信の安全性を高めることができます。

この定数は、PHPのcURL拡張機能を通じて利用可能なlibcurlライブラリが、このHSTS機能に対応しているかを確認する際に利用されます。具体的には、curl_version()関数やcurl_version_info()関数が返す、libcurlの機能を示すビットマスクの中に、HSTSサポートの情報が含まれているかどうかを判別するために使用されます。

例えば、curl_version_info()関数が返す情報のfeatures要素に対し、このCURL_VERSION_HSTS定数をビット論理AND演算子で適用することで、現在のcURL環境がHSTSをサポートしているか否かをプログラムで確認することができます。これにより、アプリケーションがlibcurlの特定のセキュリティ機能に依存する場合、実行環境がその要件を満たしているかを事前にチェックすることが可能になります。このように、CURL_VERSION_HSTSは、Web通信のセキュリティを高めるHSTS機能のlibcurlサポート状況を判別するための重要な定数として機能します。

構文(syntax)

1<?php
2
3// cURLがHTTP Strict Transport Security (HSTS) をサポートしているか確認する例
4$curl_version_info = curl_version();
5
6if ($curl_version_info['features'] & CURL_VERSION_HSTS) {
7    echo "cURLはHSTSをサポートしています。\n";
8} else {
9    echo "cURLはHSTSをサポートしていません。\n";
10}
11
12?>

引数(parameters)

引数なし

引数はありません

戻り値(return)

int

CURL_VERSION_HSTSは、libcurlがHSTS(HTTP Strict Transport Security)をサポートしている場合に1を返します。サポートしていない場合は0を返します。

関連コンテンツ