PHPのhttp://ラッパーとは？HTTP/HTTPSストリームラッパーの使い方を解説

はじめに

https:// および https:// ラッパーは、HTTPプロトコル経由でリソースやファイルへの読み取り専用アクセスを可能にするストリームラッパーです。名前ベースの仮想ホストを扱う場合には、Host: ヘッダーが user_agent（php.ini で設定されている場合）とともに送信されます。

HTTPヘッダー情報は $http_response_header 変数に格納されます。このヘッダーを処理することで、from: ヘッダーの情報をもとに、ドキュメントがどのURLのリソースから取得されたものなのかを把握できます。

なお、HTTPSは php.ini の設定で openssl 拡張モジュールが有効になっている場合にのみ利用可能です。また、HTTP・HTTPSどちらの接続も読み取り専用であり、ファイルへの書き込みやコピーはサポートされていません。

使い方

ファイル名（URL）は、以下のようにさまざまな形式で指定できます。

https://localhost
https://example.com
https://localhost?name='Ram'&age=20
https://example.com
https://username:password@abc.com

使用例

次のスクリプトは、fopen() でHTTPのURLを開き、stream_get_meta_data() を使ってヘッダーのメタデータを取得する例です。

<?php
$url = 'https://www.tutorialspoint.com/php7/php7_closure_call.htm';
if (!$fp = fopen($url, 'r')) {
    trigger_error("Unable to open URL ($url)", E_USER_ERROR);
}
$meta = stream_get_meta_data($fp);
print_r($meta);
?>

上記のスクリプトは、HTTPのURLからヘッダーのメタデータを読み取ります。実行すると、以下のような配列が出力されます。

Array(
    [crypto] => Array(
        [protocol] => TLSv1.2
        [cipher_name] => ECDHE-RSA-AES128-GCM-SHA256
        [cipher_bits] => 128
        [cipher_version] => TLSv1/SSLv3
    )

    [timed_out] =>
    [blocked] => 1
    [eof] =>
    [wrapper_data] => Array(
        [0] => HTTP/1.0 200 OK
        [1] => Age: 1310067
        [2] => Cache-Control: max-age=2592000
        [3] => Content-Type: text/html; charset=UTF-8
        [4] => Date: Mon, 14 Sep 2020 17:15:36 GMT
        [5] => Expires: Wed, 14 Oct 2020 17:15:36 GMT
        [6] => Last-Modified: Sun, 30 Aug 2020 13:21:09 GMT
        [7] => Server: ECS (nag/99AA)
        [8] => Strict-Transport-Security: max-age=63072000; includeSubdomains
        [9] => Vary: Accept-Encoding
        [10] => X-Cache: HIT
        [11] => X-Content-Type-Options: nosniff
        [12] => X-Frame-Options: SAMEORIGIN
        [13] => X-XSS-Protection: 1; mode=block
        [14] => Content-Length: 24102
        [15] => Connection: close
    )
    [wrapper_type] => http
    [stream_type] => tcp_socket/ssl
    [mode] => r
    [unread_bytes] => 0
    [seekable] =>
    [uri] => https://www.tutorialspoint.com/php7/php7_closure_call.htm
)

この出力から、使用されているTLSプロトコルや暗号方式、HTTPステータスコード、キャッシュ情報など、通信に関する詳細なメタデータを確認できます。Web APIのレスポンス検証やデバッグの際に役立つでしょう。