huahuibao/common/components/PosterUtil.php

<?php

namespace common\components;

/**
 * 散客分享海报（OSS：poster/blank.png 动态画布 + 水印合成，布局参考快团团）
 */
class PosterUtil
{
    const BLANK_CANVAS = 'poster/blank.png';

    const FONT = 'd3F5LW1pY3JvaGVp';

    const POSTER_W = 750;

    const CANVAS_PAD_X = 20;

    const CANVAS_PAD_Y = 20;

    /** 文案每行最多字数（商品名、注意事项） */
    const TEXT_CHARS_PER_LINE = 13;

    const SLOT_W = 710;

    const FOOTER_H = 300;

    const IMG_H_MIN = 240;

    const IMG_H_MAX = 880;

    const TOTAL_H_MAX = 2000;

    const CANVAS_COLOR = 'FFFFFF';

    const SHOP_LOGO_SIZE = 72;

    const SHOP_LOGO_GAP = 12;

    const SHOP_TITLE_SIZE = 36;

    const SHOP_TITLE_MAX_LEN = 18;

    const HEADER_BOTTOM_GAP = 16;

    const MID_AFTER_COVER_GAP = 16;

    const MID_BLOCK_GAP = 10;

    const MID_LINE_GAP = 6;

    const MID_NAME_SIZE = 38;

    const MID_REMARK_SIZE = 26;

    const REMARK_PREFIX = '注意：';

    const QR_SIZE = 220;

    const QR_PAD_RIGHT = 36;

    const QR_PAD_BOTTOM = 32;

    /** 价格下方：灰色圆角条 + 文案（布局参考快团团） */
    const FOOTER_BUY_HINT = '长按识别小程序购买';

    const FOOTER_BUY_HINT_SIZE = 26;

    const FOOTER_BUY_HINT_BAR_H = 48;

    const FOOTER_BUY_HINT_BAR_RADIUS = 12;

    const FOOTER_BUY_HINT_BAR_COLOR = 'F2F2F2';

    /** 灰条左右内边距（条宽 = 文案宽度 + 两侧 padding） */
    const FOOTER_BUY_HINT_TEXT_PAD_X = 20;

    const FOOTER_TEXT_GAP = 12;

    const FOOTER_PRICE_SIZE = 64;

    /**
     * 与 admin/home/me 一致：门店展示名、Logo 对象路径、itemRemark
     */
    public static function withShopAndRemark(array $options, $shop, $sj, $itemOrRemark = null)
    {
        $meta = self::resolveShopPosterMeta($shop, $sj);
        $options['shopTitle'] = $meta['shopTitle'];
        $options['shopLogo'] = $meta['shopLogo'];
        if (is_string($itemOrRemark)) {
            $options['itemRemark'] = self::filterPosterUtf8Text($itemOrRemark);
        } elseif ($itemOrRemark !== null) {
            $options['itemRemark'] = self::filterPosterUtf8Text($itemOrRemark->itemRemark ?? '');
        } else {
            $options['itemRemark'] = self::filterPosterUtf8Text($options['itemRemark'] ?? '');
        }

        return $options;
    }

    /**
     * hdApp/ghsApp me 页门店标题：sjName·shopName（首店仅 sjName）
     */
    public static function buildShopDisplayTitle($sjName, $shopName)
    {
        $sjName = trim((string)$sjName);
        $shopName = trim((string)$shopName);
        if ($shopName === '' || $shopName === '首店') {
            return $sjName;
        }

        return $sjName . '·' . $shopName;
    }

