PHP图像处理函数imagecopyresampled用法详解

Mia

发布时间：2026-10-13 | 5人浏览过

原创

本文详细介绍了PHP中用于高质量重采样的核心图像处理函数`imagecopyresampled`。通过解析其完整的语法结构和十个关键参数，并结合图像裁剪与等比缩放的实际代码案例，帮助开发者快速掌握在PHP中进行精准图片处理的技巧。

函数语法与功能概述

imagecopyresampled 是 PHP GD 库中用于将一块方形区域从一个图像复制到另一个图像的函数，并在这个过程中进行高质量的重采样和缩放。相较于旧的 imagecopyresized 函数，它能产生更平滑的图像过渡效果，特别适合进行图像缩放操作。

该函数的基本语法如下：

bool imagecopyresampled ( resource $dst_image , resource $src_image , int $dst_x , int $dst_y , int $src_x , int $src_y , int $dst_w , int $dst_h , int $src_w , int $src_h )

成功时返回 true，失败时返回 false。

参数详解

理解每个参数的含义是正确使用该函数的关键：

$dst_image：目标图像连接资源。这是接收复制内容的图像对象。
$src_image：源图像连接资源。这是被复制或截取的原始图像对象。
$dst_x：目标 X 坐标点。在目标图像上开始放置内容的左上角 X 轴位置。
$dst_y：目标 Y 坐标点。在目标图像上开始放置内容的左上角 Y 轴位置。
$src_x：源的 X 坐标点。从源图像的哪个 X 位置开始截取内容。
$src_y：源的 Y 坐标点。从源图像的哪个 Y 位置开始截取内容。
$dst_w：目标宽度。复制到目标图像后的宽度（新尺寸）。
$dst_h：目标高度。复制到目标图像后的高度（新尺寸）。
$src_w：源图宽度。要从源图像截取的原始宽度。
$src_h：源图高度。要从源图像截取的原始高度。

实战应用案例

第1步：实现图像裁剪

此场景适用于用户在前端选择了特定区域（如头像裁剪），服务器端根据坐标提取目标区域的图片。假设前端 POST 提交选中区域的坐标 x, y 以及宽高 w, h。

<?php
$targ_w = $targ_h = 150; // 设置目标输出宽度与高度
$jpeg_quality = 90;      // 设置图片质量，满分为100
$src = 'demo_files/pool.jpg'; // 指定被处理的原始图片路径

$img_r = imagecreatefromjpeg($src);       // 创建源图像资源
$dst_r = ImageCreateTrueColor( $targ_w, $targ_h ); // 创建真彩色的目标图像资源

// 执行重采样复制
imagecopyresampled($dst_r, $img_r, 0, 0, $_POST['x'], $_POST['y'],
$targ_w, $targ_h, $_POST['w'], $_POST['h']); 

header('Content-type: image/jpeg');
imagejpeg($dst_r, null, $jpeg_quality); // 输出图像到浏览器或保存文件
?
>

第2步：实现保持比例的图片缩放

在处理缩略图时，通常需要保持原始宽高比以避免图片变形。以下代码展示了如何将图片自动缩放至指定的最大宽高范围内。

<?php
$filename = '1.jpg';               // 指定源文件路径
$max_width = 400;                  // 设置最大宽度限制
$max_height = 400;                 // 设置最大高度限制
header('Content-Type: image/jpeg');

// 获取原图尺寸
list($width_orig, $height_orig) = getimagesize($filename);
$ratio_orig = $width_orig / $height_orig;

// 计算新的尺寸以保持比例
if ($max_width / $max_height > $ratio_orig) {
    $new_width = $max_height * $ratio_orig;
    $new_height = $max_height;
} else {
    $new_width = $max_width;
    $new_height = $max_width / $ratio_orig;
}

// 重新取样
$image_p = imagecreatetruecolor($new_width, $new_height);
$image = imagecreatefromjpeg($filename);
imagecopyresampled($image_p, $image, 0, 0, 0, 0, $new_width, $new_height, $width_orig, $height_orig);

// 输出结果
imagejpeg($image_p, null, 100);
?
>