README

主页 : http://www.verot.net/php_class_upload.htm

演示 : http://www.verot.net/php_class_upload_samples.htm

商业用途: http://www.verot.net/php_class_upload_license.htm

安装

composer require "egorryaroslavl/classupload":"1.0.0"

它做什么？

这个类为您管理文件上传。简而言之，它管理上传的文件，并允许您对文件进行任何操作，尤其是如果它是图片，并且可以重复多次。

它是将文件上传快速集成到您网站的理想类。如果文件是图片，您可以以多种方式将其转换、调整大小、裁剪。您还可以应用过滤器、添加边框、文本、水印等... 这就是实例化画廊脚本所需的所有功能。支持的格式有 PNG、JPG、GIF 和 BMP。

您还可以使用该类来处理本地文件，这对于使用图像处理功能特别有用。该类还支持 Flash 上传器和 XMLHttpRequest。

该类与 PHP 4、5 和 7 兼容，并且可以随意本地化其错误消息。

通过 composer 安装

编辑您的 composer.json 文件，包括以下内容

    {
       "require": {
           "verot/class.upload.php": "dev-master"
       }
    }

演示和示例

查看 test/ 目录，您可以在浏览器中加载它。您可以测试该类及其不同的实例化方式，查看一些代码示例，并运行一些测试。

如何使用它？

创建一个简单的 HTML 文件，其中包含一个表单，如下所示

<form enctype="multipart/form-data" method="post" action="upload.php">
  <input type="file" size="32" name="image_field" value="">
  <input type="submit" name="Submit" value="upload">
</form>

创建一个名为 upload.php 的文件（您首先在该文件中加载了该类）

$handle = new upload($_FILES['image_field']);
if ($handle->uploaded) {
  $handle->file_new_name_body   = 'image_resized';
  $handle->image_resize         = true;
  $handle->image_x              = 100;
  $handle->image_ratio_y        = true;
  $handle->process('/home/user/files/');
  if ($handle->processed) {
    echo 'image resized';
    $handle->clean();
  } else {
    echo 'error : ' . $handle->error;
  }
}

它是如何工作的？

您使用 $_FILES['my_field'] 数组实例化该类，其中 my_field 是您的上传表单的字段名称。该类将检查原始文件是否已上传到其临时位置（或者，您也可以使用本地文件名实例化该类）。

然后，您可以为文件设置一些处理变量。例如，您可以重命名文件，如果它是图片，可以以多种方式转换和调整大小。您还可以设置如果文件已存在，类将执行的操作。

然后调用函数 process() 来根据您上面设置的参数执行操作。它将创建原始文件的实例，因此原始文件在每个处理过程中保持不变。文件将被处理并复制到指定位置。处理变量将在完成后重置。

您可以重复设置新的处理变量，并多次调用 process()。完成之后，您可以调用 clean() 删除原始上传文件。

如果您没有设置任何处理参数，并且仅实例化类后调用 process()，则上传的文件将简单地复制到指定位置，没有任何更改或检查。

如果您想使表单上传文件，请勿忘记在表单标签 <form> 中添加 enctype="multipart/form-data"。

如何处理本地文件？

使用本地文件名实例化类，如下所示

$handle = new upload('/home/user/myfile.jpg');

如何处理通过 XMLHttpRequest 上传的文件？

使用特殊的 php: 关键字实例化类，如下所示

$handle = new upload('php:'.$_SERVER['HTTP_X_FILE_NAME']);

在参数前加上php:告诉类从php://input检索上传的数据，其余部分是流文件的名称，通常位于$_SERVER['HTTP_X_FILE_NAME']。但你可以使用任何你觉得合适的名称

$handle = new upload('php:mycustomname.ext');

如何处理原始文件数据？

使用特殊的data:关键字实例化类，如下所示

$handle = new upload('data:'.$file_contents);

如果你的数据是base64编码的，类提供了一个简单的base64:关键字，它会在使用之前解码你的数据

$handle = new upload('base64:'.$base64_file_contents);

如何设置语言？

使用语言代码作为第二个参数实例化类

$handle = new upload($_FILES['image_field'], 'fr_FR');
$handle = new upload('/home/user/myfile.jpg', 'fr_FR');

如何直接将生成的文件或图片输出到浏览器？

只需调用process()方法，不带参数（或者第一个参数为null）

