'无链接', 'activity' => '跳转活动', 'external' => '外站链接', 'internal' => '站内相对路径']; /** * Resolve the submitted jump target. Omitting every link field keeps the saved one; old clients that * only send `link` get the type inferred from it (activity ID, `/path` or full URL). */ private static function clickBehavior(array $params, BannerModel $banner): array { $current = $banner->exists ? BannerVisibilityService::links($banner->getAttributes()) : ['click_type' => 'none', 'link' => null, 'link_pc' => null, 'link_h5' => null]; $input = array_intersect_key($params, array_flip(ContentLink::FIELDS)); if (!$input) return $current; if (array_key_exists('link', $input) && $input['link'] !== null) $input['link'] = trim((string) $input['link']); if (!array_key_exists('click_type', $input)) { $input['click_type'] = array_key_exists('link', $input) ? BannerVisibilityService::clickType(null, $input['link']) : $current['click_type']; } if ($input['click_type'] === 'activity') { $link = array_key_exists('link', $input) ? $input['link'] : ($current['click_type'] === 'activity' ? $current['link'] : null); $id = BannerVisibilityService::activityId($link); if ($id === null) throw ValidationException::withMessages(['link' => '请填写跳转活动ID']); return ['click_type' => 'activity', 'link' => $id, 'link_pc' => null, 'link_h5' => null]; } // An activity-type row has no reusable external/internal link, so forSave sees it as "none". return ContentLink::forSave($input, $current['click_type'] === 'activity' ? [] : $current); } /** * @api {get} /admin/banner/index 轮播图列表 * @apiGroup 轮播图管理 * @apiUse result * @apiUse header * @apiVersion 1.0.0 * * @apiParam {int} [page=1] * @apiParam {int} [limit=10] * */ function index() { try { $params = request()->validate([ 'page' => ['sometimes', 'integer', 'min:1'], 'limit' => ['sometimes', 'integer', 'min:1', 'max:200'], 'type' => ['nullable', 'in:pc,app'], 'platform' => ['nullable', 'in:pc,h5'], 'status' => ['nullable', 'integer', 'in:0,1'], 'lang' => ['nullable', 'string', 'max:10'], ]); $page = request()->input('page', 1); $limit = request()->input('limit', 15); $type = $params['type'] ?? ''; if (isset($params['platform']) && $params['platform'] !== '') { // The existing mobile banner enum is "app"; H5 filtering preserves that storage contract. $platformType = $params['platform'] === 'pc' ? 'pc' : 'app'; if ($type !== '' && $type !== $platformType) { throw ValidationException::withMessages(['platform' => '平台与原类型筛选不一致']); } $type = $platformType; } $query = BannerModel::query(); if ($type !== '') { $query->where('type', $type); } if (isset($params['lang']) && $params['lang'] !== '') { $query->where('lang', $params['lang']); } $query->orderByDesc('sort')->orderByDesc('id'); if (isset($params['status']) && $params['status'] !== '') { // Stored manual status is not the linked activity's actual status. Filter before pagination. $rows = BannerVisibilityService::decorate($query->get()); $rows = array_values(array_filter($rows, static fn ($row) => $row['status'] === (int) $params['status'])); $count = count($rows); $list = array_slice($rows, ((int) $page - 1) * (int) $limit, (int) $limit); } else { $count = $query->count(); $list = BannerVisibilityService::decorate($query->forPage($page, $limit)->get()); } } catch (ValidationException $e) { return $this->error(HttpStatus::VALIDATION_FAILED, $e->validator->errors()->first()); } catch (Exception $e) { return $this->error(HttpStatus::CUSTOM_ERROR, $e->getMessage()); } return $this->success(['total' => $count, 'data' => $list]); } /** * @api {post} /admin/banner/update 修改 * @apiDescription 更新或者新增都用这个接口 * @apiGroup 轮播图管理 * @apiUse result * @apiUse header * @apiVersion 1.0.0 * */ public function update() { DB::beginTransaction(); try { $params = request()->validate([ 'id' => ['nullable', 'integer', 'min:1'], 'title' => ['required'], 'image' => ['required'], 'click_type' => ['sometimes', 'string', 'in:' . implode(',', array_keys(self::CLICK_TYPES))], 'link' => ['nullable', function ($attribute, $value, $fail) { if ((!is_string($value) && !is_int($value)) || strlen((string) $value) > 2048) { $fail('跳转ID或链接格式错误'); } }], 'link_pc' => ['nullable', 'string', 'max:2048'], 'link_h5' => ['nullable', 'string', 'max:2048'], 'type' => ['required', 'in:pc,app'], 'sort' => ['nullable', 'integer'], 'lang' => ['required'], 'status' => ['sometimes', 'integer', 'in:0,1'], 'manual_status' => ['nullable', 'integer', 'in:0,1'], ], ['click_type.in' => '点击方式仅支持无链接、跳转活动、外站链接、站内相对路径']); $id = $params['id'] ?? null; $banner = $id === null ? new BannerModel() : BannerModel::where('id', $id)->lockForUpdate()->first(); if (!$banner) throw new Exception('数据不存在', HttpStatus::CUSTOM_ERROR); $links = self::clickBehavior($params, $banner); $activityId = BannerVisibilityService::boundActivityId($links['click_type'], $links['link']); $previousActivityId = BannerVisibilityService::boundActivityId($banner->click_type, $banner->link); if ($activityId !== null && (!$banner->exists || $activityId !== $previousActivityId)) { if (!DB::table('activity_rewards')->where('id', $activityId)->exists()) { throw ValidationException::withMessages(['link' => '绑定的活动不存在']); } } $manualStatus = $banner->status ?? 1; if ($activityId === null) { // Both the row button and the editor write status; a stale compatibility alias must not override it. $manualStatus = $params['status'] ?? $params['manual_status'] ?? $manualStatus; } $banner->fill([ 'title' => $params['title'], 'image' => Util::replacePartInUrl($params['image']), 'click_type' => $links['click_type'], 'link' => $links['link'], 'link_pc' => $links['link_pc'], 'link_h5' => $links['link_h5'], 'type' => $params['type'], 'sort' => array_key_exists('sort', $params) ? ($params['sort'] ?? 0) : ($banner->sort ?? 0), 'lang' => $params['lang'], 'status' => $manualStatus, ])->save(); DB::commit(); } catch (ValidationException $e) { DB::rollBack(); return $this->error(HttpStatus::VALIDATION_FAILED, $e->validator->errors()->first()); } catch (Exception $e) { DB::rollBack(); return $this->error(intval($e->getCode()), $e->getMessage()); } return $this->success(); } /** Change manual publication without resubmitting the banner form. */ public function status() { try { $params = request()->validate([ 'id' => ['required', 'integer', 'min:1'], 'status' => ['required_without:manual_status', 'integer', 'in:0,1'], 'manual_status' => ['required_without:status', 'integer', 'in:0,1'], ]); DB::transaction(function () use ($params) { $banner = BannerModel::where('id', $params['id'])->lockForUpdate()->first(); if (!$banner) throw new Exception('数据不存在', HttpStatus::CUSTOM_ERROR); if (BannerVisibilityService::boundActivityId($banner->click_type, $banner->link) !== null) { throw new Exception('关联活动的 Banner 由活动状态自动控制,不能手动上下架', HttpStatus::CUSTOM_ERROR); } $banner->status = $params['status'] ?? $params['manual_status']; $banner->save(); }); } catch (ValidationException $e) { return $this->error(HttpStatus::VALIDATION_FAILED, $e->validator->errors()->first()); } catch (Exception $e) { return $this->error(HttpStatus::CUSTOM_ERROR, $e->getMessage()); } return $this->success(); } /** * @api {post} /admin/banner/delete 删除 * @apiGroup 轮播图管理 * @apiUse result * @apiUse header * @apiVersion 1.0.0 * * @apiParam {int} id 要删除的ID * */ function delete() { DB::beginTransaction(); try { request()->validate([ 'id' => ['required', 'integer', 'min:1', 'max:99999999'], ]); $id = request()->input('id', 0); $info = BannerModel::where('id', $id)->first(); if (!$info) throw new Exception("数据不存在", HttpStatus::CUSTOM_ERROR); $info->delete(); DB::commit(); } catch (ValidationException $e) { DB::rollBack(); return $this->error(HttpStatus::VALIDATION_FAILED, $e->validator->errors()->first()); } catch (Exception $e) { DB::rollBack(); return $this->error(intval($e->getCode())); } return $this->success(); } }