PHP Undefined index/variable の原因と解決方法

Undefined index: … または Undefined variable: … とは

PHP開発中に「Undefined index」や「Undefined variable」エラーに遭遇することは少なくありません。これらのエラーは、存在しない配列キーや変数を参照しようとしたときに発生します。主にデータの入力検証や配列の扱い方に関連しています。

エラーの発生パターン

このエラーは主に以下のようなケースで発生します。

パターン1: 未定義の$_GET/$_POSTキーへのアクセス

<?php
// URL: http://localhost/test.php
// $_GET['name'] が存在しない場合、Undefined index エラーが発生
$name = $_GET['name'];
echo "Hello, " . $name;
?>

$_GET配列にnameキーが存在しない状態でアクセスしているため、Undefined indexエラーが発生します。ユーザーがURLパラメータを指定しなかった場合に起こりえます。存在しない配列キーへの直接アクセスは避けるべきです。

<?php
// isset() でキーの存在を確認してからアクセス
$name = isset($_GET['name']) ? $_GET['name'] : 'Guest';
echo "Hello, " . $name;

// PHP 7+ の場合はnull合体演算子 (??) がより簡潔
// $name = $_GET['name'] ?? 'Guest';
// echo "Hello, " . $name;
?>

パターン2: スコープ外の変数へのアクセス

<?php
function greet() {
    $message = "Hello"; // ローカル変数
}

greet();
// 関数スコープ外から$messageにアクセスしようとするとUndefined variableエラー
echo $message;
?>

greet関数内で定義された$message変数は、関数のスコープ外では参照できません。関数が終了すると変数は破棄されるため、グローバルスコープでアクセスしようとするとUndefined variableエラーになります。

<?php
// 方法1: 関数から値を返す
function greet_return() {
    $message = "Hello";
    return $message;
}
$message_from_func = greet_return();
echo $message_from_func . "\n";

// 方法2: グローバル変数を使用 (推奨されない場合が多い)
$global_message = "Hi";
function greet_global() {
    global $global_message;
    echo $global_message . "\n";
}
greet_global();
?>

パターン3: 連想配列の未定義キーへのアクセス

<?php
$user = [
    'id' => 1,
    'name' => 'Alice'
];
// 'email' キーは存在しないため、Undefined index エラーが発生
echo $user['email'];
?>

$user配列にはemailというキーが存在しないため、Undefined index: emailエラーが発生します。配列から値を取り出す前に、キーが存在するかどうかを確認することが重要です。

<?php
$user = [
    'id' => 1,
    'name' => 'Alice'
];

// 方法1: isset() でキーの存在を確認
if (isset($user['email'])) {
    $email = $user['email'];
} else {
    $email = 'N/A';
}
echo $email . "\n";

// 方法2: PHP 7+ null合体演算子 (??) を使用
$email_php7 = $user['email'] ?? 'N/A';
echo $email_php7 . "\n";
?>

根本原因の特定方法

エラーが発生した箇所でvar_dump()やprint_r()を使用して、変数や配列の内容を確認してください。特に、ユーザー入力や外部APIからのデータが期待通りに到着しているかを確認することが重要です。

<?php
// $_GETの内容を確認
var_dump($_GET);

// 特定の変数の内容を確認
$myVar = null;
// ... 何らかの処理 ...
var_dump($myVar);
?>

防止策とベストプラクティス

変数を宣言する際は初期値を設定し、配列のキーにアクセスする前にはisset()やarray_key_exists()で存在確認を行う習慣をつけましょう。これにより、予期せぬエラーを防ぐことができます。

<?php
// PHP 7+ のnull合体演算子
$name = $_GET['name'] ?? 'Guest';

// PHP 5.x/7.x のisset()によるチェック
$data = null;
if (isset($_POST['data'])) {
    $data = $_POST['data'];
} else {
    $data = 'default_value';
}

// array_key_exists() でキーの存在のみを確認
$config = ['debug' => true];
if (array_key_exists('debug', $config)) {
    // キーは存在するが値がnullの可能性も考慮する場合は isset()
    $debug_mode = $config['debug'];
}
?>

よくある質問（FAQ）