PHP round(), floor() и ceil(): округление и математика

round($x) округляет до ближайшего целого, floor($x) всегда округляет вниз, а ceil($x) всегда вверх. Передайте round() второй аргумент, чтобы задать число знаков после запятой: round(3.14159, 2) даёт 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

Все три возвращают float, даже если значение целое. var_dump(round(5)) печатает float(5), поэтому, когда нужно целое число, приводите через (int).

Округление до 2 знаков после запятой

Второй аргумент round() это точность. Положительное число округляет до стольких знаков после запятой. Отрицательное округляет слева от десятичной точки, что удобно для приблизительных цифр вроде "около 1 200 посетителей".

<?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) выводит 3.1, потому что float понятия не имеет, сколько нулей вы хотели. Когда число выводится на страницу (цены, проценты), форматируйте его: number_format() превращает 3.1 в "3.10" через number_format(3.1, 2), и sprintf('%.2f', $x) делает то же самое.

Половина вверх, вниз или к чётному

По умолчанию round() округляет половину от нуля, это то самое округление, которое большинство учило в школе. Третий аргумент выбирает другое правило для значений, которые ровно посередине между двумя числами.

<?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 это "банковское округление": половины идут к ближайшему чётному числу, поэтому при округлении множества значений сумма со временем не уползает вверх. В бухгалтерском коде часто нужно именно оно.

floor и ceil с отрицательными числами

floor() движется к минус бесконечности, а ceil() к плюс бесконечности. С отрицательными числами это удивляет: floor(-3.5) даёт -4, а не -3. Если нужно просто отбросить дробную часть (в сторону нуля), приводите к 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";

Строка с пагинацией это классическое применение ceil(): любому оставшемуся элементу всё равно нужна страница.

Целочисленное деление и остаток

/ возвращает float, когда деление не нацело, поэтому 7 / 2 даёт 3.5. Для деления нацело используйте intdiv(), которая отбрасывает остаток, а для самого остатка %.

<?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";
}

% сначала приводит оба операнда к целым, поэтому 7.5 % 2 даёт 1, а начиная с PHP 8.1 ещё и печатает Deprecated: Implicit conversion from float 7.5 to int loses precision. Если важна дробная часть, используйте fmod(). Деление на ноль через /, intdiv() или % в PHP 8 выбрасывает DivisionByZeroError, поэтому проверяйте делитель, если он приходит из ввода.

Степени, корни, abs, max и min

** возводит в степень (pow() делает то же), sqrt() извлекает квадратный корень, а abs() убирает знак. max() и min() принимают либо несколько аргументов, либо один массив.

<?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";

** вычисляется справа налево, поэтому 2 ** 3 ** 2 означает 2 ** 9. Пара max(0, min(100, $x)) это обычный способ зажать значение между нижней и верхней границей. В M_PI хранится число пи, если оно нужно для окружностей.

Случайные числа через random_int и rand

random_int($min, $max) возвращает случайное целое, включая оба конца. Вывод меняется при каждом запуске, так что нажмите 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";

Используйте random_int() для всего, что связано с безопасностью: коды входа, токены, ссылки для сброса пароля. rand() и mt_rand() по-прежнему работают и принимают те же аргументы ($min, $max), но их последовательность можно предсказать. Для перемешивания и выбора со стойким источником в PHP 8.2 появился Random\Randomizer ($r->getInt(1, 6), $r->shuffleArray($a)).

Почему floor() иногда даёт неверный ответ

Float хранятся в двоичном виде, и многие десятичные значения (например, 0.1) нельзя сохранить точно. Обычно вывод это скрывает, но floor() и (int) не округляют, а отсекают, и значение вроде 7.999999999 становится 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

Когда нужны точные десятичные значения, как с деньгами, храните целые единицы (центы целыми числами: 1999 вместо 19.99) и делите только при выводе. Округление до разумной точности перед floor() или ceil(), как в последней строке, тоже исправляет большинство случаев.