huahuibao/common/components/PosterUtil.php

<?php

namespace common\components;

/**
 * 散客分享海报（OSS：poster/blank.png 动态画布 + 水印合成）
 */
class PosterUtil
{
    /** 与 poster/1234.jpg 同目录的 10×10 白底，经 m_pad 拉成本次海报画布 */
    const BLANK_CANVAS = 'poster/blank.png';

    const FONT = 'd3F5LW1pY3JvaGVp';

    const POSTER_W = 750;

    /** 画布左右、顶部留白（各 20px） */
    const CANVAS_PAD_X = 20;

    const CANVAS_PAD_Y = 20;

    /** 底部文案每行最多字数 */
    const NAME_CHARS_PER_LINE = 13;

    /** 商品图显示宽度 = POSTER_W - 2×CANVAS_PAD_X */
    const SLOT_W = 710;

    /** 底部价格/标题/太阳码固定区 */
    const FOOTER_H = 360;

    /** 主图区温和下限，避免扁图海报过矮 */
    const IMG_H_MIN = 240;

    const IMG_H_MAX = 880;

    const TOTAL_H_MAX = 1600;

    const CANVAS_COLOR = 'FFFFFF';

    const QR_SIZE = 220;

    const QR_PAD_RIGHT = 36;

    const QR_PAD_BOTTOM = 32;

    const QR_HINT_GAP = 14;

    const SCAN_HINT = '微信扫码下单';

    const FOOTER_STAFF_Y = 32;

    const FOOTER_TEXT_GAP = 12;

    const FOOTER_PRICE_SIZE = 56;

    const FOOTER_NAME_SIZE = 36;

    const FOOTER_STAFF_SIZE = 26;

    /**
     * 海报标题过长时截断，避免压住底部文案区
     */
    public static function truncateText($text, $maxLen = 14)
    {
        $text = trim((string)$text);
        if ($text === '') {
            return '';
        }
        if (mb_strlen($text, 'UTF-8') > $maxLen) {
            return mb_substr($text, 0, $maxLen, 'UTF-8') . '…';
        }
        return $text;
    }

    /**
     * 商品名拆成最多两行：首行 13 字；次行剩余，超过 13 字则省略
     *
     * @return array{0:string,1:string}
     */
    public static function splitPosterNameLines($name, $maxPerLine = self::NAME_CHARS_PER_LINE)
    {
        $name = trim((string)$name);
        if ($name === '') {
            return ['', ''];
        }
        $maxPerLine = (int)$maxPerLine;
        if ($maxPerLine < 1) {
            $maxPerLine = self::NAME_CHARS_PER_LINE;
        }
        $len = mb_strlen($name, 'UTF-8');
        if ($len <= $maxPerLine) {
            return [$name, ''];
        }
        $line1 = mb_substr($name, 0, $maxPerLine, 'UTF-8');
        $rest = mb_substr($name, $maxPerLine, null, 'UTF-8');
        $restLen = mb_strlen($rest, 'UTF-8');
        if ($restLen <= $maxPerLine) {
            return [$line1, $rest];
        }
        $line2 = mb_substr($rest, 0, $maxPerLine, 'UTF-8') . '…';

        return [$line1, $line2];
    }

    /**
     * 商品名水印文案（支持 \\n 两行），支数/副标题尽量接在末行
     */
    public static function buildPosterNameText($name, $flowerNum = 0, $subtitle = '')
    {
        list($line1, $line2) = self::splitPosterNameLines($name);
        $suffix = '';
        if ($flowerNum > 0) {
            $suffix = ' · ' . (int)$flowerNum . '支';
        } elseif (trim((string)$subtitle) !== '') {
            $suffix = ' · ' . trim((string)$subtitle);
        }
        if ($suffix !== '') {
            $target = $line2 !== '' ? 'line2' : 'line1';
            if ($target === 'line1') {
                $merged = $line1 . $suffix;
                if (mb_strlen($merged, 'UTF-8') <= self::NAME_CHARS_PER_LINE) {
                    $line1 = $merged;
                } else {
                    $line2 = self::truncateText($suffix, self::NAME_CHARS_PER_LINE);
                }
            } else {
                $merged = $line2 . $suffix;
                if (mb_strlen($merged, 'UTF-8') <= self::NAME_CHARS_PER_LINE) {
                    $line2 = $merged;
                } else {
                    $line2 = self::truncateText($merged, self::NAME_CHARS_PER_LINE);
                }
            }
        }
        if ($line2 === '') {
            return $line1;
        }

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

    /**
     * 底部文案 y（g_sw，自下而上：推荐语 → 价格 → 商品名）
     */
    private static function footerTextYPositions($nameLineCount)
    {
        $staffY = self::FOOTER_STAFF_Y;
        $staffH = (int)ceil(self::FOOTER_STAFF_SIZE * 1.3);
        $priceY = $staffY + $staffH + self::FOOTER_TEXT_GAP;
        $priceH = (int)ceil(self::FOOTER_PRICE_SIZE * 1.1);
        $nameLineCount = max(1, min(2, (int)$nameLineCount));
        $nameLineH = (int)ceil(self::FOOTER_NAME_SIZE * 1.15);
        $nameY = $priceY + $priceH + self::FOOTER_TEXT_GAP + ($nameLineCount - 1) * $nameLineH;

        return [
            'staff' => $staffY,
            'price' => $priceY,
            'name' => $nameY,
        ];
    }

    /**
     * 按商品图比例计算主图区高度与画布总高（能多矮就多矮，仅保留温和下限）
     *
     * @return array{imgH:int,totalH:int,scaledH:int,posterW:int}
     */
    public static function calcPosterLayout($coverWidth, $coverHeight)
    {
        $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;
        }

        $totalH = $imgH + self::FOOTER_H;
        $absoluteMin = self::FOOTER_H + 120;
        $totalH = max($absoluteMin, min(self::TOTAL_H_MAX, $totalH));

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

    /**
     * 商品图：常规按宽 SLOT_W 等比（无左右垫白）；超高图用 m_fill 裁高至 IMG_H_MAX
     */
    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';
    }