    public static function resolveShopPosterMeta($shop, $sj = null)
    {
        $sjName = '';
        if ($shop) {
            $sjName = trim((string)($shop->merchantName ?? ''));
        }
        if ($sj !== null) {
            if (is_array($sj)) {
                $sjName = trim((string)($sj['name'] ?? $sjName));
            } elseif (is_object($sj) && isset($sj->name)) {
                $sjName = trim((string)$sj->name);
            }
        }
        $shopName = $shop ? trim((string)($shop->shopName ?? '')) : '';
        $title = self::filterPosterUtf8Text(self::buildShopDisplayTitle($sjName, $shopName));
        if (mb_strlen($title, 'UTF-8') > self::SHOP_TITLE_MAX_LEN) {
            $title = mb_substr($title, 0, self::SHOP_TITLE_MAX_LEN, 'UTF-8') . '…';
        }

        return [
            'shopTitle' => $title,
            'shopLogo' => self::resolveShopLogoObjectPath($shop),
        ];
    }

    public static function resolveShopLogoObjectPath($shop)
    {
        $avatar = '';
        if ($shop && !empty($shop->avatar)) {
            $avatar = $shop->avatar;
        }

        return imgUtil::normalizeOssObjectPath($avatar);
    }

    /**
     * 海报文案 UTF-8 清洗：剔除非法字节、替换符及常见乱码字符
     */
    public static function filterPosterUtf8Text($text)
    {
        $text = trim((string)$text);
        if ($text === '') {
            return '';
        }
        if (function_exists('iconv')) {
            $fixed = @iconv('UTF-8', 'UTF-8//IGNORE', $text);
            if ($fixed !== false) {
                $text = $fixed;
            }
        }
        if (function_exists('mb_convert_encoding')) {
            $converted = @mb_convert_encoding($text, 'UTF-8', 'UTF-8');
            if (is_string($converted) && $converted !== '') {
                $text = $converted;
            }
        }
        $text = preg_replace('/[\x{FFFD}\x{FFF0}-\x{FFFF}]/u', '', $text);
        $text = preg_replace('/[\x00-\x08\x0B\x0C\x0E-\x1F\x7F]/u', '', $text);
        $text = preg_replace(
            '/[^\x{4e00}-\x{9fff}a-zA-Z0-9\s，。、！？：；…·～%（）【】\[\]\/\-_+|《》「」\'\"\.#&@\x{3000}-\x{303F}\x{FF01}-\x{FF5E}]/u',
            '',
            $text
        );
        $text = trim(preg_replace('/\s+/u', ' ', $text));

        return $text;
    }

    public static function truncateText($text, $maxLen = 14)
    {
        $text = self::filterPosterUtf8Text($text);
        if ($text === '') {
            return '';
        }
        if (mb_strlen($text, 'UTF-8') > $maxLen) {
            return mb_substr($text, 0, $maxLen, 'UTF-8') . '…';
        }

        return $text;
    }

    /**
     * @return array{0:string,1:string}
     */
    public static function splitPosterTextLines($text, $maxPerLine = self::TEXT_CHARS_PER_LINE)
    {
        $text = self::filterPosterUtf8Text($text);
        if ($text === '') {
            return ['', ''];
        }
        $maxPerLine = (int)$maxPerLine;
        if ($maxPerLine < 1) {
            $maxPerLine = self::TEXT_CHARS_PER_LINE;
        }
        $len = mb_strlen($text, 'UTF-8');
        if ($len <= $maxPerLine) {
            return [$text, ''];
        }
        $line1 = mb_substr($text, 0, $maxPerLine, 'UTF-8');
        $rest = mb_substr($text, $maxPerLine, null, 'UTF-8');
        if (mb_strlen($rest, 'UTF-8') <= $maxPerLine) {
            return [$line1, $rest];
        }
        $line2 = mb_substr($rest, 0, $maxPerLine, 'UTF-8') . '…';

        return [$line1, $line2];
    }

    /** @deprecated 兼容旧调用 */
    public static function splitPosterNameLines($name, $maxPerLine = self::TEXT_CHARS_PER_LINE)
    {
        return self::splitPosterTextLines($name, $maxPerLine);
    }

    public static function buildPosterTwoLineText($text, $maxPerLine = self::TEXT_CHARS_PER_LINE)
    {
        list($line1, $line2) = self::splitPosterTextLines($text, $maxPerLine);
        if ($line2 === '') {
            return $line1;
        }

        return $line1 . "\n" . $line2;
    }

