Webman 是基于 Workerman 的 PHP Web 框架，不支持 Python 或 WebGL；其本身无图片处理能力，需依赖 ext-gd/ext-imagick 及 intervention/image 等扩展实现裁剪与水印功能。
Webman 不是 Python 框架，也不是 WebGL 引擎——它是个 PHP 框架（基于 Workerman），官方仓库明确标注为「高性能 PHP Web 框架」。网上混淆它和 Python/WebGL 同名项目的资料全是错误信息，直接照搬会导致环境根本跑不起来。
为什么 composer require webman/webman 装不上图片处理功能
Webman 本身不内置图片裁剪或水印能力，它的核心是路由、中间件和 HTTP 生命周期管理。所有图像操作必须依赖外部扩展或原生 PHP 扩展：
-
ext-gd或ext-imagick必须已启用（用php -m | grep -i gd验证） - 官方插件市场没有叫「webman-image-cropper」的现成包，别搜 npm 或 pip
- 所谓「Webman 图片处理插件」实际是开发者自己封装的
webman/image类库（如基于intervention/image的 thin wrapper）
用 intervention/image 实现带水印的实时裁剪
这是目前 Webman 生态最稳定的做法。注意不是直接在控制器里写 GD 函数，而是通过 Composer 加载成熟图像库：
Webman 2.2.0
下载
Webman 2.2.0版本强化了 TCP/UDP 服务支持，优化路由组管理，并增强异步任务处理能力。结合协程与连接池技术，Webman 能轻松应对高并发场景，适用于网站、接口服务、即时通讯、物联网及游戏开发，兼具高性能、灵活扩展与稳定可靠，是多场景 PHP 服务开发的理想选择。
- 执行
composer require intervention/image - 确保
config/app.php中已注册服务提供者（新版 Webman 通常自动发现） - 在控制器中这样写裁剪+水印逻辑：
use Intervention\Image\ImageManager;
use Intervention\Image\Drivers\Gd\Driver;
$manager = new ImageManager(new Driver());
$image = $manager->read($_FILES['image']['tmp_name']);
// 先裁剪：宽高比 1:1，居中取最大可能区域
$cropped = $image->crop(500, 500, 'center');
// 再加文字水印（位置、字体、透明度需显式设）
$cropped->text('CONFIDENTIAL', 20, 20, function ($font) {
$font->file(public_path('fonts/msyh.ttc'));
$font->size(24);
$font->color('#ff0000');
$font->align('left');
$font->valign('top');
});
// 输出 JPEG，质量 85（太高易卡顿，太低失真明显）
return response($cropped->toJpeg(85))->header('Content-Type', 'image/jpeg');
imagecopymerge 和 imagealphablending 容易踩的坑
如果不用 intervention/image，而手撸 GD，这两个函数的调用顺序和参数极易出错：
-
imagealphablending($dst, false)必须在imagecopymerge()前调用，否则 PNG 水印半透明失效 -
imagecopymerge()最后一个参数是透明度（0–100），但 0 表示完全透明（看不见），100 表示完全不透明（没水印效果）——常用值是 25–40 - 文字水印若用
imagettftext()，必须确认字体路径是服务器绝对路径，./fonts/xxx.ttf在 CLI 模式下会找不到 - 裁剪前务必用
getimagesize()校验原始尺寸，否则imagecopyresampled()可能返回黑图
真正耗时的不是写几行代码，而是验证不同尺寸图片在各种缩放比例下的水印位置偏移、JPEG 压缩后文字是否糊成一片、以及并发上传时临时文件句柄是否泄漏——这些细节不会出现在任何“快速上手”教程里。
