PHP 实现图片上传并自动替换旧图

山海之间

发布时间：2026-10-14| 6人浏览过

原创

本文介绍如何通过 PHP 处理文件上传请求，在验证格式后将新图片保存至指定路径，从而实现对旧图片的直接替换与预览输出。

结果或目标

用户通过 Web 界面选择一张图片上传，服务器端接收该图片，校验其是否为允许的图片格式（如 JPG、PNG、GIF 等），随后删除服务器原位置的同名图片，并将新上传的图片保存到相同的路径中，最终在网页上展示新上传图片的预览效果。

准备条件

服务器环境：已配置好 PHP 运行环境。
目录权限：确保存储图片的目录（如 ./files/）具有可读写权限。
配置文件检查：打开 php.ini，检查以下参数以确保满足需求：
- file_uploads = On：开启文件上传功能。
- upload_max_filesize：设置允许的最大上传文件大小，代码中演示限制为 2MB，请根据实际需求调整此值。
- post_max_size：确保该值大于等于 upload_max_filesize。

真实操作顺序

第1步：创建上传表单页面 (HTML)

目的：提供一个带有文件选择功能的入口，并通过正确的 HTTP 编码方式将文件发送至服务端。

入口：新建名为 change.html 的文件。

动作：编写一个 <form> 标签，关键参数说明如下：

method="post"：使用 POST 方法提交数据，避免 URL 长度限制和数据泄露。
action="changefile.php"：指定处理上传逻辑的后端 PHP 脚本地址。
enctype="multipart/form-data"：必须设置。告知浏览器以二进制流方式传输表单数据，这是文件上传的基础。
<input type="hidden" name="MAX_FILE_SIZE" value="2000000" />：在前端提示客户端限制最大上传大小为 2MB（单位：字节）。
<input type="file" name="file">：激活系统文件选择对话框。

<html>
<head>
<title>File Replace Example</title>
<meta charset="UTF-8">
</head>
<body>
<form method="post" action="changefile.php" enctype="multipart/form-data">
<table border=0 cellspacing=0 cellpadding=0 align=center width="100%">
<tr>
<td width=55 height=20 align="center">文件：</td>
<td>
<!-- 隐藏字段，前端辅助限制大小 -->
<input type="hidden" name="MAX_FILE_SIZE" value="2000000" />
<input name="file" type="file" />
<input type="submit" name="submit" value="Submit" /> 
</td>
</tr>
</table>
</form>
</body>
</html>

第2步：编写 PHP 处理逻辑

目的：接收上传的文件信息，进行类型校验，执行文件的移动与旧文件的删除操作，并反馈结果。

入口：新建名为 change.php 的文件（注意与表单中的 action 对应）。

动作：定义一个函数 changeFile()，核心步骤解析如下：

获取并解析文件名：
- 通过超级全局数组 $_FILES['file']['name'] 获取原始文件名。
- 使用 strrchr() 定位最后一个点号的位置，再配合 substr() 截取扩展名。例如从 pic.jpg 中提取出 jpg。
- 将扩展名转换为小写，并与白名单数组进行比对。
安全校验：
- 使用 is_uploaded_file($_FILES['file']['tmp_name']) 严格判断该文件是否是通过 HTTP POST 机制上传的。这能防止恶意用户绕过逻辑直接访问服务器本地文件。
清理旧资源：
- 使用 file_exists($oldfile) 检查目标路径下的旧图片是否存在。
- 若存在，调用 unlink($oldfile) 将其彻底删除。
执行移动：
- 调用 move_uploaded_file()，将临时目录中的文件转移到指定的最终路径（即旧的图片路径）。这一过程完成了“替换”的操作。

<?php
header("content-type:text/html;charset=utf-8");

/**
 * @param string $oldfile 需要被替换的目标文件路径
 */
function changeFile($oldfile){
    // 1. 获取上传的文件信息
    $newfile = $_FILES['file']['name'];
    $fileclass = substr(strrchr($newfile, '.'), 1); // 获取扩展名
    $type = array("jpg", "gif", "bmp", "jpeg", "png"); // 允许的扩展名白名单

    if(in_array(strtolower($fileclass), $type)){
        // 2. 判断旧文件是否存在，若存在则删除
        if(file_exists($oldfile)){
            unlink($oldfile);
        }

        // 3. 安全校验：确认是否由 HTTP POST 上传
        if(is_uploaded_file($_FILES['file']['tmp_name'])){
            // 4. 执行移动，完成替换
            if(move_uploaded_file($_FILES['file']['tmp_name'], $oldfile)){ 
                echo "<center>您的文件已经上传完毕</center><br>";
                echo "<center>上传图片预览: </center><br>";
                echo "<center><img src='$oldfile'></center>";
            } else {
                echo "<center>上传失败，文件可能超过2M或未正确上传！</center>";
            }
        } else {
            echo "<center>上传失败：非HTTP POST上传源文件</center>";
        }
    } else {
        $text = implode(", ", $type);
        echo "<center>您只能上传以下类型文件：" . $text . "</center><br>";
    }
}

// 调用函数，指定要被替换的图片路径
changeFile("./files/1.png");
?>