    /**
     * 商品名（图下，最多两行）
     */
    public static function buildPosterNameText($name, $flowerNum = 0, $subtitle = '')
    {
        $name = self::filterPosterUtf8Text($name);
        $subtitle = self::filterPosterUtf8Text($subtitle);
        list($line1, $line2) = self::splitPosterTextLines($name);
        $suffix = '';
        if ($flowerNum > 0) {
            $suffix = ' · ' . (int)$flowerNum . '支';
        } elseif (trim((string)$subtitle) !== '') {
            $suffix = ' · ' . trim((string)$subtitle);
        }
        if ($suffix !== '') {
            if ($line2 === '') {
                $merged = $line1 . $suffix;
                if (mb_strlen($merged, 'UTF-8') <= self::TEXT_CHARS_PER_LINE) {
                    $line1 = $merged;
                } else {
                    $line2 = self::truncateText($suffix, self::TEXT_CHARS_PER_LINE);
                }
            } else {
                $merged = $line2 . $suffix;
                $line2 = mb_strlen($merged, 'UTF-8') <= self::TEXT_CHARS_PER_LINE
                    ? $merged
                    : self::truncateText($merged, self::TEXT_CHARS_PER_LINE);
            }
        }
        if ($line2 === '') {
            return $line1;
        }

        return $line1 . "\n" . $line2;
    }

    /**
     * 注意事项（图下、名称下，无内容返回空串）
     */
    public static function buildPosterRemarkText($itemRemark)
    {
        $itemRemark = self::filterPosterUtf8Text($itemRemark);
        if ($itemRemark === '') {
            return '';
        }

        return self::buildPosterTwoLineText(self::REMARK_PREFIX . $itemRemark);
    }

    private static function countTextLines($text)
    {
        $text = trim((string)$text);
        if ($text === '') {
            return 0;
        }

        return substr_count($text, "\n") + 1;
    }

    private static function textBlockHeight($lineCount, $fontSize)
    {
        if ($lineCount <= 0) {
            return 0;
        }
        $lineH = (int)ceil($fontSize * 1.2);

        return $lineCount * $lineH + max(0, $lineCount - 1) * self::MID_LINE_GAP;
    }

    private static function calcMidSectionHeight($nameText, $remarkText)
    {
        $h = 0;
        $nameLines = self::countTextLines($nameText);
        if ($nameLines > 0) {
            $h += self::MID_AFTER_COVER_GAP + self::textBlockHeight($nameLines, self::MID_NAME_SIZE);
        }
        $remarkLines = self::countTextLines($remarkText);
        if ($remarkLines > 0) {
            $h += ($nameLines > 0 ? self::MID_BLOCK_GAP : self::MID_AFTER_COVER_GAP);
            $h += self::textBlockHeight($remarkLines, self::MID_REMARK_SIZE);
        }

        return $h;
    }

    private static function coverStartY()
    {
        return self::CANVAS_PAD_Y + self::SHOP_LOGO_SIZE + self::HEADER_BOTTOM_GAP;
    }

    /**
     * 底部左侧（价格+灰条）与右侧太阳码垂直居中对齐
     *
     * @return array{buyHintBarY:int,buyHintBarW:int,buyHintTextY:int,buyHintTextX:int,priceY:int,qrY:int}
     */
    private static function calcFooterLayout()
    {
        $qrCenterFromBottom = self::QR_PAD_BOTTOM + (int)(self::QR_SIZE / 2);
        $hintBarH = self::FOOTER_BUY_HINT_BAR_H;
        $hintBarW = self::calcBuyHintBarWidth(self::FOOTER_BUY_HINT);
        $priceH = (int)ceil(self::FOOTER_PRICE_SIZE * 1.3);
        $gap = self::FOOTER_TEXT_GAP;
        $blockH = $priceH + $gap + $hintBarH;
        $buyHintBarY = max(16, $qrCenterFromBottom - (int)($blockH / 2));
        $priceY = $buyHintBarY + $hintBarH + $gap;
        $textLineH = (int)ceil(self::FOOTER_BUY_HINT_SIZE * 1.2);
        $buyHintTextY = $buyHintBarY + (int)(($hintBarH - $textLineH) / 2);
        $qrY = max(16, $qrCenterFromBottom - (int)(self::QR_SIZE / 2));

        return [
            'buyHintBarY' => $buyHintBarY,
            'buyHintBarW' => $hintBarW,
            'buyHintTextY' => $buyHintTextY,
            'buyHintTextX' => self::CANVAS_PAD_X + self::FOOTER_BUY_HINT_TEXT_PAD_X,
            'priceY' => $priceY,
            'qrY' => $qrY,
        ];
    }

    /** 按文案长度估算灰条宽度，避免条过长导致 OSS 圆角裁切异常 */
    private static function calcBuyHintBarWidth($text)
    {
        $text = self::filterPosterUtf8Text($text);
        if ($text === '') {
            $text = self::FOOTER_BUY_HINT;
        }
        $charCount = mb_strlen($text, 'UTF-8');
        $charW = (int)ceil(self::FOOTER_BUY_HINT_SIZE * 1.15);
        $w = $charCount * $charW + self::FOOTER_BUY_HINT_TEXT_PAD_X * 2;

        return max(220, min(self::SLOT_W - self::QR_SIZE - self::QR_PAD_RIGHT - 24, $w));
    }

    /** OSS 生成灰色小圆角底条 */
    private static function buildBuyHintBarWatermarkPath($barW)
    {
        $w = max(200, (int)$barW);
        $h = self::FOOTER_BUY_HINT_BAR_H;
        $r = min(self::FOOTER_BUY_HINT_BAR_RADIUS, (int)floor($h / 2) - 2);

        return self::BLANK_CANVAS . '?x-oss-process=image/resize,m_fill,w_' . $w . ',h_' . $h
            . ',color_' . self::FOOTER_BUY_HINT_BAR_COLOR . '/rounded-corners,r_' . $r;
    }

    /**
     * @return array{imgH:int,totalH:int,scaledH:int,posterW:int,coverY:int,nameY:int,remarkY:int}
     */
    public static function calcPosterLayout($coverWidth, $coverHeight, array $textOptions = [])
    {
        $coverWidth = (int)$coverWidth;
        $coverHeight = (int)$coverHeight;
        $scaledH = 0;

        if ($coverWidth > 0 && $coverHeight > 0) {
            $scaledH = (int)round($coverHeight * (self::SLOT_W / $coverWidth));
            $imgH = max(self::IMG_H_MIN, min(self::IMG_H_MAX, $scaledH));
        } else {
            $scaledH = self::IMG_H_MIN;
            $imgH = self::IMG_H_MIN;
        }

        $nameText = self::buildPosterNameText(
            $textOptions['name'] ?? '',
            (int)($textOptions['flowerNum'] ?? 0),
            $textOptions['subtitle'] ?? ''
        );
        $remarkText = self::buildPosterRemarkText($textOptions['itemRemark'] ?? '');

        $coverY = self::coverStartY();
        $midH = self::calcMidSectionHeight($nameText, $remarkText);
        $totalH = $coverY + $imgH + $midH + self::FOOTER_H;
        $absoluteMin = self::coverStartY() + self::IMG_H_MIN + self::FOOTER_H;
        $totalH = max($absoluteMin, min(self::TOTAL_H_MAX, $totalH));

        $nameY = $coverY + $imgH + ($nameText !== '' ? self::MID_AFTER_COVER_GAP : 0);
        $remarkY = 0;
        if ($remarkText !== '') {
            $remarkY = $nameY;
            if ($nameText !== '') {
                $remarkY += self::textBlockHeight(self::countTextLines($nameText), self::MID_NAME_SIZE);
                $remarkY += self::MID_BLOCK_GAP;
            } else {
                $remarkY = $coverY + $imgH + self::MID_AFTER_COVER_GAP;
            }
        }

        return [
            'imgH' => $imgH,
            'totalH' => $totalH,
            'scaledH' => $scaledH,
            'posterW' => self::POSTER_W,
            'coverY' => $coverY,
            'nameY' => $nameY,
            'remarkY' => $remarkY,
        ];
    }

