finfo_file

finfo::file

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

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

説明

手続き型

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

オブジェクト指向型

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

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

パラメータ

finfo

finfo_open() が返す、finfo クラスのインスタンス。

filename

調べるファイルの名前。

flags

ひとつあるいは複数のFileinfo 定数の組み合わせ。

context

contexts の説明については、ストリーム 関数 を参照ください。

戻り値

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

変更履歴

バージョン 説明
8.1.0 引数 finfo は、finfo クラスのインスタンスを期待するようになりました。 これより前のバージョンでは、リソース を期待していました。
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, 情報, file, ファイル, context, string, filename, 関数, flags, 期待