PHP round(), floor() et ceil() : arrondir et calculer

round($x) arrondit à l'entier le plus proche, floor($x) arrondit toujours vers le bas et ceil($x) toujours vers le haut. Donnez à round() un second argument pour les décimales : round(3.14159, 2) vaut 3.14.

<?php
$price = 19.456;

echo round($price), "\n";     // nearest whole number
echo round($price, 2), "\n";  // 2 decimal places
echo floor($price), "\n";     // always down
echo ceil($price), "\n";      // always up

Les trois renvoient un float, même quand la valeur est entière. var_dump(round(5)) affiche float(5), faites donc un cast (int) quand il vous faut un entier.

Arrondir à 2 décimales

Le second argument de round() est la précision. Un nombre positif arrondit à ce nombre de décimales. Un nombre négatif arrondit à gauche de la virgule, ce qui est pratique pour des chiffres approximatifs comme « environ 1 200 visiteurs ».

<?php
$n = 1234.5678;

echo round($n, 2), "\n";   // 2 decimals
echo round($n, 1), "\n";   // 1 decimal
echo round($n, -1), "\n";  // nearest ten
echo round($n, -2), "\n";  // nearest hundred

echo round(2.5), " ", round(-2.5), "\n";  // halves go away from zero
echo round(3.10, 2), "\n";                // trailing zero is not kept

round(3.10, 2) affiche 3.1 car un float ne sait pas combien de zéros vous vouliez. Quand le nombre doit apparaître sur une page (prix, pourcentages), formatez-le plutôt : number_format() transforme 3.1 en "3.10" avec number_format(3.1, 2), et sprintf('%.2f', $x) fait la même chose.

Arrondir la moitié vers le haut, vers le bas ou au pair

Par défaut, round() arrondit une moitié en s'éloignant de zéro, l'arrondi au plus proche que la plupart des gens ont appris à l'école. Le troisième argument choisit une autre règle pour les valeurs exactement à mi-chemin entre deux nombres.

<?php
$values = [1.5, 2.5, -2.5];

foreach ($values as $v) {
    echo $v, ": ",
        round($v, 0, PHP_ROUND_HALF_UP), " up, ",
        round($v, 0, PHP_ROUND_HALF_DOWN), " down, ",
        round($v, 0, PHP_ROUND_HALF_EVEN), " even, ",
        round($v, 0, PHP_ROUND_HALF_ODD), " odd\n";
}

PHP_ROUND_HALF_EVEN est « l'arrondi du banquier » : les moitiés vont vers le nombre pair le plus proche, si bien qu'arrondir beaucoup de valeurs ne dérive pas vers le haut au fil du temps. Le code comptable en a souvent besoin.

floor et ceil avec des nombres négatifs

floor() va vers moins l'infini et ceil() vers plus l'infini. Avec des nombres négatifs, cela surprend : floor(-3.5) vaut -4, pas -3. Si vous voulez couper les décimales (troncature vers zéro), faites plutôt un cast en int.

<?php
foreach ([3.7, -3.7] as $x) {
    echo "x = $x\n";
    echo "  floor: ", floor($x), "\n";
    echo "  ceil:  ", ceil($x), "\n";
    echo "  (int): ", (int) $x, "\n";
}

// Pages needed for 23 items at 10 per page
echo ceil(23 / 10), " pages\n";

La ligne de pagination est l'usage classique de ceil() : un élément restant a quand même besoin d'une page.

Division entière et modulo

/ renvoie un float quand la division ne tombe pas juste, donc 7 / 2 vaut 3.5. Pour une division entière, utilisez intdiv(), qui supprime le reste, et % pour le reste lui-même.

<?php
$minutes = 135;

$hours = intdiv($minutes, 60);
$rest = $minutes % 60;
echo "$minutes minutes = {$hours}h {$rest}m\n";

echo 7 / 2, "\n";
echo intdiv(-7, 2), "\n";   // truncates toward zero
echo -7 % 3, "\n";          // sign of the left operand
echo fmod(7.5, 2), "\n";    // remainder for floats

// Even or odd
foreach ([4, 7] as $n) {
    echo $n, $n % 2 === 0 ? " is even\n" : " is odd\n";
}

% convertit d'abord les deux opérandes en entiers, donc 7.5 % 2 vaut 1, et depuis PHP 8.1 il affiche aussi Deprecated: Implicit conversion from float 7.5 to int loses precision. Utilisez fmod() quand les décimales comptent. Diviser par zéro avec /, intdiv() ou % lève une DivisionByZeroError en PHP 8, vérifiez donc le diviseur quand il vient d'une saisie.

Puissances, racines, abs, max et min

** élève à une puissance (pow() fait la même chose), sqrt() calcule une racine carrée et abs() supprime le signe. max() et min() prennent soit plusieurs arguments, soit un tableau.

<?php
echo 2 ** 10, "\n";       // 1024
echo 2 ** -1, "\n";       // 0.5
echo sqrt(144), "\n";     // 12
echo 27 ** (1 / 3), "\n"; // cube root
echo abs(-42), "\n";      // 42

$scores = [72, 95, 88, 61];
echo max($scores), " ", min($scores), "\n";
echo max(3, 9, 4), "\n";
echo array_sum($scores) / count($scores), "\n"; // average

// Clamp a value into the range 0 to 100
$volume = 140;
echo max(0, min(100, $volume)), "\n";

** est évalué de droite à gauche, donc 2 ** 3 ** 2 signifie 2 ** 9. La paire max(0, min(100, $x)) est la façon habituelle de borner une valeur entre une limite basse et une limite haute. M_PI contient pi si vous en avez besoin pour des cercles.

Nombres aléatoires avec random_int et rand

random_int($min, $max) renvoie un entier aléatoire, bornes incluses. Le résultat change à chaque exécution, cliquez donc plusieurs fois sur Run.

<?php
echo "Dice: ", random_int(1, 6), "\n";

// A 6-digit code, zero padded
printf("Code: %06d\n", random_int(0, 999999));

// Random element of an array
$colors = ['red', 'green', 'blue'];
echo "Color: ", $colors[array_rand($colors)], "\n";

// Random float between 0 and 1
echo "Float: ", random_int(0, PHP_INT_MAX) / PHP_INT_MAX, "\n";

Utilisez random_int() pour tout ce qui touche à la sécurité : codes de connexion, jetons, liens de réinitialisation de mot de passe. rand() et mt_rand() fonctionnent toujours et acceptent les mêmes arguments ($min, $max), mais leur séquence peut être prédite. Pour mélanger et tirer au sort avec une source sûre, PHP 8.2 a ajouté Random\Randomizer ($r->getInt(1, 6), $r->shuffleArray($a)).

Pourquoi floor() donne parfois une mauvaise réponse

Les floats sont stockés en binaire, et beaucoup de valeurs décimales (comme 0.1) ne peuvent pas être stockées exactement. La plupart du temps, l'affichage le cache, mais floor() et (int) n'arrondissent pas, ils coupent, et une valeur comme 7.999999999 devient 7.

<?php
$x = (0.1 + 0.7) * 10;

echo $x, "\n";            // looks like 8
var_dump($x);             // the real value
echo floor($x), "\n";     // 7, not 8
echo floor(round($x, 10)), "\n"; // round first, then floor

Quand vous avez besoin de décimales exactes, comme pour de l'argent, stockez des unités entières (des centimes en entiers : 1999 au lieu de 19.99) et ne divisez que pour l'affichage. Arrondir à une précision raisonnable avant floor() ou ceil(), comme sur la dernière ligne, règle aussi la plupart des cas.