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なら16進数、0bなら2進数、先頭の0なら8進数です。

<?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)は小数点以下をすべて0の方向へ切り捨てます。いちばん近い整数が欲しいなら先に丸め、括弧に注意してください。

<?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へのキャスト

boolへのキャストでfalseになるのは、0、0.0、""、"0"、null、[]のごく一部の値だけです。それ以外はすべてtrueで、"0.0"、" "、"false"もtrueです。

stringへのキャストでは、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_VALIDATE_INTを指定したfilter_varを使いましょう。整数か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);
}

0は正当な整数で、== falseだとそれを拒否してしまうので、結果は=== falseで比較します。範囲の指定やほかのバリデーターはfilter_varのページで紹介しています。