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

Copy
1<?php
2
3/**
4 * 指定されたURLのContent-Typeを取得します。
5 *
6 * この関数は、PHPのcURL拡張機能を使用し、HTTPリクエストを送信して、
7 * そのレスポンスヘッダからContent-Typeの情報を抽出します。
8 * CURLINFO_CONTENT_TYPE定数は、curl_getinfo()関数に渡すことで
9 * 特定のcURLセッションからContent-Type情報を取得するためのキーとして機能します。
10 *
11 * @param string $url 取得するWebページのURL
12 * @return string|false Content-Type文字列（例: 'text/html; charset=UTF-8'）、
13 *                      または取得に失敗した場合はfalseを返します。
14 */
15function getContentTypeFromUrl(string $url): string|false
16{
17    // 1. cURLセッションを初期化します。
18    // cURLはHTTPリクエストをプログラムから送るためのライブラリです。
19    $ch = curl_init();
20
21    // cURLセッションの初期化に失敗した場合のエラーハンドリング
22    if ($ch === false) {
23        echo 'エラー: cURLセッションを開始できませんでした。' . PHP_EOL;
24        return false;
25    }
26
27    // 2. cURLオプションを設定します。
28    // 取得するURLを指定します。
29    curl_setopt($ch, CURLOPT_URL, $url);
30    // サーバーからの応答を文字列として取得し、直接出力しないように設定します。
31    // これにより、curl_exec()の戻り値がレスポンスボディの文字列になります。
32    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
33
34    // 3. cURLリクエストを実行します。
35    // レスポンスボディは変数 $response に格納されます（CURLOPT_RETURNTRANSFER のおかげ）。
36    $response = curl_exec($ch);
37
38    // 4. cURLリクエスト実行中のエラーをチェックします。
39    if ($response === false) {
40        echo 'cURL実行エラー: ' . curl_error($ch) . PHP_EOL;
41        curl_close($ch); // エラーが発生してもセッションは閉じます
42        return false;
43    }
44
45    // 5. CURLINFO_CONTENT_TYPE定数を使用して、Content-Type情報を取得します。
46    // CURLINFO_CONTENT_TYPEは、curl_getinfo()関数に渡すことで、
47    // HTTPレスポンスヘッダに含まれるContent-Typeフィールドの値を取得するための定数です。
48    $contentType = curl_getinfo($ch, CURLINFO_CONTENT_TYPE);
49
50    // 6. cURLセッションを閉じます。
51    // これにより、リソースが解放されます。
52    curl_close($ch);
53
54    return $contentType;
55}
56
57// --- サンプル使用例 ---
58
59// 例1: GoogleのトップページのContent-Typeを取得
60$targetUrl1 = 'https://www.google.com';
61echo "対象URL: {$targetUrl1}" . PHP_EOL;
62$contentType1 = getContentTypeFromUrl($targetUrl1);
63
64if ($contentType1 !== false) {
65    echo "取得されたContent-Type: {$contentType1}" . PHP_EOL;
66} else {
67    echo "Content-Typeの取得に失敗しました。" . PHP_EOL;
68}
69
70echo PHP_EOL; // 見やすくするための改行
71
72// 例2: Googleのロゴ画像のContent-Typeを取得
73$targetUrl2 = 'https://www.google.com/images/branding/googlelogo/1x/googlelogo_color_272x92dp.png';
74echo "対象URL: {$targetUrl2}" . PHP_EOL;
75$contentType2 = getContentTypeFromUrl($targetUrl2);
76
77if ($contentType2 !== false) {
78    echo "取得されたContent-Type: {$contentType2}" . PHP_EOL;
79} else {
80    echo "Content-Typeの取得に失敗しました。" . PHP_EOL;
81}
82
83?>

CURLINFO_CONTENT_TYPEは、PHPのcURL拡張機能で使用される定数です。これは、HTTPリクエストを送信してWebサーバーから受け取ったデータの種類（例: WebページがHTMLか、画像か、PDFかなど）を示す「Content-Type」という情報を取得するために利用されます。

サンプルコードのgetContentTypeFromUrl関数は、指定されたURLのContent-Typeをプログラム的に取得する例を示しています。この関数では、まずcurl_init()でHTTPリクエストを送信するためのcURLセッションを初期化します。次に、curl_setopt()を使って、取得したいWebページのURLを設定したり、サーバーからの応答内容を直接表示するのではなく、文字列として取得するように設定（CURLOPT_RETURNTRANSFER）したりします。

リクエストはcurl_exec()によって実行され、その結果、サーバーからContent-Typeの情報を含む応答が返されます。このとき、curl_getinfo()関数にCURLINFO_CONTENT_TYPE定数を渡すことで、応答ヘッダに含まれるContent-Typeの値（例えば「text/html; charset=UTF-8」や「image/png」など）を正確に抽出できます。取得後、curl_close()でセッションを終了し、リソースを解放します。

getContentTypeFromUrl関数は、引数としてContent-Typeを取得したいWebページのURLを文字列で受け取ります。戻り値としては、Content-Typeの文字列が正常に取得できた場合はその文字列を返し、何らかの理由で取得に失敗した場合はfalseを返します。これにより、取得した情報の種類に基づいて、その後の処理を適切に判断することが可能になります。