Codeigniter 4使用Image Manipulation Class实现图片水印的技术咨询

Hey there! I totally get the frustration—when I migrated from CodeIgniter 3 to 4, I was surprised to find the built-in image watermark feature was gone too, since the official docs only cover text watermarks. No worries though, there are two solid ways to add image watermarks in CI4, and I'll walk you through both.

方法一：直接用GD库快速实现（适合临时需求） #

If you just need to add a watermark in one spot, you can bypass the CI4 Image class's limitations by working directly with GD (which CI4 uses under the hood anyway). Here's a working example:

// Load CI4's Image service and open your source image
$image = \Config\Services::image()
    ->withFile('/path/to/your/main-image.jpg')
    ->open();

// Grab the GD resource of your source image
$sourceImg = $image->getResource();

// Load your watermark image (PNG is best for transparency)
$watermarkImg = imagecreatefrompng('/path/to/your/watermark.png');

// Get dimensions for both images
$sourceWidth = imagesx($sourceImg);
$sourceHeight = imagesy($sourceImg);
$watermarkWidth = imagesx($watermarkImg);
$watermarkHeight = imagesy($watermarkImg);

// Calculate position for bottom-right corner (10px padding)
$posX = $sourceWidth - $watermarkWidth - 10;
$posY = $sourceHeight - $watermarkHeight - 10;

// Merge the watermark onto the source image
imagecopy($sourceImg, $watermarkImg, $posX, $posY, 0, 0, $watermarkWidth, $watermarkHeight);

// Save the final image (adjust quality as needed)
imagejpeg($sourceImg, '/path/to/save/finished-image.jpg', 90);

// Clean up resources
imagedestroy($sourceImg);
imagedestroy($watermarkImg);

方法二：扩展CI4的Image类（推荐复用场景） #

If you need to add watermarks across multiple parts of your app, extending the core Image class will let you use a clean, reusable method—just like CI3 did. Here's how to set it up:

1. Create a custom library file at app/Libraries/MyImage.php:

<?php namespace App\Libraries;

use CodeIgniter\Images\Image;

class MyImage extends Image
{
    /**
     * Add an image watermark to the current image
     * @param string $watermarkPath Full path to your watermark image
     * @param int|null $x Custom X position (defaults to bottom-right with padding)
     * @param int|null $y Custom Y position (defaults to bottom-right with padding)
     * @return $this
     */
    public function addImageWatermark(string $watermarkPath, int $x = null, int $y = null): self
    {
        $sourceResource = $this->getResource();
        
        // Load watermark and handle errors
        $watermarkResource = imagecreatefrompng($watermarkPath);
        if (!$watermarkResource) {
            throw new \RuntimeException('Failed to load watermark image. Check the file path!');
        }

        // Get dimensions
        $sourceW = imagesx($sourceResource);
        $sourceH = imagesy($sourceResource);
        $watermarkW = imagesx($watermarkResource);
        $watermarkH = imagesy($watermarkResource);

        // Set default position if no custom coords are passed
        if ($x === null) {
            $x = $sourceW - $watermarkW - 10;
        }
        if ($y === null) {
            $y = $sourceH - $watermarkH - 10;
        }

        // Make sure we don't position the watermark outside the image
        $x = max(0, $x);
        $y = max(0, $y);

        // Merge the watermark
        imagecopy($sourceResource, $watermarkResource, $x, $y, 0, 0, $watermarkW, $watermarkH);

        // Clean up
        imagedestroy($watermarkResource);

        return $this;
    }
}

2. Use your custom class in your code:

// Initialize your extended Image class
$image = new \App\Libraries\MyImage();

// Process your image with the new watermark method
$image->withFile('/path/to/source-image.jpg')
      ->open()
      ->addImageWatermark('/path/to/watermark.png') // Add custom coords like (20, 20) if needed
      ->save('/path/to/save/final-image.jpg');

Quick Notes #

• Make sure the GD extension is enabled on your server (CI4 relies on it by default)
• Use PNG watermarks for transparency support—JPGs won't work for see-through watermarks
• If you prefer Imagick over GD, you can adapt the code to use Imagick's compositeImage() method instead

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