huahuibao/common/components/deliverySlipPrintUtil.php

<?php

namespace common\components;

use biz\shop\classes\ShopClass;
use bizHd\order\classes\OrderGoodsClass;
use bizHd\order\classes\PsMethodClass;
use bizHd\order\services\OrderService;
use Yii;

/**
 * A4 鲜花配送单打印（链科云 HTML + PC 端 hiprint）
 */
class deliverySlipPrintUtil
{
    /**
     * 根据零售订单 ID 打印 A4 配送单（链科云）
     */
    public static function printByOrderId($orderId, $mainId = 0, array $printOptions = [])
    {
        $order = OrderService::getById($orderId);
        if (empty($order)) {
            throw new CloudPrinterApiException('订单不存在');
        }
        if ($mainId > 0) {
            OrderService::valid($order, $mainId);
        }

        $data = self::buildDataFromOrder($order);
        return self::printByData($data, $printOptions);
    }

    /**
     * 直接按模板数据打印（链科云）
     */
    public static function printByData(array $data, array $printOptions = [])
    {
        if (!cloudPrintUtil::isEnabled()) {
            throw new CloudPrinterApiException('链科云打印未启用，请先在 .env 配置 LIANKENET_*');
        }

        $paper = cloudPrintPaperSpec::resolve(array_merge([
            'scene' => cloudPrintPaperSpec::SCENE_DELIVERY_SLIP,
        ], $printOptions));
        $data['paper'] = $paper;

        $html = self::renderHtml($data);
        return (new cloudPrintUtil())->printHtml($html, $paper['dmPaperSize']);
    }

    /**
     * PC 本地 hiprint 打 A4：返回 printData + template（对齐 delivery-slip-a4 版式）
     * @param array $order 订单数组
     * @return array{printData:array,template:string}
     */
    public static function buildHiprintPayload(array $order)
    {
        return [
            'printData' => self::buildHiprintDataFromOrder($order),
            'template' => self::getHiprintTemplate(),
        ];
    }

    /**
     * 组装 hiprint 字段：封面用 URL（不做 data URI，避免本机打印慢）
     */
    public static function buildHiprintDataFromOrder(array $order)
    {
        $data = self::buildDataFromOrder($order, ['imageAsDataUri' => false]);
        $addressBlock = (string)($data['fullAddress'] ?? '');
        if (!empty($data['distanceText'])) {
            $addressBlock .= ' 配送距离: ' . $data['distanceText'];
        }
        $data['addressBlock'] = $addressBlock;
        // 配送时间后接「/配送方式：具体方式」，斜杠与冒号固定，便于与时间区分
        $reachTimeText = trim(($data['reachDateLabel'] ?? '') . ' ' . ($data['reachDateTime'] ?? ''));
        if (!empty($data['sendTypeName'])) {
            $reachTimeText = trim($reachTimeText) . ' / 配送方式:' . $data['sendTypeName'];
        }
        $data['reachTimeText'] = $reachTimeText;
        $data['productCountText'] = '共 ' . ($data['productCount'] ?? '1') . ' 个';
        $data['serviceTip'] = '';
        if (!empty($data['servicePhone'])) {
            $data['serviceTip'] = '如在制作，配送环节出现问题或疑问，欢迎随时致电: ' . $data['servicePhone'];
        }
        return $data;
    }

    /**
     * 读取 A4 配送单 hiprint JSON 模板字符串
     */
    public static function getHiprintTemplate()
    {
        $path = Yii::getAlias('@common/templates/delivery-slip-a4-hiprint.json');
        if (!is_file($path)) {
            throw new CloudPrinterApiException('配送单 hiprint 模板不存在');
        }
        $json = file_get_contents($path);
        if ($json === false || $json === '') {
            throw new CloudPrinterApiException('配送单 hiprint 模板读取失败');
        }
        return $json;
    }

    /**
     * 组装配送单展示数据
     * @param array $order 订单
     * @param array $options imageAsDataUri=true 时封面转 base64（云打印盒需离线图）
     */
    public static function buildDataFromOrder(array $order, array $options = [])
    {
        $shopId = intval($order['shopId'] ?? 0);
        $shop = ShopClass::getById($shopId, true);
        $shopName = '';
        if (!empty($shop)) {
            $merchantName = $shop->merchantName ?? '';
            $branchName = $shop->shopName ?? '';
            $shopName = ($branchName === '首店' || $branchName === '') ? $merchantName : trim($merchantName . ' ' . $branchName);
        }
        if ($shopName === '') {
            $shopName = '花掌柜';
        }

        $reachPeriodMap = [0 => '上午', 1 => '下午', 2 => '晚上'];
        $reachPeriod = $reachPeriodMap[intval($order['reachPeriod'] ?? 0)] ?? '';
        $reachDate = trim((string)($order['reachDate'] ?? ''));
        if ($reachDate === '' || $reachDate === '0000-00-00') {
            $reachDateLabel = '立即发单';
            $reachDateTime = date('m月d日 H:i');
        } else {
            $reachDateLabel = '预约配送';
            $reachDateTime = date('m月d日', strtotime($reachDate)) . ' ' . $reachPeriod;
        }

        $bookName = $order['bookName'] ?? '';
        $bookMobile = $order['bookMobile'] ?? '';
        if (intval($order['anonymity'] ?? 0) === 1) {
            $bookName = '--';
            $bookMobile = '--';
        }

        $fullAddress = trim((string)($order['fullAddress'] ?? ''));
        $showAddress = trim((string)($order['showAddress'] ?? ''));
        if ($showAddress !== '' && strpos($fullAddress, $showAddress) === false) {
            $fullAddress .= '（' . $showAddress . '）';
        }

        $productName = trim((string)($order['orderName'] ?? ''));
        $goodsNum = max(1, intval($order['goodsNum'] ?? 1));
        if ($productName === '') {
            $productName = '鲜花';
        }

        $cover = self::resolveOrderCover($order);
        $distanceText = '';
        $distance = intval($order['sendDistance'] ?? ($order['deliveryDistance'] ?? 0));
        if ($distance > 0) {
            $distanceText = $distance >= 1000
                ? ('直线 ' . round($distance / 1000, 1) . '公里')
                : ('直线 ' . $distance . '米');
        }

        $servicePhone = trim((string)getenv('LIANKENET_SERVICE_PHONE'));
        if ($servicePhone === '' && !empty($shop)) {
            $servicePhone = trim((string)($shop->telephone ?? ''));
        }

        $sendNum = (string)($order['sendNum'] ?? '');
        $batchDay = str_pad((string)date('j'), 2, '0', STR_PAD_LEFT);
        // 云打印默认转 data URI；本机 hiprint 传 URL 即可
        $imageAsDataUri = !isset($options['imageAsDataUri']) || $options['imageAsDataUri'];
        $productImage = $imageAsDataUri ? self::imageToDataUri($cover) : $cover;
        $sendTypeName = self::resolveSendTypeName($order);

        return [
            'title' => $shopName . ' 鲜花配送单',
            'batchNo' => '#O' . $batchDay . ' [#' . $sendNum . ']',
            'sendNum' => $sendNum,
            'receiveUserName' => $order['receiveUserName'] ?? '',
            'receiveMobile' => $order['receiveMobile'] ?? '',
            'fullAddress' => $fullAddress,
            'distanceText' => $distanceText,
            'reachDateLabel' => $reachDateLabel,
            'reachDateTime' => $reachDateTime,
            'sendTypeName' => $sendTypeName,
            'productName' => $productName,
            'productCount' => (string)$goodsNum,
            'productImage' => $productImage,
            'cardInfo' => $order['cardInfo'] ?? '',
            'bookName' => $bookName,
            'bookMobile' => $bookMobile,
            'orderSn' => $order['orderSn'] ?? '',
            'servicePhone' => $servicePhone,
        ];
    }

    /**
     * 解析配送方式展示名：优先门店 xhPsMethod 别名，否则与订单列表文案一致
     * @param array $order 订单
     * @return string
     */
    protected static function resolveSendTypeName(array $order)
    {
        $style = intval($order['sendType'] ?? -1);
        $defaults = [
            0 => '送货上门',
            1 => '到店自取',
            2 => '跑腿送货',
            3 => '发物流',
            4 => '发快递',
        ];
        if ($style < 0 || $style > 4) {
            return '';
        }
        $mainId = intval($order['mainId'] ?? 0);
        if ($mainId > 0) {
            $config = PsMethodClass::getByCondition(['mainId' => $mainId, 'style' => $style]);
            if (!empty($config['name'])) {
                return (string)$config['name'];
            }
        }
        return $defaults[$style];
    }

    /**
     * 渲染 A4 HTML
     */
    public static function renderHtml(array $data)
    {
        if (empty($data['paper'])) {
            $data['paper'] = cloudPrintPaperSpec::resolve([
                'scene' => cloudPrintPaperSpec::SCENE_DELIVERY_SLIP,
            ]);
        }
        $template = Yii::getAlias('@common/templates/delivery-slip-a4.php');
        if (!is_file($template)) {
            throw new CloudPrinterApiException('配送单模板不存在');
        }
        ob_start();
        include $template;
        return (string)ob_get_clean();
    }

    /**
     * 取订单商品封面图
     */
    protected static function resolveOrderCover(array $order)
    {
        $cover = trim((string)($order['cover'] ?? ''));
        if ($cover !== '') {
            return imgUtil::groupImg($cover) . '?x-oss-process=image/resize,m_fill,h_300,w_300';
        }

        $goodsList = OrderGoodsClass::getGoodsListById(intval($order['id'] ?? 0));
        if (!empty($goodsList)) {
            $first = $goodsList[0];
            $shortCover = $first['cover'] ?? '';
            if ($shortCover !== '') {
                return imgUtil::groupImg($shortCover) . '?x-oss-process=image/resize,m_fill,h_300,w_300';
            }
        }
        return '';
    }

    /**
     * 远程图片转 data URI，避免打印盒访问不了外网图
     */
    protected static function imageToDataUri($url)
    {
        $url = trim((string)$url);
        if ($url === '') {
            return '';
        }
        $binary = @file_get_contents($url);
        if ($binary === false || $binary === '') {
            return $url;
        }
        $mime = 'image/jpeg';
        if (function_exists('finfo_buffer')) {
            $finfo = finfo_open(FILEINFO_MIME_TYPE);
            if ($finfo) {
                $detected = finfo_buffer($finfo, $binary);
                if (!empty($detected)) {
                    $mime = $detected;
                }
                finfo_close($finfo);
            }
        }
        return 'data:' . $mime . ';base64,' . base64_encode($binary);
    }
}