【PHP8.x】is_string()関数の使い方

Copy
1<?php
2
3/**
4 * is_string関数の基本的な使用例と、null値に対する動作を示すサンプルコード。
5 *
6 * このスクリプトは、異なる型の変数に対してis_string関数を適用し、
7 * それぞれの結果（trueまたはfalse）を表示します。
8 * 特に、null値が文字列とは見なされないことを明確にします。
9 */
10
11// サンプルデータとして、いくつかの異なる型の変数を定義します。
12$stringExample = "Hello, world!"; // 文字列型の変数
13$integerExample = 123;             // 整数型の変数
14$booleanExample = true;            // 真偽値型の変数
15$nullExample = null;               // null値の変数 (キーワードに関連)
16$emptyStringExample = "";          // 空文字列の変数 (これも文字列型)
17
18echo "--- is_string() 関数の結果 ---" . PHP_EOL;
19
20// 各変数に対して is_string 関数を適用し、結果を表示します。
21echo "変数 \$stringExample ('" . $stringExample . "') は文字列ですか？: " . (is_string($stringExample) ? 'はい' : 'いいえ') . PHP_EOL;
22echo "変数 \$integerExample (" . $integerExample . ") は文字列ですか？: " . (is_string($integerExample) ? 'はい' : 'いいえ') . PHP_EOL;
23echo "変数 \$booleanExample (" . ($booleanExample ? 'true' : 'false') . ") は文字列ですか？: " . (is_string($booleanExample) ? 'はい' : 'いいえ') . PHP_EOL;
24echo "変数 \$nullExample (null) は文字列ですか？: " . (is_string($nullExample) ? 'はい' : 'いいえ') . PHP_EOL; // nullに対する動作
25echo "変数 \$emptyStringExample ('" . $emptyStringExample . "') は文字列ですか？: " . (is_string($emptyStringExample) ? 'はい' : 'いいえ') . PHP_EOL;
26
27echo "------------------------------" . PHP_EOL;
28
29// is_string関数の戻り値はboolean型です。
30// var_dump() を使用すると、値とその型を詳しく確認できます。
31echo "is_string() の戻り値の型を確認:" . PHP_EOL;
32var_dump(is_string($stringExample)); // 文字列の場合の戻り値
33var_dump(is_string($nullExample));   // nullの場合の戻り値

PHPのis_string関数は、指定された変数が文字列型であるかを判定するために使用されます。この関数は、引数$valueとして任意の型の値を受け取ります。そして、もし$valueが文字列型であればtrue（真）、そうでなければfalse（偽）という真偽値boolを戻り値として返します。

このサンプルコードは、様々なデータ型の変数に対してis_string関数を適用し、その結果を示しています。例えば、"Hello, world!"のような明らかな文字列や、""のような空の文字列に対してはtrueが返されます。これは、空文字列もPHPでは有効な文字列型として扱われるためです。

一方、123のような整数、trueのような真偽値、そしてキーワードにもあるnull値に対してはfalseが返されます。is_string関数はnullを文字列とは見なさないため、この点は特に重要です。

コードの最後では、var_dump関数を使ってis_stringの戻り値が実際にboolean型であることを確認しています。このようにis_string関数は、プログラムで変数の型を正確にチェックし、予期せぬエラーを防ぐための基本的なツールとして活用されます。

