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

<?php

/**
 * 指定されたファイルのMIMEタイプを検出します。
 *
 * @param string $filePath MIMEタイプを検出するファイルのパス。
 * @return string|false 検出されたMIMEタイプ文字列、またはエラーが発生した場合は false。
 */
function getFileMimeType(string $filePath): string|false
{
    // finfo_open() を使って新しいファイル情報リソースを作成します。
    // FILEINFO_MIME_TYPE フラグを指定することで、MIMEタイプのみを返却するように指示します。
    $finfo = finfo_open(FILEINFO_MIME_TYPE);

    // finfo_open() が失敗した場合 (例: Fileinfo拡張が有効でない場合) のエラーハンドリング。
    if ($finfo === false) {
        echo "エラー: Fileinfo拡張機能の初期化に失敗しました。PHPの設定を確認してください。\n";
        return false;
    }

    // finfo_file() を使って指定されたファイルのMIMEタイプを取得します。
    $mimeType = finfo_file($finfo, $filePath);

    // finfo_close() を使ってファイル情報リソースを閉じ、システムリソースを解放します。
    finfo_close($finfo);

    return $mimeType;
}

// --- 以下は、getFileMimeType 関数を単体でテストするための実行コードです ---

// 1. テストのための一時ファイルを作成します。
// sys_get_temp_dir() でシステムのテンポラリディレクトリを取得し、
// tempnam() で一意なファイル名を持つ一時ファイルを作成します。
$tempFileName = tempnam(sys_get_temp_dir(), 'php_mime_test_');

if ($tempFileName === false) {
    echo "エラー: 一時ファイルの作成に失敗しました。\n";
    exit(1); // 処理を終了します
}

// 2. 作成した一時ファイルにテストデータを書き込みます。
// この内容に基づいてMIMEタイプが検出されます。
$fileContent = "このファイルはMIMEタイプ検出のテスト用です。\nHello World!";
if (file_put_contents($tempFileName, $fileContent) === false) {
    echo "エラー: 一時ファイルへの書き込みに失敗しました。\n";
    unlink($tempFileName); // 失敗してもファイルを削除
    exit(1);
}

echo "作成された一時ファイル: " . $tempFileName . "\n";
echo "ファイル内容:\n---\n" . $fileContent . "\n---\n";

// 3. getFileMimeType 関数を呼び出し、一時ファイルのMIMEタイプを検出します。
$detectedMimeType = getFileMimeType($tempFileName);

if ($detectedMimeType !== false) {
    echo "検出されたMIMEタイプ: " . $detectedMimeType . "\n";
} else {
    echo "MIMEタイプの検出に失敗しました。上記のエラーメッセージを確認してください。\n";
}

// 4. 後処理: 作成した一時ファイルを削除します。
if (file_exists($tempFileName)) {
    unlink($tempFileName);
    echo "一時ファイルを削除しました: " . $tempFileName . "\n";
}

?>

このPHPのサンプルコードは、finfo_open関数を用いてファイルのMIMEタイプ（ファイルの種類を示す情報、例: text/plainやimage/jpegなど）を検出する方法を示しています。finfo_openは、ファイル情報を扱うための新しいリソースを作成する関数です。

引数$flagsには、どのような種類のファイル情報を取得したいかを指定します。サンプルコードではFILEINFO_MIME_TYPEを指定しており、これによりMIMEタイプのみを検出するようにfinfo_openに指示しています。2つ目の引数$magic_databaseは、通常は指定せずデフォルト値を使用します。finfo_openの戻り値は、成功すればファイル情報リソース（FInfoオブジェクト）、失敗した場合はfalseです。

サンプルコードのgetFileMimeType関数では、まずfinfo_open(FILEINFO_MIME_TYPE)でMIMEタイプ検出用のリソースを準備します。もし準備に失敗した場合はエラーメッセージを表示し、処理を終了します。次に、finfo_file関数を使い、準備したリソースとファイルのパスを渡して、実際にMIMEタイプを取得します。処理が終わったら、finfo_close関数でリソースを閉じ、システムリソースを解放することが重要です。

関数の外では、テストのために一時ファイルを作成し、そのファイルに内容を書き込んでからgetFileMimeType関数を呼び出し、MIMEタイプを検出する一連の流れが示されています。これにより、実際にファイルの種類がどのように判別されるかを確認できます。最終的に作成した一時ファイルは削除され、後片付けも行われます。このように、finfo_openはPHPでファイルのMIMEタイプを正確に判別する際に役立つ基本的な関数です。