Приведение типов в PHP: строку в число, intval() и (int)

Чтобы привести значение к другому типу, поставьте тип в скобках перед ним: (int) "42" даёт целое число 42. Функция intval("42") делает то же самое. Приведение никогда не завершается ошибкой: текст, который не является числом, становится 0, а у строки, начинающейся с цифр, остаются только эти цифры.

<?php
$input = "42";

var_dump((int) $input);
var_dump(intval($input));
var_dump((int) "12abc");   // leading digits only
var_dump((int) "abc");     // not a number at all
var_dump((float) "3.14");
var_dump((string) 99);
var_dump((bool) "0");

В PHP есть приведения (int), (float), (string), (bool), (array) и (object). Для каждого есть и функция: intval(), floatval(), strval(), boolval().

Строка в int: что возвращают (int) и intval()

PHP читает цифры с начала строки, пропустив начальные пробелы, и останавливается на первом символе, который не подходит для числа. Экспоненциальная запись считается числом, префикс 0x нет.

<?php
$samples = ["42", "  42", "-17", "12.7", "1e3", "12abc", "abc", "", "0x1A", "012"];

foreach ($samples as $s) {
    printf("%-8s => %d\n", var_export($s, true), (int) $s);
}

Обратите внимание: "12.7" превращается в 12, приведение к int отбрасывает дробную часть, а не округляет. Ни (int), ни intval() здесь не печатают предупреждений, каким бы ни был ввод.

intval() с основанием

intval($value, $base) читает строку в другой системе счисления. С основанием 0 PHP смотрит на префикс: 0x для шестнадцатеричных, 0b для двоичных, ведущий 0 для восьмеричных.

<?php
var_dump(intval("ff", 16));
var_dump(intval("101", 2));
var_dump(intval("777", 8));
var_dump(intval("0x1A", 0));
var_dump(intval("0b101", 0));
var_dump(intval("012", 0));    // octal because of the leading 0
var_dump(intval("012"));       // base 10 by default

// Converting the other way
echo dechex(255), " ", decbin(5), " ", base_convert("ff", 16, 2), "\n";

Float в int: отбрасывание, а не округление

(int) отбрасывает всё после десятичной точки, в сторону нуля. Если нужно ближайшее целое, сначала округлите, и следите за скобками:

<?php
var_dump((int) 12.99);
var_dump((int) -12.99);
var_dump((int) round(12.5));

// Precedence: the cast applies to (0.1 + 0.7) before * 10
var_dump((int) (0.1 + 0.7) * 10);
var_dump((int) ((0.1 + 0.7) * 10));
var_dump((int) round((0.1 + 0.7) * 10));

Последняя пара это классическая ловушка float: (0.1 + 0.7) * 10 хранится как 7.999999..., поэтому отбрасывание дробной части даёт 7. Если сначала округлить, получится 8. round, floor и ceil описаны на странице о математике.

Приведение к bool, string и array

В false при приведении к bool превращаются лишь несколько значений: 0, 0.0, "", "0", null и []. Всё остальное true, включая "0.0", " " и "false".

При приведении к строке true становится "1", а false и null оба становятся "". У float отбрасывается конечное .0, а очень большие или очень маленькие float записываются в экспоненциальной форме.

<?php
foreach (["0", "0.0", " ", "false", [], [0], 0.0, -1, null] as $v) {
    printf("%-10s => %s\n", json_encode($v), var_export((bool) $v, true));
}

echo "---\n";
var_dump((string) true, (string) false, (string) null);
var_dump((string) 3.0, (string) 0.1, (string) 1e25);

echo "---\n";
var_dump((array) "a");     // a scalar becomes a one-element array
var_dump((array) null);    // null becomes an empty array

Приведение массива к строке не склеивает его. Этот код выводит Tags: Array:

<?php
$tags = ["php", "web"];
echo "Tags: " . $tags;

и PHP добавляет предупреждение:

Warning: Array to string conversion in /home/index.php on line 3

Чтобы превратить массив в текст, используйте implode(", ", $array) или json_encode($array).

Все приведения сразу

Выберите значение, чтобы увидеть, что для него возвращают intval, (bool), strval, is_numeric и gettype. Каждую ячейку вычислил PHP 8.3.

Point at or tap a cell to read it as PHP.

$x	intval	bool	strval	is_numeric	gettype
"10"	10	true	'10'	true	'string'
"1abc"	1	true	'1abc'	false	'string'
"abc"	0	true	'abc'	false	'string'
""	0	false	''	false	'string'
" "	0	true	' '	false	'string'
"0"	0	false	'0'	true	'string'
"0.0"	0	true	'0.0'	true	'string'
"1e1"	10	true	'1e1'	true	'string'
"010"	10	true	'010'	true	'string'
1.5	1	true	'1.5'	true	'double'
true	1	true	'1'	false	'boolean'
false	0	false	''	false	'boolean'
null	0	false	''	false	'NULL'
[]	0	false	"Array" + warning	false	'array'
[1, 2]	1	true	"Array" + warning	false	'array'

Every cell computed by PHP 8.3.19.

Числовые строки и автоматическое приведение

Числовая строка это строка, которая выглядит как число: "12", "-3.5", "1e3", возможно с пробелами вокруг. PHP автоматически приводит такие строки в арифметике, а is_numeric() сообщает, подходит ли строка.

<?php
foreach (["12", "12.5", "1e3", " 12", "12 ", "12abc", "0x1A", ""] as $s) {
    printf("%-8s is_numeric: %s\n", var_export($s, true), var_export(is_numeric($s), true));
}

echo "---\n";
var_dump("5" * "4");     // both numeric: int
var_dump("5" + 1.5);     // float
var_dump(10 . "");       // int to string with concatenation

"12abc" + 1 по-прежнему даёт 13, но PHP 8 печатает Warning: A non-numeric value encountered, а "abc" + 1 выбрасывает TypeError. Приводите или проверяйте пользовательский ввод до арифметики.

settype() и gettype()

settype() меняет тип переменной на месте, а gettype() сообщает его. get_debug_type() возвращает более короткие имена, которые встречаются в сообщениях об ошибках (int, float, string).

<?php
$value = "42";
echo gettype($value), "\n";

settype($value, "integer");
var_dump($value);
echo gettype($value), " / ", get_debug_type($value), "\n";

$price = "19.90";
settype($price, "float");
var_dump($price);

В большинстве кода вместо этого используют приведение ($value = (int) $value;), потому что оно короче и читается так же.

Проверяйте ввод, а не приводите его

(int) никогда не отказывает, поэтому (int) "abc" молча становится 0, а (int) "5 apples" становится 5. Для данных из формы используйте filter_var с FILTER_VALIDATE_INT: функция возвращает целое число или false.

<?php
foreach (["42", " 42 ", "42abc", "4.2", "042", "-7", "abc"] as $input) {
    $n = filter_var($input, FILTER_VALIDATE_INT);
    printf("%-8s => %s\n", var_export($input, true), $n === false ? "rejected" : $n);
}

Сравнивайте результат через === false, потому что 0 это допустимое целое число, а == false его бы отклонило. Диапазоны и другие валидаторы показаны на странице про filter_var.