PHP 文件上传类实现指南

核心设计与参数准备

实现稳定的文件上传需要预先定义严格的控制参数。该类通过私有属性管理配置，确保不同场景下的灵活性。

• 大小限制：默认 $file_max_size 设为 2000000 字节（约 2MB），超出将直接拦截。
• 路径管理：$file_folder 指定基础上传目录，通常结合时间戳动态生成子文件夹以避免冲突。
• 覆盖策略：$over_write 布尔值决定当目标文件名存在时，是直接覆盖还是拒绝上传。
• 白名单过滤：$allow_type 严格限定允许的文件 MIME 类型（如 image/jpeg, image/png），防止恶意脚本上传。

实例化与环境校验步骤

使用此类时，需首先传入前端表单中的文件域名称（例如 $file）。类在初始化阶段会自动收集文件元数据，并进行一系列前置检查。

第1步：初始化数据提取

目的：将 $_FILES 数组中的关键信息映射为对象属性，减少后续冗余读取。
动作：调用构造函数 __construct($file)。
结果：成功获取 $file_name（原文件名）、$file_type（MIME）、$file_tem（临时路径）及 $file_size。

第2步：执行合法性综合检测

目的：确保上传请求合法且符合服务器配置。
操作顺序：
1. is_big()：比对当前文件大小与预设上限。
2. check_type()：校验 MIME 类型是否在 $allow_type 白名单内。
3. check_file_name() & is_upload_file()：双重验证确认文件确实通过 HTTP POST 协议上传且临时文件存在于系统磁盘中，防范本地包含攻击或伪造请求。

第3步：解决命名冲突与目录创建

目的：保证文件落盘时的唯一性与路径规范。
操作顺序：
1. creatFolder()：若目标路径不存在则递归创建。
2. creat_mulu()：按年月日格式（如 upload/20231027）建立新目录，既美观又利于文件管理。
3. check_same_file()：若 $over_write 为 false 且目标文件已存在，则抛出异常并终止流程。

文件迁移与缩略图生成

校验通过后，进入实质性的存储环节。除了移动主文件，该类还集成了针对图片类型的智能缩略图处理逻辑。

第4步：主文件持久化

入口：move_file($filename, $destination)
动作：使用 move_uploaded_file() 将临时文件移至目标路径。
完成状态：返回 true 即表示上传成功；若返回 false，记录错误日志或提示用户重试。

第5步：智能图片缩放处理

入口：create_simg($img_w, $img_h)
核心逻辑：
1. 格式识别：通过 getimagesize() 获取图像宽高与类型索引（1=GIF, 2=JPG, 3=PNG），针对性调用 imagecreatefrom* 系列函数创建资源。
2. 纵横比计算：为了防止图片拉伸变形，必须保持比例。计算原始宽高比 $src_wh 与目标宽高比 $new_wh。
- 若 $new_wh <= $src_wh，以目标宽度为准计算高度
- 反之则以目标高度为准计算宽度
3. 重采样优化：优先尝试 imagecreatetruecolor() 配合 imagecopyresampled()（高质量双线性插值）；若环境不支持旧版 GD 库，则回退至 imagecopyresized()（最近邻算法）。

<?PHP
/*
* 文件上传类（精简整合版）
*/
class upfile {
    private $file_size;
    private $file_tem;
    private $file_name;
    private $file_type;
    
    // 配置项
    private $file_max_size = 2000000;
    private $file_folder = "uploadFiles";
    private $over_write = false;
    private $allow_type = array('image/jpg','image/jpeg','image/png', 'image/pjpeg', 'image/gif');

    function __construct($file) {
        $this->file_name = $_FILES[$file]['name'];
        $this->file_type = $_FILES[$file]['type'];
        $this->file_tem  = $_FILES[$file]['tmp_name'];
        $this->file_size = $_FILES[$file]['size'];
    }

    // ... (此处省略部分上述章节描述的校验辅助方法，实际使用时请保留完整类定义)

    function upload_file() {
        $f_name = $this->files_name();
        move_uploaded_file($this->file_tem, $f_name);
        return $f_name;
    }
    
    // 其他辅助方法如 create_simg, creat_mulu 等...
}
?>

注意事项与排错建议

在使用此类进行本地部署或生产环境切换时，需注意以下几点：

1. 权限设置：确保运行 PHP 进程的用户（通常是 www-data 或 apache）对 uploadFiles 目录拥有 0777 或至少 0755 的可写权限。
2. 内存限制：处理高分辨率大图时，GD 库会占用较多内存。若遇到崩溃，请在 php.ini 中调大 memory_limit。
3. GD 扩展依赖：缩略图功能强依赖于 gd 扩展及其支持的格式插件（如 libpng, libjpeg）。可通过 phpinfo() 检查安装情况。