配列

PHPのin_array関数について解説 – 配列内検索の基本と使用例

2025-02-19更新日: 2025-02-19

PHPのin_array関数は、配列内に指定した値があるかどうかを確認するために使います。

第二引数に調査対象の配列を指定し、第三引数で厳密な比較を行うか選択できるため、用途に応じた使い分けが可能です。

この記事では、基本的な使い方と比較オプションの注意点をわかりやすく解説します。

目次から探す

in_array関数の基本仕様
in_array関数の利用例
- シンプルな使用例
- 応用的な使用例
in_array関数使用時の注意事項
- 厳密比較の取り扱い
- 想定外の結果を防ぐポイント
まとめ

in_array関数の基本仕様

関数の役割と動作

PHPのin_array関数は、指定された値(needle)が配列(haystack)内に存在するかどうかを調べるための機能です。

この関数は、見つかった場合はtrue、見つからなかった場合はfalseを返します。

コード内で値の存在確認や条件分岐に利用することで、処理の流れを簡潔に記述できる点が魅力です。

引数の詳細

$needle(検索する値)

この引数は、配列内から探す対象の値を指定します。

例えば、文字列、数値、またはその他のデータ型を指定できます。

以下は、$needleに数値を指定した簡単な例です。

<?php
// 検索する値(needle)は数値5
$needle = 5;
?>

$haystack(対象の配列)

この引数は、検索対象となる配列を指定します。

配列は、値の集合であり、任意の型の要素を含むことができます。

例えば、以下のように宣言された配列が対象となります。

<?php
// 検索対象の配列(haystack)には複数の数値が含まれる
$haystack = [1, 3, 5, 7, 9];
?>

$strict(厳密比較オプション)

このオプションは、値の比較方法を決定するための引数です。

デフォルトではfalseとなり、型の違いを無視した比較が行われますが、trueに設定すると型も含めた厳密な比較が実施されます。

厳密比較を有効にすると、例えば文字列の”5″と数値の5は区別されます。

<?php
// 厳密比較を有効にする例
$result = in_array(5, $haystack, true);
?>

戻り値の確認

in_array関数は、値が配列内に存在する場合にtrue、存在しない場合にfalseを返します。

チェック結果をそのままif分などの条件式に利用できるため、実用性が非常に高いです。

例として、次のコードは数値5が配列内に存在するかを確認します。

<?php
// 数値が配列内に存在するかをチェックするサンプルコード
$needle = 5;
$haystack = [1, 3, 5, 7, 9];
if (in_array($needle, $haystack)) {
    echo "見つかりました";
} else {
    echo "見つかりませんでした";
}
?>

見つかりました

in_array関数の利用例

シンプルな使用例

文字列や数値の検索

シンプルな例として、配列に含まれる文字列または数値を対象にチェックする方法を紹介します。

以下の例では、配列内に特定の文字列が存在するかを確認しています。

<?php
// 文字列を含む配列から検索する例
$needle = "apple";
$haystack = ["orange", "banana", "apple", "grape"];
$result = in_array($needle, $haystack);
echo $result ? "appleが見つかりました" : "appleは見つかりませんでした";
?>

appleが見つかりました

また、数値を対象とする場合も同様に利用できます。

デフォルトの比較方法であれば、型の違いによる影響を受けることもありますが、基本的な検索には十分対応できます。

<?php
// 数値を含む配列から検索する例
$needle = 10;
$haystack = [5, 10, 15, 20];
$result = in_array($needle, $haystack);
echo $result ? "10が見つかりました" : "10は見つかりませんでした";
?>

10が見つかりました

応用的な使用例

複雑な配列からの検索

複雑な配列、例えば多次元配列や連想配列が存在する場合、in_array関数は第一階層の値に対して機能します。

例えば、連想配列の値部分のみを対象に検索を実施する際の工夫が必要になるケースもあります。

<?php
// 連想配列から特定の値を検索する例
$data = [
    ["name" => "Alice", "age" => 25],
    ["name" => "Bob", "age" => 30],
    ["name" => "Charlie", "age" => 35]
];
// 配列の中のage値を取り出して検索
$ages = array_column($data, "age");
$needle = 30;
$result = in_array($needle, $ages);
echo $result ? "年齢30が存在します" : "年齢30は存在しません";
?>

年齢30が存在します

型変換を伴う比較のケース

型変換が自動で行われるデフォルトの動作では、数値と文字列などの型の違いによる予期しない結果が発生する場合があります。

このようなケースでは、第三引数にtrueを指定して厳密比較を利用することで、確実な判定が行えます。

<?php
// 厳密比較を利用した例
$needle = 5;      // 数値の5
$haystack = ["5", 10, 15];
$result_loose = in_array($needle, $haystack);       // デフォルトの比較(型を無視)
$result_strict = in_array($needle, $haystack, true);  // 厳密比較
echo "デフォルト比較: " . ($result_loose ? "見つかりました" : "見つかりません") . "\n";
echo "厳密比較: " . ($result_strict ? "見つかりました" : "見つかりません");
?>

デフォルト比較: 見つかりました
厳密比較: 見つかりません

in_array関数使用時の注意事項

厳密比較の取り扱い

型の違いによる挙動の差異

厳密比較が有効な場合、数値と文字列など、異なる型の値は異なるものとして扱われます。

このため、例えば5と"5"は厳密比較では一致しません。

注意点として、特に外部からの入力を受ける際には型に注意して使用することが重要です。

<?php
// 厳密比較を用いない場合
$needle = 5;
$haystack = ["5", "15", "25"];
$result_default = in_array($needle, $haystack);       // 型変換が行われる
$result_strict  = in_array($needle, $haystack, true);   // 厳密比較
echo "デフォルト比較: " . ($result_default ? "一致" : "不一致") . "\n";
echo "厳密比較: " . ($result_strict ? "一致" : "不一致");
?>

デフォルト比較: 一致
厳密比較: 不一致

想定外の結果を防ぐポイント

比較条件の設定方法

in_array関数使用時は、特に第三引数の設定に注意する必要があります。

厳密比較を有効にすることで、型の違いによる誤判定を防止することができます。

また、対象配列の構造が複雑な場合は、事前に必要な値のみを抽出するなどの対策が効果的です。

<?php
// 対象配列から必要な値を事前に抽出してから検索を実施する例
$users = [
    ["username" => "user1", "status" => "active"],
    ["username" => "user2", "status" => "inactive"],
    ["username" => "user3", "status" => "active"]
];
// statusのみを取り出す
$statuses = array_column($users, "status");
$needle = "active";
$result = in_array($needle, $statuses, true);
echo $result ? "activeなユーザーが存在します" : "activeなユーザーはいません";
?>