萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP 多功能圖片處理類 ThumbHandler:縮圖、裁切、水印、翻轉一站式方案

類能力總覽

  • 縮放模式:等比縮放、固定寬高(可選填充/裁切)、自動裁切正方形、手動指定區域裁切。
  • 水印:圖片水印(支援透明度合成、自動縮放適應)、文字水印(字體、顏色、位置、偏移)。
  • 變換:水平/垂直翻轉、旋轉(90°倍數)、邊框。
  • 輸出:JPG/GIF/PNG/WBMP,品質可控,支援直接輸出瀏覽器或存檔。

核心屬性與配置

<?php
class ThumbHandler {
    // 輸入/輸出
    public $src_img, $dst_img, $img_type;
    public $dst_w, $dst_h;              // 目標尺寸
    public $img_create_quality = 100;   // 生成品質
    public $img_display_quality = 80;   // 瀏覽器輸出品質

    // 裁切
    public $cut_type = 0;               // 0不裁切 1自動中間裁切正方 2手動座標
    public $src_x, $src_y;              // 手動裁切起點
    public $rect_w, $rect_h;            // 手動裁切尺寸

    // 水印圖片
    public $mask_img, $mask_position = 0; // 0-9 九宮格位置
    public $mask_offset_x = 5, $mask_offset_y = 5;
    public $mask_img_pct = 50;          // 合成透明度 0-100

    // 水印文字
    public $mask_word, $mask_font = 2, $mask_font_size = 12;
    public $mask_font_color = '#ffffff';
    public $mask_txt_pct = 50;

    // 邊框/翻轉
    public $img_border_size = 0, $img_border_color;
    private $_flip_x = 0, $_flip_y = 0;

    // 支援格式映射
    private $all_type = [
        'jpg'  => 'imagejpeg', 'jpeg' => 'imagejpeg',
        'gif'  => 'imagegif',  'png'  => 'imagepng',
        'wbmp' => 'image2wbmp',
    ];
    // ... 完整方法見下方
}
?>

典型使用場景

1. 自動裁切正方形縮圖(適合頭像、縮圖列表)

$t = new ThumbHandler();
$t->setSrcImg('uploads/photo.jpg');
$t->setCutType(1);           // 自動中間裁切最大正方形
$t->setDstImg('thumb/photo_200.jpg');
$t->createImg(200, 200);     // 產出 200x200

2. 手動指定區域裁切

$t->setSrcImg('uploads/large.jpg');
$t->setCutType(2);
$t->setSrcCutPosition(100, 100); // 源圖座標
$t->setRectangleCut(400, 300);   // 裁切寬高
$t->setDstImg('thumb/crop.jpg');
$t->createImg(400, 300);

3. 加圖片水印(自動縮放適應)

$t->setSrcImg('uploads/photo.jpg');
$t->setMaskImg('logo.png');
$t->setMaskPosition(5);        // 右下角
$t->setMaskImgPct(30);         // 30% 不透明度
$t->setDstImg('thumb/watermarked.jpg');
$t->createImg(800, 600);

4. 加文字水印

$t->setMaskWord('Copyright © 2024');
$t->setMaskFont(5);            // GD 內建字體 1-5
$t->setMaskFontColor('#ff0000');
$t->setMaskTxtPct(50);

關鍵實現細節

  • createImg() 為總入口,內部流程:載入源圖 → 計算縮放/裁切參數 → 建立目標畫布 → imagecopyresampled() 高品質重採樣 → 疊加水印/邊框/翻轉 → 輸出/存檔 → 釋放資源。
  • 水印圖超過目標圖尺寸時,自動按比例縮小至目標寬 1/5(可配置)。
  • 支援 GD 內建字體(1-5)與 TTF 字體(需擴展 imagettftext 邏輯)。

現代替代建議

新專案建議使用 Intervention Image (intervention/image) 或 Imagine (imagine/imagine):

  • API 更優雅(鏈式調用)、支援 Imagick 驅動(效能更強)、Composer 安裝、單元測試完善。
  • 範例:Image::make('foo.jpg')->resize(300, 200)->insert('watermark.png')->save('bar.jpg');
copyright © 萬盛學電腦網 all rights reserved