PHP文件上传详解

发布时间：2023-05-17

一、PHP文件上传接口

PHP文件上传是Web开发中常用的功能之一，通过PHP，可以实现以HTML表单方式上传文件。在实现文件上传之前，我们需要先了解PHP的文件上传接口。PHP的文件上传接口主要有以下五个方面：

1. enctype属性

在HTML表单中，我们需要设置enctype属性为“multipart/form-data”，以便PHP能够接收上传的文件数据。

<form enctype="multipart/form-data" method="POST">
    <input type="file" name="upload_file">
    <input type="submit" value="上传">
</form>

2. $_FILES数组

在PHP中，上传文件数据通过$_FILES数组来访问。这个数组包含了上传文件的名称、类型、大小、临时文件名等信息。

<?php
if(isset($_FILES['upload_file'])){
    $file = $_FILES['upload_file'];
    echo "文件名: " . $file['name'] . "<br>";
    echo "文件类型: " . $file['type'] . "<br>";
    echo "文件大小: " . $file['size'] . " bytes<br>";
    echo "临时文件名: " . $file['tmp_name'] . "<br>";
}
?>

3. move_uploaded_file()函数

通过move_uploaded_file()函数将临时文件移动到指定目录。

<?php
if(isset($_FILES['upload_file'])){
    $file = $_FILES['upload_file'];
    $upload_dir = './uploads/';
    if(move_uploaded_file($file['tmp_name'], $upload_dir.$file['name'])){
        echo "文件上传成功！";
    }else{
        echo "文件上传失败！";
    }
}
?>

4. $_FILES数组的错误信息

如果上传文件时出现错误，比如文件大小超过了限制、文件格式不对等等，会通过$_FILES数组中的error键来体现，其值代表着不同的错误信息。例如，error值为1代表文件大小超过了制定的限制。

<?php
if(isset($_FILES['upload_file'])){
    $file = $_FILES['upload_file'];
    if($file['error'] > 0){
        echo "上传错误: " . $file['error'] . "<br>";
    }else{
        $upload_dir = './uploads/';
        if(move_uploaded_file($file['tmp_name'], $upload_dir.$file['name'])){
            echo "文件上传成功！";
        }else{
            echo "文件上传失败！";
        }
    }
}
?>

5. ini_set()函数

通过ini_set()函数可以设置文件上传的大小限制，这个限制可以在php.ini文件中设置，也可以通过ini_set()函数动态修改。

<?php
ini_set('upload_max_filesize', '2M');
ini_set('post_max_size', '3M');
?>

二、PHP文件上传进度

在上传大文件时，为了方便用户了解文件上传进度，我们可以通过AJAX来实现文件上传进度的监控和显示。以下是实现文件上传进度的步骤：

1. 前端代码

在前端页面中，通过XHR对象监听AJAX响应事件，获取文件上传进度并显示在进度条上。

<div id="progress"></div>
<script>
var xhr = new XMLHttpRequest();
xhr.upload.onprogress = function(event){
    if(event.lengthComputable){
        var percent = Math.round((event.loaded / event.total) * 100);
        var progress = document.getElementById('progress');
        progress.style.width = percent + '%';
        progress.innerHTML = percent + '%';
    }
};
xhr.open('POST', 'upload.php', true);
xhr.send(formData);
</script>

2. 后端代码

在后端代码中，通过PHP的SESSION来保存文件上传进度，然后将进度返回给前端，以便前端页面更新进度条。

<?php
session_start();
if(isset($_FILES['upload_file'])){
    $file = $_FILES['upload_file'];
    $upload_dir = './uploads/';
    if(move_uploaded_file($file['tmp_name'], $upload_dir.$file['name'])){
        echo "文件上传成功！";
    }else{
        echo "文件上传失败！";
    }
}
if(isset($_SESSION['upload_progress'])){
    echo json_encode($_SESSION['upload_progress']);
}else{
    echo json_encode(array('progress' => 0));
}
session_write_close();
?>

三、PHP文件上传下载

文件上传完成后，我们可以在后端代码中提供文件下载的功能，供用户下载已上传的文件。以下是实现文件上传下载的步骤：

1. 前端代码

在前端页面中，用户点击下载链接时，通过AJAX向后端代码请求文件数据并下载。

<a href="#" onclick="downloadFile('file.txt')">下载文件</a>
<script>
function downloadFile(filename){
    var xhr = new XMLHttpRequest();
    xhr.onreadystatechange = function() {
        if(xhr.readyState == 4 && xhr.status == 200){
            var blob = new Blob([xhr.response], {type: "application/octet-stream"});
            saveAs(blob, filename);
        }
    };
    xhr.open('GET', 'download.php?filename=' + filename, true);
    xhr.responseType = 'arraybuffer';
    xhr.send();
}
function saveAs(blob, filename){
    var link = document.createElement('a');
    link.download = filename;
    link.href = URL.createObjectURL(blob);
    link.click();
}
</script>