Copy
1<?php
2
3/**
4 * is_string() 関数の使い方をデモンストレーションします。
5 * この関数は、指定された変数が厳密に文字列型であるかをチェックします。
6 * 'stringable' (PHP 8のStringableインターフェースを実装または__toString()メソッドを持つオブジェクト)
7 * とは異なる点に注意してください。is_string() は厳密な型チェックを行います。
8 *
9 * @param mixed $value チェック対象の値
10 * @return void
11 */
12function checkStringType(mixed $value): void
13{
14    // 変数の実際の型を取得
15    $type = gettype($value);
16    // is_string() 関数で文字列型であるかを確認
17    $isStringResult = is_string($value);
18
19    // デモンストレーション用に値を整形して表示
20    $displayValue = match (true) {
21        is_string($value) => "'" . $value . "'",
22        is_int($value), is_float($value) => (string)$value,
23        is_bool($value) => $value ? 'true' : 'false',
24        is_array($value) => 'array',
25        is_object($value) => get_class($value) . ' object',
26        is_null($value) => 'NULL',
27        default => 'unknown type',
28    };
29
30    echo "値: {$displayValue} (gettype(): '{$type}') -> is_string() の結果: " . ($isStringResult ? 'true' : 'false') . PHP_EOL;
31}
32
33// --- デモンストレーション ---
34
35// 1. 文字列型の変数
36$stringValue = "Hello, PHP!";
37// 2. 整数型の変数
38$integerValue = 123;
39// 3. 浮動小数点数型の変数
40$floatValue = 1.23;
41// 4. 真偽値型の変数
42$booleanValue = true;
43// 5. 配列型の変数
44$arrayValue = ['a', 'b'];
45// 6. NULL値
46$nullValue = null;
47
48// 7. PHP 8 で導入された Stringable インターフェースを実装するオブジェクトの例
49//    このオブジェクトは文字列に変換可能ですが、データ型は 'object' です。
50$stringableObject = new class implements Stringable {
51    public function __toString(): string
52    {
53        return "私はStringableオブジェクトです。";
54    }
55};
56
57echo "--- is_string() 関数のデモンストレーション ---" . PHP_EOL;
58
59// 各変数をチェックし、is_string() の結果を出力
60checkStringType($stringValue);
61checkStringType($integerValue);
62checkStringType($floatValue);
63checkStringType($booleanValue);
64checkStringType($arrayValue);
65checkStringType($nullValue);
66checkStringType($stringableObject); // Stringableオブジェクトであっても、is_string() は false を返す
67
68echo PHP_EOL;
69// 補足:
70// is_string() は変数のデータ型が 'string' であるかのみを判定します。
71// PHP 8 で導入された Stringable インターフェースを実装する、または __toString() メソッドを持つオブジェクトは、
72// 文字列に変換可能 (stringable) ですが、その型は 'object' であり 'string' ではないため、
73// is_string() は false を返します。
74// オブジェクトが文字列に変換可能であるかをチェックするには、PHP 8 以降では `instanceof Stringable` で確認するのが一般的です。
75

PHPのis_string()関数は、指定された変数が厳密に文字列型であるかどうかを判定します。この関数は引数として任意の型の値を受け取り、その値が文字列型であればtrue、そうでなければfalseを真偽値で返します。

提供されたサンプルコードでは、checkStringType関数がさまざまなデータ型の値（文字列、整数、真偽値、配列、NULLなど）に対してis_string()関数を適用した場合の結果を具体的にデモンストレーションしています。

特に注目すべきは、「stringable」なオブジェクトとの違いです。PHP 8以降で導入されたStringableインターフェースを実装する、または__toString()メソッドを持つオブジェクトは、文字列に変換可能（stringable）ですが、is_string()はこれらのオブジェクトに対してfalseを返します。これは、is_string()が変数の実際のデータ型が「string」であるかを厳密にチェックするためです。オブジェクトの型はあくまで「object」であり、たとえ文字列として扱えても、データ型そのものは文字列ではありません。

したがって、変数のデータ型が厳密に文字列であるかを確認したい場合にis_string()を使用し、オブジェクトが文字列に変換可能であるかを確認したい場合は、PHP 8以降ではinstanceof Stringableを使用するのが一般的です。

Copy
1<?php
2
3/**
4 * 変数が文字列型であり、かつ空でないかをチェックする関数。
5 * is_string() と !empty() の基本的な使い方を示します。
6 *
7 * @param mixed $value チェックする値
8 * @return bool 値が文字列型であり、かつ空でない場合にtrueを返します
9 */
10function isNonEmptyString(mixed $value): bool
11{
12    // is_string() は、変数が文字列型である場合に true を返します。
13    // !empty() は、変数が「空ではない」場合に true を返します。
14    // ここでいう「空」とは、空文字列 ('')、0、false、null、空の配列 [] などが含まれます。
15    // この関数は、変数が文字列型であり、かつその文字列が空でないことを確認します。
16    return is_string($value) && !empty($value);
17}
18
19// サンプル値の定義
20$stringData = "Hello, PHP!";
21$emptyString = "";
22$whitespaceString = "   "; // スペースだけの文字列
23$integerData = 123;
24$nullData = null;
25$booleanData = true;
26
27// 各サンプル値で関数をテストし、結果を出力
28echo "--- isNonEmptyString() 関数のテスト ---" . PHP_EOL;
29
30echo "値: '" . $stringData . "'" . PHP_EOL;
31echo "結果: " . (isNonEmptyString($stringData) ? "文字列かつ空ではない" : "文字列ではない、または空である") . PHP_EOL . PHP_EOL;
32
33echo "値: '" . $emptyString . "' (空文字列)" . PHP_EOL;
34echo "結果: " . (isNonEmptyString($emptyString) ? "文字列かつ空ではない" : "文字列ではない、または空である") . PHP_EOL . PHP_EOL;
35
36echo "値: '" . $whitespaceString . "' (スペースのみの文字列)" . PHP_EOL;
37echo "結果: " . (isNonEmptyString($whitespaceString) ? "文字列かつ空ではない" : "文字列ではない、または空である") . PHP_EOL . PHP_EOL;
38
39echo "値: " . $integerData . " (整数)" . PHP_EOL;
40echo "結果: " . (isNonEmptyString($integerData) ? "文字列かつ空ではない" : "文字列ではない、または空である") . PHP_EOL . PHP_EOL;
41
42echo "値: null" . PHP_EOL;
43echo "結果: " . (isNonEmptyString($nullData) ? "文字列かつ空ではない" : "文字列ではない、または空である") . PHP_EOL . PHP_EOL;
44
45echo "値: " . ($booleanData ? "true" : "false") . " (真偽値)" . PHP_EOL;
46echo "結果: " . (isNonEmptyString($booleanData) ? "文字列かつ空ではない" : "文字列ではない、または空である") . PHP_EOL . PHP_EOL;
47
48?>

このサンプルコードは、PHPのis_string関数と!empty関数を組み合わせることで、変数が「文字列型であり、かつ空ではない」ことを厳密にチェックする方法を示しています。

まず、is_string関数は、引数として渡された値が「文字列型」であるかどうかを判定します。文字列型であればtrueを、そうでなければfalseを返します。これにより、対象のデータが数値や真偽値などではなく、確実に文字列であることを確認できます。

次に、!emptyは、変数が「空ではない」場合にtrueを返します。PHPにおいて「空」と判断される値は多岐にわたり、具体的には空文字列 ('')、null、論理値のfalse、数値の0などが含まれます。

サンプルコード内のisNonEmptyString関数は、これら二つの条件を論理AND演算子&&で結合しています。引数が「文字列型である」かつ「空ではない」の両方を満たす場合にのみtrueを返します。これにより、例えば空文字列やnull、整数などはfalseとなりますが、スペースのみの文字列はtrueと判定されます。

このようなチェックは、Webフォームからの入力値のバリデーションや、データベースから取得したデータが有効な文字列であるかを確認するなど、システム開発において非常に重要な場面で利用されます。

