HOWTO · PHP

PHP で整数を文字列に変換する方法

この記事では、PHP で整数を文字列に変換する方法を紹介します。

このページの内容

PHP には、整数を文字列に変換する方法がいくつかあります。最も直接的なのは明示的な (string) キャストで、組み込み関数の strval() も同じ役割を果たします。また PHP は、ダブルクォートで囲んだ文字列の中や連結演算子で値を結合する場合など、文字列が期待される場面では整数を暗黙的に変換するため、変数展開や連結に別の変換呼び出しは必要ありません。以下では各方法を順に示し、続いてどれを選ぶべきかの指針を説明します。

(string) キャストで整数を文字列に変換する

キャストは、対象の型をコード自体に明示します。整数リテラル、または整数を保持する変数の前に (string) を置くと、PHP はその文字列表現を返し、文字列が必要な場所へそのまま格納したり渡したりできます。

次の例を実行します:

このセクションのコードと表示されるラベルや出力は英語のままです。

<?php
$variable = 10;
$string1 = (string)$variable;
echo "The variable is converted to a string and its value is $string1.\n";
?>
The variable is converted to a string and its value is 10.

キャストは明示的なので意図が一目で分かり、結果は実際に string 型になります。gettype($string1) や var_dump() で確認できます。このため、表示するだけでなく本物の文字列値が必要な場合には、(string) が慣用的な選択肢になります。

strval() で整数を文字列に変換する

strval() は、値を文字列に変換する PHP の組み込み関数です。変数を strval($variable) のようにパラメーターとして渡すと、その文字列形式が返されます。整数の場合、返される数字の並びは (string) キャストが生成するものと同じです。

このセクションのコードと表示されるラベルや出力は英語のままです。

<?php
$variable = 10;
$string1 = strval($variable);
echo "The variable is converted to a string and its value is $string1.\n";
?>
The variable is converted to a string and its value is 10.
警告
関数 strval() は配列やオブジェクトには使用できません。その場合、関数は渡されたパラメーターの型名を返します。

ダブルクォートで囲んだ文字列の中で整数を文字列に変換する

PHP は、ダブルクォートで囲まれた文字列に埋め込まれた変数を解析して値に置き換えます。これは変数展開(インターポレーション)と呼ばれる機能です。変数が整数を保持している場合、PHP が自動的に文字列へ変換するため、明示的な変換は不要です。

このセクションのコードと表示されるラベルや出力は英語のままです。

<?php
$variable = 10;
echo "The variable is converted to a string and its value is $variable.\n";
?>
The variable is converted to a string and its value is 10.

変数展開はダブルクォートで囲まれた文字列(およびヒアドキュメント)内でのみ機能します。シングルクォート内の '$variable' はリテラルなテキストであり、10 ではなく $variable とそのまま出力されます。出力するだけでなく変換後の値を保持したい場合は、展開した文字列を代入します。$string1 = "$variable"; とすれば、キャストが生成したのと同じ "10" が得られます。

連結で整数を文字列に変換する

. 演算子は文字列を結合し、PHP の型ジャグリングが整数のオペランドを自動的に変換するため、連結も暗黙的な変換経路の1つです。PHP の文字列連結 の記事では、この演算子をさらに詳しく解説しています。

このセクションのコードと表示されるラベルや出力は英語のままです。

<?php
$variable = 10;
$string1 = "The variable is converted to a string and its value is ".$variable.".";
echo $string1."\n";
?>
The variable is converted to a string and its value is 10.

変換だけが目的なら、整数を空の文字列 "" (文字を持たない文字列)とどちら側からでも連結します。"".$variable と $variable."" のどちらも "10" を返します:

<?php
$variable = 10;
echo "".$variable."\n";
echo $variable.""."\n";
?>
10
10

適切な変換方法を選ぶ

実際の文字列値が必要な場合、つまり値を格納したり、文字列を期待する関数や API に渡したり、後で再利用したりする場合は (string) キャストか strval() を使います。どちらも変換を明示しますが、キャストの方が慣用的でわずかに高速な形式であり、strval() はコードがすでに関数呼び出し中心で書かれている場合に自然に読めます。整数を大きな出力に埋め込むだけなら両方とも不要です。変数展開や . 連結がすでにその場で文字列を生成するため、別の変換ステップを加えても得るものはありません。制限にも留意してください。変数展開にはダブルクォートの文字列が必要で、strval() は配列とオブジェクトを受け付けません。書式を整えた結果が必要なら、sprintf("%d", $variable) のような関数が最終テキストを最も細かく制御できます。