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

Copy
1<?php
2
3/**
4 * 指定されたファイルのMIMEタイプとエンコーディング情報を取得します。
5 *
6 * この関数は、`fileinfo`拡張機能の`FILEINFO_MIME_ENCODING`定数を使用して、
7 * ファイルのMIMEタイプだけでなく、そのエンコーディング情報も取得する方法を示します。
8 * `FILEINFO_MIME_TYPE`フラグと組み合わせることで、より詳細な情報を得られます。
9 *
10 * @param string $filePath 情報を取得するファイルのパス。
11 * @return string|false ファイルのMIMEタイプとエンコーディング情報 (例: "text/plain; charset=utf-8")、
12 *                      またはエラー時に false を返します。
13 */
14function getFileMimeAndEncoding(string $filePath): string|false
15{
16    // fileinfo拡張機能がロードされているか確認します。
17    // PHP 8では、fileinfoはデフォルトで有効なことが多いですが、念のためチェックします。
18    if (!extension_loaded('fileinfo')) {
19        echo "エラー: fileinfo拡張機能が有効ではありません。\n";
20        return false;
21    }
22
23    // finfo_open() を使って fileinfo リソースを作成します。
24    // ここで FILEINFO_MIME_TYPE と FILEINFO_MIME_ENCODING フラグを組み合わせることで、
25    // MIMEタイプとエンコーディングの両方を含む形式で情報が返されるようになります。
26    // 例: "text/plain; charset=us-ascii" または "text/html; charset=utf-8"
27    $finfo = finfo_open(FILEINFO_MIME_TYPE | FILEINFO_MIME_ENCODING);
28
29    if (!$finfo) {
30        echo "エラー: finfo_open() の呼び出しに失敗しました。\n";
31        return false;
32    }
33
34    // finfo_file() を使って、指定されたファイルのMIMEタイプとエンコーディング情報を取得します。
35    // ファイルが存在しない、または読み込み権限がない場合、falseを返します。
36    $mimeInfo = finfo_file($finfo, $filePath);
37
38    // リソースを解放します。
39    finfo_close($finfo);
40
41    return $mimeInfo;
42}
43
44// --- サンプルコードの実行 ---
45
46// 1. テスト用の一時ファイルを作成します。
47// `sys_get_temp_dir()`でOSの一時ディレクトリを取得し、そこに一時ファイルを作成します。
48$tempFile = tempnam(sys_get_temp_dir(), 'php_mime_');
49if ($tempFile === false) {
50    echo "エラー: 一時ファイルの作成に失敗しました。\n";
51    exit(1);
52}
53
54// UTF-8エンコードされたテキストコンテンツを一時ファイルに書き込みます。
55$content = "これはUTF-8エンコードされたサンプルテキストです。\n日本語の文字も含まれます。\n";
56file_put_contents($tempFile, $content);
57
58echo "--- テキストファイル情報の取得 ---\n";
59// 2. 作成した一時ファイルのMIMEタイプとエンコーディング情報を取得し、表示します。
60$info = getFileMimeAndEncoding($tempFile);
61
62if ($info !== false) {
63    echo "ファイルパス: " . $tempFile . "\n";
64    echo "MIMEタイプとエンコーディング: " . $info . "\n";
65} else {
66    echo "ファイル情報の取得に失敗しました。詳細については上記のエラーメッセージを確認してください。\n";
67}
68
69// 3. プログラムの終了時に一時ファイルが残らないように、必ず削除します。
70unlink($tempFile);
71
72echo "\n";
73
74// 4. 存在しないファイルの情報を取得しようとした場合の例。
75echo "--- 存在しないファイル情報の取得 ---\n";
76$nonExistentFile = "non_existent_file.txt";
77$infoNonExistent = getFileMimeAndEncoding($nonExistentFile);
78
79if ($infoNonExistent !== false) {
80    echo "ファイルパス: " . $nonExistentFile . "\n";
81    echo "MIMEタイプとエンコーディング: " . $infoNonExistent . "\n";
82} else {
83    echo "ファイル '" . $nonExistentFile . "' の情報の取得に失敗しました。ファイルが存在しない可能性があります。\n";
84}
85

このPHPサンプルコードは、fileinfo拡張機能を利用して、指定されたファイルのMIMEタイプとエンコーディング情報を取得する方法を示しています。FILEINFO_MIME_ENCODING定数は、ファイルの文字エンコーディング情報まで詳細に取得したい場合に利用します。通常はFILEINFO_MIME_TYPE定数と組み合わせて使用し、finfo_open()関数の第一引数にこれらをビット論理和（|）で指定することで、例えば「text/plain; charset=utf-8」のような形式で結果が得られます。

getFileMimeAndEncoding関数は、引数としてファイルパス（$filePath）を受け取り、そのファイルのMIMEタイプとエンコーディング情報を文字列として返します。ファイルが存在しない場合や読み込みに失敗した場合はfalseを返しますので、呼び出し側でその確認が必要です。関数内では、まずfileinfo拡張機能が有効かを確認し、次にfinfo_open()でfileinfoリソースを作成し、finfo_file()で実際の情報取得を行います。取得後にはfinfo_close()でリソースを必ず解放しています。サンプルコードでは、一時ファイルを作成し、そのMIMEタイプとエンコーディングを取得する具体的な手順を示しており、ファイルの作成から情報取得、そして削除までの一連の流れを確認できます。存在しないファイルの場合の挙動も確認できます。