PHPのデータ型：int・float・string・bool・array・null

PHPで日常的に使う型は8つあります。int、float、string、bool、array、object、null、そして受け渡しする関数のためのcallableです。変数そのものに固定の型はなく、今入っている値が型を持っています。var_dump($x)は型と値の両方を表示し、gettype($x)は型を文字列で返します。

<?php
$values = [42, 3.14, "hello", true, [1, 2, 3], null, new stdClass()];

printf("%-8s %-10s %s\n", "gettype", "debug", "value");
foreach ($values as $value) {
    printf("%-8s %-10s %s\n", gettype($value), get_debug_type($value), json_encode($value));
}

1列目がgettype()、2列目がget_debug_type()です。値を自分のものに置き換えて、もう一度実行してみてください。いくつかの名前は一致しません。gettypeは歴史的な理由でinteger、double、booleanと答えますが、get_debug_typeは型宣言と同じ名前（int、float、bool）を使い、オブジェクトならクラス名を返します。

PHPの型の一覧

var_dumpで値を調べる

var_dumpは、実際に何が入っているかを確かめるための道具です。型と値を表示し、文字列ならバイト単位の長さも表示します。

<?php
var_dump(10);
var_dump(10.0);
var_dump("10");
var_dump(true);
var_dump(null);
var_dump(["id" => 7, "tags" => ["php", "web"]]);
var_dump("café");   // 5 bytes: é takes two bytes in UTF-8

echoだと最初の3つはどれも10と表示され、違いがわかりません。string(5) "café"の長さはバイト数なので、ASCII以外のテキストではstrlenとmb_strlenの結果が違います。

整数と浮動小数点数

整数は小数部分のない数です。リテラルには読みやすさのためにアンダースコアを入れられ、16進数、8進数、2進数の表記も使えます。floatは小数点か指数を持つ数で、どの言語とも同じく、ほとんどの小数は近似値で保存されます。

<?php
$population = 8_100_000_000;   // underscores are ignored
var_dump($population);
var_dump(0xFF, 0b1010, 0o17);  // hex, binary, octal
var_dump(PHP_INT_MAX);
var_dump(PHP_INT_MAX + 1);     // too big: becomes a float

var_dump(7 / 2);               // / returns a float when needed
var_dump(8 / 2);               // and an int when the result is whole
var_dump(intdiv(7, 2));        // integer division

var_dump(0.1 + 0.2);
var_dump(0.1 + 0.2 == 0.3);
var_dump(abs((0.1 + 0.2) - 0.3) < PHP_FLOAT_EPSILON);

floatを==で比較してはいけません。差を小さな許容値と比べるか、先に両辺を丸めます。金額はセント単位の整数で保存しましょう。

真偽値とfalseになる値

boolはtrueかfalseです。PHPが条件を期待する場所（if、while、!）では、どんな値もboolに変換され、ごく一部の値がfalseとして扱われます：false、0、0.0、""、"0"、[]、null。それ以外はすべてtrueです。次の表は、各値の型、boolへの変換結果、数値かどうかを示しています。

意外なのは"0.0"、" "、"null"です。3つとも"0"以外の空でない文字列なのでtrueになり、if ($value)の中身が実行されます。

配列、オブジェクト、null

配列は、整数か文字列のキーの下にどんな値でも混ぜて持てます。オブジェクトはクラスのインスタンスです。stdClassは手早くオブジェクトを作るためのPHPの空のクラスで、(object)で配列をオブジェクトに変えられます。nullは「値がない」ことを表します。

<?php
$user = ["name" => "Ada", "roles" => ["admin", "editor"]];
echo gettype($user), ": ", $user["name"], "\n";

$point = new stdClass();
$point->x = 3;
$point->y = 4;
echo get_debug_type($point), ": ", $point->x, ",", $point->y, "\n";

$config = (object) ["debug" => true];
echo get_debug_type($config), ": debug is ", var_export($config->debug, true), "\n";

class Product
{
    public function __construct(public string $name, public float $price) {}
}
$p = new Product("Lamp", 25.0);
echo get_debug_type($p), ": {$p->name}\n";

$nothing = null;
var_dump($nothing, is_null($nothing));

is_*関数で型を確認する

型ごとに、trueかfalseを返す判定関数があります。is_numericはis_intとは違い、数値の文字列も受け付けます。フォームの入力を確認するときに欲しいのはこちらです。

<?php
$tests = [5, 5.0, "5", "5.5", " 5", "abc", true, null];

printf("%-7s %-6s %-8s %-9s %-10s\n", "value", "is_int", "is_float", "is_string", "is_numeric");
foreach ($tests as $t) {
    printf(
        "%-7s %-6s %-8s %-9s %-10s\n",
        var_export($t, true),
        is_int($t) ? "yes" : "",
        is_float($t) ? "yes" : "",
        is_string($t) ? "yes" : "",
        is_numeric($t) ? "yes" : ""
    );
}

ほかにis_bool、is_array、is_object、is_null、is_callable、is_iterableがあり、特定のクラスかどうかは$x instanceof ClassNameで調べます。

型の自動変換とstrict_types

演算子が別の型を必要とするとき、PHPは自動で型を変換します。計算に使った数値の文字列は数値になり、.は数値を文字列にします。まったく数値でない文字列は足し算できず、PHP 8はTypeErrorを投げます。

<?php
var_dump("10" + 5);        // int(15)
var_dump("1.5" * 2);       // float(3)
var_dump(10 . " items");   // string
var_dump("10" == "1e1");   // both numeric strings: compared as numbers
var_dump(100 == "1e2");

try {
    var_dump("abc" + 1);
} catch (TypeError $e) {
    echo "TypeError: ", $e->getMessage(), "\n";
}

型付きの引数も変換されますが、ファイルがdeclare(strict_types=1);で始まっている場合は別です。その場合、間違ったスカラー型での呼び出しは変換されずに失敗します。

<?php
declare(strict_types=1);

function addVat(float $net): float
{
    return $net * 1.2;
}

echo addVat(100), "\n";          // int to float is still allowed

try {
    echo addVat("100"), "\n";    // a string is not converted in strict mode
} catch (TypeError $e) {
    echo "TypeError: ", $e->getMessage(), "\n";
}

意図して変換するにはキャストします：(int) "42"、(float) "3.5"、(string) 10、(bool) "0"。すべてのキャストと注意点は型キャストのページにあります。

よくあるミス：異なる型を==で比較する

==は比較の前に変換するので、型の違う2つの値がバグの原因になる形で「等しい」ことがあります。たとえば"1e1" == "10"（どちらも数値の10）やnull == falseです。変換させたいのでなければ、型も一致することを求める===を使いましょう。

<?php
$pairs = [["1e1", "10"], [null, false], [0, ""], ["abc", 0], [1.0, 1]];

foreach ($pairs as [$a, $b]) {
    $show = var_export($a, true) . " vs " . var_export($b, true);
    printf("%-16s ==  %-6s ===  %s\n", $show, var_export($a == $b, true), var_export($a === $b, true));
}

PHP 8で最悪のケースは直りました。"abc" == 0は以前はtrueでしたが、数値でない文字列は文字列として比較されるようになったので、今はfalseです。完全な表は比較演算子のページにあります。