PHP: полный мануал с примерами, функциями и ООП

PHP 4+ · standard

abs(int|float $num): int|float

Изменение остатка может быть отрицательным; abs даёт величину изменения без направления.

Перед первым опытом: запись abs(...) вызывает функцию; в круглых скобках передаются значения через запятую, возвращённое значение можно сохранить через =. echo печатает, var_dump показывает ещё и тип, "\n" переносит строку. Параметр, вызов и возврат; Как читать числовые типы и результаты.

Числа float хранят двоичное приближение. Входной int разрешён и для параметра float. Массив и неподходящая строка не являются числом: возможен TypeError; правила нестрогого преобразования строк и режима strict_types разобраны в главе о типах. Данные формы сначала проверяют, а не исправляют математической функцией.

Обозначения последующих шагов: условие ? A : B выбирает результат A при истине, иначе B. Условия и обход списка.

<?php
$change = 13 - 18;
echo abs($change), "\n";
var_dump(abs(-2.5));

5
float(2.5)

<?php
$expected = 20.0;
$actual = 20.03;
echo abs($actual - $expected) <= 0.05 ? "within tolerance\n" : "inspect\n";
var_dump(is_float(abs(PHP_INT_MIN)));

within tolerance
bool(true)

Когда подходит и где остановиться. Модуль пригоден для расстояния между двумя скалярными измерениями. Для двух координат используйте hypot. abs не устраняет накопленную погрешность и не заменяет проверку is_finite.

Сравните: hypot, is_finite. Выбор по задаче.

• PHP: abs

PHP 4+ · standard

ceil(int|float $num): float

Чтобы разместить все товары, неполную коробку тоже нужно учесть. ceil округляет вверх.

Перед первым опытом: запись ceil(...) вызывает функцию; в круглых скобках передаются значения через запятую, возвращённое значение можно сохранить через =. echo печатает, var_dump показывает ещё и тип, "\n" переносит строку. Параметр, вызов и возврат; Как читать числовые типы и результаты.

Числа float хранят двоичное приближение. Входной int разрешён и для параметра float. Массив и неподходящая строка не являются числом: возможен TypeError; правила нестрогого преобразования строк и режима strict_types разобраны в главе о типах. Данные формы сначала проверяют, а не исправляют математической функцией.

В примерах printf("%.3f\n", $value) печатает число с тремя знаками после точки; это формат вывода, само значение в памяти не становится точным десятичным числом. if выбирает ветку, function объявляет повторяемое действие, return возвращает его результат: начальные объяснения.

Обозначения последующих шагов: function name($value) { ... } объявляет действие; имя в круглых скобках — локальный параметр; return завершает вызов и отдаёт результат. Условия и обход списка.

<?php
var_dump(ceil(2.2));
var_dump(ceil(-2.2));

float(3)
float(-2)

<?php
function boxesNeeded($pieces, $capacity) {
    return (int) ceil($pieces / $capacity);
}
echo boxesNeeded(25, 12), "\n";
echo boxesNeeded(24, 12), "\n";

3
2

Когда подходит и где остановиться. Деление на ноль нужно отклонять до вызова. Десятичное произведение вроде суммы × 100 может оказаться чуть ниже ожидаемого целого; floor тогда честно выберет предыдущее. Для точных денег используйте целые минимальные единицы либо десятичную арифметику. Для целых количеств рассмотрите intdiv и остаток.

Сравните: floor, round, intdiv. Выбор по задаче.

• PHP: ceil

PHP 4+ · standard

floor(int|float $num): float

Чтобы узнать число полностью заполненных ёмкостей, floor округляет вниз.

Перед первым опытом: запись floor(...) вызывает функцию; в круглых скобках передаются значения через запятую, возвращённое значение можно сохранить через =. echo печатает, var_dump показывает ещё и тип, "\n" переносит строку. Параметр, вызов и возврат; Как читать числовые типы и результаты.

Числа float хранят двоичное приближение. Входной int разрешён и для параметра float. Массив и неподходящая строка не являются числом: возможен TypeError; правила нестрогого преобразования строк и режима strict_types разобраны в главе о типах. Данные формы сначала проверяют, а не исправляют математической функцией.

В примерах printf("%.3f\n", $value) печатает число с тремя знаками после точки; это формат вывода, само значение в памяти не становится точным десятичным числом. if выбирает ветку, function объявляет повторяемое действие, return возвращает его результат: начальные объяснения.

Обозначения последующих шагов: function name($value) { ... } объявляет действие; имя в круглых скобках — локальный параметр; return завершает вызов и отдаёт результат. Условия и обход списка.

<?php
var_dump(floor(2.8));
var_dump(floor(-2.2));

float(2)
float(-3)

<?php
function fullSegments($meters, $segmentMeters) {
    return (int) floor($meters / $segmentMeters);
}
echo fullSegments(7.5, 2.0), "\n";
echo fullSegments(8.0, 2.0), "\n";

3
4

Когда подходит и где остановиться. Деление на ноль нужно отклонять до вызова. Десятичное произведение вроде суммы × 100 может оказаться чуть ниже ожидаемого целого; floor тогда честно выберет предыдущее. Для точных денег используйте целые минимальные единицы либо десятичную арифметику. Для целых количеств рассмотрите intdiv и остаток.

Сравните: ceil, round, intdiv. Выбор по задаче.

• PHP: floor

PHP 8+ · standard

fdiv(float $num1, float $num2): float

В численной обработке можно сохранить бесконечный или неопределённый результат деления, а затем явно выбрать, что показать пользователю.

Перед первым опытом: запись fdiv(...) вызывает функцию; в круглых скобках передаются значения через запятую, возвращённое значение можно сохранить через =. echo печатает, var_dump показывает ещё и тип, "\n" переносит строку. Параметр, вызов и возврат; Как читать числовые типы и результаты.

Числа float хранят двоичное приближение. Входной int разрешён и для параметра float. Массив и неподходящая строка не являются числом: возможен TypeError; правила нестрогого преобразования строк и режима strict_types разобраны в главе о типах. Данные формы сначала проверяют, а не исправляют математической функцией.

В примерах printf("%.3f\n", $value) печатает число с тремя знаками после точки; это формат вывода, само значение в памяти не становится точным десятичным числом. if выбирает ветку, function объявляет повторяемое действие, return возвращает его результат: начальные объяснения.

Обозначения последующих шагов: function name($value) { ... } объявляет действие; имя в круглых скобках — локальный параметр; return завершает вызов и отдаёт результат; if (условие) { ... } выполняет блок только при истинном условии; ! отрицает, && требует оба условия, || — хотя бы одно. Условия и обход списка.

<?php
var_dump(fdiv(12, 4));
var_dump(fdiv(1, 0), fdiv(-1, 0), fdiv(0, 0));

float(3)
float(INF)
float(-INF)
float(NAN)

<?php
function rateLabel($processed, $seconds) {
    $rate = fdiv($processed, $seconds);
    if (!is_finite($rate)) { return 'unavailable'; }
    return number_format($rate, 1, '.', '') . ' rows/s';
}
echo rateLabel(12, 4), "\n";
echo rateLabel(12, 0), "\n";

3.0 rows/s
unavailable

Когда подходит и где остановиться. Это выбор политики вычисления, а не универсальное исправление деления на ноль. Оператор / на нуле бросает ошибку в PHP 8. JSON не представляет INF/NAN; определите состояние отсутствующих данных перед сериализацией.

Сравните: intdiv, fmod, is_finite. Выбор по задаче.

• PHP: fdiv

PHP 4.2+ · standard

fmod(float $num1, float $num2): float

Получите оставшуюся часть дробной величины: например, остаток длины после нарезки равных кусков.

Перед первым опытом: запись fmod(...) вызывает функцию; в круглых скобках передаются значения через запятую, возвращённое значение можно сохранить через =. echo печатает, var_dump показывает ещё и тип, "\n" переносит строку. Параметр, вызов и возврат; Как читать числовые типы и результаты.

Числа float хранят двоичное приближение. Входной int разрешён и для параметра float. Массив и неподходящая строка не являются числом: возможен TypeError; правила нестрогого преобразования строк и режима strict_types разобраны в главе о типах. Данные формы сначала проверяют, а не исправляют математической функцией.

Обозначения последующих шагов: function name($value) { ... } объявляет действие; имя в круглых скобках — локальный параметр; return завершает вызов и отдаёт результат; условие ? A : B выбирает результат A при истине, иначе B. Условия и обход списка.

<?php
echo fmod(7.5, 2), "\n";
echo fmod(-7.5, 2), "\n";
var_dump(is_nan(fmod(7.5, 0)));

1.5
-1.5
bool(true)

<?php
function normalizedAngle($degrees) {
    $remainder = fmod($degrees, 360.0);
    return $remainder < 0 ? $remainder + 360.0 : $remainder;
}
echo normalizedAngle(-22.5), "\n";
echo normalizedAngle(742.5), "\n";

337.5
22.5

Когда подходит и где остановиться. fmod(2.0, 0.1) может выглядеть как 0.1: в памяти 0.1 является приближением. Поэтому «остаток равен нулю» не доказывает десятичную кратность; для шага в копейках используйте целые единицы. Масштабный допуск для измерений должен вытекать из задачи.

