basketball-stats
Basketball statistics formatting using BasketballStats\StatsFormatter for percentages, averages, and totals. Use when displaying stats, calculating averages, or formatting basketball numbers.
📖 中文导读:Basketball statistics formatting using BasketballStats\StatsFormatter for percentages, averages, and totals. Use when displaying stats, calculating averages, or formatting basketball numbers. 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。
name: basketball-stats description: Basketball statistics formatting using BasketballStats\StatsFormatter for percentages, averages, and totals. Use when displaying stats, calculating averages, or formatting basketball numbers.
Basketball Statistics Formatting
Use BasketballStats\StatsFormatter for ALL statistic formatting. Never use number_format() directly.
Available Methods
formatPercentage($made, $attempted)
Shooting percentages with 3 decimal places.
echo StatsFormatter::formatPercentage($fgm, $fga); // "0.523"
echo StatsFormatter::formatPercentage($ftm, $fta); // "0.875"
echo StatsFormatter::formatPercentage($tgm, $tga); // "0.412"
formatPerGameAverage($total, $games)
Per-game stats with 1 decimal place.
echo StatsFormatter::formatPerGameAverage($points, $gamesPlayed); // "25.3" PPG
echo StatsFormatter::formatPerGameAverage($assists, $gamesPlayed); // "7.2" APG
echo StatsFormatter::formatPerGameAverage($rebounds, $gamesPlayed); // "10.1" RPG
formatPer36Stat($total, $minutes)
Per-36-minute stats with 1 decimal place.
echo StatsFormatter::formatPer36Stat($points, $totalMinutes); // "18.5"
echo StatsFormatter::formatPer36Stat($rebounds, $totalMinutes); // "8.3"
formatTotal($value)
Counting stats with comma separators.
echo StatsFormatter::formatTotal($careerPoints); // "12,345"
echo StatsFormatter::formatTotal($careerRebounds); // "5,678"
formatAverage($value)
General averages with 2 decimal places.
echo StatsFormatter::formatAverage($playerRating); // "85.23"
calculatePoints($fgm, $ftm, $tgm)
Calculate point totals from shot makes.
$points = StatsFormatter::calculatePoints($fgm, $ftm, $tgm);
// Formula: (2 * FGM) + FTM + TGM
safeDivide($numerator, $denominator)
Division with zero-division handling.
$avg = StatsFormatter::safeDivide($total, $games); // Returns 0 if games=0
Usage Example
use BasketballStats\StatsFormatter;
// Player stat line
$fgPct = StatsFormatter::formatPercentage($player['fgm'], $player['fga']);
$ppg = StatsFormatter::formatPerGameAverage($player['pts'], $player['gp']);
$rpg = StatsFormatter::formatPerGameAverage($player['reb'], $player['gp']);
echo "FG%: $fgPct | PPG: $ppg | RPG: $rpg";
// Output: "FG%: 0.485 | PPG: 18.5 | RPG: 7.2"
Input Validation
Use BasketballStats\StatsSanitizer for input validation:
use BasketballStats\StatsSanitizer;
$playerId = StatsSanitizer::sanitizeInt($_GET['pid']);
$rating = StatsSanitizer::sanitizeFloat($_POST['rating']);
$name = StatsSanitizer::sanitizeString($_POST['name']);
Examples
See examples/ for more patterns: