php项目统计界外球进攻威胁次数？

wen PHP项目 2026-08-14 4

本文目录导读：

php项目统计界外球进攻威胁次数？

第一步：数据库结构设计
第二步：PHP核心计算逻辑
第三步：进阶——基于“进攻延续性”的判定
第四步：API接口设计（Laravel/TypiCode 风格）
第五步：前端可视化建议（补充）
数据采集建议（重中之重）

在足球数据分析中，"界外球进攻威胁次数"通常指通过掷界外球形成的、能直接或间接创造射门机会（或进入危险区域）的进攻回合。

由于PHP通常用于后端数据处理和API接口，而非实时图像识别，这个统计主要依赖于前端采集的数据入库后，由PHP进行逻辑聚合和计算。

以下是完整的实现方案，包含数据库设计、PHP逻辑计算和前端展示建议。

第一步：数据库结构设计

首先需要一个表来记录每一次“界外球事件”的详细特征。

-- 事件明细表（核心表）
CREATE TABLE `throw_in_events` (
  `id` bigint(20) unsigned NOT NULL AUTO_INCREMENT,
  `match_id` int(11) NOT NULL COMMENT '比赛ID',
  `team_id` int(11) NOT NULL COMMENT '进攻方球队ID',
  `period` tinyint(4) DEFAULT NULL COMMENT '半场（1/2）',
  `minute` tinyint(4) DEFAULT NULL COMMENT '发生分钟',
  `throw_position_x` decimal(5,2) DEFAULT NULL COMMENT '掷球点X坐标（标准化0-100）',
  `throw_position_y` decimal(5,2) DEFAULT NULL COMMENT '掷球点Y坐标',
  `destination_zone` varchar(20) DEFAULT NULL COMMENT '落点区域（如：禁区、肋部）',
  `is_deep` tinyint(1) DEFAULT 0 COMMENT '是否前场界外球（对方半场）',
  `result_type` enum('shot','assist','key_pass','retention','foul_won','loss') DEFAULT NULL COMMENT '结果类型',
  `is_threat` tinyint(1) DEFAULT 0 COMMENT '是否判定为威胁（由PHP计算/人工标注）',
  PRIMARY KEY (`id`),
  KEY `idx_match_team` (`match_id`,`team_id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

第二步：PHP核心计算逻辑

场景1：基于规则自动判定（简单版） 如果已经记录了大量事件，可以通过PHP写一个规则引擎来自动标记 is_threat。

<?php
class ThrowInThreatAnalyzer
{
    // 判定该界外球是否构成“进攻威胁”
    public static function isThreat(array $event): bool
    {
        // 规则1：前场界外球（对方半场30米区域）优先
        if ($event['throw_position_x'] >= 70 && $event['is_deep'] == 1) {
            return true;
        }
        // 规则2：若后续结果直接导致射门或关键传球
        if (in_array($event['result_type'], ['shot', 'assist', 'key_pass'])) {
            return true;
        }
        // 规则3：落点在禁区内或禁区前沿（视为高威胁）
        $dangerZones = ['penalty_area', 'edge_of_box'];
        if (in_array($event['destination_zone'], $dangerZones)) {
            return true;
        }
        return false;
    }
    // 批量统计某场比赛的威胁次数
    public static function countThreats(int $matchId, PDO $pdo): array
    {
        // 1. 查询该场比赛所有界外球事件
        $sql = "SELECT * FROM throw_in_events WHERE match_id = :mid";
        $stmt = $pdo->prepare($sql);
        $stmt->execute([':mid' => $matchId]);
        $events = $stmt->fetchAll(PDO::FETCH_ASSOC);
        $teamStats = [];
        foreach ($events as $event) {
            $isThreat = self::isThreat($event);
            $teamId = $event['team_id'];
            // 初始化数组
            if (!isset($teamStats[$teamId])) {
                $teamStats[$teamId] = [
                    'total_throw_ins' => 0,
                    'threat_throw_ins' => 0,
                    'threat_rate' => 0.0
                ];
            }
            $teamStats[$teamId]['total_throw_ins']++;
            if ($isThreat) {
                $teamStats[$teamId]['threat_throw_ins']++;
                // 视情况更新数据库中的标记（此处省略UPDATE，或批量更新）
            }
        }
        // 计算威胁率
        foreach ($teamStats as &$team) {
            $team['threat_rate'] = $team['total_throw_ins'] > 0 
                ? round($team['threat_throw_ins'] / $team['total_throw_ins'] * 100, 2) 
                : 0;
        }
        return $teamStats;
    }
}

第三步：进阶——基于“进攻延续性”的判定

更专业的统计会看这次界外球进攻是否持续了X秒且最终形成射门，这需要记录进攻序列ID。

// 进阶：将界外球视为一次进攻发起点，关联后续结果
public function countSequencedThreat(int $matchId, \PDO $pdo): array
{
    $sql = "
        SELECT 
            t.team_id,
            COUNT(DISTINCT t.id) as total_throw_ins,
            COUNT(DISTINCT CASE WHEN s.shot_id IS NOT NULL THEN t.id END) as threat_throw_ins
        FROM throw_in_events t
        LEFT JOIN (
            -- 假设有一个表记录了界外球后的进攻序列结果
            SELECT throw_in_id, shot_id FROM attack_sequences WHERE shot_id IS NOT NULL
        ) s ON s.throw_in_id = t.id
        WHERE t.match_id = :mid
        GROUP BY t.team_id
    ";
    $stmt = $pdo->prepare($sql);
    $stmt->execute([':mid' => $matchId]);
    return $stmt->fetchAll(\PDO::FETCH_ASSOC);
}

第四步：API接口设计（Laravel/TypiCode 风格）

// routes/api.php
Route::get('/matches/{matchId}/throw-in-threats', [ThrowInController::class, 'threats']);
// app/Http/Controllers/ThrowInController.php
public function threats($matchId) {
    $stats = ThrowInThreatAnalyzer::countThreats($matchId, DB::connection()->getPdo());
    return response()->json([
        'match_id' => $matchId,
        'stats' => array_values($stats), // 按球队分组
        'generated_at' => now()
    ]);
}