PHP实现的文件上传类与用法详解

介绍

在Web应用程序中，文件上传是一个极其普遍的功能需求。PHP提供了方便的文件上传功能来处理这个需求。然而，PHP自带的文件上传功能并不是十分完善。因此，我们需要使用第三方的类来实现更多自定义的功能。本文将介绍一个PHP实现的文件上传类以及如何使用它。

下载

我们可以从GitHub上下载这个PHP文件上传类。

开始使用

我们先在我们的PHP文件中引入上传类库文件：

require_once 'class.upload.php';

然后，我们可以创建一个新的Upload类实例，来进行文件上传操作：

// 创建上传类实例
$upload = new Upload($_FILES['userfile']);

// 检查文件是否有错误
if ($upload->uploaded) {
    // 设置上传参数
    $upload->file_new_name_body = 'new_file_name';
    $upload->allowed = array('image/*');

    // 上传
    $upload->process('/path/to/folder/');

    // 检查上传是否成功
    if ($upload->processed) {
        echo 'File uploaded successfully';
    } else {
        echo 'Error: ' . $upload->error;
    }
} else {
    echo 'Error: ' . $upload->error;
}

我们初始化了一个Upload实例，并传入了$_FILES['userfile']变量（也就是在form表单中使用的input type="file"的name属性）。如果文件上传没有任何问题，我们可以设置上传参数，然后调用process()方法来进行上传。上传完成后，我们检查上传是否成功。

上传参数

我们可以使用很多参数来指定上传的特性，比如允许的文件类型、上传到的目录等等。下面列出了一些常用的参数：

allowed

允许上传的文件类型。可以是字符串、数组或正则表达式。比如，'image/*'代表只允许上传图片文件。

denied

禁止上传的文件类型。可以是字符串、数组或正则表达式。比如，'application/*'代表禁止上传所有的应用程序文件。

file_max_size

允许的最大文件大小，以字节为单位。

file_new_name_body

上传后文件的名字，不包括文件后缀。比如，'new_file_name'代表上传后的文件名字为'new_file_name.jpg'。

file_name_body_prepend

在文件名字前面追加的字符串，可以用来防止文件名冲突。

file_name_body_append

在文件名字后面追加的字符串，可以用来防止文件名冲突。

file_rename_duplicates

是否重命名重复文件，可以是true或false。如果是true，则会在文件名字后面追加'_1'、'_2'等数字。

示例1

让我们假设我们要上传一张图片文件到服务器，同时重命名文件名字为'my_photo.jpg'。我们可以这样做：

// 创建上传类实例
$upload = new Upload($_FILES['userfile']);

// 检查文件是否有错误
if ($upload->uploaded) {
    // 设置上传参数
    $upload->file_new_name_body = 'my_photo';
    $upload->allowed = array('image/*');

    // 上传
    $upload->process('/path/to/folder/');

    // 检查上传是否成功
    if ($upload->processed) {
        echo 'File uploaded successfully';
    } else {
        echo 'Error: ' . $upload->error;
    }
} else {
    echo 'Error: ' . $upload->error;
}

示例2

让我们假设我们要上传一个PDF文件到服务器，同时允许上传的文件大小不超过1MB。我们可以这样做：

// 创建上传类实例
$upload = new Upload($_FILES['userfile']);

// 检查文件是否有错误
if ($upload->uploaded) {
    // 设置上传参数
    $upload->allowed = array('application/pdf');
    $upload->file_max_size = 1048576; // 1 MB

    // 上传
    $upload->process('/path/to/folder/');

    // 检查上传是否成功
    if ($upload->processed) {
        echo 'File uploaded successfully';
    } else {
        echo 'Error: ' . $upload->error;
    }
} else {
    echo 'Error: ' . $upload->error;
}

总结

本文介绍了一个PHP实现的文件上传类以及如何使用它。我们可以使用这个类来更方便地实现文件上传功能，并且可定制性更强。同时，我们还介绍了一些常用的上传参数以及示例代码。