---

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.

Copyecho 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.

Copyecho 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.

Copyecho StatsFormatter::formatPer36Stat($points, $totalMinutes);  // "18.5"
echo StatsFormatter::formatPer36Stat($rebounds, $totalMinutes); // "8.3"

formatTotal($value)

Counting stats with comma separators.

Copyecho StatsFormatter::formatTotal($careerPoints);   // "12,345"
echo StatsFormatter::formatTotal($careerRebounds); // "5,678"

formatAverage($value)

General averages with 2 decimal places.

Copyecho StatsFormatter::formatAverage($playerRating); // "85.23"

calculatePoints($fgm, $ftm, $tgm)

Calculate point totals from shot makes.

Copy$points = StatsFormatter::calculatePoints($fgm, $ftm, $tgm);
// Formula: (2 * FGM) + FTM + TGM

safeDivide($numerator, $denominator)

Division with zero-division handling.

Copy$avg = StatsFormatter::safeDivide($total, $games); // Returns 0 if games=0

Usage Example

Copyuse 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:

Copyuse BasketballStats\StatsSanitizer;

$playerId = StatsSanitizer::sanitizeInt($_GET['pid']);
$rating = StatsSanitizer::sanitizeFloat($_POST['rating']);
$name = StatsSanitizer::sanitizeString($_POST['name']);

Examples

See examples/ for more patterns:

• percentage-formatting.php
• per-game-averages.php