PHPTime

Типы данных и преобразование типов в 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
<?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
<?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: строка вместо int

declare(strict_types=1) ставят первым оператором файла. Для скалярных аргументов режим определяется файлом, где сделан вызов. Для скалярного возвращаемого значения действует режим файла, где объявлена функция. Даже в строгом режиме int подходит для параметра типа float и преобразуется в float. Для значений из формы, переменных окружения и других строковых источников разбор выполняют перед вызовом типизированной функции.

Директива не меняет правила арифметики, явных приведений и оператора ==. Для проверки значения вместе с типом используйте === и !==. При поиске в массиве тот же эффект даёт третий аргумент true у in_array().

PHP
<?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
<?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
<?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
<?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
<?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.

Значение $valueis_null($value)isset($value)empty($value)
Переменная отсутствуетtrue с предупреждениемfalsetrue
nulltruefalsetrue
false, 0, 0.0, '', '0', []falsetruetrue
' ', '0.0', 'false'falsetruefalse

Для поля с допустимым нулём empty() даст ложный сигнал о пропуске. Для строки, где пробелы считаются пустым вводом, проверяйте trim($text) === '' после проверки типа. Если нужно отличить отсутствующий ключ массива от ключа со значением null, используйте array_key_exists(). Оператор ?? подставляет значение по умолчанию для обоих случаев.

PHP
<?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
<?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
<?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_*.

Чек-лист для работы с типами

  1. Объявите типы в сигнатурах и включите strict_types в файлах приложения, где нужен строгий контроль скалярных аргументов.
  2. Разберите входные строки по правилам предметной области. Проверьте формат, диапазон и допустимость нуля до приведения типа.
  3. Проверяйте null через === null у известного значения. Для необязательного ключа выберите isset(), ?? или array_key_exists() по смыслу.
  4. Выберите операцию деления по ожидаемому результату и обработайте нулевой делитель. Для целого частного используйте intdiv().
  5. Задайте момент и режим округления в расчёте. Проверьте отрицательные числа, значения ровно посередине и границы диапазона. Форматируйте итог при выводе.

Частые вопросы

Как узнать тип переменной в 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. Перед чтением необязательного ключа проверьте его наличие.

Справка по теме

Ещё в разделе «Справочник PHP»

Функции в PHP: аргументы, типы, замыкания и стрелочные функции

Практическая справка по функциям PHP 8.3–8.5: аргументы, типы и return, область видимости, global и static, замыкания use и стрелочные функции fn.

10 мин

Хеширование паролей в PHP: password_hash, password_verify, md5 и hash

Как хешировать и проверять пароли в PHP 8.3–8.5, обновлять старые хеши при входе и выбирать между password_hash(), md5(), hash() и hash_hmac() для разных задач.

9 мин

Циклы в PHP: for, while, do-while и foreach

Как работают циклы for, while, do-while и foreach в PHP 8.3–8.5. Примеры обхода массивов, вложенных циклов и применения break и continue.

10 мин

Что нового в PHP 8.x: от 8.0 до 8.5

Разбираем, что изменилось в PHP 8.0–8.5: типы, enum, readonly, хуки свойств и оператор pipe. Примеры кода, ошибки совместимости и чек-лист обновления.

9 мин