怎样用ThinkPHP7实现图片水印-ThinkPHP-PHP中文网

要在thinkphp7项目中给上传图片自动添加水印，必须先启用gd或imagick扩展，配置watermark参数，创建watermark类，并在上传逻辑中调用apply方法；未启用gd会导致watermark初始化失败，水印图需为带alpha通道的png，字体文件须真实存在。

怎样用thinkphp7实现图片水印

要在ThinkPHP7项目中给上传的图片自动添加水印，必须先确认图像处理扩展已启用，否则调用image方法会直接报错退出。

安装并启用GD或Imagick扩展

进入PHP安装目录，打开php.ini，取消注释extension=gd（Windows下为php_gd2.dll，Linux下为gd.so）→ 重启Web服务器 → 在项目根目录运行php -m | grep gd验证是否生效。

若需更高画质水印（如透明度控制、矢量文字渲染），则必须启用Imagick扩展：安装系统级ImageMagick程序 → 编译安装php-imagick扩展 → php.ini中加入extension=imagick → 重启服务。

【ThinkPHP7默认只支持GD驱动，未启用GD将导致Watermark类初始化失败】

配置水印参数与路径规则

在config/app.php中新增watermark配置项：

'watermark' => [
  'enable' => true,
  'position' => 'bottom-right', // 可选：top-left / top-right / center / bottom-left / bottom-right
  'margin' => 15,
  'opacity' => 70,
  'image' => ROOT_PATH . 'public/static/watermark.png',
  'text' => '', // 留空则仅使用图片水印
  'font' => ROOT_PATH . 'public/static/simhei.ttf',
  'fontsize' => 16,
  'color' => '#ffffff'
],

注意：watermark.png必须为带Alpha通道的PNG图，尺寸建议不小于200×80像素；字体文件simhei.ttf需真实存在且可读。

PHP 8.5.5

PHP 8.5.5 是 PHP 8.5 分支的维护更新版本。该版本延续了“小步快跑”的迭代逻辑，通过深度错误修复、底层性能微调以及安全加固，旨在为开发者提供一个更健壮、更高效的运行环境。该版本严格遵守语义化版本规范，不包含破坏性变更。

下载

编写水印处理类Watermark.php

在app/common/下新建Watermark.php文件，内容如下：

namespace app\common;
use think\Image;
class Watermark {
  protected $config;
  public function __construct($config = []) {
    $this->config = array_merge(config('watermark'), $config);
  }
  public function apply($source, $target = null) {
    if (!$this->config['enable']) return false;
    if (!is_file($source)) return false;
    $image = Image::open($source);
    if (empty($this->config['text'])) {
      $waterImg = $this->config['image'];
      if (!is_file($waterImg)) return false;
      $image->water($waterImg, $this->config['position'], $this->config['opacity'], $this->config['margin']);
    } else {
      $image->text($this->config['text'], $this->config['font'], $this->config['fontsize'], $this->config['color'], $this->config['position'], $this->config['margin']);
    }
    $target = $target ?: $source;
    return $image->save($target);
  }
}

在上传逻辑中调用水印功能

第一步：接收上传文件 → 第二步：移动到upload目录 → 第三步：实例化Watermark并执行apply()

示例代码（放在控制器upload方法内）：

$file = $this->request->file('image');
if ($file) {
  $info = $file->move(ROOT_PATH . 'public/upload/');
  if ($info) {
    $path = ROOT_PATH . 'public/upload/' . $info->getSaveName();
    $water = new \app\common\Watermark();
    $water->apply($path); // 原图被覆盖写入水印
    return json(['code'=>1, 'msg'=>'上传成功，已加水印']);
  }
}

这一步操作起来很简单，直接把Watermark实例化后调用apply即可。但【务必确保$target参数为空时，原图路径与$source一致，否则水印不会写回原图】。