rename() 函数最直接改扩展名,但仅重命名不校验内容;需用 finfo_open() 识别真实类型,并配置 Web 服务器解析新后缀。

rename() 函数改扩展名最直接,但只改名字不改内容
PHP 本身没有“修改文件类型”的内置函数,所谓“改扩展名”,本质是重命名文件。用 rename() 是最常用方式,但它只改磁盘上的文件名,不会校验或转换文件内容。比如把 report.pdf 改成 report.jpg,系统会照做,但打开时大概率报错——因为文件头还是 PDF 格式。
- 必须确保目标路径可写,且源文件存在,否则
rename()返回false - 目标文件名要带完整路径,不能只写扩展名,例如:
rename('/tmp/data.txt', '/tmp/data.log') - 跨文件系统(如不同挂载点)时,
rename()可能失败,需改用copy()+unlink()
判断真实文件类型不能靠扩展名,要用 finfo 或 mime_content_type
用户上传的文件常伪造扩展名(比如把木马脚本改成 .jpg),单靠 $_FILES['file']['name'] 后缀做判断极不安全。PHP 提供 finfo_open() 基于二进制头识别真实类型:
$finfo = finfo_open(FILEINFO_MIME_TYPE); $mimeType = finfo_file($finfo, '/tmp/uploaded'); finfo_close($finfo); // $mimeType 可能是 'image/jpeg'、'application/pdf' 等
-
finfo_open()需要系统安装 fileinfo 扩展(PHP 5.3+ 默认启用,但某些精简环境可能关闭) - 避免用已废弃的
mime_content_type(),它在 PHP 8.0+ 已移除 - 仅靠 MIME 类型也不绝对可靠,敏感场景建议结合文件头字节校验(如 JPEG 必须以
\xFF\xD8开头)
批量改扩展名要注意 glob() 匹配范围和编码问题
用 glob() 批量处理目录下文件时,容易漏匹配或误匹配:
-
glob('*.txt')不会递归子目录;需要递归得用RecursiveDirectoryIterator - 中文路径或文件名在 Windows 下可能因编码问题导致
glob()返回空数组,建议统一用 UTF-8 并检查 locale 设置 - 改名前务必加锁或检查目标文件是否已存在,否则并发请求可能覆盖或报错
- 示例安全改名逻辑:
if (!file_exists($newPath) && rename($oldPath, $newPath)) { ... }
Web 服务器配置会影响扩展名修改后的访问行为
改完扩展名只是第一步,Apache/Nginx 还要能正确解析新后缀。比如把 PHP 文件改成 .bak,默认不会执行 PHP 代码——这是好事;但若改成 .html 却希望仍解析 PHP,则需额外配置:
立即学习“PHP免费学习笔记(深入)”;
- Apache:在
.htaccess或虚拟主机中加AddHandler application/x-httpd-php .html - Nginx:在
location ~ \.html$块里加fastcgi_pass转发 - 改扩展名后未更新 Web 服务器配置,可能导致 404、下载而非渲染、或 PHP 源码被直接暴露
真正难的不是怎么改后缀,而是改完之后,文件能不能被按预期的方式读取、执行或校验——这三步(重命名、类型校验、服务端适配)缺一不可。











