当前位置:首页 > 文章列表 > 文章 > php教程 > PHP SplFileInfo.getFileInfo 怎样用指定类生成当前文件信息对象

PHP SplFileInfo.getFileInfo 怎样用指定类生成当前文件信息对象

来源:17golang原创 2026-11-18 18:12:21 0浏览 收藏

如果你已经有一个 SplFileInfo 对象,但希望后续拿到自己的文件信息子类,可以调用 getFileInfo()。这个方法不接收新的文件路径,而是针对当前对象引用的文件创建一个信息对象;把自定义类名作为参数传入,就能让返回值使用 SplFileInfo 的派生类。

官方文档:https://www.php.net/manual/en/splfileinfo.getfileinfo.php

getFileInfo(?string $class = null): SplFileInfo 的关键是“当前文件 + 可选的派生类名”。想让类选择成为对象的默认配置,可以使用 setInfoClass();想让某一次调用更清楚,则直接传入类名。

getFileInfo() 返回的是什么

SplFileInfo 是面向单个文件信息的对象接口。假设源对象已经由 new SplFileInfo($path) 创建,那么 $source->getFileInfo() 会围绕同一个文件生成新的信息对象。它不是复制一份字符串路径,也不会把当前对象改造成另一个类。

该方法的参数是可空字符串 $class。传入时应是 SplFileInfo 本身或它的派生类名称,返回值仍然声明为 SplFileInfo,因为自定义类必须处在这条继承关系中。

SplFileInfo 文件路径、可选 class 参数、getFileInfo 与返回对象之间的静态结构说明图
图1:对象关系说明图,展示 getFileInfo() 围绕当前文件创建 SplFileInfo 派生对象;这是原创静态说明图,不是运行截图。

先定义一个可接受的文件信息子类

自定义类的职责可以很小,例如给文件信息增加一个业务标签。不要在构造函数里假设会收到新的路径;这个例子只增加方法,路径和文件元数据仍由父类负责。

getFilename();
    }
}

$source = new SplFileInfo(__DIR__ . '/config/app.php');

// 这里先只创建源对象,尚未改变它引用的文件路径。
$custom = $source->getFileInfo(ProjectFileInfo::class);

echo $custom->displayLabel();
// 输出示例:project:app.php

这里传入的是 ProjectFileInfo::class 产生的类名字符串。返回对象可以调用父类的 getFilename(),也可以调用子类新增的 displayLabel()。这正是“为当前文件选择信息对象类型”,而不是“为对象重新设置文件路径”。

直接传类名:让调用点表达类型

当同一份源对象在不同业务分支需要不同的信息子类时,直接传参最直观。每次调用都把意图写在方法旁边,阅读代码时不必先追踪对象是否调用过 setInfoClass()。

getExtension()), ['jpg', 'png', 'webp'], true);
    }
}

$source = new SplFileInfo(__DIR__ . '/assets/banner.webp');

// 直接传入派生类,让这一次调用返回 ImageFileInfo。
$imageInfo = $source->getFileInfo(ImageFileInfo::class);

if (!$imageInfo instanceof ImageFileInfo) {
    // 类型不符合预期时立即终止,避免后面调用子类方法产生隐蔽错误。
    throw new RuntimeException('未得到 ImageFileInfo 对象');
}

echo $imageInfo->isImageCandidate() ? '可作为图片候选' : '扩展名不匹配';

如果类名来自配置或用户输入,先把它限制在应用允许的白名单中,再交给 getFileInfo();不要把任意字符串直接当成可信类名。文章讨论的是对象类型选择,不是动态加载未知代码。

setInfoClass():为后续调用设置默认类

如果一个 SplFileInfo 对象在同一段流程里多次需要使用同一种自定义信息类,可以先调用 setInfoClass()。之后不传显式类名的 getFileInfo() 会使用这个配置。官方手册也说明,setInfoClass() 设置的类会同时影响 getFileInfo() 和 getPathInfo(),所以配置范围要有意识。

setInfoClass(ProjectFileInfo::class);

// 不传 class 时,使用刚才设置的默认类。
$info = $source->getFileInfo();

echo $info instanceof ProjectFileInfo ? $info->projectName() : '类型未按预期设置';

两种方式可以这样选择:只有一个调用点或需要突出本次类型时直接传参;同一对象的后续操作都遵循相同类型时使用 setInfoClass()。如果代码距离较远,显式传参通常更容易维护。

getFileInfo 直接传派生类与 setInfoClass 设置默认类两条路径的静态边界图
图2:类选择边界图,对比直接传入类名和先设置默认类的两条路径;这是原创结构说明图,不是执行结果截图。

几个容易混淆的边界