    private static function buildCoverWatermarkPath($cover, $scaledH)
    {
        $scaledH = (int)$scaledH;
        if ($scaledH > self::IMG_H_MAX) {
            return $cover . '?x-oss-process=image/resize,m_fill,w_' . self::SLOT_W . ',h_' . self::IMG_H_MAX . ',limit_0';
        }

        return $cover . '?x-oss-process=image/resize,m_lfit,w_' . self::SLOT_W . ',limit_0';
    }

    private static function buildShopLogoWatermarkPath($logoObject)
    {
        $logoObject = imgUtil::normalizeOssObjectPath($logoObject);

        return $logoObject . '?x-oss-process=image/resize,m_fill,h_' . self::SHOP_LOGO_SIZE
            . ',w_' . self::SHOP_LOGO_SIZE . ',limit_0';
    }

    private static function shopTitleY()
    {
        return self::CANVAS_PAD_Y + (int)((self::SHOP_LOGO_SIZE - self::SHOP_TITLE_SIZE) / 2);
    }

    public static function buildCanvasBaseUrl($prefix, $totalH)
    {
        $absoluteMin = self::coverStartY() + self::IMG_H_MIN + self::FOOTER_H;
        $totalH = max($absoluteMin, min(self::TOTAL_H_MAX, (int)$totalH));
        $process = '?x-oss-process=image/resize,m_pad,w_' . self::POSTER_W . ',h_' . $totalH
            . ',color_' . self::CANVAS_COLOR;

        return $prefix . self::BLANK_CANVAS . $process;
    }

    public static function buildHyxhLogoWatermark($mainId)
    {
        if (!in_array((int)$mainId, [52, 1459, 13495], true)) {
            return '';
        }
        $logo = 'poster/hyxh_ncd_logo.png?x-oss-process=image/resize,m_fill,h_72,w_72';
        if ($mainId == 1459) {
            $logo = 'poster/hyxh_gcd_logo.png?x-oss-process=image/resize,m_fill,h_72,w_72';
        }
        if ($mainId == 13495) {
            $logo = 'poster/hyxh_hzd_logo.png?x-oss-process=image/resize,m_fill,h_72,w_72';
        }

        return stringUtil::ossBase64($logo);
    }

    public static function buildMallGoodsPosterUrl($prefix, array $options)
    {
        return self::buildMallSharePosterUrl($prefix, $options);
    }

    public static function buildMallItemPosterUrl($prefix, array $options)
    {
        return self::buildMallSharePosterUrl($prefix, $options);
    }

    public static function buildGhsHdItemPosterUrl($prefix, array $options)
    {
        return self::buildMallSharePosterUrl($prefix, $options);
    }

