在WordPress中利用Alpha通道为图片添加水印

一、先搞懂原PHP水印代码的工作原理 #

先拆解你给出的那段GD库代码，每一步逻辑都很清晰：

• 加载图片：imagecreatefrompng('stamp.png') 和 imagecreatefromjpeg('photo.jpeg') 是GD库的核心函数，分别读取水印PNG（支持透明背景）和目标JPEG图片到内存中，生成可操作的GD资源对象。
• 计算水印位置：通过imagesx()和imagesy()获取水印的宽高，然后设置右下角的边距（10px），用目标图的宽高减去水印宽高和边距，算出水印要放置的精确坐标。
• 合成水印：imagecopy()把水印资源复制到目标图的指定坐标位置，完成水印叠加操作。
• 输出与清理：设置响应头为PNG格式，输出合成后的图片，最后用imagedestroy()销毁图片资源，避免内存泄漏。

这段代码本身没问题，但它是面向本地静态图片的，要适配WordPress的缩略图体系，得做针对性改造。

二、结合WordPress文章缩略图的改造方案 #

WordPress的wp_get_attachment_image_src(get_post_thumbnail_id($post->ID))返回的是图片的URL，但我们需要服务器上的本地文件路径才能用GD库处理，所以要换用get_attached_file(get_post_thumbnail_id($post->ID))来获取本地路径。

更高效的方式是：在WordPress生成缩略图的环节就自动加水印，而不是每次访问都重新处理。下面是完整的可复用代码：

完整实现代码 #

function add_watermark_to_post_thumbnails($metadata, $attachment_id) {
    // 只处理图片类型的附件
    if (!wp_attachment_is_image($attachment_id)) {
        return $metadata;
    }

    // 定义水印图的路径（建议放在主题的assets/images目录下）
    $stamp_path = get_stylesheet_directory() . '/assets/images/stamp.png';
    // 检查水印图是否存在，避免报错
    if (!file_exists($stamp_path)) {
        return $metadata;
    }

    // 加载水印图（PNG格式支持透明）
    $stamp = imagecreatefrompng($stamp_path);
    if (!$stamp) {
        return $metadata;
    }

    // 获取水印的宽高
    $stamp_width = imagesx($stamp);
    $stamp_height = imagesy($stamp);

    // 遍历所有生成的缩略图尺寸（比如thumbnail、medium、large等）
    foreach ($metadata['sizes'] as $size => $size_data) {
        $original_image_path = get_attached_file($attachment_id);
        // 拼接当前缩略图的实际本地路径
        $thumb_path = pathinfo($original_image_path, PATHINFO_DIRNAME) . '/' . $size_data['file'];

        // 根据图片格式选择对应的加载函数，兼容JPEG/PNG/WebP
        $image_info = getimagesize($thumb_path);
        switch ($image_info[2]) {
            case IMAGETYPE_JPEG:
                $target_image = imagecreatefromjpeg($thumb_path);
                $save_function = 'imagejpeg';
                break;
            case IMAGETYPE_PNG:
                $target_image = imagecreatefrompng($thumb_path);
                $save_function = 'imagepng';
                break;
            case IMAGETYPE_WEBP:
                $target_image = imagecreatefromwebp($thumb_path);
                $save_function = 'imagewebp';
                break;
            default:
                continue; // 跳过不支持的图片格式
        }

        if (!$target_image) {
            continue;
        }

        // 设置水印位置：右下角，边距10px（可自行调整）
        $margin_right = 10;
        $margin_bottom = 10;
        $dest_x = imagesx($target_image) - $stamp_width - $margin_right;
        $dest_y = imagesy($target_image) - $stamp_height - $margin_bottom;

        // 将水印复制到目标缩略图上
        imagecopy($target_image, $stamp, $dest_x, $dest_y, 0, 0, $stamp_width, $stamp_height);

        // 保存加水印后的缩略图
        $save_function($target_image, $thumb_path);

        // 释放目标图片内存
        imagedestroy($target_image);
    }

    // 释放水印图片内存
    imagedestroy($stamp);

    return $metadata;
}
// 绑定WordPress钩子：在生成附件元数据（缩略图）时触发水印添加
add_filter('wp_generate_attachment_metadata', 'add_watermark_to_post_thumbnails', 10, 2);

三、代码放置位置与启用方式 #

有两种推荐方式，按需选择：

• 主题functions.php：

  1. 进入WordPress后台 → 外观 → 主题文件编辑器
  2. 选择当前使用的主题，找到functions.php文件
  3. 将上述代码粘贴到文件末尾，点击更新文件即可

  注意：如果主题更新，这段代码会被覆盖，所以仅适合自定义主题或不打算更新主题的场景。

• 自定义插件（更推荐）：

  1. 新建一个PHP文件，命名为wp-thumbnail-watermark.php
  2. 在文件开头添加插件头信息：

     <?php
     /*
     Plugin Name: 文章缩略图自动水印
     Description: 为WordPress所有文章缩略图添加自定义水印
     Version: 1.0
     Author: Your Name
     */
     

  3. 将上面的水印函数代码粘贴到插件头下方
  4. 把文件上传到服务器的wp-content/plugins/目录
  5. 进入WordPress后台 → 插件，找到这个插件并启用即可

  优点：主题更新不会影响代码，方便管理和禁用。

四、关键注意事项 #

• GD库支持：确保你的服务器开启了PHP GD扩展（绝大多数主机默认开启，可通过phpinfo()查看）
• 水印图格式：推荐用PNG格式，支持透明背景，水印效果更自然
• 位置调整：如果想把水印放在左上角，只需把$dest_x改为$margin_right，$dest_y改为$margin_bottom即可
• 已存在的缩略图：这段代码只对新上传的图片生效，如果要给已有的缩略图加水印，需要用插件（比如Regenerate Thumbnails）重新生成所有缩略图

内容的提问来源于stack exchange，提问作者DHL17