0

0

PHP如何判断文件扩展名是否合法_PHP合法扩展名法【格式】

絕刀狂花

絕刀狂花

发布时间:2026-02-03 12:21:42

|

228人浏览过

|

来源于php中文网

原创

最可靠的方式是用 pathinfo() 提取扩展名后严格比对硬编码白名单:先 strtolower() 统一大小写,再 in_array() 校验;需过滤反斜杠、校验扩展名非空,并限制文件名长度以防截断。

php如何判断文件扩展名是否合法_php合法扩展名法【格式】

pathinfo() 提取扩展名再比对白名单最可靠

直接读取文件名后缀字符串(比如用 substr(strrchr($filename, '.'), 1))容易被绕过,例如 shell.php.jpgimage.jpg.php。PHP 的 pathinfo() 能按标准路径规则解析,返回的 extension 是最后一段点号后的部分,但真正安全的做法是:只信任它提取出的扩展名,再严格比对预设白名单。

示例:

$ext = strtolower(pathinfo($filename, PATHINFO_EXTENSION));
$allowed = ['jpg', 'jpeg', 'png', 'gif', 'pdf'];
if (!in_array($ext, $allowed)) {
    throw new InvalidArgumentException('不支持的文件扩展名');
}
  • 务必用 strtolower() 统一小写,避免 JPGjpg 被当成不同扩展名
  • 白名单必须硬编码或从可信配置加载,不能从用户输入、数据库动态拼接
  • PATHINFO_EXTENSION 只取最后一段,所以 test.tar.gz 返回 gz,不是 tar.gz —— 这正是你想要的,避免误判归档包内嵌脚本

别信 mime_content_type()finfo_file() 做唯一判断

MIME 类型检测(如 finfo_file(finfo_open(FILEINFO_MIME_TYPE), $tmpfile))能识别文件真实内容,但它解决的是「文件是不是图片」这类问题,和「扩展名是否合法」是两件事。上传场景中,你通常需要同时满足:扩展名在白名单内 + 内容类型匹配预期。只靠 MIME 检测会漏掉扩展名伪造(比如把恶意 PHP 文件改成 .jpg 后缀但内容仍是 PHP),而只靠扩展名又会误杀真实图片(比如某些相机生成的 .arw 文件)。

  • 扩展名合法性检查必须独立做,且优先于 MIME 检查
  • finfo_file() 需要临时文件路径,不能直接用于未保存的上传流;mime_content_type() 已被标记为废弃
  • 若需双重校验,顺序应为:先验扩展名 → 再存临时文件 → 再用 finfo_file() 验内容 → 最后才移动到正式位置

$_FILES['file']['name'] 的扩展名可能被客户端篡改,必须重解析

浏览器上传时,$_FILES['file']['name'] 完全由前端控制,可任意构造。攻击者可能提交 webshell.php 却把表单字段 name 改成 avatar.jpg,或者在 filename 中插入空字节、Unicode 零宽字符干扰解析。PHP 不会自动清理这些。

DeepBrain
DeepBrain

AI视频生成工具,ChatGPT +生成式视频AI =你可以制作伟大的视频!

下载

立即学习PHP免费学习笔记(深入)”;

  • 永远不要直接使用 $_FILES['file']['name'] 拼接存储路径或判断类型
  • 必须用 pathinfo() 在服务端重新解析该字段值,且只取 PATHINFO_EXTENSION
  • 如果业务允许,更稳妥的方式是忽略原始文件名,服务端生成唯一文件名(如 sha256($content).jpg),仅保留扩展名用于 Content-Type 响应

注意 Windows 路径中的反斜杠和长文件名截断陷阱

在 Windows 环境下,$_FILES['file']['name'] 可能含 \(虽然罕见),pathinfo() 对反斜杠的处理与正斜杠不一致,可能导致提取失败。另外,超长文件名(如带大量 Unicode 字符)在某些 PHP 版本中会被截断,使 pathinfo() 返回空扩展名。

  • 上传前先用 str_replace('\\', '/', $_FILES['file']['name']) 统一路径分隔符
  • 检查 pathinfo($filename, PATHINFO_EXTENSION) 是否为空字符串,空则拒绝 —— 这可能是截断或非法格式信号
  • PHP 7.4+ 对长文件名支持更好,但生产环境仍建议限制 $_FILES['file']['name'] 总长度(如 ≤ 255 字节)
扩展名合法性这事,核心就一条:不信任任何客户端输入,只依赖服务端可控的解析 + 白名单硬比对。最容易被忽略的是大小写统一和空扩展名校验,这两个点线上出过不少隐蔽漏洞。

相关文章

PHP速学教程(入门到精通)
PHP速学教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
js 字符串转数组
js 字符串转数组

js字符串转数组的方法:1、使用“split()”方法;2、使用“Array.from()”方法;3、使用for循环遍历;4、使用“Array.split()”方法。本专题为大家提供js字符串转数组的相关的文章、下载、课程内容,供大家免费下载体验。

361

2023.08.03

js截取字符串的方法
js截取字符串的方法

js截取字符串的方法有substring()方法、substr()方法、slice()方法、split()方法和slice()方法。本专题为大家提供字符串相关的文章、下载、课程内容,供大家免费下载体验。

213

2023.09.04

java基础知识汇总
java基础知识汇总

java基础知识有Java的历史和特点、Java的开发环境、Java的基本数据类型、变量和常量、运算符和表达式、控制语句、数组和字符串等等知识点。想要知道更多关于java基础知识的朋友,请阅读本专题下面的的有关文章,欢迎大家来php中文网学习。

1505

2023.10.24

字符串介绍
字符串介绍

字符串是一种数据类型,它可以是任何文本,包括字母、数字、符号等。字符串可以由不同的字符组成,例如空格、标点符号、数字等。在编程中,字符串通常用引号括起来,如单引号、双引号或反引号。想了解更多字符串的相关内容,可以阅读本专题下面的文章。

625

2023.11.24

java读取文件转成字符串的方法
java读取文件转成字符串的方法

Java8引入了新的文件I/O API,使用java.nio.file.Files类读取文件内容更加方便。对于较旧版本的Java,可以使用java.io.FileReader和java.io.BufferedReader来读取文件。在这些方法中,你需要将文件路径替换为你的实际文件路径,并且可能需要处理可能的IOException异常。想了解更多java的相关内容,可以阅读本专题下面的文章。

718

2024.03.22

php中定义字符串的方式
php中定义字符串的方式

php中定义字符串的方式:单引号;双引号;heredoc语法等等。想了解更多字符串的相关内容,可以阅读本专题下面的文章。

670

2024.04.29

go语言字符串相关教程
go语言字符串相关教程

本专题整合了go语言字符串相关教程,阅读专题下面的文章了解更多详细内容。

175

2025.07.29

c++字符串相关教程
c++字符串相关教程

本专题整合了c++字符串相关教程,阅读专题下面的文章了解更多详细内容。

84

2025.08.07

c语言中/相关合集
c语言中/相关合集

本专题整合了c语言中/的用法、含义解释。阅读专题下面的文章了解更多详细内容。

0

2026.02.03

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
PHP课程
PHP课程

共137课时 | 10.9万人学习

JavaScript ES5基础线上课程教学
JavaScript ES5基础线上课程教学

共6课时 | 11.2万人学习

PHP新手语法线上课程教学
PHP新手语法线上课程教学

共13课时 | 0.9万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号