【PHP8.x】is_array()関数の使い方
is_array関数の使い方について、初心者にもわかりやすく解説します。
基本的な使い方
is_array関数は、指定された変数が配列（array型）であるかどうかを検査し、その結果を真偽値（trueまたはfalse）で返す関数です。この関数はPHPの標準的な機能として提供されており、プログラム内で変数の型を安全に確認するために頻繁に利用されます。
具体的には、is_array関数は引数として一つの変数を受け取ります。もしその変数がPHPのデータ型の一つである「配列」として認識される場合、この関数は真（true）を返します。反対に、変数が配列ではない場合、例えば整数、文字列、オブジェクト、nullなどであった場合は偽（false）を返します。
この関数を使用することで、後続の処理で配列として扱われるべき変数が実際に配列であるかを事前に確認できます。これにより、意図しない型のデータに対して配列操作を行って発生するエラー（TypeErrorなど）を未然に防ぎ、堅牢で安定したプログラムを作成することが可能になります。特に、ユーザーからの入力や外部システムからのデータを受け取る際に、データの整合性をチェックする上で非常に役立ちます。変数の型チェックを行うことは、安全なプログラミングの基本であり、is_arrayはそのための基本的なツールの一つとして広く活用されています。
構文(syntax)
1<?php 2$value_is_array = [1, 2, 3]; 3$result_true = is_array($value_is_array); 4 5$value_is_string = "hello"; 6$result_false = is_array($value_is_string); 7?>
引数(parameters)
mixed $value
- mixed $value: 配列かどうかを判定したい値
戻り値(return)
bool
指定された変数が配列である場合に true を、そうでない場合に false を返します。
サンプルコード
PHPで連想配列かどうかを判定する
1<?php 2 3/** 4 * 連想配列かどうかを判定するサンプルコード 5 */ 6 7// 連想配列の例 8$assoc_array = [ 9 "name" => "John", 10 "age" => 30, 11 "city" => "New York" 12]; 13 14// 通常の配列の例 15$numeric_array = ["apple", "banana", "orange"]; 16 17// is_array関数で配列かどうかを判定 18if (is_array($assoc_array)) { 19 echo "assoc_array は配列です。\n"; 20} else { 21 echo "assoc_array は配列ではありません。\n"; 22} 23 24if (is_array($numeric_array)) { 25 echo "numeric_array は配列です。\n"; 26} else { 27 echo "numeric_array は配列ではありません。\n"; 28} 29 30// 文字列の例 31$not_array = "This is a string"; 32 33if (is_array($not_array)) { 34 echo "not_array は配列です。\n"; 35} else { 36 echo "not_array は配列ではありません。\n"; 37}
PHPのis_array()関数は、与えられた変数が配列かどうかを判定するために使用します。引数には任意の型の変数 $value を指定します。この関数は、$value が配列の場合には true (真) を、そうでない場合には false (偽) を返します。
このサンプルコードでは、連想配列 $assoc_array、数値添字配列 $numeric_array、そして文字列 $not_array の3つの変数を用意しています。is_array()関数を使って、これらの変数がそれぞれ配列かどうかを判定し、その結果をechoで出力しています。
$assoc_array は、キーと値のペアを持つ連想配列の例です。$numeric_array は、0から始まる数値の添字を持つ通常の配列です。$not_array は配列ではない文字列の例です。
is_array($assoc_array)はtrueを返し、"assoc_array は配列です。"と出力されます。同様に、is_array($numeric_array)もtrueを返し、"numeric_array は配列です。"と出力されます。一方、is_array($not_array)はfalseを返し、"not_array は配列ではありません。"と出力されます。
この関数を使うことで、変数の型をチェックし、配列として処理できるかどうかを事前に確認できます。配列を扱う処理を行う前に、is_array()で型を確認することで、エラーを未然に防ぐことができます。
is_array()関数は、変数が配列かどうかを判定します。連想配列も通常の配列も、PHPでは区別なく配列として扱われるため、どちらもis_array()はtrueを返します。is_array()は、変数が本当に配列型であるかをチェックするものであり、配列の中身がどうなっているかは関係ありません。配列かどうかを厳密に判定したい場合に役立ちます。文字列や数値などの配列以外の変数を渡すと、falseが返ります。型を意識したプログラミングを心がけましょう。
PHP is_array で配列を判定する
1<?php 2 3/** 4 * 変数が配列かどうかをチェックするサンプルコード 5 */ 6function checkArrayType($value): void 7{ 8 if (is_array($value)) { 9 echo "変数は配列です。\n"; 10 } else { 11 echo "変数は配列ではありません。\n"; 12 } 13} 14 15// 配列の例 16$array_example = [1, 2, 3]; 17checkArrayType($array_example); // 出力: 変数は配列です。 18 19// 文字列の例 20$string_example = "これは文字列です"; 21checkArrayType($string_example); // 出力: 変数は配列ではありません。 22 23// 整数の例 24$integer_example = 123; 25checkArrayType($integer_example); // 出力: 変数は配列ではありません。
PHP 8のis_array()関数は、変数が配列かどうかを判定するために使用されます。この関数は引数として任意の型の変数 $value を受け取り、$value が配列であれば true、そうでなければ false を返します。
上記のサンプルコードでは、checkArrayType() という関数を定義し、is_array() 関数を使って変数の型をチェックしています。checkArrayType() 関数は、引数として受け取った変数が配列かどうかを is_array() で判定し、その結果に応じてメッセージを表示します。
具体的には、配列の例として $array_example = [1, 2, 3]; を checkArrayType() に渡すと、「変数は配列です。」と出力されます。一方、文字列 $string_example = "これは文字列です"; や整数 $integer_example = 123; を渡すと、「変数は配列ではありません。」と出力されます。
この例から、is_array() 関数は変数の型を安全にチェックし、配列に対する処理を行う前に型を確認する際に非常に役立つことがわかります。例えば、配列に対してのみ有効な関数を実行する前に、is_array() を使用して変数が配列であることを確認することで、エラーを未然に防ぐことができます。
is_array()関数は、変数が配列かどうかを判定します。この関数を使う際、変数の型を誤って認識していると、意図しない結果になることがあります。例えば、オブジェクトを配列と勘違いしないように注意が必要です。また、空の配列（[]）もis_array()関数はtrueを返します。処理によっては、配列の中身が空かどうかを別途確認する必要があります。is_array()は型チェックを行う関数であり、変数の内容まではチェックしないことを覚えておきましょう。
PHPのis_array()でnullを判定する
1<?php 2 3/** 4 * is_array()関数の動作を様々な型の変数でテストする関数。 5 * 6 * この関数は、システムエンジニアを目指す初心者向けに、 7 * 変数が配列であるかどうかを判定するis_array()関数の使い方を実演します。 8 * 特に、null値が配列ではないことを明確に示します。 9 */ 10function testIsArrayWithVariousTypes(): void 11{ 12 // 配列の例 13 $anArray = [1, 2, 3]; 14 echo "変数 \$anArray ([1, 2, 3]) は配列ですか？ " . (is_array($anArray) ? "はい" : "いいえ") . "\n"; 15 16 // 文字列の例 17 $aString = "Hello PHP"; 18 echo "変数 \$aString (\"Hello PHP\") は配列ですか？ " . (is_array($aString) ? "はい" : "いいえ") . "\n"; 19 20 // nullの例 (キーワードに最も関連性の高い部分) 21 $aNull = null; 22 echo "変数 \$aNull (null) は配列ですか？ " . (is_array($aNull) ? "はい" : "いいえ") . "\n"; 23 24 // 整数の例 25 $anInteger = 123; 26 echo "変数 \$anInteger (123) は配列ですか？ " . (is_array($anInteger) ? "はい" : "いいえ") . "\n"; 27 28 // 空の配列の例 29 $emptyArray = []; 30 echo "変数 \$emptyArray ([]) は配列ですか？ " . (is_array($emptyArray) ? "はい" : "いいえ") . "\n"; 31} 32 33// 関数を実行して結果を表示 34testIsArrayWithVariousTypes();
このPHPのサンプルコードは、is_array()関数が変数の型をどのように判定するかを実演しています。is_array()関数は、引数mixed $valueとして渡された変数が配列であるかどうかを調べ、その結果を真偽値のbool（trueまたはfalse）で返します。引数$valueには任意の型の値を指定できますが、戻り値は変数の型が「配列」であるかどうかに基づきます。
コードでは、[1, 2, 3]のような通常の配列や、[]のような空の配列がis_array()によって「はい」（true）と判定されることが示されています。一方で、"Hello PHP"のような文字列、123のような整数、そして特にnull値はすべて配列ではないため、「いいえ」（false）と判定されることが確認できます。これは、is_array()関数が、変数の内容ではなく、そのデータ型が「配列」であるかを厳密に判断しているためです。システム開発において、変数が特定の型であることを確認し、予期せぬエラーを防ぐためにも非常に役立つ関数です。
is_array()関数は、与えられた変数が「配列型」であるかを厳密に判定します。サンプルコードで確認できるように、null値は配列ではありませんので、is_array(null)はfalseを返します。これに対し、要素が一つもない「空の配列[]」は配列と判定され、is_array([])はtrueを返します。このnullと空の配列の違いは初心者が混同しやすい点ですので、特に注意が必要です。文字列や数値、オブジェクトなど、配列以外の型はすべてfalseと判定されます。この関数は、プログラムが予期せぬエラーを起こさないよう、変数の型を事前に確認して適切な処理を行うために非常に役立ちます。
PHP: 配列かつキー存在チェック
1<?php 2 3/** 4 * 指定された変数が配列であるか、かつ指定されたキーがその配列内に存在するかをチェックします。 5 * この関数は、is_array() と array_key_exists() の基本的な使用方法を 6 * システムエンジニアを目指す初心者の方向けに示します。 7 * 8 * @param mixed $value チェックする対象の変数（配列、文字列、数値など何でも可） 9 * @param string $key 配列内に存在するかを確認するキー 10 * @return void 11 */ 12function checkIfArrayAndKeyExists(mixed $value, string $key): void 13{ 14 echo "--- チェック開始: 対象変数とキー '{$key}' ---\n"; 15 16 // 1. まず、渡された $value が本当に配列であるかを is_array() 関数で確認します。 17 // is_array() は、変数の型が配列であれば true を、そうでなければ false を返します。 18 if (is_array($value)) { 19 echo " is_array() 結果: 値は配列です。次のステップとしてキーの存在をチェックします。\n"; 20 21 // 2. $value が配列であることが確認できた場合のみ、 22 // array_key_exists() 関数を使って指定された $key がその配列内に存在するかを確認します。 23 // array_key_exists() は、キーが存在すれば true を、そうでなければ false を返します。 24 if (array_key_exists($key, $value)) { 25 echo " array_key_exists() 結果: キー '{$key}' は配列内に存在します。\n"; 26 echo " 最終判定: はい、変数は配列であり、キー '{$key}' も存在します。\n"; 27 } else { 28 echo " array_key_exists() 結果: キー '{$key}' は配列内に存在しません。\n"; 29 echo " 最終判定: いいえ、変数は配列ですが、キー '{$key}' は存在しません。\n"; 30 } 31 } else { 32 // $value が配列ではなかった場合、キーの存在をチェックする意味がないため、その旨を伝えます。 33 echo " is_array() 結果: 値は配列ではありません。\n"; 34 echo " 最終判定: いいえ、変数が配列ではないため、キー '{$key}' の存在は確認できません。\n"; 35 } 36 echo "---------------------------------------------------\n\n"; 37} 38 39// --- サンプル実行例 --- 40 41// ケース1: 配列であり、指定されたキー ('name') も存在する 42$userInfo = [ 43 'name' => 'アリス', 44 'age' => 30, 45 'city' => '東京', 46]; 47checkIfArrayAndKeyExists($userInfo, 'name'); 48 49// ケース2: 配列であるが、指定されたキー ('email') が存在しない 50$productInfo = [ 51 'id' => 101, 52 'name' => 'PHP本', 53 'price' => 2500, 54]; 55checkIfArrayAndKeyExists($productInfo, 'email'); 56 57// ケース3: 配列ではない文字列をチェックする場合 58$notAnArrayString = "これは配列ではありません。"; 59checkIfArrayAndKeyExists($notAnArrayString, 'length'); 60 61// ケース4: 配列ではない数値をチェックする場合 62$notAnArrayNumber = 12345; 63checkIfArrayAndKeyExists($notAnArrayNumber, 'value'); 64 65?>
このPHPサンプルコードは、変数が配列であるか、さらにその配列内に特定のキーが存在するかを安全に確認する方法を、is_array()関数とarray_key_exists()関数を用いて示しています。
is_array(mixed $value)関数は、引数$valueとして渡された変数が配列であるかを判定します。配列であればtrueを、そうでなければfalseを戻り値として返します。このコードでは、まずこの関数で値が本当に配列なのかを最初に確認しています。
次に、array_key_exists(string $key, mixed $array)関数は、指定された$array内に$keyが存在するかどうかを判定します。キーが存在すればtrueを、存在しなければfalseを戻り値として返します。この関数は、is_array()で値が配列であることが確認できた場合にのみ使用することで、存在しない配列に対してキーを検索する際のエラーを防ぎ、堅牢なコードを記述できます。
サンプルコード内のcheckIfArrayAndKeyExists関数は、まずis_array()で対象の値が配列であるかを確認します。配列であった場合にのみ、array_key_exists()で指定されたキーの存在を確認し、それぞれの判定結果に応じたメッセージを出力します。これにより、データが期待する構造を持っているかを効率的かつ安全に検証するプログラミングの基礎を学べます。提供されている複数の実行例で、これらの関数の挙動を具体的に確認できます。
このサンプルコードは、変数が配列であるかを確認するis_array()と、配列内に特定のキーが存在するかを確認するarray_key_exists()の安全な利用方法を示しています。特に注意すべき点は、is_array()でまず変数の型が配列であることを確認することです。PHP 8以降では、この確認をせずにarray_key_exists()の第二引数に配列以外の値を渡すと、TypeErrorが発生します。array_key_exists()は、キーが存在すればそのキーに対応する値がnullであってもtrueを返します。そのため、キーが存在することと、そのキーに具体的な値がセットされていることとは異なります。このコード例のように二段階でチェックするアプローチは、予期せぬエラーを防ぎ、より堅牢なプログラムを作成するために推奨されます。