Сравните: intdiv, fdiv, floor. Выбор по задаче.

• PHP: fmod

PHP 4+ · standard

max(mixed $value, mixed ...$values): mixed; max(array $value_array): mixed

Выберите наибольшее время обработки из отчёта без сортировки всего списка.

Перед первым опытом: запись max(...) вызывает функцию; в круглых скобках передаются значения через запятую, возвращённое значение можно сохранить через =. echo печатает, var_dump показывает ещё и тип, "\n" переносит строку. Параметр, вызов и возврат; Как читать числовые типы и результаты.

Используются обычные min / правила сравнения PHP, а не специальное числовое преобразование всех значений. В PHP 8 число при сравнении с нечисловой строкой превращается в строку; до PHP 8 нечисловая строка превращалась в число. Bool/null и массивы имеют свои правила — приводите данные отчёта к одному смысловому типу.

В опытах с отказом try выполняет попытку, catch ловит указанный тип ошибки; как работает обработка исключений.

<?php
echo max(180, 240, 210), "\n";
echo max([180, 240, 210]), "\n";

240
240

<?php
try { max([]); }
catch (ValueError $error) { echo "no measurements\n"; }
var_dump(max([0, false]));
var_dump(max([false, 0]));

no measurements
int(0)
bool(false)

Когда подходит и где остановиться. Сравнение массивов не ищет максимум по колонке: сначала выделите нужные числа. Если нужно вернуть заказ с максимальной суммой, сохраняйте вместе число и запись при обходе. Для массивов PHP сперва учитывает размер, затем пары ключ/значение; для bool действует логическое преобразование. NAN не следует использовать в наборе кандидатов. Сортировка всего массива ради одного экстремума обычно делает ненужную работу, точное время измеряют на своём объёме.

Сравните: min, is_finite, clamp. Выбор по задаче.

• PHP: max

PHP 4+ · standard

min(mixed $value, mixed ...$values): mixed; min(array $value_array): mixed

Выберите наименьшее время обработки из отчёта без сортировки всего списка.

Перед первым опытом: запись min(...) вызывает функцию; в круглых скобках передаются значения через запятую, возвращённое значение можно сохранить через =. echo печатает, var_dump показывает ещё и тип, "\n" переносит строку. Параметр, вызов и возврат; Как читать числовые типы и результаты.

Используются обычные max / правила сравнения PHP, а не специальное числовое преобразование всех значений. В PHP 8 число при сравнении с нечисловой строкой превращается в строку; до PHP 8 нечисловая строка превращалась в число. Bool/null и массивы имеют свои правила — приводите данные отчёта к одному смысловому типу.

В опытах с отказом try выполняет попытку, catch ловит указанный тип ошибки; как работает обработка исключений.

<?php
echo min(180, 240, 210), "\n";
echo min([180, 240, 210]), "\n";

180
180

<?php
try { min([]); }
catch (ValueError $error) { echo "no measurements\n"; }
var_dump(min([0, false]));
var_dump(min([false, 0]));

no measurements
int(0)
bool(false)

Когда подходит и где остановиться. Сравнение массивов не ищет максимум по колонке: сначала выделите нужные числа. Если нужно вернуть заказ с максимальной суммой, сохраняйте вместе число и запись при обходе. Для массивов PHP сперва учитывает размер, затем пары ключ/значение; для bool действует логическое преобразование. NAN не следует использовать в наборе кандидатов. Сортировка всего массива ради одного экстремума обычно делает ненужную работу, точное время измеряют на своём объёме. Граница переносимости: на проверенном PHP 8.5.11 прямой вызов min(0, false) возвращает false, а min([0, false]) и вызов через распаковку списка возвращают 0. Не используйте неоднородные равные значения как способ стабильно выбрать тип результата; это расхождение с общей формулировкой документации воспроизведено отдельно.

Сравните: max, is_finite, clamp. Выбор по задаче.

• PHP: min

PHP 8.6+; встроенная функция отсутствует в проверочном PHP 8.5.11 · standard

clamp(mixed $value, mixed $min, mixed $max): mixed

Ограничьте величину допустимым диапазоном: яркость ниже 0 станет 0, выше 100 станет 100.

Перед первым опытом: запись clamp(...) вызывает функцию; в круглых скобках передаются значения через запятую, возвращённое значение можно сохранить через =. echo печатает, var_dump показывает ещё и тип, "\n" переносит строку. Параметр, вызов и возврат; Как читать числовые типы и результаты.

Ниже два фрагмента для PHP 8.6, они не запускались на PHP 8.5.11. Затем — два проверяемых числовых решения для PHP 8.2+. Не определяем собственную глобальную функцию clamp: после обновления она конфликтовала бы со встроенной.

В опытах с отказом try выполняет попытку, catch ловит указанный тип ошибки; как работает обработка исключений.

Обозначения последующих шагов: function name($value) { ... } объявляет действие; имя в круглых скобках — локальный параметр; return завершает вызов и отдаёт результат; if (условие) { ... } выполняет блок только при истинном условии; ! отрицает, && требует оба условия, || — хотя бы одно. Условия и обход списка.

<?php
echo clamp(-12, 0, 100), "\n";
echo clamp(42, 0, 100), "\n";
echo clamp(115, 0, 100), "\n";

0
42
100

<?php
try { clamp(4, 10, 2); }
catch (ValueError $error) { echo "reversed bounds\n"; }
try { clamp(4, NAN, 10); }
catch (ValueError $error) { echo "invalid bound\n"; }
var_dump(is_nan(clamp(NAN, 0, 10)));

reversed bounds
invalid bound
bool(true)

<?php
$brightness = -12;
echo max(0, min(100, $brightness)), "\n";
$brightness = 115;
echo max(0, min(100, $brightness)), "\n";

0
100

<?php
function boundedNumber($value, $lower, $upper) {
    if (!is_finite($value) || !is_finite($lower) || !is_finite($upper) || $lower > $upper) {
        throw new InvalidArgumentException('invalid range');
    }
    return max($lower, min($upper, $value));
}
echo boundedNumber(42, 0, 100), "\n";
try { boundedNumber(4, 10, 2); }
catch (InvalidArgumentException $error) { echo "invalid range\n"; }

42
invalid range

Когда подходит и где остановиться. Не маскируйте ошибку заказа автоматическим уменьшением количества: иногда нужно сообщить «нет такого остатка». Ограничение подходит настройке интерфейса или численной модели, если эта политика согласована. Для нескольких типов нет обещания числового порядка.

Сравните: min, max, is_finite. Выбор по задаче.

• PHP: clamp

PHP 4.2+ · standard

is_finite(float $num): bool

Перед сохранением измерения убедитесь, что оно не NAN и не бесконечность.

Перед первым опытом: запись is_finite(...) вызывает функцию; в круглых скобках передаются значения через запятую, возвращённое значение можно сохранить через =. echo печатает, var_dump показывает ещё и тип, "\n" переносит строку. Параметр, вызов и возврат; Как читать числовые типы и результаты.

Числа float хранят двоичное приближение. Входной int разрешён и для параметра float. Массив и неподходящая строка не являются числом: возможен TypeError; правила нестрогого преобразования строк и режима strict_types разобраны в главе о типах. Данные формы сначала проверяют, а не исправляют математической функцией.

Обозначения последующих шагов: foreach ($list as $value) последовательно берёт элементы списка; [a, b] создаёт список; if (условие) { ... } выполняет блок только при истинном условии; ! отрицает, && требует оба условия, || — хотя бы одно. Условия и обход списка.

<?php
var_dump(is_finite(12.5), is_finite(INF), is_finite(-INF), is_finite(NAN));

bool(true)
bool(false)
bool(false)
bool(false)

<?php
$readings = [12.5, INF, NAN, 13.0];
$accepted = [];
foreach ($readings as $reading) {
    if (is_finite($reading)) { $accepted[] = $reading; }
}
echo count($accepted), " valid readings\n";

2 valid readings

Когда подходит и где остановиться. is_nan не является отрицанием is_numeric; is_infinite не ловит NAN; is_finite не проверяет положительность или единицы измерения. Сначала подтвердите тип, затем конечность, затем допустимый диапазон. Для NAN не пользуйтесь == или ===.

Сравните: is_infinite, is_nan. Выбор по задаче.

• PHP: is_finite

PHP 4.2+ · standard

is_infinite(float $num): bool

Отдельно распознайте переполнение расчёта или бесконечность от деления.

Перед первым опытом: запись is_infinite(...) вызывает функцию; в круглых скобках передаются значения через запятую, возвращённое значение можно сохранить через =. echo печатает, var_dump показывает ещё и тип, "\n" переносит строку. Параметр, вызов и возврат; Как читать числовые типы и результаты.

Числа float хранят двоичное приближение. Входной int разрешён и для параметра float. Массив и неподходящая строка не являются числом: возможен TypeError; правила нестрогого преобразования строк и режима strict_types разобраны в главе о типах. Данные формы сначала проверяют, а не исправляют математической функцией.

Обозначения последующих шагов: условие ? A : B выбирает результат A при истине, иначе B. Условия и обход списка.

<?php
var_dump(is_infinite(12.5), is_infinite(INF), is_infinite(-INF), is_infinite(NAN));

