PHPで配列のキーが存在するか確認する方法：array_key_existsとissetの使い分け

2026年5月27日

基礎知識

PHPでプログラムを開発する際、配列の中に特定のキーが存在するかどうかを確認する処理は非常に頻繁に登場します。

PHPには配列のキーを確認するための手段として、主にarray_key_exists関数とisset関数が用意されています。

これらの関数は似たような役割を果たしますが、実は挙動やパフォーマンスに大きな違いがあることをご存じでしょうか。

適切な使い分けができていないと、意図しないバグを引き起こしたり、プログラムの実行速度を低下させたりする原因になります。

この記事では、PHP 8.x以降の最新の仕様も踏まえながら、これらの関数の違いと最適な活用シーンについて詳しく掘り下げていきます。

目次 [ close ]

array_key_exists関数の基本と使い方

array_key_existsは、指定したキーまたは添字が配列の中に存在するかどうかを調べるための関数です。

この関数の最大の特徴は、「値が何であるかに関わらず、キーの存在だけを純粋に確認する」点にあります。

基本的な構文は、第一引数に検索したいキー、第二引数に対象の配列を指定します。

PHP

<?php
// サンプル配列の定義
$user = [
    'name' => '田中太郎',
    'age' => 25,
    'occupation' => null // 値がnullのキー
];

// array_key_existsを使用してキーの存在を確認
if (array_key_exists('name', $user)) {
    echo "名前のキーが存在します。\n";
}

if (array_key_exists('occupation', $user)) {
    echo "職業のキーが存在します（値がnullでも検知可能）。\n";
}
?>

実行結果

名前のキーが存在します。
職業のキーが存在します（値がnullでも検知可能）。

上記のコードからわかるように、たとえ値がnullであっても、キーさえ定義されていればtrueを返します。

これは、設定ファイルやデータベースのレコードなどで、「値が未設定（null）」であることを保持しておきたい場合に非常に有用です。

isset関数の特徴と配列への活用

一方、issetは、変数が宣言されており、かつその値がnullではないことを確認するための言語構造です。

配列のキーチェックにも利用可能ですが、厳密には「キーの存在確認」ではなく「値の有効性確認」としての側面が強くなります。

以下のサンプルコードで、その動作を確認してみましょう。

PHP

<?php
// サンプル配列の定義
$config = [
    'timeout' => 30,
    'debug' => null
];

// issetを使用して確認
if (isset($config['timeout'])) {
    echo "timeoutは設定されており、nullではありません。\n";
}

if (isset($config['debug'])) {
    echo "debugは設定されています。\n";
} else {
    echo "debugは未設定、もしくはnullです。\n";
}
?>

実行結果

timeoutは設定されており、nullではありません。
debugは未設定、もしくはnullです。

注目すべきは、$config['debug']に対する結果です。

配列内にキー自体は存在していますが、値がnullであるため、issetはfalseを返します。

「キーが存在しない場合」と「値がnullの場合」を区別しないのがissetの大きな特徴です。

array_key_existsとissetの決定的な違い

これら2つの手法の使い分けを理解するために、主要な相違点を整理してみましょう。

最も重要な違いは、先ほども触れた「値がnullのときの挙動」です。

NULL値が含まれる場合の挙動差

プログラムの中で、nullという値に特別な意味を持たせている場合は注意が必要です。

例えば、「ユーザーが任意で入力しなかった項目」をnullとして保持している場合、issetではその項目が「最初から存在しない」のか「あえて空（null）として存在する」のかを判定できません。

このようなケースでは、必ずarray_key_existsを使用する必要があります。

実行速度（パフォーマンス）の比較

大量のデータをループ内で処理する場合など、実行速度が問題になるケースではissetが有利です。

issetはPHPの「言語構造」であり、通常の「関数」であるarray_key_existsよりも高速に動作します。

以下の表で、主な違いを比較しました。

比較項目	array_key_exists	isset
主な目的	キーの存在のみを確認する	変数が定義され、nullでないことを確認する
値がNULLの場合	true を返す	false を返す
実行速度	相対的に遅い	非常に高速
未定義変数の参照	エラー（Warning）が発生する	エラーにならない（falseを返す）

issetはパフォーマンスに優れるだけでなく、変数が定義されていない場合でもエラーを吐かずにfalseを返してくれるため、コードを簡潔に保てるメリットがあります。

モダンPHPにおける「??（Null合体演算子）」の活用

PHP 7.0以降、そして現在のPHP 8.x系では、さらに便利な「Null合体演算子（??）」が広く使われています。

これは、キーが存在し、かつnullでない場合はその値を返し、そうでなければデフォルト値を返すという処理を一行で記述できる仕組みです。

issetによる条件分岐の多くは、この演算子で代用可能です。

PHP

<?php
$options = [
    'items_per_page' => 20
];

// 従来のissetによる記述
$limit = isset($options['items_per_page']) ? $options['items_per_page'] : 10;

// Null合体演算子による記述
$limit = $options['items_per_page'] ?? 10;

echo "表示件数: " . $limit;
?>

実行結果

表示件数: 20

この記述方法は可読性が高く、現代のPHP開発においてはスタンダードな手法となっています。

ただし、これもissetと同様に値がnullの場合はデフォルト値が採用される点に注意してください。

どちらを使うべきか？判断基準のまとめ

どちらを使うべきか迷った際は、以下のフローで判断することをおすすめします。

array_key_existsを使うべきケース

値がnullであっても、そのキーが配列内に定義されていることを厳密にチェックしたいとき。
多次元配列などで、特定の階層のキーが確実に存在することを確認したいとき。
設定ファイルなどのバリデーションにおいて、必要な項目が欠落していないかを確認したいとき。

isset（またはNull合体演算子）を使うべきケース

キーが存在することを確認した直後に、その値を利用したいとき。
値がnullである場合を「データなし」とみなして良いとき。
大量の配列データを処理しており、極限までパフォーマンスを追求したいとき。

基本的には、「issetで事足りるならissetを使う」というのがPHPエンジニアの間での一般的なプラクティスです。

しかし、APIのレスポンスやJSONデータのパース結果を扱う際は、意図的なnullが含まれることが多いため、array_key_existsによる厳密なチェックが欠かせません。

まとめ

PHPで配列のキーを確認する方法には、目的や状況に応じた適切な選択肢があります。

キーの存在そのものを厳密に判定したい場合はarray_key_existsを使用しましょう。

一方で、値の取得と存在確認を同時に行いたい場合や、速度を優先したい場合はissetや??演算子が最適です。

それぞれの特性を正しく理解し、予期せぬ挙動を防ぐ堅牢なコードを記述していきましょう。

PHP 8.x以降、型に関する制約やエラーハンドリングが厳格化されているため、こうした基本関数の使い分けの重要性はさらに高まっています。