Типы данных и преобразование типов в PHP
PHP определяет тип значения во время выполнения, а типы в сигнатурах задают, какие аргументы и результаты принимает ваш код. Разберём, как проверить тип переменной, разобрать число из строки, обработать null и предсказуемо выполнить деление и округление. Примеры рассчитаны на PHP 8.3–8.5.
Типы данных в PHP и тип переменной
В PHP у значения есть тип. Обычной переменной можно присвоить значение другого типа, а у типизированного свойства класса действуют ограничения из объявления. Число 42, строка '42' и число 42.0 имеют разные типы, хотя при некоторых сравнениях PHP считает их равными.
bool—trueиfalse.intиfloat— целые числа и числа с плавающей точкой.string— последовательность байтов.strlen()считает байты, поэтому для длины текста в UTF-8 можно использоватьmb_strlen($text, 'UTF-8')из расширения mbstring.array— упорядоченное отображение с ключами типаintилиstring. Им представляют и списки, и словари.object— экземпляр класса. Для проверки принадлежности к классу или интерфейсу естьinstanceof.resource— дескриптор внешнего ресурса, например открытого потока.null— отдельный тип с единственным значениемnull.
В сигнатурах также встречаются mixed для любого значения, iterable для массива или объекта Traversable и callable для вызываемого значения. void и never описывают поведение функции при возврате.
Как узнать и проверить тип переменной
Для диагностики используйте get_debug_type() или var_dump(). Первая функция возвращает строку с именем типа, а для объекта — с именем класса. Для условия берите is_int(), is_float(), is_string(), is_array() и другие функции is_*. У старой gettype() встречаются названия вроде 'integer' и 'double'.
<?php
$value = '42';
echo get_debug_type($value), PHP_EOL; // string
var_dump(is_int($value)); // bool(false)
var_dump(is_numeric($value)); // bool(true): строка числоваяСтрогая типизация и сравнение значений
Объявляйте типы параметров, возвращаемых значений и свойств там, где известен их контракт. Запись ?int эквивалентна int|null. Объединение int|float подходит, если функция принимает оба числовых типа.
<?php
declare(strict_types=1);
function subtotal(int $priceInCents, int $quantity): int
{
return $priceInCents * $quantity;
}
var_dump(subtotal(199, 3)); // int(597)
// subtotal('199', 3); // TypeError: строка вместо intdeclare(strict_types=1) ставят первым оператором файла. Для скалярных аргументов режим определяется файлом, где сделан вызов. Для скалярного возвращаемого значения действует режим файла, где объявлена функция. Даже в строгом режиме int подходит для параметра типа float и преобразуется в float. Для значений из формы, переменных окружения и других строковых источников разбор выполняют перед вызовом типизированной функции.
Директива не меняет правила арифметики, явных приведений и оператора ==. Для проверки значения вместе с типом используйте === и !==. При поиске в массиве тот же эффект даёт третий аргумент true у in_array().
<?php
var_dump('42' == 42); // bool(true)
var_dump('42' === 42); // bool(false)
var_dump(in_array('42', [42], true)); // bool(false)
var_dump(0 == 'abc'); // bool(false) в PHP 8.xНачиная с PHP 8.0, при нестрогом сравнении числа с нечисловой строкой PHP сравнивает строковое представление числа со строкой. При сравнении числа с числовой строкой по-прежнему применяется числовое сравнение. Поэтому '01' == 1 даёт true. Для идентификаторов, в которых важны начальные нули, проверяйте строки через ===.
Как преобразовать строку в число в PHP
(int), (float), intval() и floatval() преобразуют значение. Если строка начинается с числа, приведение может отбросить остаток, а строка без числового начала даст ноль. Для входных данных сначала задайте допустимый формат, затем преобразуйте значение.
<?php
var_dump((int) '42 яблока'); // int(42)
var_dump((int) 'яблоки'); // int(0)
var_dump((float) '12,5'); // float(12): разбор до запятой
var_dump((float) '12.5'); // float(12.5)
var_dump((int) '-3.9'); // int(-3): дробная часть отброшенаЦелое число с проверкой диапазона
FILTER_VALIDATE_INT возвращает целое или false. Сравнивайте результат через === false, чтобы сохранить допустимый ноль. Если формат требует ведущих нулей, определите отдельное правило: например, строка '007' может быть кодом, который следует хранить целиком.
<?php
$raw = '0';
$quantity = filter_var($raw, FILTER_VALIDATE_INT, [
'options' => ['min_range' => 0, 'max_range' => 1000],
]);
if ($quantity === false) {
throw new InvalidArgumentException('Ожидается целое число от 0 до 1000');
}
var_dump($quantity); // int(0)Дробь, запятая и экспонента
is_numeric() распознаёт числовые строки, в том числе '1e3' и ' 12.5 '. Поддержка завершающих пробельных символов в числовых строках появилась в PHP 8.0. Если форма принимает только десятичную запись без экспоненты и разделителей тысяч, проще проверить её собственным шаблоном. Следующий пример разрешает точку или запятую между целой и дробной частями.
<?php
$raw = trim('12,50');
if (preg_match('/\A[+-]?[0-9]+(?:[.,][0-9]+)?\z/', $raw) !== 1) {
throw new InvalidArgumentException('Ожидается десятичное число');
}
$amount = (float) str_replace(',', '.', $raw);
if (!is_finite($amount)) {
throw new InvalidArgumentException('Число вне диапазона float');
}
var_dump($amount); // float(12.5)Избегайте $raw + 0 для разбора пользовательского ввода. В PHP 8.x полностью нечисловая строка в таком выражении вызывает TypeError, а строка с числом в начале и посторонним хвостом может участвовать в вычислении с предупреждением.
PHP int и float: диапазон и точность
Границы int зависят от платформы. Для них есть PHP_INT_MIN, PHP_INT_MAX и PHP_INT_SIZE в байтах. При переполнении в арифметике, например в PHP_INT_MAX + 1, результат становится float и может потерять целочисленную точность. Длинные идентификаторы храните строками, когда их нужно передавать без потери цифр.
float хранит двоичное приближение. Значения вроде 0.1 и 0.2 представляются с погрешностью. В расчётах с допустимой абсолютной ошибкой сравнивайте разность с порогом, выбранным под задачу. Денежные суммы удобно хранить в целых минимальных единицах валюты с учётом диапазона int или считать десятичными строками с помощью BCMath.
<?php
$sum = 0.1 + 0.2;
var_dump($sum === 0.3); // bool(false)
var_dump(abs($sum - 0.3) < 1e-12); // bool(true) при таком допускеС PHP 8.1 неявное преобразование float в int с потерей дробной части помечено как устаревшее. Это касается, например, дробного ключа массива. Если нужно усечение, пишите (int) $value явно для конечного числа в допустимом диапазоне. Если требуется ближайшее целое, сначала задайте правило округления.
Проверка null в PHP: is_null(), isset() и empty()
is_null($value) и $value === null проверяют, что значение равно null. Для отсутствующей переменной или ключа массива прямое чтение может выдать предупреждение. isset() проверяет, что значение доступно и отлично от null. empty() возвращает true для отсутствующего значения и для значений, которые при преобразовании в bool дают false.
Значение $value | is_null($value) | isset($value) | empty($value) |
|---|---|---|---|
| Переменная отсутствует | true с предупреждением | false | true |
null | true | false | true |
false, 0, 0.0, '', '0', [] | false | true | true |
' ', '0.0', 'false' | false | true | false |
Для поля с допустимым нулём empty() даст ложный сигнал о пропуске. Для строки, где пробелы считаются пустым вводом, проверяйте trim($text) === '' после проверки типа. Если нужно отличить отсутствующий ключ массива от ключа со значением null, используйте array_key_exists(). Оператор ?? подставляет значение по умолчанию для обоих случаев.
<?php
$input = ['limit' => '0', 'cursor' => null];
var_dump(isset($input['limit'])); // bool(true)
var_dump(empty($input['limit'])); // bool(true)
var_dump(isset($input['cursor'])); // bool(false)
var_dump(array_key_exists('cursor', $input)); // bool(true)
var_dump($input['limit'] ?? '20'); // string(1) "0"
var_dump($input['cursor'] ?? 'start'); // string(5) "start"Деление в PHP: /, intdiv(), % и fdiv()
/ выполняет обычное деление. Для двух операндов int, которые делятся нацело и дают результат в диапазоне int, результат будет целым. Если частное дробное или один из операндов имеет тип float, результат будет float. intdiv() возвращает целое частное с усечением к нулю, а % — целочисленный остаток со знаком делимого. Для дробного остатка используйте fmod().
<?php
var_dump(6 / 3); // int(2)
var_dump(6.0 / 3); // float(2)
var_dump(7 / 3); // float, примерно 2.333333333333333
var_dump(intdiv(-7, 3)); // int(-2)
var_dump(-7 % 3); // int(-1)
var_dump(fmod(7.5, 2.0)); // float(1.5)В PHP 8.x операторы /, % и функция intdiv() выбрасывают DivisionByZeroError при нулевом делителе. Вызов intdiv(PHP_INT_MIN, -1) выбрасывает ArithmeticError, поскольку частное выходит за верхнюю границу int. Функция fdiv(), доступная с PHP 8.0, позволяет получить результат по правилам IEEE 754. При делении на ноль она возвращает INF, -INF или NAN. Такие результаты проверяют через is_finite(), is_infinite() и is_nan().
Округление в PHP: round(), floor() и ceil()
round() возвращает float. Второй аргумент задаёт точность: 2 округляет до сотых, 0 — до целого, -2 — до сотен. Третий аргумент задаёт режим. По умолчанию при равном расстоянии до соседних значений PHP округляет от нуля. PHP_ROUND_HALF_EVEN выбирает чётное из двух соседних значений на заданном разряде.
<?php
var_dump(round(12.345, 2)); // float(12.35)
var_dump(round(1249, -2)); // float(1200)
var_dump(round(-2.5, 0)); // float(-3)
var_dump(round(2.5, 0, PHP_ROUND_HALF_EVEN)); // float(2)
var_dump(floor(-2.1)); // float(-3)
var_dump(ceil(-2.1)); // float(-2)
echo number_format(12.5, 2, ',', ' '); // Строка «12,50»floor() округляет к минус бесконечности, ceil() — к плюс бесконечности. На отрицательных числах это особенно заметно: floor(-2.1) даёт -3.0, а (int) -2.1 даёт -2. Для вывода с фиксированным количеством знаков используйте number_format(). Его результат подходит для отображения, а расчёты ведите с исходными числовыми значениями.
В PHP 8.4 появился RoundingMode. В PHP 8.4 и 8.5 можно передать RoundingMode::HalfEven или выбрать направленный режим, например RoundingMode::TowardsZero. С PHP 8.4 недопустимый режим вызывает ValueError, а PHP 8.3 в таком случае использует PHP_ROUND_HALF_UP. Если один код работает на всех трёх версиях, для округления половин указывайте именованную константу PHP_ROUND_HALF_*.
Чек-лист для работы с типами
- Объявите типы в сигнатурах и включите
strict_typesв файлах приложения, где нужен строгий контроль скалярных аргументов. - Разберите входные строки по правилам предметной области. Проверьте формат, диапазон и допустимость нуля до приведения типа.
- Проверяйте
nullчерез=== nullу известного значения. Для необязательного ключа выберитеisset(),??илиarray_key_exists()по смыслу. - Выберите операцию деления по ожидаемому результату и обработайте нулевой делитель. Для целого частного используйте
intdiv(). - Задайте момент и режим округления в расчёте. Проверьте отрицательные числа, значения ровно посередине и границы диапазона. Форматируйте итог при выводе.
Частые вопросы
Как узнать тип переменной в PHP?
Вызовите get_debug_type($value), чтобы получить имя типа, или var_dump($value), чтобы увидеть тип и значение. Для условий используйте is_int(), is_float(), is_string() и другие проверки.
Как преобразовать строку в число и сохранить допустимый ноль?
Для целого используйте filter_var($raw, FILTER_VALIDATE_INT) и проверяйте результат через === false. Для дроби сначала проверьте формат строки, затем приведите её к float и при необходимости проверьте диапазон.
Чем isset() отличается от empty() и is_null()?
isset() возвращает true для доступного значения, отличного от null. empty() считает пустыми в том числе 0, строку '0', false, пустую строку и пустой массив. is_null() проверяет равенство null. Перед чтением необязательного ключа проверьте его наличие.