bool(false)
bool(true)
bool(true)
bool(false)

<?php
$result = exp(1000);
echo is_infinite($result) ? "range exceeded\n" : "ok\n";
echo is_infinite(sqrt(-4)) ? "infinite\n" : "not infinite\n";

range exceeded
not infinite

Когда подходит и где остановиться. is_nan не является отрицанием is_numeric; is_infinite не ловит NAN; is_finite не проверяет положительность или единицы измерения. Сначала подтвердите тип, затем конечность, затем допустимый диапазон. Для NAN не пользуйтесь == или ===.

Сравните: is_finite, is_nan. Выбор по задаче.

• PHP: is_infinite

PHP 4.2+ · standard

is_nan(float $num): bool

Отличите неопределённый численный результат от обычного измерения и бесконечности.

Перед первым опытом: запись is_nan(...) вызывает функцию; в круглых скобках передаются значения через запятую, возвращённое значение можно сохранить через =. echo печатает, var_dump показывает ещё и тип, "\n" переносит строку. Параметр, вызов и возврат; Как читать числовые типы и результаты.

Числа float хранят двоичное приближение. Входной int разрешён и для параметра float. Массив и неподходящая строка не являются числом: возможен TypeError; правила нестрогого преобразования строк и режима strict_types разобраны в главе о типах. Данные формы сначала проверяют, а не исправляют математической функцией.

<?php
var_dump(is_nan(12.5), is_nan(INF), is_nan(-INF), is_nan(NAN));

bool(false)
bool(false)
bool(false)
bool(true)

<?php
$result = sqrt(-4);
var_dump($result === NAN);
var_dump(is_nan($result));
var_dump(is_float($result));

bool(false)
bool(true)
bool(true)

Когда подходит и где остановиться. is_nan не является отрицанием is_numeric; is_infinite не ловит NAN; is_finite не проверяет положительность или единицы измерения. Сначала подтвердите тип, затем конечность, затем допустимый диапазон. Для NAN не пользуйтесь == или ===.

Сравните: is_finite, is_infinite. Выбор по задаче.

• PHP: is_nan

PHP 4+ · standard

sqrt(float $num): float

Из площади квадратной плитки получите сторону: корень отвечает, какое число в квадрате даст исходное.

Перед первым опытом: запись sqrt(...) вызывает функцию; в круглых скобках передаются значения через запятую, возвращённое значение можно сохранить через =. echo печатает, var_dump показывает ещё и тип, "\n" переносит строку. Параметр, вызов и возврат; Как читать числовые типы и результаты.

Числа float хранят двоичное приближение. Входной int разрешён и для параметра float. Массив и неподходящая строка не являются числом: возможен TypeError; правила нестрогого преобразования строк и режима strict_types разобраны в главе о типах. Данные формы сначала проверяют, а не исправляют математической функцией.

В примерах printf("%.3f\n", $value) печатает число с тремя знаками после точки; это формат вывода, само значение в памяти не становится точным десятичным числом. if выбирает ветку, function объявляет повторяемое действие, return возвращает его результат: начальные объяснения.

Обозначения последующих шагов: function name($value) { ... } объявляет действие; имя в круглых скобках — локальный параметр; return завершает вызов и отдаёт результат; if (условие) { ... } выполняет блок только при истинном условии; ! отрицает, && требует оба условия, || — хотя бы одно. Условия и обход списка.

<?php
var_dump(sqrt(81));
var_dump(sqrt(0));

float(9)
float(0)

<?php
function squareSide($area) {
    if (!is_finite($area) || $area < 0) { return null; }
    return sqrt($area);
}
var_dump(squareSide(144));
var_dump(squareSide(-4));
var_dump(is_nan(sqrt(-4)));

float(12)
NULL
bool(true)

Когда подходит и где остановиться. sqrt не считает комплексные числа. Для расстояния по двум координатам hypot яснее и избегает некоторых промежуточных переполнений от x*x + y*y. float не подходит для проверки, является ли огромное целое идеальным квадратом, без отдельного точного алгоритма.

Сравните: hypot, pow, is_nan. Выбор по задаче.

• PHP: sqrt

PHP 4+ · standard

pow(mixed $num, mixed $exponent): int|float|object

Посчитайте число вариантов из независимых позиций: четыре состояния в трёх позициях дают 4³ = 64.

Перед первым опытом: запись pow(...) вызывает функцию; в круглых скобках передаются значения через запятую, возвращённое значение можно сохранить через =. echo печатает, var_dump показывает ещё и тип, "\n" переносит строку. Параметр, вызов и возврат; Как читать числовые типы и результаты.

Оператор ** — альтернативная запись той же степени. ^ в PHP означает побитовое XOR, а не степень. Объявленный mixed отражает перегрузку и преобразования, но не обещает осмысленный результат для любого объекта.

Обозначения последующих шагов: function name($value) { ... } объявляет действие; имя в круглых скобках — локальный параметр; return завершает вызов и отдаёт результат. Условия и обход списка.

<?php
var_dump(pow(4, 3));
var_dump(pow(4, -1));
echo 4 ** 3, "\n";

int(64)
float(0.25)
64

<?php
function scaledArea($area, $scale) {
    return $area * pow($scale, 2);
}
echo scaledArea(12, 3), "\n";
var_dump(is_nan(pow(-4, 0.5)));
var_dump(pow(0, 0));

108
bool(true)
int(1)

Когда подходит и где остановиться. Не переводите большие идентификаторы в float ради степени. Для произвольной точности выбирают BCMath/GMP по требуемому типу данных. Сигнатура object не означает автоматическую перегрузку для любого пользовательского класса.

Сравните: fpow, sqrt, exp. Выбор по задаче.

• PHP: pow

PHP 8.4+ · standard

fpow(float $num, float $exponent): float

Когда численная модель должна возвращать INF/NAN без предупреждения о нуле в отрицательной степени, используйте fpow.

Перед первым опытом: запись fpow(...) вызывает функцию; в круглых скобках передаются значения через запятую, возвращённое значение можно сохранить через =. echo печатает, var_dump показывает ещё и тип, "\n" переносит строку. Параметр, вызов и возврат; Как читать числовые типы и результаты.

Числа float хранят двоичное приближение. Входной int разрешён и для параметра float. Массив и неподходящая строка не являются числом: возможен TypeError; правила нестрогого преобразования строк и режима strict_types разобраны в главе о типах. Данные формы сначала проверяют, а не исправляют математической функцией.

Обозначения последующих шагов: function name($value) { ... } объявляет действие; имя в круглых скобках — локальный параметр; return завершает вызов и отдаёт результат; условие ? A : B выбирает результат A при истине, иначе B. Условия и обход списка.

<?php
var_dump(fpow(4, -1));
var_dump(fpow(0, -2));
var_dump(is_nan(fpow(-4, 0.5)));

float(0.25)
float(INF)
bool(true)

<?php
function reciprocalSquare($distance) {
    $factor = fpow($distance, -2);
    return is_finite($factor) ? $factor : null;
}
var_dump(reciprocalSquare(2));
var_dump(reciprocalSquare(0));

float(0.25)
NULL

Когда подходит и где остановиться. Функции нет в PHP 8.2/8.3. Если бесконечности нежелательны, проверка нуля перед обычной степенью бывает яснее. fpow не делает арифметику более точной десятично.

Сравните: pow, fdiv, is_finite. Выбор по задаче.

• PHP: fpow

PHP 4+ · standard

exp(float $num): float

В расчёте плавного затухания нужен коэффициент e в степени: exp превращает время модели в положительный множитель.

Перед первым опытом: запись exp(...) вызывает функцию; в круглых скобках передаются значения через запятую, возвращённое значение можно сохранить через =. echo печатает, var_dump показывает ещё и тип, "\n" переносит строку. Параметр, вызов и возврат; Как читать числовые типы и результаты.

Для exp(0) множитель равен 1. При отрицательном показателе значение между 0 и 1 удобно для затухания; формулу и коэффициент выбирают из модели, функция их не придумывает.

В примерах printf("%.3f\n", $value) печатает число с тремя знаками после точки; это формат вывода, само значение в памяти не становится точным десятичным числом. if выбирает ветку, function объявляет повторяемое действие, return возвращает его результат: начальные объяснения.

Обозначения последующих шагов: function name($value) { ... } объявляет действие; имя в круглых скобках — локальный параметр; return завершает вызов и отдаёт результат. Условия и обход списка.

<?php
var_dump(exp(0));
printf("%.3f\n", exp(1));

float(1)
2.718

<?php
function eventWeight($age, $timeScale) {
    return exp(-$age / $timeScale);
}
printf("%.3f\n", eventWeight(0, 10));
printf("%.3f\n", eventWeight(10, 10));
var_dump(is_infinite(exp(1000)));

1.000
0.368
bool(true)

Когда подходит и где остановиться. Проверяйте единицы возраста и масштаба: минуты и секунды нельзя смешать. Если требуется exp(x) − 1 при малом x, используйте expm1, чтобы не вычитать почти равные числа.

Сравните: expm1, log, pow. Выбор по задаче.

• PHP: exp

PHP 4.1+ · standard

expm1(float $num): float

Для очень малого изменения вычислите eˣ − 1, сохранив малую разницу, которую обычное вычитание может потерять.

