finfo_file

finfo::file

(PHP >= 5.3.0, PHP 7, PHP 8, PECL fileinfo >= 0.1.0)

finfo_file -- finfo::file — ファイルについての情報を返す

説明

手続き型

function finfo_file(
    finfo $finfo,
    string $filename,
    int $flags = FILEINFO_NONE,
    ?resource $context = null
): string|false

オブジェクト指向型

public function finfo::file(string $filename, int $flags = FILEINFO_NONE, ?resource $context = null): string|false

この関数は、ファイルについての情報を返すために使用します。

パラメータ

finfo: finfo_open() が返す、finfo クラスのインスタンス。
filename: 調べるファイルの名前。
flags: ひとつあるいは複数のFileinfo 定数の組み合わせ。
context: contexts の説明については、ストリーム関数を参照ください。

戻り値

filename のテキスト表現、あるいはエラーが発生した場合に false を返します。

エラー / 例外

filename にヌルバイトが含まれている場合、 ValueError がスローされます。 PHP 8.5.0 より前のバージョンでは、TypeError がスローされていました。

変更履歴

バージョン	説明
8.5.0	`filename` にヌルバイトが含まれている場合、 TypeError ではなく ValueError がスローされるようになりました。
8.1.0	引数 `finfo` は、finfo クラスのインスタンスを期待するようになりました。これより前のバージョンでは、resource を期待していました。
8.0.0	`context` は、nullable になりました。

例

例1 finfo_file() の例

<?php
$finfo = finfo_open(FILEINFO_MIME_TYPE); // mimetype 拡張モジュール風に mime タイプを返します
foreach (glob("*") as $filename) {
    echo finfo_file($finfo, $filename) . "\n";
}
finfo_close($finfo);
?>

上の例の出力は、たとえば以下のようになります。

text/html
image/gif
application/vnd.ms-excel

参考

finfo_buffer() - 文字列バッファの情報を返す