2. 后端代码

在后端代码中，通过PHP的readfile()函数读取文件数据并输出到浏览器，以便前端页面进行下载。

<?php
if(isset($_GET['filename'])){
    $filename = $_GET['filename'];
    $file_path = './uploads/' . $filename;
    if(file_exists($file_path)){
        header("Content-Type: application/octet-stream");
        header("Content-Length: " . filesize($file_path));
        header("Content-Disposition: attachment; filename=" . $filename);
        readfile($file_path);
    }else{
        echo "文件不存在！";
    }
}
?>

四、PHP文件上传机制

在PHP文件上传时，要注意机制漏洞，以及机制漏洞的绕过方法。以下是常见的文件上传机制及其绕过方法：

1. MIME类型检查

在上传文件时，服务器一般会检查文件的MIME类型是否为允许上传的类型。但是，恶意用户可以通过修改文件扩展名或者添加特殊的文件头部，绕过MIME类型检查。

// 判断文件类型是否合法
$allow_type = array('image/jpeg', 'image/png', 'image/gif');
if(!in_array($_FILES['upload_file']['type'], $allow_type)){
    echo "文件类型不合法！";
}

2. 文件扩展名检查

在上传文件时，服务器也会检查文件的扩展名是否为允许上传的扩展名。但是，恶意用户可以通过上传JPG格式的文件并将扩展名修改为PHP，绕过扩展名检查，并在服务器上执行恶意代码。

// 判断文件扩展名是否合法
$allow_ext = array('jpg', 'png', 'gif');
$file_ext = pathinfo($_FILES['upload_file']['name'], PATHINFO_EXTENSION);
if(!in_array($file_ext, $allow_ext)){
    echo "文件扩展名不合法！";
}

3. 文件上传大小检查

在上传文件时，服务器也会检查文件的大小是否超过限制。但是，恶意用户可以通过分块上传的方式，将一个大文件分成多个小文件一块一块地上传，绕过上传大小限制，并且可以在服务器上组装成一个完整的大文件。

// 限制文件上传大小为2M
$allow_size = 2097152;
if($_FILES['upload_file']['size'] > $allow_size){
    echo "文件上传大小超过2MB！";
}

4. 文件上传目录权限

在上传文件时，服务器需要对上传文件目录进行写操作，确保上传的文件能够成功保存到指定的目录。但是，如果上传目录的权限设置得太高，恶意用户可以上传包含恶意脚本的文件，并让文件被执行，以达到攻击服务器的目的。

// 设置上传目录的权限为755
chmod('uploads/', 0755);

五、PHP文件上传漏洞

在PHP文件上传时，如果开发不慎，可能会造成文件上传漏洞，使得恶意用户可以通过上传恶意脚本来攻击服务器。以下是常见的文件上传漏洞及其解决方法：

1. 文件上传路径披露漏洞

在上传文件时，如果上传目录可以被恶意用户访问，那么恶意用户可以直接通过URL路径访问上传的文件。要解决这个问题，可以将上传目录设置为禁止访问。

<IfModule mod_autoindex.c>
    Options -Indexes
</IfModule>

2. XSS漏洞

在上传文件时，如果上传的文件包含HTML或者JavaScript代码，那么可能会导致XSS漏洞，因为这些代码可以被直接渲染在页面上。要解决这个问题，可以在前端对上传的文件数据进行过滤，过滤掉HTML或者JavaScript代码。

<?php
$html = htmlspecialchars($_FILES['upload_file']['name']);
echo "文件名: " . $html . "<br>";
?>

3. 文件包含漏洞

在上传文件时，如果上传的文件被直接包含，那么恶意用户可以通过上传特定的文件来执行任意代码。要解决这个问题，可以在后端代码中对上传的文件进行检查，如果不是允许的文件类型，不要进行任何操作。

<?php
$allow_ext = array('jpg', 'png', 'gif');
$file_ext = pathinfo($_FILES['upload_file']['name'], PATHINFO_EXTENSION);
if(!in_array($file_ext, $allow_ext)){
    die("文件上传扩展名不合法！");
}
?>

4. 文件覆盖漏洞

在上传文件时，如果服务器上已经存在同名的文件，那么上传的文件可能会覆盖原有的文件。要解决这个问题，可以对上传的文件重命名，将文件名设置为唯一值，以确保文件名的唯一性。

<?php
$extension = pathinfo($_FILES['upload_file']['name'], PATHINFO_EXTENSION);
$new_filename = uniqid() . '.' . $extension;
move_uploaded_file($_FILES['upload_file']['tmp_name'], 'uploads/' . $new_filename);
?>
推荐文章