Перед первым опытом: запись expm1(...) вызывает функцию; в круглых скобках передаются значения через запятую, возвращённое значение можно сохранить через =. echo печатает, var_dump показывает ещё и тип, "\n" переносит строку. Параметр, вызов и возврат; Как читать числовые типы и результаты.

Проблема не в записи минуса: exp(x) может уже округлиться до ровно 1. Тогда вычитание 1 потеряет полезный сигнал. expm1 рассчитывает разность другим численным способом.

В примерах printf("%.3f\n", $value) печатает число с тремя знаками после точки; это формат вывода, само значение в памяти не становится точным десятичным числом. if выбирает ветку, function объявляет повторяемое действие, return возвращает его результат: начальные объяснения.

<?php
$change = 1e-16;
var_dump(exp($change) - 1 === 0.0);
var_dump(expm1($change) > 0.0);

bool(true)
bool(true)

<?php
$continuousChange = 0.02;
$relativeChange = expm1($continuousChange);
printf("%.6f\n", $relativeChange);
printf("%.6f\n", log1p($relativeChange));

0.020201
0.020000

Когда подходит и где остановиться. Не заменяйте все exp подряд: если нужен сам множитель, exp яснее. Преимущество expm1 относится к точности малого изменения, а не обещанию большей скорости.

Сравните: exp, log1p. Выбор по задаче.

• PHP: expm1

PHP 4+ · standard

log(float $num, float $base = M_E): float

Узнайте, в какую степень нужно возвести основание, чтобы получить число: log(32, 2) даёт 5.

Перед первым опытом: запись log(...) вызывает функцию; в круглых скобках передаются значения через запятую, возвращённое значение можно сохранить через =. echo печатает, var_dump показывает ещё и тип, "\n" переносит строку. Параметр, вызов и возврат; Как читать числовые типы и результаты.

В примерах printf("%.3f\n", $value) печатает число с тремя знаками после точки; это формат вывода, само значение в памяти не становится точным десятичным числом. if выбирает ветку, function объявляет повторяемое действие, return возвращает его результат: начальные объяснения. В опытах с отказом try выполняет попытку, catch ловит указанный тип ошибки; как работает обработка исключений.

<?php
echo log(32, 2), "\n";
printf("%.3f\n", log(M_E));

5
1.000

<?php
var_dump(log(0));
var_dump(is_nan(log(-2)));
try { log(8, 0); }
catch (ValueError $error) { echo "invalid base\n"; }
var_dump(is_nan(log(8, 1)));

float(-INF)
bool(true)
invalid base
bool(true)

Когда подходит и где остановиться. log не имеет отношения к файлу журнала — это error_log или собственный logger. Для log(1+x) с очень малым x нужен log1p. Численный логарифм не следует применять к огромному строковому ID ради определения его точной длины.

Сравните: log10, log1p, exp. Выбор по задаче.

• PHP: log

PHP 4+ · standard

log10(float $num): float

Покажите величины разных порядков на логарифмической шкале: 10, 100 и 1000 превращаются в 1, 2 и 3.

Перед первым опытом: запись log10(...) вызывает функцию; в круглых скобках передаются значения через запятую, возвращённое значение можно сохранить через =. echo печатает, var_dump показывает ещё и тип, "\n" переносит строку. Параметр, вызов и возврат; Как читать числовые типы и результаты.

В примерах printf("%.3f\n", $value) печатает число с тремя знаками после точки; это формат вывода, само значение в памяти не становится точным десятичным числом. if выбирает ветку, function объявляет повторяемое действие, return возвращает его результат: начальные объяснения.

Обозначения последующих шагов: function name($value) { ... } объявляет действие; имя в круглых скобках — локальный параметр; return завершает вызов и отдаёт результат; if (условие) { ... } выполняет блок только при истинном условии; ! отрицает, && требует оба условия, || — хотя бы одно. Условия и обход списка.

<?php
echo log10(1000), "\n";
echo log10(0.01), "\n";

3
-2

<?php
function chartPosition($value) {
    if (!is_finite($value) || $value <= 0) { return null; }
    return log10($value);
}
var_dump(chartPosition(100));
var_dump(chartPosition(0));

float(2)
NULL

Когда подходит и где остановиться. Равные интервалы на такой шкале означают одинаковое отношение, не одинаковую разность. Подписывайте шкалу пользователю. Для числа цифр огромной целочисленной строки надёжнее работа со строкой, а не floor(log10()).

Сравните: log, pow, is_finite. Выбор по задаче.

• PHP: log10

PHP 4.1+ · standard

log1p(float $num): float

Вычислите ln(1+x) для малой доли x, не теряя её при предварительном сложении с единицей.

Перед первым опытом: запись log1p(...) вызывает функцию; в круглых скобках передаются значения через запятую, возвращённое значение можно сохранить через =. echo печатает, var_dump показывает ещё и тип, "\n" переносит строку. Параметр, вызов и возврат; Как читать числовые типы и результаты.

В примерах printf("%.3f\n", $value) печатает число с тремя знаками после точки; это формат вывода, само значение в памяти не становится точным десятичным числом. if выбирает ветку, function объявляет повторяемое действие, return возвращает его результат: начальные объяснения.

<?php
$delta = 1e-16;
var_dump(log(1 + $delta) === 0.0);
var_dump(log1p($delta) > 0.0);

bool(true)
bool(true)

<?php
$stepChange = 0.01;
$steps = 10;
$totalChange = expm1($steps * log1p($stepChange));
printf("%.6f\n", $totalChange);
var_dump(log1p(-1));
var_dump(is_nan(log1p(-2)));

0.104622
float(-INF)
bool(true)

Когда подходит и где остановиться. Не нужно вручную складывать 1+x перед вызовом. Для обычного log(x) используйте log, а log1p выбирайте именно по структуре формулы.

Сравните: log, expm1. Выбор по задаче.

• PHP: log1p

PHP 4.1+ · standard

hypot(float $x, float $y): float

На плане склада найдите расстояние по двум смещениям: 3 м по горизонтали и 4 м по вертикали дают 5 м по прямой.

Перед первым опытом: запись hypot(...) вызывает функцию; в круглых скобках передаются значения через запятую, возвращённое значение можно сохранить через =. echo печатает, var_dump показывает ещё и тип, "\n" переносит строку. Параметр, вызов и возврат; Как читать числовые типы и результаты.

<?php
var_dump(hypot(3, 4));
var_dump(hypot(-3, 4));

float(5)
float(5)

<?php
$start = ['x' => 10, 'y' => 20];
$finish = ['x' => 16, 'y' => 28];
echo hypot($finish['x'] - $start['x'], $finish['y'] - $start['y']), "\n";
var_dump(is_finite(hypot(1e200, 1e200)));
var_dump(is_infinite(sqrt(1e200 * 1e200 + 1e200 * 1e200)));

10
bool(true)
bool(true)

Когда подходит и где остановиться. Широта и долгота в градусах — не координаты плоского плана в метрах; для Земли нужны соответствующие формулы и система координат. Не обещайте ускорение относительно sqrt без измерения.

Сравните: sqrt, atan2, is_finite. Выбор по задаче.

• PHP: hypot

PHP 4+ · standard

pi(): float

Для длины окружности используйте встроенное приближение π, не запоминая сокращённое 3.14.

Перед первым опытом: запись pi(...) вызывает функцию; в круглых скобках передаются значения через запятую, возвращённое значение можно сохранить через =. echo печатает, var_dump показывает ещё и тип, "\n" переносит строку. Параметр, вызов и возврат; Как читать числовые типы и результаты.

В примерах printf("%.3f\n", $value) печатает число с тремя знаками после точки; это формат вывода, само значение в памяти не становится точным десятичным числом. if выбирает ветку, function объявляет повторяемое действие, return возвращает его результат: начальные объяснения.

Обозначения последующих шагов: function name($value) { ... } объявляет действие; имя в круглых скобках — локальный параметр; return завершает вызов и отдаёт результат. Условия и обход списка.

<?php
$radius = 10;
printf("%.3f\n", 2 * pi() * $radius);
var_dump(pi() === M_PI);

62.832
bool(true)

<?php
function circleArea($radius) {
    return pi() * $radius * $radius;
}
printf("%.3f\n", circleArea(2));
printf("%.3f\n", circleArea(4));

12.566
50.265

Когда подходит и где остановиться. Для угла в радианах используйте deg2rad/rad2deg, чтобы не перепутать коэффициент π/180. Лишние десятичные цифры в самописной константе не расширяют точность float.

Сравните: deg2rad, rad2deg, pow. Выбор по задаче.

• PHP: pi

PHP 4+ · standard

sin(float $num): float

Для точки на чертеже вычислите вертикальную проекцию единичного радиуса через синус.

Перед первым опытом: запись sin(...) вызывает функцию; в круглых скобках передаются значения через запятую, возвращённое значение можно сохранить через =. echo печатает, var_dump показывает ещё и тип, "\n" переносит строку. Параметр, вызов и возврат; Как читать числовые типы и результаты.

Вызов получает уже переведённый угол. Радиан — мера угла: длина дуги единичной окружности. Для градусов из интерфейса сначала вызовите deg2rad.

