TP5无内置头像处理函数，需封装图像操作逻辑；须统一处理头像来源、裁圆需用透明遮罩、QR合成需避免输出流冲突、应抽离为独立Service类。
TP5 里没有内置的「头像处理函数」，所谓“自定义函数写头像”，本质是封装图像操作逻辑——比如下载远程头像、缩放、裁圆、合成到海报等。直接用 imagecreatefromxxx 系列函数裸写容易出错，建议优先复用成熟扩展，再按需封装。
头像路径判断与本地化必须做
用户头像来源杂（微信 URL、本地上传路径、默认占位图），不统一处理会导致后续 imagecreatefromjpeg() 报错或空白。
- 先用
filter_var($url, FILTER_VALIDATE_URL)判断是否为远程地址；是则用file_get_contents()下载并保存到临时目录（如runtime/avatar/），注意加文件后缀校验（.jpg/.png） - 本地路径要检查
is_file()，失败时 fallback 到默认图（如public/assets/images/people.png） - 别直接传 URL 给 GD 函数——
imagecreatefromjpeg('https://...')在多数 PHP 配置下被禁用（allow_url_fopen=Off）
裁圆头像要用 imagecopyresampled() + alpha 通道
单纯用 imagearc() 画个圆圈没用，得真正抠出圆形区域。关键点在创建透明背景和遮罩。
- 用
imagecreatetruecolor($w, $h)创建新画布，imagealphablending($img, false)关闭混合 - 用
imagesavealpha($img, true)保留 alpha 通道 - 核心是：先画一个黑色实心圆作为 mask，再用
imagecopymerge()或双层imagecopyresampled()把原图贴上去，只保留 mask 范围内像素 - 示例片段：
$mask = imagecreatetruecolor($size, $size); imagealphablending($mask, false); imagesavealpha($mask, true); imagefilledellipse($mask, $size/2, $size/2, $size, $size, 0x000000); // 后续用 $mask 控制 copy 区域
QRcode::png() 和头像合成不能共用输出流
很多 TP5 海报代码卡在这儿：先调 QRcode::png() 输出二维码（它会 echo 二进制），再想用 GD 合成头像，结果页面直接显示乱码 PNG 数据。
-
QRcode::png()的$outfile参数必须传真实路径（如runtime/qrcode/xxx.png），不能传false或留空 - 确保该路径目录存在且可写（
mkdir(..., 0755, true)加递归参数） - 合成阶段用
imagecreatefrompng()读取这个文件，不是靠QRcode::png()返回值——它根本不返回东西 - 如果坚持用
endroid/qrcode，改用$qrcode->writeString()获取二进制数据，再用imagecreatefromstring()
真正麻烦的不是写函数，而是头像来源不可控（微信可能返回 403、CDN 域名变动、用户上传了 webp）、GD 对透明 PNG 支持不稳定、以及 TP5 模板缓存干扰图像输出。每一步都得加 if (!function_exists('...')) 包裹，避免重复声明，也别把头像处理塞进控制器——抽成独立 service 类更易测、易换库。