$handle = new upload($_FILES['image_field']);
header('Content-type: ' . $handle->file_src_mime);
echo $handle->Process();
die();

或者，如果你想强制下载文件

$handle = new upload($_FILES['image_field']);
header('Content-type: ' . $handle->file_src_mime);
header("Content-Disposition: attachment; filename=".rawurlencode($handle->file_src_name).";");
echo $handle->Process();
die();

故障排除

如果类没有按照你的预期工作，你可以显示日志，以便详细查看类做了什么。要获取日志，只需在代码末尾添加此行即可

echo $handle->log;

你的问题可能已经在常见问题解答中讨论过：http://www.verot.net/php_class_upload_faq.htm

如果没有，你可以在论坛中搜索，并在那里提问：http://www.verot.net/php_class_upload_forum.htm。请勿使用GitHub issues寻求帮助。

处理参数

注意：本节中所有参数在每个处理过程后都会重置。

文件处理

file_new_name_body替换文件名主体（默认：null）

$handle->file_new_name_body = 'new name';

file_name_body_add添加到文件名主体（默认：null）

$handle->file_name_body_add = '_uploaded';

file_name_body_pre添加到文件名主体前面（默认：null）

$handle->file_name_body_pre = 'thumb_';

file_new_name_ext替换文件扩展名（默认：null）

$handle->file_new_name_ext = 'txt';

file_safe_name格式化文件名（例如，空格替换为_等...）（默认：true）

$handle->file_safe_name = true;

file_force_extension如果没有扩展名，则强制添加扩展名（默认：true）

$handle->file_force_extension = true;

file_overwrite设置文件已存在时的行为（默认：false）

$handle->file_overwrite = true;

file_auto_rename如果文件已存在，则自动重命名文件（默认：true）

$handle->file_auto_rename = true;

dir_auto_create如果缺失，则自动创建目标目录（默认：true）

$handle->dir_auto_create = true;

dir_auto_chmod如果目录不可写，则自动尝试更改目录权限（默认：true）

$handle->dir_auto_chmod = true;

dir_chmod创建目录或目录不可写时使用的chmod（默认：0777）

$handle->dir_chmod = 0777;

file_max_size设置最大上传大小（默认：php.ini中的upload_max_filesize）

$handle->file_max_size = '1024'; // 1KB

mime_check设置类是否检查MIME类型与allowed列表是否匹配（默认：true）

$handle->mime_check = true;

no_script设置类是否将脚本转换为文本文件（默认：true）

$handle->no_script = false;