Copy
1<?php
2
3/**
4 * is_string() 関数の動作を様々なデータ型でデモンストレーションします。
5 * 特に、数値形式の文字列がどのように扱われるかを示します。
6 */
7function demonstrateIsStringFunction(): void
8{
9    echo "--- PHP is_string() 関数のデモンストレーション ---" . PHP_EOL;
10    echo "この関数は、引数が文字列型である場合に true を、それ以外の場合に false を返します。" . PHP_EOL . PHP_EOL;
11
12    // 検証用の様々なデータ型を定義
13    $stringValue = "Hello World";      // 標準的な文字列
14    $emptyString = "";                 // 空文字列
15    $numericString = "12345";          // 数値形式の文字列
16    $floatString = "3.14";             // 浮動小数点数形式の文字列
17    $negativeNumericString = "-100";   // 負の数値形式の文字列
18    $intValue = 123;                   // 整数型
19    $floatValue = 3.14;                // 浮動小数点数型
20    $boolValue = true;                 // 真偽値型
21    $nullValue = null;                 // NULL型
22    $arrayValue = ['apple', 'banana']; // 配列型
23    $objectValue = new stdClass();     // オブジェクト型
24
25    // 各値に対して is_string() を適用し、結果を出力
26    // (is_string() の結果は `true` または `false` なので、三項演算子で表示を分かりやすくしています)
27
28    echo "値: '" . $stringValue . "'" . PHP_EOL;
29    echo "  is_string(): " . (is_string($stringValue) ? 'true' : 'false') . PHP_EOL . PHP_EOL;
30
31    echo "値: '" . $emptyString . "' (空文字列)" . PHP_EOL;
32    echo "  is_string(): " . (is_string($emptyString) ? 'true' : 'false') . PHP_EOL . PHP_EOL;
33
34    echo "値: '" . $numericString . "' (数値形式の文字列)" . PHP_EOL;
35    echo "  is_string(): " . (is_string($numericString) ? 'true' : 'false') . PHP_EOL;
36    echo "  補足: この値は '文字列' です。is_numeric() 関数では true を返しますが、型はあくまで string です。" . PHP_EOL . PHP_EOL;
37
38    echo "値: '" . $floatString . "' (浮動小数点数形式の文字列)" . PHP_EOL;
39    echo "  is_string(): " . (is_string($floatString) ? 'true' : 'false') . PHP_EOL;
40    echo "  補足: この値も '文字列' です。is_numeric() 関数では true を返しますが、型はあくまで string です。" . PHP_EOL . PHP_EOL;
41
42    echo "値: '" . $negativeNumericString . "' (負の数値形式の文字列)" . PHP_EOL;
43    echo "  is_string(): " . (is_string($negativeNumericString) ? 'true' : 'false') . PHP_EOL . PHP_EOL;
44
45    echo "値: " . $intValue . " (整数)" . PHP_EOL;
46    echo "  is_string(): " . (is_string($intValue) ? 'true' : 'false') . PHP_EOL . PHP_EOL;
47
48    echo "値: " . $floatValue . " (浮動小数点数)" . PHP_EOL;
49    echo "  is_string(): " . (is_string($floatValue) ? 'true' : 'false') . PHP_EOL . PHP_EOL;
50
51    echo "値: " . ($boolValue ? 'true' : 'false') . " (真偽値)" . PHP_EOL;
52    echo "  is_string(): " . (is_string($boolValue) ? 'true' : 'false') . PHP_EOL . PHP_EOL;
53
54    echo "値: NULL" . PHP_EOL;
55    echo "  is_string(): " . (is_string($nullValue) ? 'true' : 'false') . PHP_EOL . PHP_EOL;
56
57    echo "値: 配列 ([...])" . PHP_EOL;
58    echo "  is_string(): " . (is_string($arrayValue) ? 'true' : 'false') . PHP_EOL . PHP_EOL;
59
60    echo "値: オブジェクト (stdClass)" . PHP_EOL;
61    echo "  is_string(): " . (is_string($objectValue) ? 'true' : 'false') . PHP_EOL . PHP_EOL;
62}
63
64// デモンストレーション関数を実行
65demonstrateIsStringFunction();

PHPのis_string関数は、指定された変数が文字列型であるかどうかを判定する際に使用します。この関数は、引数として任意の型の値（mixed $value）を受け取り、その値が文字列型であればtrue（真）を、それ以外の場合はfalse（偽）を真偽値（bool）として返します。

この関数は、通常のテキスト文字列はもちろんのこと、空の文字列（""）に対してもtrueを返します。特に、"123"や"3.14"のように、見た目が数値であってもダブルクォーテーションやシングルクォーテーションで囲まれた「数値形式の文字列」に対してもtrueを返します。これは、PHPがそれらをあくまで「文字列」というデータ型として認識しているためです。数値形式の文字列が本当に数値として扱えるかを確認したい場合は、is_numeric()関数を使用するなど、目的に応じて適切な関数を使い分けることが重要です。

一方、数値型（整数や浮動小数点数）、真偽値、NULL、配列、オブジェクトなど、文字列型以外の値に対してはfalseを返します。変数の型を正確に把握し、プログラムの誤動作を防ぐために役立つ基本的な関数です。