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.

php

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.

php

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.

php

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

formatTotal($value)

Counting stats with comma separators.

php

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

formatAverage($value)

General averages with 2 decimal places.

php

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

calculatePoints($fgm, $ftm, $tgm)

Calculate point totals from shot makes.

php

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

safeDivide($numerator, $denominator)

Division with zero-division handling.

php

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

Usage Example

php

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:

php

use BasketballStats\StatsSanitizer;

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

Examples

See examples/ for more patterns: