PHP は変数宣言時に明示的な型定義を必要としません。 型を定義しない場合、変数の型は保存する値によって決まります。 これは、変数 $var に文字列を代入した場合、 $var の型は文字列 (string) になることを意味しています。 その後、整数値を $var に代入すると、 その変数の型は整数 (int) になります。
コンテクスト(文脈)によっては、 PHP が値を別の型に自動変換しようとすることがあります。 自動変換が行われる異なるコンテクストが存在するのは、以下のとおりです:
注意: 値を別の型として解釈する必要がある場合でも、 値そのものの型は 変わりません。
変数を強制的にある特定の型として評価させたい場合は、 型キャスト のセクションを参照ください。 ある変数の型を変更したい場合は、settype() を参照ください。
これは、 算術演算子 を使った場合です。
このコンテクストでは、 オペランドのどちらかが float (または整数と解釈できない場合) の場合か、 両方のオペランドが float の場合、 結果の型は float になります。 そうでない場合、オペランドは整数として解釈され、 結果の型も整数になります。 PHP 8.0.0 以降では、いずれかのオペランドが解釈できない場合、 TypeError がスローされます。
これは、 ビット演算子 を使った場合です。
全てのオペランドが文字列の場合、 結果の型も文字列になります。 そうでない場合、 オペランドは整数として解釈され、 結果の型も整数になります。 PHP 8.0.0 以降では、いずれかのオペランドが解釈できない場合、 TypeError がスローされます。
これは、値が型付きの引数、型付きプロパティに渡された場合や、 戻り値の型を宣言している関数から値が返される場合です。
型の自動変換(coercive) モードが有効な場合(デフォルト) には、 スカラー型の値だけが別のスカラー型に変換される可能性があります。 単一の型が宣言されている場合の振る舞いは、以下のとおりです:
内部関数 は、null
を自動的にスカラー型に変換します。
この振る舞いは PHP 8.1.0 以降は 推奨されなくなっています。
型キャストは、変換しようとする型の名前を括弧で括り、 キャストする変数の前に置くことで、値を別の型に変換するものです。
<?php
$foo = 10; // $foo は整数です
$bar = (bool) $foo; // $bar は boolean です
?>
使用可能なキャストを以下に示します:
(int)
- 整数(int) へのキャスト(bool)
- 論理値(bool) へのキャスト(float)
- float へのキャスト(string)
- 文字列(string) へのキャスト(array)
- 配列(array) へのキャスト(object)
- オブジェクト(object) へのキャスト(unset)
- NULL へのキャスト注意:
(integer)
は、(int)
のエイリアスです。(boolean)
は、(bool)
のエイリアスです。(binary)
は、(string)
のエイリアスです。(double)
と(real)
は、(float)
のエイリアスです。 これらのキャストは、正規化された型の名前を使っていません。そのため使うこと自体がおすすめできません。
キャストのエイリアス (real)
を使うことは、PHP 8.0.0 以降は推奨されなくなっています。
(unset)
によるキャストは、
PHP 7.2.0 以降推奨されなくなりました。
(unset)
によるキャストは、
値に NULL 値を代入することと同じです。
(unset)
によるキャストは、PHP 8.0.0 で削除されました。
将来サポートされることを見越して、(binary)
によるキャストと b
プレフィックスが存在しています。
(binary)
と (string)
は現状は等価ですが、将来変更される可能性があります。そのため、現状等価であることに依存すべきではありません。
注意:
キャストの括弧内のホワイトスペースは無視されます。 よって、以下のふたつのキャストは等価です:
<?php
$foo = (int) $bar;
$foo = ( int ) $bar;
?>
以下の例は、リテラル文字列や変数を、バイナリ文字列にキャストします:
<?php
$binary = (binary) $string;
$binary = b"binary string";
?>
注意: ある変数を文字列にキャストする代わりに、 二重引用符で括ることもできます。
<?php
$foo = 10; // $foo は整数です
$str = "$foo"; // $str は文字列です
$fst = (string) $foo; // $fst も文字列です
// これは、"they are the same"を出力します
if ($fst === $str) {
echo "they are the same";
}
?>
型の間でキャストを行う際の動作は、必ずしも明確ではありません。 詳細については、以下の節を参照ください:
注意: PHP では配列の添字と同じ構文を使用した文字列へのアクセスをサポートしているので、次の例はあらゆるバージョンの PHP で成立します:
詳細は、 文字列への文字単位のアクセス を参照ください。<?php
$a = 'car'; // $a は文字列です
$a[0] = 'b'; // $a はここでも文字列です
echo $a; // bar
?>