PHP 基础文件上传与图片处理类实现详解

功能目标与适用场景

在 Web 开发中，直接依赖第三方框架可能增加部署复杂度，而原生 PHP 文件处理又较为繁琐。本方案旨在提供一个轻量级的类库，解决以下核心问题：

• 安全上传：限制文件类型、大小，防止非法格式注入。
• 规范管理：自动创建目录，按时间或指定规则重命名文件，避免冲突。
• 图片处理：在上传后自动对图片进行尺寸调整（缩略图）及版权水印添加。

注意：现代生产环境建议优先使用成熟框架（如 Laravel, ThinkPHP）内置的文件服务或使用云存储 SDK。此类原生代码更适合作为学习原理或在极简服务器环境下使用。

准备工作

第 1 步：确认服务器环境

该类依赖于 PHP 的两个关键组件：

1. PHP GD 扩展：用于图像创建和处理。可通过 phpinfo() 查看是否已加载。gd 信息应在输出中存在。
2. 写入权限：确保脚本运行用户（如 www-data 或 nginx）对保存路径具有读写权限。

第 2 步：了解类结构

代码包含两个核心类：

• uploadFile：处理通用文件的上传逻辑，包括错误码判断、类型白名单校验和存储路径管理。
• uploadImg extends uploadFile：继承自前者，额外提供图片缩放和水印功能。

核心操作顺序

第 1 步：基础文件上传流程

首先实例化 uploadFile 类，配置参数并调用上传方法。

入口与动作

通过构造函数设置默认属性：

• $save_path: 文件保存根目录，默认 './upload/'。
• $file_name: 重命名策略。设为 'date' 表示以时间戳命名，其他字符串表示固定前缀。
• $allow_types: 允许的文件扩展名，用 '|' 分隔，如 'jpg|png|gif'。

随后调用 upload_file($_FILES) 接收表单提交的文件数据。若成功，返回 true；失败则通过 $errmsg 获取具体原因（如超过 php.ini 限制、类型不允许等）。

第 2 步：图片专项处理（缩略图与水印）

当需要处理图片时，使用 uploadImg 类。该类在父类基础上增加了 GD 图像操作方法。

生成缩略图

调用 img_resized($w, $h, $source_img)：

• $w / $h: 目标宽度和高度（像素）。
• $source_img: 可选，源图片路径。若不传，默认使用上一次上传的图片。
• 内部逻辑会使用 imagecreatetruecolor 和 imagecopyresized 生成指定尺寸的副本，并保留至 $dst_path。

添加水印

调用 img_mark($source_img, $mark_type, $mark_postion)：

• $mark_type: 水印类型。1 为英文字符串，2 为中文字符串，3 为图片 Logo。
• $mark_postion: 位置坐标。1=左下，2=右下，3=左上，4=右上。
• 配置项: $mark_str (水印文字), $mark_ttf (字体文件路径，中文水印必需), $mark_logo (Logo 图片路径)。

注意：中文水印需确保 $mark_ttf 指向有效的 .ttf 文件，且编码匹配（类注释中提到需处理 GBK/UTF8 转换）。位置计算涉及图片宽高和字符长度，硬编码的参数 $stre_w 可能需要根据实际字体调整以获得最佳对齐效果。

完成判断

操作完成的标志是检查实例的 $uploaded 属性是否包含合法的文件路径，且 $errmsg 为空（对于上传阶段）或方法返回布尔值 true。生成的缩略图和水印图应能在设定的目录下找到对应文件。

排错与注意事项

• 上传失败无提示：检查 PHP 错误日志。常见原因包括 post_max_size 和 upload_max_filesize 设置过小。
• GD 库缺失：若报函数不存在，请在 php.ini 中启用 extension=gd 或安装对应包。
• 权限拒绝：若 mkdir 或 move_uploaded_file 失败，检查目标文件夹的 CHMOD 权限及所有者。
• 水印偏移：中文字符串水印可能出现垂直偏移，需微调 get_mark_xy 中的 Y 轴常量。

简要总结

上述关于 PHP 原生文件上传与图片处理类的详细内容，涵盖了从基础校验到高级图像处理的完整链路。更多关于 PHP 图形编程与文件管理的资料请关注本站其它相关文章！