    /**
     * 太阳码水平中心 X（用于扫码文案 g_south 居中）
     */
    private static function qrCenterX()
    {
        return self::POSTER_W - self::QR_PAD_RIGHT - (int)(self::QR_SIZE / 2);
    }

    /**
     * 扫码提示文案：位于太阳码正上方居中（g_south = 文字下边中点对齐）
     */
    private static function scanHintYFromBottom()
    {
        return self::QR_PAD_BOTTOM + self::QR_SIZE + self::QR_HINT_GAP;
    }

    /**
     * 动态白底画布（blank.png → 750 × totalH）
     */
    public static function buildCanvasBaseUrl($prefix, $totalH)
    {
        $absoluteMin = self::FOOTER_H + 120;
        $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);
    }

    /**
     * 花农端花店采购海报（ghs 花材详情太阳码）
     */
    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 = $options['name'] ?? '';
        $staffText = $options['staffText'] ?? '';
        $mainId = (int)($options['mainId'] ?? 0);
        $flowerNum = (int)($options['flowerNum'] ?? 0);
        $subtitle = trim((string)($options['subtitle'] ?? ''));
        $scanHint = trim((string)($options['scanHint'] ?? self::SCAN_HINT));
        if ($scanHint === '微信扫码采购') {
            $scanHint = self::SCAN_HINT;
        }

        $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);
        $imgH = $layout['imgH'];
        $totalH = $layout['totalH'];

        $displayName = self::buildPosterNameText($name, $flowerNum, $subtitle);
        $nameLineCount = ($displayName !== '' && strpos($displayName, "\n") !== false) ? 2 : 1;
        $footerY = self::footerTextYPositions($nameLineCount);

        $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, $totalH);
        $url .= '/watermark,image_' . stringUtil::ossBase64($coverWatermark)
            . ',g_nw,x_' . self::CANVAS_PAD_X . ',y_' . self::CANVAS_PAD_Y;
        $url .= '/watermark,image_' . stringUtil::ossBase64($qrWatermark) . ',g_se,x_' . self::QR_PAD_RIGHT . ',y_' . self::QR_PAD_BOTTOM;

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

        $url .= '/watermark,text_' . stringUtil::ossBase64($staffText)
            . ',g_sw,x_' . self::CANVAS_PAD_X . ',y_' . $footerY['staff']
            . ',color_999999,type_' . self::FONT . ',size_' . self::FOOTER_STAFF_SIZE;
        $url .= '/watermark,text_' . stringUtil::ossBase64($priceText)
            . ',g_sw,x_' . self::CANVAS_PAD_X . ',y_' . $footerY['price']
            . ',color_EE2C2C,type_' . self::FONT . ',size_' . self::FOOTER_PRICE_SIZE;
        $url .= '/watermark,text_' . stringUtil::ossBase64($displayName)
            . ',g_sw,x_' . self::CANVAS_PAD_X . ',y_' . $footerY['name']
            . ',color_333333,type_' . self::FONT . ',size_' . self::FOOTER_NAME_SIZE;
        $url .= '/watermark,text_' . stringUtil::ossBase64($scanHint)
            . ',g_south,x_' . self::qrCenterX() . ',y_' . self::scanHintYFromBottom()
            . ',color_888888,type_' . self::FONT . ',size_24';

        return $url;
    }
}