В примерах printf("%.3f\n", $value) печатает число с тремя знаками после точки; это формат вывода, само значение в памяти не становится точным десятичным числом. if выбирает ветку, function объявляет повторяемое действие, return возвращает его результат: начальные объяснения.

<?php
printf("%.3f\n", sin(0));

0.000

<?php
$radius = 10;
$angle = deg2rad(30);
printf("%.3f\n", $radius * sin($angle));

5.000

Когда подходит и где остановиться. Из-за округления sin(π) или cos(π/2) может быть очень малым ненулевым числом. Для геометрического совпадения нужен масштабный допуск. Для очень больших углов теряется информация младших разрядов. Не передавайте 90, подразумевая градусы.

Сравните: asin, cos, deg2rad. Выбор по задаче.

• PHP: sin

PHP 4+ · standard

cos(float $num): float

Для точки на чертеже вычислите горизонтальную проекцию единичного радиуса через косинус.

Перед первым опытом: запись cos(...) вызывает функцию; в круглых скобках передаются значения через запятую, возвращённое значение можно сохранить через =. echo печатает, var_dump показывает ещё и тип, "\n" переносит строку. Параметр, вызов и возврат; Как читать числовые типы и результаты.

Вызов получает уже переведённый угол. Радиан — мера угла: длина дуги единичной окружности. Для градусов из интерфейса сначала вызовите deg2rad.

В примерах printf("%.3f\n", $value) печатает число с тремя знаками после точки; это формат вывода, само значение в памяти не становится точным десятичным числом. if выбирает ветку, function объявляет повторяемое действие, return возвращает его результат: начальные объяснения.

<?php
printf("%.3f\n", cos(0));

1.000

<?php
$radius = 10;
$angle = deg2rad(60);
printf("%.3f\n", $radius * cos($angle));

5.000

Когда подходит и где остановиться. Из-за округления sin(π) или cos(π/2) может быть очень малым ненулевым числом. Для геометрического совпадения нужен масштабный допуск. Для очень больших углов теряется информация младших разрядов. Не передавайте 90, подразумевая градусы.

Сравните: acos, sin, deg2rad. Выбор по задаче.

• PHP: cos

PHP 4+ · standard

tan(float $num): float

Для точки на чертеже вычислите отношение вертикального смещения к горизонтальному через тангенс.

Перед первым опытом: запись tan(...) вызывает функцию; в круглых скобках передаются значения через запятую, возвращённое значение можно сохранить через =. echo печатает, var_dump показывает ещё и тип, "\n" переносит строку. Параметр, вызов и возврат; Как читать числовые типы и результаты.

Вызов получает уже переведённый угол. Радиан — мера угла: длина дуги единичной окружности. Для градусов из интерфейса сначала вызовите deg2rad.

В примерах printf("%.3f\n", $value) печатает число с тремя знаками после точки; это формат вывода, само значение в памяти не становится точным десятичным числом. if выбирает ветку, function объявляет повторяемое действие, return возвращает его результат: начальные объяснения.

<?php
printf("%.3f\n", tan(0));

0.000

<?php
$horizontal = 10;
$slopeAngle = deg2rad(30);
printf("%.3f\n", $horizontal * tan($slopeAngle));

5.774

Когда подходит и где остановиться. Возле π/2 + kπ тангенс неустойчив: приближение pi()/2 может дать очень большое конечное число вместо математической бесконечности. Не проверяйте вертикальность через точное равенство cos угла нулю; задайте допустимый диапазон входных углов. Не передавайте 90, подразумевая градусы.

Сравните: atan, atan2, deg2rad. Выбор по задаче.

• PHP: tan

PHP 4+ · standard

asin(float $num): float

Восстановите угол по синусу: подъём 5 при длине 10 даёт угол для чертежа.

Перед первым опытом: запись asin(...) вызывает функцию; в круглых скобках передаются значения через запятую, возвращённое значение можно сохранить через =. echo печатает, var_dump показывает ещё и тип, "\n" переносит строку. Параметр, вызов и возврат; Как читать числовые типы и результаты.

«Обратная» означает восстановление одного выбранного угла, а не 1/sin(x). Периодичность не позволяет восстановить все обороты из одного отношения. Прямая функция после обратной восстанавливает допустимый вход лишь с точностью float.

В примерах printf("%.3f\n", $value) печатает число с тремя знаками после точки; это формат вывода, само значение в памяти не становится точным десятичным числом. if выбирает ветку, function объявляет повторяемое действие, return возвращает его результат: начальные объяснения.

<?php
printf("%.3f\n", asin(0));

0.000

<?php
$rise = 5;
$length = 10;
printf("%.1f\n", rad2deg(asin($rise / $length)));

30.0

<?php
var_dump(is_nan(asin(1.1)));

bool(true)

Когда подходит и где остановиться. При малом выходе за [−1,1] из-за вычислительной погрешности иногда допустимо ограничить значение, но только после проверки масштаба ошибки. Для ошибочного отношения 1.1 это скроет проблему.

Сравните: sin, acos, atan. Выбор по задаче.

• PHP: asin

PHP 4+ · standard

acos(float $num): float

Восстановите угол по косинусу: горизонтальная проекция 5 при длине 10 даёт угол для чертежа.

Перед первым опытом: запись acos(...) вызывает функцию; в круглых скобках передаются значения через запятую, возвращённое значение можно сохранить через =. echo печатает, var_dump показывает ещё и тип, "\n" переносит строку. Параметр, вызов и возврат; Как читать числовые типы и результаты.

«Обратная» означает восстановление одного выбранного угла, а не 1/cos(x). Периодичность не позволяет восстановить все обороты из одного отношения. Прямая функция после обратной восстанавливает допустимый вход лишь с точностью float.

В примерах printf("%.3f\n", $value) печатает число с тремя знаками после точки; это формат вывода, само значение в памяти не становится точным десятичным числом. if выбирает ветку, function объявляет повторяемое действие, return возвращает его результат: начальные объяснения.

<?php
printf("%.3f\n", acos(1));

0.000

<?php
$projection = 5;
$length = 10;
printf("%.1f\n", rad2deg(acos($projection / $length)));

60.0

<?php
var_dump(is_nan(acos(1.1)));

bool(true)

Когда подходит и где остановиться. При малом выходе за [−1,1] из-за вычислительной погрешности иногда допустимо ограничить значение, но только после проверки масштаба ошибки. Для ошибочного отношения 1.1 это скроет проблему.

Сравните: cos, asin, atan. Выбор по задаче.

• PHP: acos

PHP 4+ · standard

atan(float $num): float

Восстановите угол по тангенсу: подъём 10 при горизонтали 10 даёт угол для чертежа.

Перед первым опытом: запись atan(...) вызывает функцию; в круглых скобках передаются значения через запятую, возвращённое значение можно сохранить через =. echo печатает, var_dump показывает ещё и тип, "\n" переносит строку. Параметр, вызов и возврат; Как читать числовые типы и результаты.

«Обратная» означает восстановление одного выбранного угла, а не 1/tan(x). Периодичность не позволяет восстановить все обороты из одного отношения. Прямая функция после обратной восстанавливает допустимый вход лишь с точностью float.

В примерах printf("%.3f\n", $value) печатает число с тремя знаками после точки; это формат вывода, само значение в памяти не становится точным десятичным числом. if выбирает ветку, function объявляет повторяемое действие, return возвращает его результат: начальные объяснения.

<?php
printf("%.3f\n", atan(0));

0.000

<?php
$rise = 10;
$horizontal = 10;
printf("%.1f\n", rad2deg(atan($rise / $horizontal)));

45.0

<?php
printf("%.1f\n", rad2deg(atan(1)));
printf("%.1f\n", rad2deg(atan2(-1, -1)));

45.0
-135.0

Когда подходит и где остановиться. Для направления произвольного вектора используйте atan2(y,x), особенно при x=0 и отрицательных координатах.

Сравните: tan, atan2, asin. Выбор по задаче.

• PHP: atan

PHP 4+ · standard

atan2(float $y, float $x): float

Получите направление между двумя точками, сохранив четверть плоскости и не деля самостоятельно на x.

Перед первым опытом: запись atan2(...) вызывает функцию; в круглых скобках передаются значения через запятую, возвращённое значение можно сохранить через =. echo печатает, var_dump показывает ещё и тип, "\n" переносит строку. Параметр, вызов и возврат; Как читать числовые типы и результаты.

В отличие от atan(y/x), atan2 видит знаки по отдельности. На экранной карте ось Y часто направлена вниз: договоритесь о координатах до вычисления.

В примерах printf("%.3f\n", $value) печатает число с тремя знаками после точки; это формат вывода, само значение в памяти не становится точным десятичным числом. if выбирает ветку, function объявляет повторяемое действие, return возвращает его результат: начальные объяснения.

Обозначения последующих шагов: function name($value) { ... } объявляет действие; имя в круглых скобках — локальный параметр; return завершает вызов и отдаёт результат; if (условие) { ... } выполняет блок только при истинном условии; ! отрицает, && требует оба условия, || — хотя бы одно; условие ? A : B выбирает результат A при истине, иначе B. Условия и обход списка.

<?php
printf("%.1f\n", rad2deg(atan2(1, 0)));
printf("%.1f\n", rad2deg(atan2(-1, -1)));