allowed允许的MIME类型数组（或一个字符串）。接受通配符，如image/*（默认：检查init()）

$handle->allowed = array('application/pdf','application/msword', 'image/*');

forbidden禁止的MIME类型数组（或一个字符串）。接受通配符，如image/*（默认：检查init()）

$handle->forbidden = array('application/*');

图像处理

image_convert如果设置，图像将被转换（可能的值：''|'png'|'jpeg'|'gif'|'bmp'；默认：''）

$handle->image_convert = 'jpg';

image_background_color如果设置，将强制使用颜色填充透明区域，颜色为十六进制（默认：null）

$handle->image_background_color = '#FF00FF';

image_default_color非透明输出格式（如JPEG或BMP）的回退背景颜色，十六进制表示（默认：#FFFFFF）

$handle->image_default_color = '#FF00FF';

png_compression设置PNG图像的压缩级别，介于1（快速但文件大）和9（慢但文件小）之间（默认：null（Zlib默认））

$handle->png_compression = 9;

jpeg_quality设置JPEG图像的压缩质量（默认：85）

$handle->jpeg_quality = 50;

jpeg_size如果设置为字节数，将调整jpeg_quality，以便输出图像适合该大小（默认：null）

$handle->jpeg_size = 3072;

image_interlace如果设置为true，则图像将被交错保存（如果是JPEG，则保存为渐进式PEG）（默认：false）

$handle->image_interlace = true;

图像检查

以下八个设置可以用来在文件为图像时使上传无效（注意：open_basedir 限制阻止使用这些设置）

image_max_width 如果设置为像素尺寸，则如果图像宽度超过此尺寸，上传将无效（默认：null）

$handle->image_max_width = 200;

image_max_height 如果设置为像素尺寸，则如果图像高度超过此尺寸，上传将无效（默认：null）

$handle->image_max_height = 100;

image_max_pixels 如果设置为像素数量，则如果图像像素数量超过此数量，上传将无效（默认：null）

$handle->image_max_pixels = 50000;

image_max_ratio 如果设置为宽高比（宽度/高度），则如果图像宽高比超过此值，上传将无效（默认：null）

$handle->image_max_ratio = 1.5;

image_min_width 如果设置为像素尺寸，则如果图像宽度低于此尺寸，上传将无效（默认：null）

$handle->image_min_width = 100;

image_min_height 如果设置为像素尺寸，则如果图像高度低于此尺寸，上传将无效（默认：null）

$handle->image_min_height = 500;

image_min_pixels 如果设置为像素数量，则如果图像像素数量低于此数量，上传将无效（默认：null）

$handle->image_min_pixels = 20000;

image_min_ratio 如果设置为宽高比（宽度/高度），则如果图像宽高比低于此值，上传将无效（默认：null）

$handle->image_min_ratio = 0.5;

图像缩放

image_resize 决定图像是否将被缩放（默认：false）

$handle->image_resize = true;

以下变量仅在 image_resize == true 时使用

image_x 目标图像宽度（默认：150）

$handle->image_x = 100;

image_y 目标图像高度（默认：150）

$handle->image_y = 200;

使用以下选项之一

image_ratio 如果为 true，则保留原始尺寸比例缩放图像，使用 image_x 和 image_y 作为最大尺寸（默认：false）

$handle->image_ratio = true;

image_ratio_crop 如果为 true，则保留原始尺寸比例缩放图像，使用 image_x 和 image_y 作为最大尺寸，并裁剪多余部分。设置也可以是一个字符串，包含一个或多个来自 'TBLR' 的值，表示裁剪时将保留图像的哪些边（默认：false）

$handle->image_ratio_crop = true;

image_ratio_fill 如果为 true，则保留原始尺寸比例缩放图像，使用 image_x 和 image_y 作为最大尺寸，并将图像填充到空间中，用颜色填充剩余空间。设置也可以是一个字符串，包含一个或多个来自 'TBLR' 的值，表示图像将位于空间的哪个边（默认：false）

$handle->image_ratio_fill = true;

image_ratio_x 如果为 true，则从 image_y 计算图像宽度 image_x 并保留原始尺寸比例（默认：false）

$handle->image_ratio_x = true;

image_ratio_y 如果为 true，则从 image_x 计算图像高度 image_y 并保留原始尺寸比例（默认：false）

$handle->image_ratio_y = true;

image_ratio_pixels 如果设置为长整数，则缩放图像，计算 image_y 和 image_x 以匹配像素数量（默认：false）

$handle->image_ratio_pixels = 25000;

最终防止放大或缩小图像

image_no_enlarging 如果缩放后的图像比原始图像大，则取消缩放，以防止放大（默认：false）

$handle->image_no_enlarging = true;

image_no_shrinking 如果缩放后的图像比原始图像小，则取消缩放，以防止缩小（默认：false）

$handle->image_no_shrinking = true;

图像效果

以下图像操作需要 GD2+

image_brightness 如果设置，则校正亮度。值在 -127 和 127 之间（默认：null）

$handle->image_brightness = 40;

image_contrast 如果设置，则校正对比度。值在 -127 和 127 之间（默认：null）

$handle->image_contrast = 50;

image_opacity 如果设置，则更改图像不透明度。值在 0 和 100 之间（默认：null）

$handle->image_opacity = 50;

image_tint_color 如果设置，则用颜色着色图像，值为十六进制 #FFFFFF（默认：null）

$handle->image_tint_color = '#FF0000';

image_overlay_color 如果设置，则添加彩色叠加，值为十六进制 #FFFFFF（默认：null）

$handle->image_overlay_color = '#FF0000';

image_overlay_opacity 在设置 image_overlay_color 时使用，确定透明度（默认：50）

$handle->image_overlay_opacity = 20;

image_negative 反转图像中的颜色（默认：false）

$handle->image_negative = true;

image_greyscale 将图像转换为灰度（默认：false）

$handle->image_greyscale = true;

image_threshold 应用阈值过滤器。值在 -127 和 127 之间（默认：null）

$handle->image_threshold = 20;

image_pixelate 将图像像素化，值为块大小（默认：null）

$handle->image_pixelate = 10;

image_unsharp 应用不锐化掩码，支持 alpha 透明度（默认：false）

$handle->image_unsharp = true;

image_unsharp_amount 不锐化掩码量，通常为 50 - 200（默认：80）

$handle->image_unsharp_amount = 120;

image_unsharp_radius 不锐化掩码半径，通常为 0.5 - 1（默认：0.5）

$handle->image_unsharp_radius = 1;

image_unsharp_threshold 不锐化掩码阈值，通常为 0 - 5（默认：1）

$handle->image_unsharp_threshold = 0;

图像文本

image_text 在图像上创建文本标签，值为字符串，包含可能的替换令牌（默认：null）

$handle->image_text = 'test';

image_text_direction 文本标签方向，可以是 'h' 水平或 'v' 垂直（默认：'h'）

$handle->image_text_direction = 'v';

image_text_color 文本标签的文本颜色，为十六进制（默认：#FFFFFF）

$handle->image_text_color = '#FF0000';

image_text_opacity 文本标签上的文本透明度，介于 0 和 100 之间的整数（默认：100）

$handle->image_text_opacity = 50;

image_text_background 文本标签背景颜色，为十六进制（默认：null）

$handle->image_text_background = '#FFFFFF';

image_text_background_opacity 文本标签背景透明度，介于 0 和 100 之间的整数（默认：100）

$handle->image_text_background_opacity = 50;

image_text_font 文本标签的内置字体，从 1 到 5。1 是最小的（默认：5）。值也可以是字符串，代表 GDF 或 TTF 字体的路径（TrueType）

$handle->image_text_font = 4; // or './font.gdf' or './font.ttf'

image_text_size TrueType 字体的字体大小，以像素（GD1）或点（GD1）为单位（默认：16）（仅 TrueType 字体）

$handle->image_text_size = 24;

image_text_angle TrueType 字体的文本角度，以度为单位，0 度是左到右阅读的文本（默认：null）（仅 TrueType 字体）

$handle->image_text_angle = 45;

image_text_x 绝对文本标签位置，以像素从左侧边框计算。可以是负值（默认：null）

$handle->image_text_x = 5;

image_text_y 绝对文本标签位置，以像素从顶部边框计算。可以是负值（默认：null）

$handle->image_text_y = 5;

image_text_position 文本标签在图像内的位置，是 'TBLR' 中的一个或两个的组合：顶部、底部、左侧、右侧（默认：null）

$handle->image_text_position = 'LR';

image_text_padding 文本标签填充，以像素为单位。可以被 image_text_padding_x 和 image_text_padding_y 覆盖（默认：0）

$handle->image_text_padding = 5;

image_text_padding_x 文本标签水平填充（默认：null）

$handle->image_text_padding_x = 2;

image_text_padding_y 文本标签垂直填充（默认：null）

$handle->image_text_padding_y = 10;

image_text_alignment 当文本有多个行时，文本对齐方式，可以是 'L'、'C' 或 'R'（默认：'C'）（GD 字体仅限）

$handle->image_text_alignment = 'R';

image_text_line_spacing 当文本有多个行时，行之间的空间，以像素为单位（默认：0）（GD 字体仅限）

$handle->image_text_line_spacing = 3;

图像变换

image_auto_rotate 根据 EXIF 数据自动旋转图像（仅限 JPEG）（默认：true，即使没有图像操作也适用）

$handle->image_auto_rotate = false;

image_flip 翻转图像，可以是 'h' 水平或 'v' 垂直（默认：null）

$handle->image_flip = 'h';

image_rotate 旋转图像。可能的值为 90、180 和 270（默认：null）

$handle->image_rotate = 90;

image_crop 裁剪图像。接受 4、2 或 1 个值作为 'T R B L' 或 'TB LR' 或 'TBLR'。尺寸可以是 20，或 20px 或 20%（默认：null）

$handle->image_crop = array(50,40,30,20); OR '-20 20%'...

image_precrop 裁剪图像，在最终调整大小之前。接受 4、2 或 1 个值作为 'T R B L' 或 'TB LR' 或 'TBLR'。尺寸可以是 20，或 20px 或 20%（默认：null）

$handle->image_precrop = array(50,40,30,20); OR '-20 20%'...

图像边框

image_bevel 向图像添加斜边框。值为像素厚度（默认：null）

$handle->image_bevel = 20;

image_bevel_color1 顶部和左侧斜边框颜色，为十六进制（默认：#FFFFFF）

$handle->image_bevel_color1 = '#FFFFFF';

image_bevel_color2 底部和右侧斜边框颜色，为十六进制（默认：#000000）

$handle->image_bevel_color2 = '#000000';

image_border 向图像添加单色边框。接受 4、2 或 1 个值作为 'T R B L' 或 'TB LR' 或 'TBLR'。尺寸可以是 20，或 20px 或 20%（默认：null）

$handle->image_border = '3px'; OR '-20 20%' OR array(3,2)...

image_border_color 边框颜色，为十六进制（默认：#FFFFFF）

$handle->image_border_color = '#FFFFFF';

image_border_opacity 边框透明度，介于0和100之间的整数（默认：100）

$handle->image_border_opacity = 50;

image_border_transparent 为图像添加渐变到透明的边框。接受4、2或1个值作为'T R B L'或'TB LR'或'TBLR'。尺寸可以是20，或20px或20%（默认：null）

$handle->image_border_transparent = '3px'; OR '-20 20%' OR array(3,2)...

image_frame 边框类型：1=平面 2=交叉（默认：null）

$handle->image_frame = 2;

image_frame_colors 十六进制颜色列表，为数组或用空格分隔的字符串（默认：'#FFFFFF #999999 #666666 #000000'）

$handle->image_frame_colors = array('#999999',  '#FF0000', '#666666', '#333333', '#000000');

image_frame_opacity 边框透明度，介于0和100之间的整数（默认：100）

$handle->image_frame_opacity = 50;

图像水印

image_watermark 在图像上添加水印，值是本地文件名。接受的文件格式为GIF、JPG、BMP、PNG和PNG alpha（默认：null）

$handle->image_watermark = 'watermark.png';

image_watermark_x 水印绝对位置，从左边界起像素值。可以是负数（默认：null）

$handle->image_watermark_x = 5;

image_watermark_y 水印绝对位置，从顶部边界起像素值。可以是负数（默认：null）

$handle->image_watermark_y = 5;

image_watermark_position 水印在图像中的位置，是'TBLR'中的一个或两个的组合：顶部、底部、左、右（默认：null）

$handle->image_watermark_position = 'LR';

image_watermark_no_zoom_in 防止水印在小于图像时被放大（默认：true）

$handle->image_watermark_no_zoom_in = false;

image_watermark_no_zoom_out 防止水印在大于图像时被缩小（默认：false）

$handle->image_watermark_no_zoom_out = true;

图像反射

image_reflection_height 如果设置，将添加反射。格式可以是像素或百分比，例如40、'40'、'40px'或'40%'（默认：null）

$handle->image_reflection_height = '25%';

image_reflection_space 源图像和反射之间的空间，以像素为单位，可以是负数（默认：null）

$handle->image_reflection_space = 3;

image_reflection_color 反射背景颜色，十六进制表示。现在已被image_default_color取代（默认：#FFFFFF）

$handle->image_default_color = '#000000';

image_reflection_opacity 反射开始时的透明度级别，介于0和100之间的整数（默认：60）

$handle->image_reflection_opacity = 60;

在调用`process()`之前可以读取的值

file_src_name 源文件名
file_src_name_body 源文件名主体
file_src_name_ext 源文件扩展名
file_src_pathname 源文件的完整路径和名称
file_src_mime 源文件MIME类型
file_src_size 源文件大小（以字节为单位）
file_src_error 上传错误代码
file_is_image 布尔标志，如果是支持的图像类型则为true

如果文件是支持的图像类型（并且open_basedir限制允许）

image_src_x 源文件宽度（以像素为单位）
image_src_y 源文件高度（以像素为单位）
image_src_pixels 源文件像素数
image_src_type 源文件类型（png、jpg、gif或bmp）
image_src_bits 源文件颜色深度

在调用`process()`之后可以读取的值

file_dst_path 目标文件路径
file_dst_name_body 目标文件名主体
file_dst_name_ext 目标文件扩展名
file_dst_name 目标文件名
file_dst_pathname 目标文件的完整路径和名称

如果文件是支持的图像类型

image_dst_type 目标文件类型（png、jpg、gif或bmp）
image_dst_x 目标文件宽度
image_dst_y 目标文件高度

要求

大多数图像操作需要GD。GD2强烈推荐

该类需要PHP 4.3+，且与PHP 5和PHP 7兼容

变更日志

dev

添加了对UTF-8文本和TrueType字体的支持
添加了对原始文件数据和base64编码文件数据的支持
移除了过时的属性
更好地检查函数可用性
添加了image_no_enlarging和image_no_shrinking以替换image_ratio_no_zoom_in和image_ratio_no_zoom_out
即使没有图像操作，也检查JPEG自动旋转

v 0.33 16/07/2016

添加了对PHP7的兼容性
修复了使用XMLHttpRequest时文件大小的问题
添加了匈牙利语翻译
添加了泰米尔语翻译
添加了芬兰语翻译
修复了土耳其语翻译
更新了MIME检测的正则表达式规则
添加了composer.json
更新了代码以支持GIT发布
根据EXIF数据自动旋转JPEG图片

v 0.32 15/01/2013

添加了对XMLHttpRequest上传的支持
添加了image_pixelate
添加了image_interlace
添加了png_compression以改变PNG压缩级别
如果Suhosin已启用，则禁用exec()
添加更多扩展到危险脚本检测中
从PHP 5.4开始，imagejpeg使用null作为第二个参数
将默认的PECL Fileinfo MAGIC路径设置为null
默认将gd.jpeg_ignore_warning设置为true
修复了文件名规范化问题

v 0.31 11/04/2011

添加了`_application/x-rar` MIME类型
确保如果我们想使用它们，则不要禁用exec()和ini_get_all()函数
确保在计算JPEG大小时不要除以零
allowed和forbidden现在可以接受字符串
如果没有文件扩展名，尝试从MIME类型猜测文件扩展名
更改文件扩展名时改进了类属性
添加了file_force_extension以允许需要时无扩展名文件
改进了文件名安全转换
允许对file_max_size和jpeg_size使用简写字节值，例如1K、2M、3G
添加了image_opacity以改变图片透明度
添加了image_border_opacity以允许半透明边框
添加了image_frame_opacity以允许半透明框架
添加了image_border_transparent以允许边框渐变为透明
将image_overlay_percent复制到image_overlay_opacity
将image_text_percent复制到image_text_opacity
将image_text_background_percent复制到image_text_background_opacity

v 0.30 05/09/2010

实现了一个非锐化蒙版，支持alpha透明度，如果image_unsharp为true则激活。添加了image_unsharp_amount、image_unsharp_radius和image_unsharp_threshold
添加了text/rtf MIME类型，以及no_script异常
当激活no_script并调用多个process()时，修复了错误
改进了finfo的错误处理
在日志中显示php.ini中的upload_max_filesize信息
为无扩展名图像添加自动扩展
修复了image_ratio_fill顶部和左侧填充问题
修复了在透明PNG上应用透明PNG水印时的混合问题
添加了image_watermark_no_zoom_in和image_watermark_no_zoom_out以允许水印调整大小以适应图像。默认情况下，水印可以缩小，但不能放大。

v 0.29 03/02/2010

添加了对恶意图像的保护
添加了zip和torrent MIME类型
用explode()替换了split()
使用image_src_x/y初始化image_dst_x/y
由于它们在process之前使用，所以从文档中删除了mime_fileinfo、mime_file、mime_magic和mime_getimagesize
添加了更多扩展和MIME类型
改进了MIME类型验证
改进了日志记录

v 0.28 10/08/2009

将ereg函数替换为与PHP 5.3兼容
添加了flv MIME类型
改进了MIME类型检测
添加了file_name_body_pre以在文件名前添加字符串
添加了mime_fileinfo、mime_file、mime_magic和mime_getimagesize，以便可以停用某些MIME类型检查方法
使用exec()而不是shell_exec()，以更好地与安全模式协同工作
添加了一些错误消息
修复了在检查条件时的问题，processed没有正确传播

v 0.27 14/05/2009

从FILE_目录中查找语言文件目录
如果设置了 file_overwrite，则禁用 file_auto_rename
改进了对真彩色图像的透明度替换
修复了对较新版本的 UNIX 文件工具的调用
修复了在安全模式下使用 PECL Fileinfo 扩展以及使用 finfo 类时的错误
添加了 image_precrop 用于在最终调整大小之前裁剪图像

v 0.26 13/11/2008

重写了调色板到真彩色的转换以更好地处理透明度
修复了当叠加的图像尺寸不正确时的 imagecopymergealpha()
修复了当要创建的图像宽度或高度小于 1 像素时的 imagecreatenew()
重写了 MIME 类型检测以更安全，并不要依赖于浏览器信息；现在使用 Fileinfo PECL 扩展、UNIX file 命令、MIME magic 和 getimagesize，按照此顺序
添加了对 Flash 上传的支持
一些错误修复和错误处理

v 0.25 17/11/2007

添加了翻译文件和机制以使用非英语语言实例化类
添加了 forbidden 来设置一组禁止的 MIME 类型
在 allowed 和 forbidden 中实现了对简单通配符的支持，例如 image/*
在转换图像时预设文件扩展名到所需的转换格式
添加了对 BMP 图像的读写支持
添加了一个 file_is_image 标志，以确定文件是否是受支持的图像类型
在调用 process() 之前，该类现在提供了一些关于图像的信息。可用的有 image_src_x、image_src_y 以及新引入的 image_src_bits、image_src_pixels 和 image_src_type。请注意，如果设置了 open_basedir 限制，则此功能将不起作用
改进了日志记录；现在提供有用的系统信息
为图像文件添加了一些预处理检查：image_max_width、image_max_height、image_max_pixels、image_max_ratio、image_min_width、image_min_height、image_min_pixels 和 image_min_ratio
添加了 image_ratio_pixels 以将图像调整到像素数，同时保持宽高比
为 GIF 图像添加了 image_is_palette、image_is_transparent 和 image_transparent_color
添加了 image_default_color 以定义非 alpha 透明输出格式（如 JPEG 或 BMP）的回退颜色
更改了 image_background_color，现在它强制透明区域被涂色
改进了反射和颜色叠加，以便与 alpha 透明图像一起工作
image_reflection_color 现已弃用，改用 image_default_color
透明 PNG 现在以真彩色处理，并在合并时完全保留 alpha 通道
透明 GIF 现在自动检测。preserve_transparency 已弃用
透明真彩色图像可以保存为 GIF，同时保留透明度，半透明区域与 image_default_color 合并
透明真彩色图像可以保存为 JPG/BMP，半透明区域与 image_default_color 合并
修复了图像到真彩色的转换
如果函数以空或 null 参数调用，或者没有参数，则该类现在可以输出上传文件的作为 process() 的返回值

v 0.24 25/05/2007

添加了 image_background_color，用于设置图像的默认背景颜色
添加了在文本标签中使用替换令牌的可能性
将默认 JPEG 质量更改为 85
修复了使用灰度滤镜和相关滤镜时的小错误
添加了 image_ratio_fill 以将图像适应某些尺寸，并用颜色填充剩余空间。与 image_ratio_crop 非常相似
改进了目录的递归创建
该类现在在执行图形操作之前将基于调色板的图像转换为真彩色

v 0.23 23/12/2006

修复了处理同一上传文件多次时的bug。如果存在open_basedir限制，类现在在第一次调用process()时创建一个临时文件。此文件将用于后续处理，并在调用clean()时删除。

v 0.22 16/12/2006

添加了如果上传目录不在open_basedir中自动创建临时文件的功能。
修复了一个bug，该bug阻止了通过覆盖其处理副本来在本地文件上工作。
添加了MIME类型video/x-ms-wmv和image/x-png，并修复了PNG在IE中怪异MIME类型的支持。
修改了image_ratio_crop，使其可以接受字符串'TBLR'中的一个或多个，以确定裁剪时保留图像的哪一侧。
添加了对文本中的多行支持，使用"\n"作为换行符。
添加了image_text_line_spacing，允许设置多行文本之间的空间。
添加了image_text_alignment，允许设置文本多行时的对齐方式。
image_text_font现在可以设置为GDF字体文件的路径，以加载外部字体。
添加了image_reflection_height以创建源图像的反射，其高度以像素或百分比表示。
添加了image_reflection_space以设置源图像和反射之间的像素空间。
添加了image_reflection_color以设置反射的背景颜色。
添加了image_reflection_opacity以设置反射的初始透明度级别。

v 0.21 30/09/2006

添加了image_ratio_crop，它可以在image_x和image_y内调整大小，保持比例，但通过裁剪图像的额外部分来填充空间。
添加了mime_check，默认值为true，以设置对allowed MIME列表的检查。
如果MIME为空，类现在将触发错误。
颜色#000000对image_text_color是有效的，并且修复了相关的文本透明度bug。
gd_version()现在使用gd_info()，否则使用phpinfo()。
修复了在Windows系统上目标路径没有尾随斜杠时的路径问题。
移除了内联函数以实现完全PHP5兼容性。

v 0.20 11/08/2006

添加了一些更多的错误检查和消息（GD存在、权限等）。
修复了上传没有扩展名的文件时的问题。
将image_brightness和image_contrast的值更改为介于-127和127之间。
添加了dir_auto_create以自动递归创建缺失的目标目录。
添加了dir_auto_chmod以自动chmod不可写的目标目录。
添加了dir_chmod以设置默认的chmod值。
添加了image_crop以裁剪图像。
添加了image_negative以在图像上反转颜色。
添加了image_greyscale以将图像转换为灰度。
添加了image_threshold以在图像上应用阈值过滤器。
添加了image_bevel、image_bevel_color1和image_bevel_color2以添加斜边边框。
添加了image_border和image_border_color以添加单色边框。
添加了image_frame和image_frame_colors以添加多色边框。

v 0.19 29/03/2006

类现在与i18n兼容（感谢Sylwester）。
类现在可以操作本地文件，而不仅仅是上传的文件（用本地文件名实例化类）。
对file_safe_name进行了一些改进。
添加了image_brightness、image_contrast、image_tint_color、image_overlay_color和image_overlay_percent以在图像上进行颜色操作。
添加了image_text及其所有相关设置以在图像上添加文本标签。
添加了image_watermark及其所有相关设置以在图像上添加水印图像。
添加了image_flip和image_rotate以实现更多图像处理功能。
添加了jpeg_size以计算JPG压缩质量，以便适应单个文件大小。

v 0.18 02/02/2006

添加了no_script将危险的脚本转换为文本文件。
添加了mime_magic_check以设置使用mime_magic的类。
添加了preserve_transparency 实验性。感谢Gregor。
修正了大小和MIME检查，之前没有正常工作：<:/ 感谢Willem。
修复了调整图像大小时出现的内存泄漏。
调整大小时，不再需要设置image_convert。
现在可以简单地转换图像，而不需要调整大小。
将默认的file_max_size设置为php.ini中的upload_max_filesize。感谢Edward。

v 0.17 28/05/2005

该类可以与任何版本的GD一起使用。
在文件上添加了对mime类型的列表的安全检查。
将许可证更改为仅GPL v2。

v 0.16 19/05/2005

添加了file_auto_rename，如果文件名已存在，则自动重命名文件。
添加了file_safe_name，对文件名进行安全格式化（目前是将空格转换为下划线）。
添加了一些错误报告，以避免GD不存在时崩溃。

v 0.15 16/04/2005

添加了JPEG压缩质量设置。感谢Vad。

v 0.14 14/03/2005

重写了类文件，以便可以使用phpDocumentor进行解析。

v 0.13 07/03/2005

修复了image_ratio的bug。感谢Justin。
添加了image_ratio_no_zoom_in和image_ratio_no_zoom_out。

v 0.12 21/01/2005

添加了image_ratio以在最大值内调整大小，保持图像比例。

v 0.11 22/08/2003

更新了对GD2的支持（将imageresized()更改为imagecopyresampled()，将imagecreate()更改为imagecreatetruecolor()）。

egorryaroslavl / classupload

维护者

详细信息

README

安装

它做什么？

通过 composer 安装

演示和示例

如何使用它？

它是如何工作的？

如何处理本地文件？

如何处理通过 XMLHttpRequest 上传的文件？

如何处理原始文件数据？

如何设置语言？

如何直接将生成的文件或图片输出到浏览器？

故障排除

处理参数

文件处理

图像处理

图像检查

图像缩放

图像效果

图像文本

图像变换

图像边框

图像水印

图像反射

在调用`process()`之前可以读取的值

在调用`process()`之后可以读取的值

要求

变更日志

egorryaroslavl / classupload

维护者

详细信息

README

安装

它做什么？

通过 composer 安装

演示和示例

如何使用它？

它是如何工作的？

如何处理本地文件？

如何处理通过 XMLHttpRequest 上传的文件？

如何处理原始文件数据？

如何设置语言？

如何直接将生成的文件或图片输出到浏览器？

故障排除

处理参数

文件处理

图像处理

图像检查

图像缩放

图像效果

图像文本

图像变换

图像边框

图像水印

图像反射

在调用process()之前可以读取的值

在调用process()之后可以读取的值

要求

变更日志

在调用`process()`之前可以读取的值

在调用`process()`之后可以读取的值