问题正确理解
会不会更换文件路径不会。路径来自当前 SplFileInfo 对象,getFileInfo() 只创建对应的信息对象。
能不能传任意 PHP 类不能。应传 SplFileInfo 或其派生类名称。
返回值是不是字符串不是。返回的是 SplFileInfo 对象;需要路径时再调用 getPathname() 等方法。
setInfoClass() 是否只影响当前一次不是。它设置当前对象后续相关调用的默认信息类;需要单次例外时可在 getFileInfo() 中显式传类名。

另外,getFileInfo() 与 getPathInfo() 的关注对象不同:前者面向当前文件,后者面向当前路径。两者都可能受 setInfoClass() 的配置影响,但不要因为返回类型相似就混用语义。

常见问题

不传参数时一定返回自定义类吗?

只有当前对象设置过信息类时才会按该配置返回。没有额外配置时,按 SplFileInfo 的默认行为使用基础类;需要稳定的自定义类型时,可以直接传类名或先调用 setInfoClass()。

为什么自定义类必须继承 SplFileInfo?

因为这个 API 生成的是文件信息对象,父类提供路径、文件名、大小和类型等统一接口。继承关系既保证返回值可以按 SplFileInfo 使用,也让 PHP 能检查类参数是否符合方法要求。

什么时候不该使用 getFileInfo()?

如果目标只是读取另一个路径,应该重新创建对应的 SplFileInfo;如果只是要字符串路径,应调用 getPathname() 或使用对象的字符串转换。getFileInfo() 适合“同一个当前文件,换一个信息对象类”的场景。

小结

SplFileInfo::getFileInfo() 的用法可以归纳为三步:先准备当前文件的 SplFileInfo,再定义继承自 SplFileInfo 的类,最后根据作用范围选择直接传入类名或用 setInfoClass() 设置默认类。只要记住它不会改路径、不会返回字符串,并且类必须满足继承约束,就能把文件元数据对象的业务扩展控制在清晰边界内。

版本声明
本文转载于:17golang原创 如有侵犯,请联系study_golang@163.com删除
PyTorch Tensor.storage_offset 怎样读取张量视图的存储起始偏移PyTorch Tensor.storage_offset 怎样读取张量视图的存储起始偏移
上一篇
PyTorch Tensor.storage_offset 怎样读取张量视图的存储起始偏移
Go net/textproto.Reader.ReadLineBytes 怎样理解返回缓冲区的有效期
下一篇
Go net/textproto.Reader.ReadLineBytes 怎样理解返回缓冲区的有效期
查看更多
最新文章
查看更多
课程推荐
  • 前端进阶之JavaScript设计模式
    前端进阶之JavaScript设计模式
    设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
    543次学习
  • GO语言核心编程课程
    GO语言核心编程课程
    本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
    516次学习
  • 简单聊聊mysql8与网络通信
    简单聊聊mysql8与网络通信
    如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
    500次学习
  • JavaScript正则表达式基础与实战
    JavaScript正则表达式基础与实战
    在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
    487次学习
  • 从零制作响应式网站—Grid布局
    从零制作响应式网站—Grid布局
    本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
    485次学习
查看更多
AI推荐
  • PubMedQA数据集详解:生物医学问答基准、功能与应用指南
    PubMedQA
    深入了解PubMedQA生物医学问答数据集,涵盖其核心功能、使用方法及在临床决策、药物研发等场景的应用,助力提升NLP模型性能。
    1095次使用
  • H2O EvalGPT:开源LLM大模型评估与排行榜工具
    H2O EvalGPT
    H2O EvalGPT是H2O.ai推出的开源LLM评估平台,提供详细的大模型性能排行榜、行业特定基准测试及A/B测试功能,助您快速选择最适合项目的高性能大语言模型。
    1092次使用
  • LMArena是什么?伯克利AI模型评估平台使用指南与功能解析
    LMArena
    LMArena是加州大学伯克利分校推出的AI模型匿名评测平台。通过盲测投票机制,用户可对比不同大模型回答并生成实时排行榜,助力开发者优化模型及用户选择最佳AI工具。
    1259次使用
  • 斯坦福HELM:大语言模型Holistic Evaluation整体评估框架详解
    HELM
    深入了解斯坦福推出的HELM(Holistic Evaluation of Language Models)大模型评测体系。本文解析其核心功能、安装配置步骤及应用场景,涵盖准确性、公平性、鲁棒性等多维度指标,助力开发者全面优化语言模型性能。
    1200次使用
  • MMBench详解:多模态大模型基准测试、功能特点与使用指南
    MMBench
    MMBench是由上海人工智能实验室等机构联合推出的多模态基准测试平台,提供细粒度能力评估、大规模数据集及VLMEvalKit工具。本文详细介绍其核心功能、安装使用方法及应用场景,助力开发者全面评估多模态模型性能。
    1049次使用
微信登录更方便
  • 密码登录
  • 注册账号
登录即同意 用户协议 和 隐私政策
返回登录
  • 重置密码