首页 > 文章列表 > 详解PHP FileInfo扩展

详解PHP FileInfo扩展

php 扩展 FileInfo
176 2023-06-30

概述

PHP FileInfo 扩展是一个为了更方便地获取文件的类型及一些基本信息而开发的功能扩展,其核心功能是基于 libmagic 库来实现,能够快速地帮助 PHP 开发者获取任意文件的 MIME 类型以及描述信息。

本文将详细介绍如何在 PHP 中使用这一强大扩展,包括扩展文件的安装及基本使用,以及如何更加深入地使用此扩展库来优化 web 应用性能等方面。

环境准备

首先需要确保系统中已安装好 PHP 和 libmagic,而且 PHP 的版本需要不低于 5.3.0 才能支持这个扩展。

使用 PECL 安装

PECL 是 PHP 扩展仓库,可以在 PECL 中直接搜索并安装 FileInfo 扩展。启动终端,输入以下命令:

pecl install fileinfo

如果系统中没有安装 autoconf 工具,需要先安装该工具。终端中输入:

sudo apt-get install autoconf

PDCLIB 安装

PDCLIB 是源代码包的安装方式,首先从官网,下载并解压 FileInfo 源码包,然后执行编译安装:

cd /path/to/fileinfo-x.x.x
phpize
./configure
make
make install

安装完成后,在php.ini文件中加入 extension=fileinfo.so。

使用方法

通过 insteading 方法来获取文件的信息,函数签名:

public static string finfo_file ( resource $finfo , string $filename = NULL [, int $options = FILEINFO_NONE [, resource $context = NULL ]] )

参数说明:

finfo:必须参数,调用 finfo_open 方法得到的资源句柄;

filename:必选参数,文件路径或 URL 地址;

options:可选参数,常量,FILEINFO_NONE,FILEINFO_SYMLINK 或 FILEINFO_MIME_ENCODING;

context:可选参数。

示例代码:

$finfo = finfo_open(FILEINFO_MIME_TYPE);
$fileType = finfo_file($finfo, '/your/file/path');
finfo_close($finfo);
echo $fileType;

函数 finfo_file 会返回文件的 MIME 类型。

其他常用方法

$finfo = finfo_open(FILEINFO_MIME);
$result = finfo_buffer($finfo, $content);
finfo_close($finfo);

函数 finfo_buffer 则是根据文件内容返回 MIME 类型。

PDCLIB 简介

PDCLIB 是针对强制编译器实现的 C99 库,提供了标准 I/O 和多种其他库函数等。其目的是为了在适合要求时转化成静态库。

关于 PDCLIB,在上面我们讲了解如何编译源代码安装扩展时,也命令中出现了 phpize。这说明我们在编译时需要先安装 autoconf 工具,这样扩展才能正常编译安装。

但是,如果没有这些工具,仍然可以使用 PDCLIB 等强制编译器实现库来编译安装,没有其他过多的要求。

PDCLIB 的目的并不是替代 glibc 或 BSD libc 族,而是提供一种追求简单、更安全和可靠的 libc 的选择。

值得注意的是,PDCLIB 并非是完整的 libc,但它提供了基于 current C99 标准库的优秀子集。

与 libc 的差异:

  1. pdclib 是一个 C99 库,支持 C99 标准及 C语言基础库函数;
  2. pdclib 不同于其他库,它的“万事都先考虑 KISS 原则”,所以代码简单,可维护性高;
  3. pdclib 最关键的差异是其高度可移植性,完全独立于操作系统,更容易适应新的操作系统;

PDCLIB 的函数和常量:

在代码中,可以访问如下函数和常量,使用时与原来相同:

define ('E_ERROR', 1);

size_t strlen(const char *s);

size_t fwrite(const void *buf, size_t size, size_t nmemb, FILE *stream);

总体来说,PDCLIB 是一款高性能并完全独立于操作系统的库,是使用 PHP FileInfo 扩展时,其中一个编译的库。

