【PHP8.x】finfo_close()関数の使い方

Copy
1<?php
2
3// 一時ファイルを作成し、サンプルデータを書き込む
4// finfo_close の動作を確認するための一時ファイルです。
5$tempFile = tempnam(sys_get_temp_dir(), 'finfo_test_');
6if ($tempFile === false) {
7    exit("一時ファイルの作成に失敗しました。\n");
8}
9file_put_contents($tempFile, 'これはテスト用のテキストファイルです。');
10
11/**
12 * finfo_open で開いた finfo オブジェクトを使用し、最後に finfo_close で閉じる例。
13 * finfo_close は、finfo_open で作成されたリソースを明示的に解放します。
14 *
15 * @param string $filePath 処理するファイルのパス
16 * @return void
17 */
18function handleFileWithFinfoAndClose(string $filePath): void
19{
20    // finfo オブジェクトを初期化
21    // FILEINFO_MIME_TYPE フラグを指定してMIMEタイプ検出器を開きます。
22    $finfo = finfo_open(FILEINFO_MIME_TYPE);
23
24    if ($finfo === false) {
25        echo "エラー: finfo データベースのオープンに失敗しました。\n";
26        return;
27    }
28
29    // ファイルのMIMEタイプを取得
30    $mimeType = finfo_file($finfo, $filePath);
31
32    if ($mimeType !== false) {
33        echo "ファイルパス: " . $filePath . "\n";
34        echo "MIMEタイプ: " . $mimeType . "\n";
35    } else {
36        echo "エラー: ファイル情報の取得に失敗しました。\n";
37    }
38
39    // finfo_close を使用して finfo オブジェクトをクローズ
40    // finfo_close は成功時に true、失敗時に false を返します。
41    if (finfo_close($finfo)) {
42        echo "finfo オブジェクトが正常にクローズされました。\n";
43    } else {
44        echo "警告: finfo オブジェクトのクローズに失敗しました。\n";
45    }
46}
47
48// 関数を呼び出し、処理を実行
49handleFileWithFinfoAndClose($tempFile);
50
51// 作成した一時ファイルを削除
52unlink($tempFile);
53
54?>

PHPのfinfo_close関数は、finfo_open関数によって開かれたファイル情報データベースのリソースを閉じるために使用されます。この関数を呼び出すことで、ファイル情報の読み込みに使用したシステムリソース（メモリやファイルハンドルなど）が解放され、プログラムがより効率的に動作するようになります。

finfo_closeは、引数としてfinfo_openから返されたfinfoオブジェクトを受け取ります。このオブジェクトを渡すことで、どのリソースを閉じるかを指定します。関数の実行が成功し、リソースが正常に閉じられた場合はtrueを、何らかの理由でクローズに失敗した場合はfalseを戻り値として返します。

サンプルコードでは、まず一時ファイルを準備し、このファイルから情報を取得する一連の処理を示しています。handleFileWithFinfoAndClose関数内で、finfo_openを使ってファイル情報データベースを開き、一時ファイルのMIMEタイプをfinfo_fileで取得します。ファイル情報の取得が完了した後、finfo_close($finfo)を実行することで、開いていたデータベースのリソースを明示的に閉じ、リソースリークを防ぎます。成功時には「finfo オブジェクトが正常にクローズされました。」と表示され、適切にリソースが管理されていることを確認できます。最後に、作成した一時ファイルも削除し、クリーンな状態に戻しています。このように、開いたリソースは必ず明示的に閉じるのが良い習慣です。