90.0
-135.0

<?php
function heading($fromX, $fromY, $toX, $toY) {
    $dx = $toX - $fromX;
    $dy = $toY - $fromY;
    if ($dx == 0 && $dy == 0) { return null; }
    $degrees = rad2deg(atan2($dy, $dx));
    return $degrees < 0 ? $degrees + 360 : $degrees;
}
echo heading(2, 2, 1, 1), "\n";
var_dump(heading(2, 2, 2, 2));

225
NULL

Когда подходит и где остановиться. Не называйте направление одного вектора углом между двумя произвольными векторами: для последнего нужны две стороны и правило разности/ориентации. На географической сфере простой atan2 разностей широты/долготы не даёт универсальный азимут.

Сравните: atan, rad2deg, hypot. Выбор по задаче.

• PHP: atan2

PHP 4+ · standard

deg2rad(float $num): float

Явно согласуйте единицы угла между интерфейсом и математическими функциями.

Перед первым опытом: запись deg2rad(...) вызывает функцию; в круглых скобках передаются значения через запятую, возвращённое значение можно сохранить через =. echo печатает, var_dump показывает ещё и тип, "\n" переносит строку. Параметр, вызов и возврат; Как читать числовые типы и результаты.

В примерах printf("%.3f\n", $value) печатает число с тремя знаками после точки; это формат вывода, само значение в памяти не становится точным десятичным числом. if выбирает ветку, function объявляет повторяемое действие, return возвращает его результат: начальные объяснения.

<?php
printf("%.3f\n", deg2rad(180));

3.142

<?php
$degrees = 30;
$radians = deg2rad($degrees);
printf("%.3f\n", sin($radians));
printf("%.1f\n", rad2deg($radians));

0.500
30.0

Когда подходит и где остановиться. 720° превращаются в 4π, а не в 0. Для диапазона оборота применяют отдельную нормализацию fmod. Прямое и обратное преобразования ограничены точностью float.

Сравните: rad2deg, pi, fmod. Выбор по задаче.

• PHP: deg2rad

PHP 4+ · standard

rad2deg(float $num): float

Явно согласуйте единицы угла между интерфейсом и математическими функциями.

Перед первым опытом: запись rad2deg(...) вызывает функцию; в круглых скобках передаются значения через запятую, возвращённое значение можно сохранить через =. echo печатает, var_dump показывает ещё и тип, "\n" переносит строку. Параметр, вызов и возврат; Как читать числовые типы и результаты.

В примерах printf("%.3f\n", $value) печатает число с тремя знаками после точки; это формат вывода, само значение в памяти не становится точным десятичным числом. if выбирает ветку, function объявляет повторяемое действие, return возвращает его результат: начальные объяснения.

<?php
printf("%.3f\n", rad2deg(M_PI));

180.000

<?php
$radians = atan2(1, 1);
printf("%.1f degrees\n", rad2deg($radians));
printf("%.1f degrees\n", rad2deg(-M_PI_2));

45.0 degrees
-90.0 degrees

Когда подходит и где остановиться. 720° превращаются в 4π, а не в 0. Для диапазона оборота применяют отдельную нормализацию fmod. Прямое и обратное преобразования ограничены точностью float.

Сравните: deg2rad, pi, fmod. Выбор по задаче.

• PHP: rad2deg

PHP 4.1+ · standard

sinh(float $num): float

Для численной шкалы или геометрической модели используйте гиперболический синус; ниже показано, какую величину он преобразует.

Перед первым опытом: запись sinh(...) вызывает функцию; в круглых скобках передаются значения через запятую, возвращённое значение можно сохранить через =. echo печатает, var_dump показывает ещё и тип, "\n" переносит строку. Параметр, вызов и возврат; Как читать числовые типы и результаты.

Гиперболическая функция не является обычной sin/cos/tan для градусов. Здесь не нужен deg2rad: аргумент задаёт выбранная модель. Формулы через exp объясняют математический смысл, а не рекомендуют менее устойчивую ручную реализацию.

В примерах printf("%.3f\n", $value) печатает число с тремя знаками после точки; это формат вывода, само значение в памяти не становится точным десятичным числом. if выбирает ветку, function объявляет повторяемое действие, return возвращает его результат: начальные объяснения.

<?php
printf("%.3f\n", sinh(0));

0.000

<?php
$scaled = asinh(12.0);
printf("%.3f\n", sinh($scaled));
printf("%.3f\n", sinh(-$scaled));

12.000
-12.000

Когда подходит и где остановиться. Обратимость математической формулы не гарантирует точного побитового восстановления float. Подпишите шкалу и её единицы, а при сохранении данных держите исходное измерение отдельно. Это специализированная математика: не нужна обычному выводу цены или обработке формы.

Сравните: asinh, exp, is_finite. Выбор по задаче.

• PHP: sinh

PHP 4.1+ · standard

cosh(float $num): float

Для численной шкалы или геометрической модели используйте гиперболический косинус; ниже показано, какую величину он преобразует.

Перед первым опытом: запись cosh(...) вызывает функцию; в круглых скобках передаются значения через запятую, возвращённое значение можно сохранить через =. echo печатает, var_dump показывает ещё и тип, "\n" переносит строку. Параметр, вызов и возврат; Как читать числовые типы и результаты.

Гиперболическая функция не является обычной sin/cos/tan для градусов. Здесь не нужен deg2rad: аргумент задаёт выбранная модель. Формулы через exp объясняют математический смысл, а не рекомендуют менее устойчивую ручную реализацию.

В примерах printf("%.3f\n", $value) печатает число с тремя знаками после точки; это формат вывода, само значение в памяти не становится точным десятичным числом. if выбирает ветку, function объявляет повторяемое действие, return возвращает его результат: начальные объяснения.

<?php
printf("%.3f\n", cosh(0));

1.000

<?php
$a = 10.0;
$x = 5.0;
$height = $a * (cosh($x / $a) - 1);
printf("%.3f\n", $height);
printf("%.3f\n", $a * (cosh(-$x / $a) - 1));

1.276
1.276

Когда подходит и где остановиться. Обратимость математической формулы не гарантирует точного побитового восстановления float. Подпишите шкалу и её единицы, а при сохранении данных держите исходное измерение отдельно. Это специализированная математика: не нужна обычному выводу цены или обработке формы.

Сравните: acosh, exp, is_finite. Выбор по задаче.

• PHP: cosh

PHP 4.1+ · standard

tanh(float $num): float

Для численной шкалы или геометрической модели используйте гиперболический тангенс; ниже показано, какую величину он преобразует.

Перед первым опытом: запись tanh(...) вызывает функцию; в круглых скобках передаются значения через запятую, возвращённое значение можно сохранить через =. echo печатает, var_dump показывает ещё и тип, "\n" переносит строку. Параметр, вызов и возврат; Как читать числовые типы и результаты.

Гиперболическая функция не является обычной sin/cos/tan для градусов. Здесь не нужен deg2rad: аргумент задаёт выбранная модель. Формулы через exp объясняют математический смысл, а не рекомендуют менее устойчивую ручную реализацию.

В примерах printf("%.3f\n", $value) печатает число с тремя знаками после точки; это формат вывода, само значение в памяти не становится точным десятичным числом. if выбирает ветку, function объявляет повторяемое действие, return возвращает его результат: начальные объяснения.

Обозначения последующих шагов: foreach ($list as $value) последовательно берёт элементы списка; [a, b] создаёт список. Условия и обход списка.

<?php
printf("%.3f\n", tanh(0));

0.000

<?php
foreach ([-3.0, 0.0, 3.0] as $score) {
    printf("%.3f\n", tanh($score));
}

-0.995
0.000
0.995

Когда подходит и где остановиться. tanh конечного x математически лежит строго между −1 и 1, но float может округлиться до границы. Не используйте atanh(результат) без проверки границы. Это специализированная математика: не нужна обычному выводу цены или обработке формы.

Сравните: atanh, exp, is_finite. Выбор по задаче.

• PHP: tanh

PHP 4.1+ · standard

asinh(float $num): float

Для численной шкалы или геометрической модели используйте обратный гиперболический синус; ниже показано, какую величину он преобразует.

Перед первым опытом: запись asinh(...) вызывает функцию; в круглых скобках передаются значения через запятую, возвращённое значение можно сохранить через =. echo печатает, var_dump показывает ещё и тип, "\n" переносит строку. Параметр, вызов и возврат; Как читать числовые типы и результаты.

Гиперболическая функция не является обычной sin/cos/tan для градусов. Здесь не нужен deg2rad: аргумент задаёт выбранная модель. Формулы через exp объясняют математический смысл, а не рекомендуют менее устойчивую ручную реализацию.

В примерах printf("%.3f\n", $value) печатает число с тремя знаками после точки; это формат вывода, само значение в памяти не становится точным десятичным числом. if выбирает ветку, function объявляет повторяемое действие, return возвращает его результат: начальные объяснения.

Обозначения последующих шагов: foreach ($list as $value) последовательно берёт элементы списка; [a, b] создаёт список. Условия и обход списка.

<?php
printf("%.3f\n", asinh(0));

0.000

<?php
foreach ([-100.0, 0.0, 100.0] as $value) {
    printf("%.3f\n", asinh($value));
}

-5.298
0.000
5.298

