huahuibao/app-mall/controllers/HomePageConfigController.php

<?php

namespace mall\controllers;

use bizHd\homePageConfig\classes\HomePageConfigClass;
use bizHd\homePageConfig\classes\HomePageDisplayClass;
use bizHd\homePageConfig\classes\HomePageModuleClass;
use common\components\util;
use mall\models\homePageConfig\GetSectionGoodsForm;

/**
 * 商城端首页配置读取接口
 * mallApp 通过 account(shopId) 获取配置，与 hd 管理端共用 Redis。
 * 具体的格式化/真实商品解析逻辑统一收敛在 HomePageDisplayClass，
 * 保证与 app-hd 的预览接口返回结构完全一致。
 */
class HomePageConfigController extends BaseController
{
    public $guestAccess = [
        'get-banner',
        'get-nav-grid',
        'get-seckill',
        'get-group-buy',
        'get-hot',
        'get-new',
        'get-pull-goods',
        'get-home',
        'get-section-goods',
    ];

    /**
     * 一次拉取首页全部模块配置，便于 mallApp 首页组装
     */
    public function actionGetHome()
    {
        util::success(HomePageDisplayClass::buildHome($this->requireMainId()));
    }

    public function actionGetBanner()
    {
        util::success(HomePageDisplayClass::formatBanner(HomePageConfigClass::getBanner($this->requireMainId())));
    }

    public function actionGetNavGrid()
    {
        util::success(HomePageDisplayClass::formatNavGrid(HomePageModuleClass::getNavGrid($this->requireMainId())));
    }

    public function actionGetSeckill()
    {
        util::success(HomePageDisplayClass::formatActivity(HomePageModuleClass::getSeckill($this->requireMainId(), true)));
    }

    public function actionGetGroupBuy()
    {
        util::success(HomePageDisplayClass::formatActivity(HomePageModuleClass::getGroupBuy($this->requireMainId(), true)));
    }

    public function actionGetHot()
    {
        util::success(HomePageDisplayClass::formatGoodsSection($this->requireMainId(), 'hot'));
    }

    public function actionGetNew()
    {
        util::success(HomePageDisplayClass::formatGoodsSection($this->requireMainId(), 'new'));
    }

    public function actionGetPullGoods()
    {
        util::success(HomePageDisplayClass::formatGoodsSection($this->requireMainId(), 'pullGoods'));
    }

    /**
     * 首页模块「更多」商品列表分页
     * moduleKey: seckill|groupBuy|hot|new|pullGoods
     */
    public function actionGetSectionGoods()
    {
        $form = new GetSectionGoodsForm();
        $form->loadAndValidate();
        util::success(HomePageDisplayClass::getSectionGoodsPage(
            $this->requireMainId(),
            $form->moduleKey,
            (int)$form->page,
            (int)$form->pageSize
        ));
    }

    private function requireMainId()
    {
        $mainId = intval($this->mainId);
        if ($mainId <= 0) {
            util::fail('无效门店');
        }
        return $mainId;
    }
}