大网数据广告活动
PHP 语言与运行手册

finfo_open · 创建新 finfo 实例

· 52CE 我爱测

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

finfo_open

finfo::__construct

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

finfo_open -- finfo::__construct — 创建新 finfo 实例

说明

过程化风格

function finfo_open(int $flags = FILEINFO_NONE, ?string $magic_database = null): finfo|false

面向对象风格(构造器):

public function finfo::__construct(int $flags = FILEINFO_NONE, ?string $magic_database = null)

本函数打开一个魔数数据库并且返回它的实例。

参数

flags

一个 Fileinfo 常量 或多个 Fileinfo 常量 进行逻辑或运算。

magic_database

魔数数据库文件名称, 通常是 /path/to/magic.mime。 如果未指定,则使用 MAGIC 环境变量。 如果未指定此环境变量, 则使用 PHP 绑定的魔数数据库。

传入 null 或者空字符串,等同于使用默认值。

返回值

(仅适用于过程化风格) 成功时返回 finfo 实例, 或者在失败时返回 false。

更新日志

版本 说明
8.1.0 现在返回 finfo 实例,之前返回 resource。
8.0.3 magic_database 现在可以为 null。

示例

示例 #1 面向对象风格

<?php
$finfo = new finfo(FILEINFO_MIME, "/usr/share/misc/magic"); // 返回 mime 类型

/* get mime-type for a specific file */
$filename = "/usr/local/something.txt";
echo $finfo->file($filename);

?>

示例 #2 过程化风格

<?php
$finfo = finfo_open(FILEINFO_MIME, "/usr/share/misc/magic"); // 返回 mime 类型

if (!$finfo) {
    echo "Opening fileinfo database failed";
    exit();
}

/* 获取指定文件的 mime 类型 */
$filename = "/usr/local/something.txt";
echo finfo_file($finfo, $filename);

/* 关闭资源 */
finfo_close($finfo);
?>

以上示例会输出:

text/plain; charset=us-ascii

注释

注意:

通常来说,除非特别需要自定义的魔数数据库。否则使用绑定的魔数数据库(不设置 magic_file 和 MAGIC 环境变量)是最好的做法。

参见

来源:PHP Documentation Group · 作者与贡献记录 · CC BY 3.0。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
PHP Documentation Group
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY 3.0

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。