Когда подходит и где остановиться. Обратимость математической формулы не гарантирует точного побитового восстановления float. Подпишите шкалу и её единицы, а при сохранении данных держите исходное измерение отдельно. Это специализированная математика: не нужна обычному выводу цены или обработке формы.

Сравните: sinh, exp, is_finite. Выбор по задаче.

• PHP: asinh

PHP 4.1+ · standard

acosh(float $num): float

Для численной шкалы или геометрической модели используйте обратный гиперболический косинус; ниже показано, какую величину он преобразует.

Перед первым опытом: запись acosh(...) вызывает функцию; в круглых скобках передаются значения через запятую, возвращённое значение можно сохранить через =. echo печатает, var_dump показывает ещё и тип, "\n" переносит строку. Параметр, вызов и возврат; Как читать числовые типы и результаты.

Гиперболическая функция не является обычной sin/cos/tan для градусов. Здесь не нужен deg2rad: аргумент задаёт выбранная модель. Формулы через exp объясняют математический смысл, а не рекомендуют менее устойчивую ручную реализацию.

В примерах printf("%.3f\n", $value) печатает число с тремя знаками после точки; это формат вывода, само значение в памяти не становится точным десятичным числом. if выбирает ветку, function объявляет повторяемое действие, return возвращает его результат: начальные объяснения.

<?php
printf("%.3f\n", acosh(1));

0.000

<?php
$a = 10.0;
$height = 5.0;
$x = $a * acosh(1 + $height / $a);
printf("%.3f\n", $x);
var_dump(is_nan(acosh(0.5)));

9.624
bool(true)

Когда подходит и где остановиться. Обратимость математической формулы не гарантирует точного побитового восстановления float. Подпишите шкалу и её единицы, а при сохранении данных держите исходное измерение отдельно. Это специализированная математика: не нужна обычному выводу цены или обработке формы.

Сравните: cosh, exp, is_finite. Выбор по задаче.

• PHP: acosh

PHP 4.1+ · standard

atanh(float $num): float

Для численной шкалы или геометрической модели используйте обратный гиперболический тангенс; ниже показано, какую величину он преобразует.

Перед первым опытом: запись atanh(...) вызывает функцию; в круглых скобках передаются значения через запятую, возвращённое значение можно сохранить через =. echo печатает, var_dump показывает ещё и тип, "\n" переносит строку. Параметр, вызов и возврат; Как читать числовые типы и результаты.

Гиперболическая функция не является обычной sin/cos/tan для градусов. Здесь не нужен deg2rad: аргумент задаёт выбранная модель. Формулы через exp объясняют математический смысл, а не рекомендуют менее устойчивую ручную реализацию.

В примерах printf("%.3f\n", $value) печатает число с тремя знаками после точки; это формат вывода, само значение в памяти не становится точным десятичным числом. if выбирает ветку, function объявляет повторяемое действие, return возвращает его результат: начальные объяснения.

<?php
printf("%.3f\n", atanh(0));

0.000

<?php
printf("%.3f\n", atanh(0.5));
var_dump(atanh(1), atanh(-1));
var_dump(is_nan(atanh(1.1)));

0.549
float(INF)
float(-INF)
bool(true)

Когда подходит и где остановиться. Обратимость математической формулы не гарантирует точного побитового восстановления float. Подпишите шкалу и её единицы, а при сохранении данных держите исходное измерение отдельно. Это специализированная математика: не нужна обычному выводу цены или обработке формы.

Сравните: tanh, exp, is_finite. Выбор по задаче.

• PHP: atanh

PHP 4+ · standard

base_convert(string $num, int $from_base, int $to_base): string

Переведите небольшое целое между системами счисления: число 255 записывается как ff в основании 16.

Перед первым опытом: запись base_convert(...) вызывает функцию; в круглых скобках передаются значения через запятую, возвращённое значение можно сохранить через =. echo печатает, var_dump показывает ещё и тип, "\n" переносит строку. Параметр, вызов и возврат; Как читать числовые типы и результаты.

В опытах с отказом try выполняет попытку, catch ловит указанный тип ошибки; как работает обработка исключений.

Обозначения последующих шагов: function name($value) { ... } объявляет действие; имя в круглых скобках — локальный параметр; return завершает вызов и отдаёт результат; if (условие) { ... } выполняет блок только при истинном условии; ! отрицает, && требует оба условия, || — хотя бы одно. Условия и обход списка.

<?php
var_dump(base_convert('255', 10, 16));
echo base_convert('FF', 16, 2), "\n";
echo base_convert('0035', 10, 36), "\n";

string(2) "ff"
11111111
z

<?php
function shortLabel($id) {
    if ($id < 0 || $id > 1000000) {
        throw new InvalidArgumentException('ID out of range');
    }
    return 'ITEM-' . base_convert((string) $id, 10, 36);
}
echo shortLabel(1295), "\n";
try { base_convert('10', 1, 16); }
catch (ValueError $error) { echo "invalid base\n"; }

ITEM-zz
invalid base

Когда подходит и где остановиться. Не переводите длинный хеш в decimal через base_convert ради хранения: младшие разряды могут измениться. Для произвольной точности нужен алгоритм/расширение с точными большими целыми, например GMP. Для байтов используйте bin2hex/hex2bin, а не численную конверсию.

Сравните: bindec, hexdec, octdec. Выбор по задаче.

• PHP: base_convert

PHP 4+ · standard

bindec(string $binary_string): int|float

Прочитайте двоичную запись из интеграции как обычное число.

Перед первым опытом: запись bindec(...) вызывает функцию; в круглых скобках передаются значения через запятую, возвращённое значение можно сохранить через =. echo печатает, var_dump показывает ещё и тип, "\n" переносит строку. Параметр, вызов и возврат; Как читать числовые типы и результаты.

Самый левый бит — разряд величины, не знак. bindec читает беззнаковое представление; строка из одних единиц не означает −1. Оператор & в прикладном примере проверяет отдельный бит маски: 4 обозначает третий бит справа; это не логическое &&. Перед примером проверки: strspn($text, "01") считает длину начальной части из разрешённых символов; strlen даёт всю длину ASCII-записи. ctype_xdigit проверяет шестнадцатеричные символы. !== проверяет различие с учётом типа; === — совпадение.

Обозначения последующих шагов: if (условие) { ... } выполняет блок только при истинном условии; ! отрицает, && требует оба условия, || — хотя бы одно; условие ? A : B выбирает результат A при истине, иначе B. Условия и обход списка.

<?php
echo bindec('10110'), "\n";

22

<?php
$flags = '00000101';
$value = bindec($flags);
echo $value, "\n";
echo ($value & 4) !== 0 ? "export enabled\n" : "export disabled\n";

5
export enabled

<?php
$text = '102';
if ($text !== '' && strspn($text, '01') === strlen($text)) {
    echo bindec($text), "\n";
} else {
    echo "invalid digits\n";
}

invalid digits

Когда подходит и где остановиться. Не храните большие внешние идентификаторы как float: храните исходную проверенную строку или примените большие целые. Знак минуса, разделители и префиксы нужно разбирать по контракту своего протокола, а не полагаться на игнорирование символов. Для двоичного файла нужен разбор байтов, а не bindec всей строки.

Сравните: base_convert, decbin. Выбор по задаче.

• PHP: bindec

PHP 4+ · standard

hexdec(string $hex_string): int|float

Прочитайте шестнадцатеричную запись из интеграции как обычное число.

Перед первым опытом: запись hexdec(...) вызывает функцию; в круглых скобках передаются значения через запятую, возвращённое значение можно сохранить через =. echo печатает, var_dump показывает ещё и тип, "\n" переносит строку. Параметр, вызов и возврат; Как читать числовые типы и результаты.

Передаётся строка записи числа, а не готовый числовой литерал другого основания. Преобразование не сохраняет ведущие нули. Перед примером проверки: strspn($text, "01") считает длину начальной части из разрешённых символов; strlen даёт всю длину ASCII-записи. ctype_xdigit проверяет шестнадцатеричные символы. !== проверяет различие с учётом типа; === — совпадение.

Обозначения последующих шагов: if (условие) { ... } выполняет блок только при истинном условии; ! отрицает, && требует оба условия, || — хотя бы одно; условие ? A : B выбирает результат A при истине, иначе B. Условия и обход списка.

<?php
echo hexdec('2A'), "\n";

42

<?php
$component = '7f';
$intensity = hexdec($component);
echo $intensity, "\n";
echo $intensity / 255 < 0.5 ? "lower half\n" : "upper half\n";

127
lower half

<?php
$text = '7g';
if ($text !== '' && ctype_xdigit($text)) {
    echo hexdec($text), "\n";
} else {
    echo "invalid digits\n";
}

invalid digits

Когда подходит и где остановиться. Не храните большие внешние идентификаторы как float: храните исходную проверенную строку или примените большие целые. Знак минуса, разделители и префиксы нужно разбирать по контракту своего протокола, а не полагаться на игнорирование символов. Для двоичного файла нужен разбор байтов, а не bindec всей строки.

Сравните: base_convert, dechex. Выбор по задаче.

• PHP: hexdec

PHP 4+ · standard

octdec(string $octal_string): int|float

Прочитайте восьмеричную запись из интеграции как обычное число.

