图片处理类 class_image.php 使用说明

admin · 发表于 2020-7-8 10:30:51

马上注册，免费下载更多dz插件网资源。

您需要登录才可以下载或查看，没有账号？立即注册

×

/*** 图片处理类** @example** require_once libfile('class/image');* $img = new image;* $r = $img->Thumb($attachfile, '', $w, $h, 'fixwr'); //生成 $attachfile.'thumb.jpg' 为文件名的缩略图* $r = $img->Thumb($attachfile, 'temp/test.jpg', $w, $h, 'fixwr'); //生成 /data/attachment/test/test.jpg' 为文件名的缩略图* if($r) {* $isthumb = $r;* } else {* $error = $img->error();* showmessage('Thumb Error');* }** $r = $img->Watermark($attachfile); //为 $attachfile 加水印* if(!$r) {* $error = $img->error();* showmessage('Watermark Error');* }**/

复制代码

/* * $this->error() 返回值（用于处理失败时） * 0: 图片不符合处理条件，无需处理正常退出 * -1: $source 为无效的图片文件 * -2: 文件权限不足无法处理图片($source 图片无法读取、$target 路径不可写) * -3: 系统设置错误无法处理图片 * -4: 服务器缺少处理图片所需的功能 */

复制代码

/** * 生成图片的缩略图 * @param $source 图片源路径 * @param $target 生成的缩略图路径，路径为相对 data/attachment/ 的文件名 * 本地图片省略时自动加后缀 .thumb.jpg，远程图片无法省略 * @param $thumbwidth 缩略宽度 * @param $thumbheight 缩略高度 * @param $thumbtype 缩略方法 * fixnone / 1 : 小于指定大小、保持比率（默认） * fixwr / 2 : 与指定大小相同、保持比率，超出部分剪切 * @param $nosuffix 缩略图路径不加 .thumb.jpg 后缀 * @return 是否处理完毕 */ function Thumb($source, $target, $thumbwidth, $thumbheight, $thumbtype = 1, $nosuffix = 0)

复制代码

/** * 生成图片的水印 * @param $source 图片源路径 * @param $target 生成的图片路径，省略表示同 $source * @param $type forum - 社区; portal - 门户; album - 空间相册 * @return 是否处理完毕 */ function Watermark($source, $target = '', $type = 'forum')

复制代码

©DZ插件网所发布的一切资源仅限用于学习和研究目的；不得将上述内容用于商业或者非法用途，否则，一切后果请用户自负。
本站内容为站长个人技术研究记录或网络，不提供用户交互功能，所有内容版权归原作者所有。您必须在下载后的24个小时之内，从您的电脑中彻底删除上述内容。如果您喜欢该程序，请支持正版软件，得到更好的正版服务。
您在本站任何的赞助购买、下载、查阅、回复等行为等均表示接受并同意签订《DZ插件网免责声明协议》。
如有侵权请邮件与我们联系处理: discuzaddons@vip.qq.com 并出示相关证明以便删除。敬请谅解！

Discuz智能体 · 发表于 2025-3-18 00:10:03

`class_image.php` 是 Discuz! 中的一个图片处理类，主要用于生成缩略图和添加水印。以下是对该类中 `Thumb` 和 `Watermark` 方法的详细说明和使用示例。

### 1. 生成缩略图 `Thumb` 方法

#### 方法签名：

function Thumb($source, $target, $thumbwidth, $thumbheight, $thumbtype = 1, $nosuffix = 0)

复制代码

#### 参数说明：
- **$source**: 图片源路径，可以是本地文件路径或远程图片 URL。
- **$target**: 生成的缩略图路径，路径为相对 `data/attachment/` 的文件名。如果省略，则自动在源文件名后加上 `.thumb.jpg` 后缀。
- **$thumbwidth**: 缩略图的宽度。
- **$thumbheight**: 缩略图的高度。
- **$thumbtype**: 缩略方法，可选值：
- `fixnone` 或 `1`：小于指定大小、保持比率（默认）。
- `fixwr` 或 `2`：与指定大小相同、保持比率，超出部分剪切。
- **$nosuffix**: 是否在缩略图路径中不加 `.thumb.jpg` 后缀，默认为 `0`（即加后缀）。

#### 返回值：
- 返回 `true` 表示处理成功，返回 `false` 表示处理失败。可以通过 `$img->error()` 获取错误代码。

#### 使用示例：

require_once libfile('class/image');
$img = new image;
// 生成缩略图，自动加 .thumb.jpg 后缀
$r = $img->Thumb($attachfile, '', $w, $h, 'fixwr');
// 生成缩略图，指定目标路径
$r = $img->Thumb($attachfile, 'temp/test.jpg', $w, $h, 'fixwr');
if($r) {
$isthumb = $r;
} else {
$error = $img->error();
showmessage('Thumb Error');
}

复制代码

### 2. 添加水印 `Watermark` 方法

#### 方法签名：

function Watermark($source, $target = '', $type = 'forum')

复制代码

#### 参数说明：
- **$source**: 图片源路径，可以是本地文件路径或远程图片 URL。
- **$target**: 生成的图片路径，省略表示与 `$source` 相同。
- **$type**: 水印类型，可选值：
  - `forum`：社区（默认）。
  - `portal`：门户。
  - `album`：空间相册。

#### 返回值：
- 返回 `true` 表示处理成功，返回 `false` 表示处理失败。可以通过 `$img->error()` 获取错误代码。

#### 使用示例：

require_once libfile('class/image');
$img = new image;
// 为图片添加水印
$r = $img->Watermark($attachfile);
if(!$r) {
$error = $img->error();
showmessage('Watermark Error');
}

复制代码

### 3. 错误处理

在处理图片时，如果出现错误，可以通过 `$img->error()` 获取错误代码。错误代码的含义如下：

- **0**: 图片不符合处理条件，无需处理正常退出。
- **-1**: `$source` 为无效的图片文件。
- **-2**: 文件权限不足无法处理图片（`$source` 图片无法读取、`$target` 路径不可写）。
- **-3**: 系统设置错误无法处理图片。
- **-4**: 服务器缺少处理图片所需的功能。

### 4. 注意事项
- 确保 `data/attachment/` 目录及其子目录有正确的写权限。
- 如果处理远程图片，确保服务器支持远程图片的读取。
- 如果使用水印功能，确保水印图片和字体文件配置正确。

### 5. 参考文档
更多关于 Discuz! 图片处理类的详细说明，可以参考 [DZ插件网](https://www.dz-x.net/) 的相关文档和教程。

希望这些信息对你有所帮助！如果你有其他问题，欢迎继续提问。
-- 本回答由人工智能 AI智能体生成，内容仅供参考，请仔细甄别。