【PHP8.x】finfo_file関数の使い方

Copy
1<?php
2
3/**
4 * finfo_file() を使用してファイルのMIMEタイプを取得するサンプル関数です。
5 *
6 * この関数は、一時的なテキストファイルを作成し、そのファイルのMIMEタイプを特定して表示します。
7 * 処理完了後、作成したファイルは自動的に削除されます。
8 *
9 * @return void
10 */
11function checkFileMimeType(): void
12{
13    // 調査対象の一時ファイルを作成します。
14    $filename = 'sample.txt';
15    $content = 'これはMIMEタイプを調べるためのサンプルテキストです。';
16    
17    // file_put_contentsは成功時に書き込んだバイト数、失敗時にfalseを返します。
18    if (file_put_contents($filename, $content) === false) {
19        echo "エラー: 一時ファイル '{$filename}' の作成に失敗しました。\n";
20        return;
21    }
22
23    try {
24        // finfoリソースをオープンします。
25        // 第1引数に定数 FILEINFO_MIME_TYPE を指定することで、
26        // 'text/plain' や 'image/jpeg' のようなMIMEタイプを取得できます。
27        $finfo = finfo_open(FILEINFO_MIME_TYPE);
28
29        if ($finfo === false) {
30            echo "エラー: Fileinfo拡張機能の初期化に失敗しました。\n";
31            return;
32        }
33
34        // finfo_file() を使って、指定したファイルのMIMEタイプを文字列として取得します。
35        $mimeType = finfo_file($finfo, $filename);
36
37        // リソースを解放します。
38        finfo_close($finfo);
39
40        if ($mimeType !== false) {
41            // 取得したMIMEタイプを表示します。
42            echo "ファイル名: {$filename}\n";
43            echo "MIMEタイプ: {$mimeType}\n"; // 期待される出力: MIMEタイプ: text/plain
44        } else {
45            echo "エラー: ファイル '{$filename}' のMIMEタイプの取得に失敗しました。\n";
46        }
47    } finally {
48        // 後処理として、作成した一時ファイルを確実に削除します。
49        if (file_exists($filename)) {
50            unlink($filename);
51        }
52    }
53}
54
55// 作成した関数を実行します。
56checkFileMimeType();
57
58?>

このPHPサンプルコードは、finfo_file関数を使ってファイルのMIMEタイプ（種類）を特定する方法を示しています。まず、MIMEタイプを調べるための一時的なテキストファイルを作成します。次に、finfo_open関数を用いてFileinfo拡張機能のリソースを初期化します。この際、FILEINFO_MIME_TYPE定数を指定することで、結果がMIMEタイプ形式（例: "text/plain"）となるように設定しています。

finfo_file関数は、第一引数にfinfo_openで取得したFileinfoリソース、第二引数にMIMEタイプを調べたいファイルのパスを受け取ります。この関数は、指定されたファイルのMIMEタイプを示す文字列を返しますが、MIMEタイプの取得に失敗した場合はfalseを返します。サンプルコードでは、取得したMIMEタイプを画面に表示し、その後にfinfo_closeでリソースを解放し、作成した一時ファイルもunlink関数で確実に削除することで、リソースリークや不要なファイル残存を防いでいます。このように、finfo_fileはファイルの種類をプログラムで正確に判別したい場合に利用できる便利な関数です。

Copy
1<?php
2
3// ファイルのMIMEタイプを検出する例
4
5// ファイルパス
6$filename = 'example.txt';
7
8// finfoオブジェクトを作成
9$finfo = finfo_open(FILEINFO_MIME_TYPE);
10
11if ($finfo) {
12    // ファイルのMIMEタイプを取得
13    $mime_type = finfo_file($finfo, $filename);
14
15    if ($mime_type !== false) {
16        echo "ファイルのMIMEタイプ: " . $mime_type . PHP_EOL;
17    } else {
18        echo "ファイルのMIMEタイプの取得に失敗しました。" . PHP_EOL;
19    }
20
21    // finfoオブジェクトを閉じる
22    finfo_close($finfo);
23} else {
24    echo "finfoの初期化に失敗しました。" . PHP_EOL;
25}
26
27?>

このサンプルコードは、PHPのfinfo_file関数を使用して、ファイルのMIMEタイプを検出する方法を示しています。finfo_file関数は、finfoオブジェクトとファイル名を引数に取り、ファイルのMIMEタイプを文字列として返します。MIMEタイプの取得に失敗した場合はfalseを返します。

まず、finfo_open関数を使用してfinfoオブジェクトを初期化します。この際、FILEINFO_MIME_TYPEフラグを指定することで、MIMEタイプの検出に特化したfinfoオブジェクトを作成できます。

次に、finfo_file関数に、初期化したfinfoオブジェクトとファイル名を渡します。この関数は、指定されたファイルの内容を解析し、そのファイルのMIMEタイプを返します。

サンプルコードでは、finfo_file関数の戻り値がfalseでないか確認し、正常にMIMEタイプを取得できた場合に、その値を画面に出力します。MIMEタイプの取得に失敗した場合は、エラーメッセージを表示します。

最後に、finfo_close関数を使用して、使用済みのfinfoオブジェクトを解放します。これは、システムリソースを適切に管理するために重要です。finfo_open関数が失敗した場合もエラーメッセージを表示します。 この例では、'example.txt'というファイルが同一ディレクトリに存在することを前提としています。存在しない場合は、MIMEタイプの取得に失敗します。