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

CURLINFO_SCHEME定数は、PHPのcURL拡張機能において、実行された通信のURLスキーム、すなわちプロトコルの種類を表す定数です。

この定数は、curl_getinfo()関数と組み合わせて使用されます。curl_getinfo()関数は、cURLセッションに関する様々な情報を取得するために用いられる重要な関数です。具体的には、curl_getinfo($ch, CURLINFO_SCHEME)のように記述することで、指定されたcURLハンドル$chで実行された通信が、どのようなプロトコル（通信規約）を使用しているかを文字列として取得できます。

例えば、ウェブサイトへのリクエストが「https://www.example.com」であった場合、この定数を使用すると「https」という文字列が得られます。同様に、「http://www.example.com」であれば「http」が、「ftp://www.example.com」であれば「ftp」といった値が返されます。

システム開発において、外部のウェブサービスと連携したり、ファイルを転送したりする際、実際にどのプロトコルが使用されたかを確認することは重要です。この情報を使って、通信の安全性をチェックしたり、特定のプロトコルに応じた処理の分岐を行ったりすることが可能になります。CURLINFO_SCHEME定数は、通信の詳細情報をプログラムで扱う上で役立つ、基本的ながらも重要な情報源の一つです。

Copy
1<?php
2$ch = curl_init();
3curl_setopt($ch, CURLOPT_URL, "https://example.com");
4curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
5curl_exec($ch);
6
7$scheme = curl_getinfo($ch, CURLINFO_SCHEME);
8
9curl_close($ch);

引数なし

引数はありません

int

CURLINFO_SCHEMEは、cURL通信で使用されたプロトコルのスキーマを示す整数値を返します。例えば、HTTP通信であれば「http」、HTTPS通信であれば「https」に対応する値が返されます。