    private static function buildMallSharePosterUrl($prefix, array $options)
    {
        $cover = $options['cover'] ?? '';
        $miniCode = $options['miniCode'] ?? '';
        $priceText = $options['priceText'] ?? '';
        $name = self::filterPosterUtf8Text($options['name'] ?? '');
        $mainId = (int)($options['mainId'] ?? 0);
        $flowerNum = (int)($options['flowerNum'] ?? 0);
        $subtitle = self::filterPosterUtf8Text($options['subtitle'] ?? '');
        $itemRemark = self::filterPosterUtf8Text($options['itemRemark'] ?? '');
        $shopTitle = self::filterPosterUtf8Text($options['shopTitle'] ?? '');
        $shopLogo = trim((string)($options['shopLogo'] ?? ''));

        $coverW = (int)($options['coverWidth'] ?? 0);
        $coverH = (int)($options['coverHeight'] ?? 0);
        if ($coverW <= 0 || $coverH <= 0) {
            list($coverW, $coverH) = imgUtil::getOssImageSize($cover, $prefix);
        }

        $layout = self::calcPosterLayout($coverW, $coverH, [
            'name' => $name,
            'flowerNum' => $flowerNum,
            'subtitle' => $subtitle,
            'itemRemark' => $itemRemark,
        ]);
        $displayName = self::buildPosterNameText($name, $flowerNum, $subtitle);
        $displayRemark = self::buildPosterRemarkText($itemRemark);
        $footer = self::calcFooterLayout();

        $coverWatermark = self::buildCoverWatermarkPath($cover, $layout['scaledH']);
        $qrWatermark = $miniCode . '?x-oss-process=image/resize,m_fill,h_' . self::QR_SIZE . ',w_' . self::QR_SIZE;

        $url = self::buildCanvasBaseUrl($prefix, $layout['totalH']);

        if ($shopLogo !== '') {
            $url .= '/watermark,image_' . stringUtil::ossBase64(self::buildShopLogoWatermarkPath($shopLogo))
                . ',g_nw,x_' . self::CANVAS_PAD_X . ',y_' . self::CANVAS_PAD_Y;
        }
        if ($shopTitle !== '') {
            $titleX = self::CANVAS_PAD_X + self::SHOP_LOGO_SIZE + self::SHOP_LOGO_GAP;
            $url .= '/watermark,text_' . stringUtil::ossBase64($shopTitle)
                . ',g_nw,x_' . $titleX . ',y_' . self::shopTitleY()
                . ',color_333333,type_' . self::FONT . ',size_' . self::SHOP_TITLE_SIZE;
        }

        $url .= '/watermark,image_' . stringUtil::ossBase64($coverWatermark)
            . ',g_nw,x_' . self::CANVAS_PAD_X . ',y_' . $layout['coverY'];

        if ($displayName !== '') {
            $url .= '/watermark,text_' . stringUtil::ossBase64($displayName)
                . ',g_nw,x_' . self::CANVAS_PAD_X . ',y_' . $layout['nameY']
                . ',color_333333,type_' . self::FONT . ',size_' . self::MID_NAME_SIZE;
        }
        if ($displayRemark !== '') {
            $url .= '/watermark,text_' . stringUtil::ossBase64($displayRemark)
                . ',g_nw,x_' . self::CANVAS_PAD_X . ',y_' . $layout['remarkY']
                . ',color_888888,type_' . self::FONT . ',size_' . self::MID_REMARK_SIZE;
        }

        $url .= '/watermark,image_' . stringUtil::ossBase64($qrWatermark)
            . ',g_se,x_' . self::QR_PAD_RIGHT . ',y_' . $footer['qrY'];

        $logoB64 = self::buildHyxhLogoWatermark($mainId);
        if ($logoB64 !== '') {
            $url .= '/watermark,image_' . $logoB64 . ',g_se,x_210,y_48';
        }

        $url .= '/watermark,image_' . stringUtil::ossBase64(self::buildBuyHintBarWatermarkPath($footer['buyHintBarW']))
            . ',g_sw,x_' . self::CANVAS_PAD_X . ',y_' . $footer['buyHintBarY'];
        $url .= '/watermark,text_' . stringUtil::ossBase64(self::FOOTER_BUY_HINT)
            . ',g_sw,x_' . $footer['buyHintTextX'] . ',y_' . $footer['buyHintTextY']
            . ',color_666666,type_' . self::FONT . ',size_' . self::FOOTER_BUY_HINT_SIZE;
        $url .= '/watermark,text_' . stringUtil::ossBase64($priceText)
            . ',g_sw,x_' . self::CANVAS_PAD_X . ',y_' . $footer['priceY']
            . ',color_EE2C2C,type_' . self::FONT . ',size_' . self::FOOTER_PRICE_SIZE;

        return $url;
    }
}