高级使用

除了上述介绍如何基于 FileInfo 获取文件基本信息外,通过进一步深入学习,可以更好地使用 FileInfo 扩展,从而进一步优化应用性能。

下面是一些常见角色函数和处理文件类型方法,来帮助更好地使用 FileInfo 扩展。

获得更详细的文件信息

函数 finfo_file 和 finfo_buffer 都能够得到文件的 MIME 类型,但如果想要稍微详细一点的文件信息,需要调用常量 FILEINFO_ALL,示例代码:

$finfo = finfo_open(FILEINFO_ALL);
$fileInfo = finfo_file($finfo, '/example/file');
finfo_close($finfo);
echo $fileInfo;

如果需要得到特定协议文件的信息,可以在 finfo_open 中添加地址协议:

$finfo = finfo_open(FILEINFO_ALL,'ftp://ftp.example.com');
$finfo = finfo_file($finfo, '/example/file');
finfo_close($finfo);
echo $finfo;

在这个例子中,文件来自唯一的地址,表示没有对 fdp 或 tcp 进行手动处理。

转换文件名为 MIME 类型

有时用户可能将文件名存储在数据库中,而不是文件本身,因此需要使用 FileInfo 扩展来从文件名获取 MIME 类型,示例代码:

$finfo = finfo_open(FILEINFO_MIME_TYPE);
$file = 'example.jpg';
$filename = '/your/path/' . $file;
$fileType = finfo_file(finfo, $filename);
finfo_close($finfo);
echo $fileType;

注释:在 filename 变量中,我们使用了一个相对路径。为了避免调用之前出现任何问题,这里可以使用绝对路径。

检查是否为文本类型

有时需要在上传文件的时候对文件类型进行一系列验证,例如,禁止上传非文本类型的文件。

使用 FileInfo 扩展可以轻松完成这个任务,示例代码:

$finfo = finfo_open(FILEINFO_MIME_TYPE);
$file = 'example.txt';
$filePath = 'your/file/path' . $file;
$fileType = finfo_file($finfo, $filePath);

if (strpos($fileType, 'text/') !== false) {
    echo '文件可用上传';
} else {
    echo '非文本类型文件,禁止上传';
}

finfo_close($finfo);

在上面的示例代码中,我们首先打开文件,通过 MIME 类型字符串返回文件的类型。然后,使用 strpos() 来查找返回的字符串中是否包含“文本/”字符串。

更改顺序

文件类型检查是企业 web 应用程序的关键部分之一,因此在处理大量上传文件时,FileInfo 扩展可能会装备一些未实现检查的检测程序。这通常是用于更改搜索 magic 数据库的顺序。

示例代码:

$magicBytes = '/usr/share/misc/magic.mime';
$order = [FILEINFO_EXTENSION, FILEINFO_MIME_TYPE, FILEINFO_NONE];
$finfo = finfo_open($order, $magicBytes);
$file = 'example.jpg';
$filename = '/your/path/' . $file;
$fileType = finfo_file($finfo, $filename);
finfo_close($finfo);
echo $fileType;

在上面的示例代码中,我们重新 orderBy 确定了检查顺序。在这种情况下,我们更希望使用文件扩展名,如果可以通过扩展名提供帮助,FileInfo 会使用扩展名进行检查。在扩展名不可用时,它将使用 find magic 数据库的顺序进行搜索。

结语

FileInfo 扩展是 PHP FILEINFO 类别的一部分,通过与 FileInfo 许多功能非常相似,可以更好地提高业务性能。在这个实例中,我们可以根据其文件扩展名的检查结果检查文件类型,并且还可以获得关于文件或流的更多信息。

总体来说,通过这篇文章,你已经进一步掌握了如何使用 PHP FileInfo 扩展,在上面的示例中,你可以更好地理解文件信息及其类型及其相互之间的关系,相信你已经准备好了在实际开发中使用它,为你的应用程序提供更强大的功能支持了。