Перед первым опытом: запись octdec(...) вызывает функцию; в круглых скобках передаются значения через запятую, возвращённое значение можно сохранить через =. echo печатает, var_dump показывает ещё и тип, "\n" переносит строку. Параметр, вызов и возврат; Как читать числовые типы и результаты.

Передаётся строка записи числа, а не готовый числовой литерал другого основания. Преобразование не сохраняет ведущие нули. Перед примером проверки: strspn($text, "01") считает длину начальной части из разрешённых символов; strlen даёт всю длину ASCII-записи. ctype_xdigit проверяет шестнадцатеричные символы. !== проверяет различие с учётом типа; === — совпадение.

Обозначения последующих шагов: if (условие) { ... } выполняет блок только при истинном условии; ! отрицает, && требует оба условия, || — хотя бы одно. Условия и обход списка.

<?php
echo octdec('640'), "\n";

416

<?php
$permissions = '640';
$mask = octdec($permissions);
echo $mask, "\n";
echo decoct($mask), "\n";

416
640

<?php
$text = '680';
if ($text !== '' && strspn($text, '01234567') === strlen($text)) {
    echo octdec($text), "\n";
} else {
    echo "invalid digits\n";
}

invalid digits

Когда подходит и где остановиться. Не храните большие внешние идентификаторы как float: храните исходную проверенную строку или примените большие целые. Знак минуса, разделители и префиксы нужно разбирать по контракту своего протокола, а не полагаться на игнорирование символов. Для двоичного файла нужен разбор байтов, а не bindec всей строки.

Сравните: base_convert, decoct. Выбор по задаче.

• PHP: octdec

PHP 4+ · standard

decbin(int $num): string

Получите текстовую двоичную запись целого числа для диагностики и обмена.

Перед первым опытом: запись decbin(...) вызывает функцию; в круглых скобках передаются значения через запятую, возвращённое значение можно сохранить через =. echo печатает, var_dump показывает ещё и тип, "\n" переносит строку. Параметр, вызов и возврат; Как читать числовые типы и результаты.

Это изменение записи, не сохранение числа в двоичном файле. Для −1 все биты машинного слова равны 1: 32/64 двоичных цифры, 8/16 hex-цифр; восьмеричная верхняя цифра содержит неполные три бита. str_pad($text, 8, "0", STR_PAD_LEFT) дополняет текст слева до восьми символов; strlen измеряет длину; str_repeat("7", 3) создаёт "777". Литерал 0640 — восьмеричное число в исходном PHP, кавычки превращают запись в строку. Строки и их функции.

Обозначения последующих шагов: условие ? A : B выбирает результат A при истине, иначе B. Условия и обход списка.

<?php
var_dump(decbin(13));

string(4) "1101"

<?php
$flags = 5;
echo str_pad(decbin($flags), 8, '0', STR_PAD_LEFT), "\n";
echo strlen(decbin(-1)) === PHP_INT_SIZE * 8 ? "machine width\n" : "other width\n";

00000101
machine width

Когда подходит и где остановиться. Принимается signed int, хотя отрицательное значение интерпретируется как unsigned-машинная запись. Не вычисляйте «верхнюю unsigned границу» через PHP_INT_MAX * 2 + 1 и не передавайте получившийся float: он уже может быть неточным. decbin(-1) и bindec результата не обязаны образовать signed-обратное преобразование.

Сравните: bindec, base_convert. Выбор по задаче.

• PHP: decbin

PHP 4+ · standard

dechex(int $num): string

Получите текстовую шестнадцатеричную запись целого числа для диагностики и обмена.

Перед первым опытом: запись dechex(...) вызывает функцию; в круглых скобках передаются значения через запятую, возвращённое значение можно сохранить через =. echo печатает, var_dump показывает ещё и тип, "\n" переносит строку. Параметр, вызов и возврат; Как читать числовые типы и результаты.

Это изменение записи, не сохранение числа в двоичном файле. Для −1 все биты машинного слова равны 1: 32/64 двоичных цифры, 8/16 hex-цифр; восьмеричная верхняя цифра содержит неполные три бита. str_pad($text, 8, "0", STR_PAD_LEFT) дополняет текст слева до восьми символов; strlen измеряет длину; str_repeat("7", 3) создаёт "777". Литерал 0640 — восьмеричное число в исходном PHP, кавычки превращают запись в строку. Строки и их функции.

Обозначения последующих шагов: условие ? A : B выбирает результат A при истине, иначе B. Условия и обход списка.

<?php
var_dump(dechex(171));

string(2) "ab"

<?php
$red = 15;
$green = 128;
$blue = 255;
echo '#', str_pad(dechex($red), 2, '0', STR_PAD_LEFT),
    str_pad(dechex($green), 2, '0', STR_PAD_LEFT),
    str_pad(dechex($blue), 2, '0', STR_PAD_LEFT), "\n";
echo strlen(dechex(-1)) === PHP_INT_SIZE * 2 ? "machine width\n" : "other width\n";

#0f80ff
machine width

Когда подходит и где остановиться. Принимается signed int, хотя отрицательное значение интерпретируется как unsigned-машинная запись. Не вычисляйте «верхнюю unsigned границу» через PHP_INT_MAX * 2 + 1 и не передавайте получившийся float: он уже может быть неточным. decbin(-1) и bindec результата не обязаны образовать signed-обратное преобразование.

Сравните: hexdec, base_convert. Выбор по задаче.

• PHP: dechex

PHP 4+ · standard

decoct(int $num): string

Получите текстовую восьмеричную запись целого числа для диагностики и обмена.

Перед первым опытом: запись decoct(...) вызывает функцию; в круглых скобках передаются значения через запятую, возвращённое значение можно сохранить через =. echo печатает, var_dump показывает ещё и тип, "\n" переносит строку. Параметр, вызов и возврат; Как читать числовые типы и результаты.

Это изменение записи, не сохранение числа в двоичном файле. Для −1 все биты машинного слова равны 1: 32/64 двоичных цифры, 8/16 hex-цифр; восьмеричная верхняя цифра содержит неполные три бита. str_pad($text, 8, "0", STR_PAD_LEFT) дополняет текст слева до восьми символов; strlen измеряет длину; str_repeat("7", 3) создаёт "777". Литерал 0640 — восьмеричное число в исходном PHP, кавычки превращают запись в строку. Строки и их функции.

Обозначения последующих шагов: условие ? A : B выбирает результат A при истине, иначе B. Условия и обход списка.

<?php
var_dump(decoct(416));

string(3) "640"

<?php
$permissions = 0640;
echo decoct($permissions), "\n";
echo decoct(-1) === str_repeat('7', intdiv(PHP_INT_SIZE * 8, 3)) ? "all sevens\n" : "leading partial digit\n";

640
leading partial digit

Когда подходит и где остановиться. Принимается signed int, хотя отрицательное значение интерпретируется как unsigned-машинная запись. Не вычисляйте «верхнюю unsigned границу» через PHP_INT_MAX * 2 + 1 и не передавайте получившийся float: он уже может быть неточным. decbin(-1) и bindec результата не обязаны образовать signed-обратное преобразование.

Сравните: octdec, base_convert. Выбор по задаче.

• PHP: decoct

PHP 8.4+ · standard

enum RoundingMode { case HalfAwayFromZero; case HalfTowardsZero; case HalfEven; case HalfOdd; case TowardsZero; case AwayFromZero; case NegativeInfinity; case PositiveInfinity; }

Режим — часть договора расчёта: «половину вверх» и «любую дробь вверх» нужно различать.

Перед первым опытом: RoundingMode::HalfEven выбирает именованный вариант, который затем передаётся в round. Сам enum не является вызываемой функцией. echo печатает, var_dump показывает ещё и тип, "\n" переносит строку. Параметр, вызов и возврат; Как читать числовые типы и результаты.

Например, при precision = 1 выбираются соседние десятые; «чётный» относится к последнему сохраняемому разряду. Что такое enum и его варианты.

Обозначения последующих шагов: foreach ($list as $value) последовательно берёт элементы списка; [a, b] создаёт список. Условия и обход списка.

<?php
echo round(2.9, 0, RoundingMode::TowardsZero), "\n";
echo round(2.9, 0, RoundingMode::HalfTowardsZero), "\n";
echo round(-2.1, 0, RoundingMode::NegativeInfinity), "\n";

2
3
-3

<?php
foreach (RoundingMode::cases() as $mode) {
    echo $mode->name, ': ', round(2.5, 0, $mode), '/', round(-2.5, 0, $mode), "\n";
}

HalfAwayFromZero: 3/-3
HalfTowardsZero: 2/-2
HalfEven: 2/-2
HalfOdd: 3/-3
TowardsZero: 2/-2
AwayFromZero: 3/-3
NegativeInfinity: 2/-3
PositiveInfinity: 3/-2

Когда подходит и где остановиться. PHP_ROUND_HALF_UP соответствует HalfAwayFromZero, а не AwayFromZero; PHP_ROUND_HALF_DOWN — HalfTowardsZero, а не TowardsZero. Для точных десятичных расчётов сам переход с int-константы на enum не устраняет погрешность float.

Сравните: round, ceil, floor. Выбор по задаче.

• PHP: RoundingMode