【PHP】「Warning: Undefined array key」エラーの原因と解決方法｜全パターン完全解説

このエラーが出ていませんか？

Warning: Undefined array key "username" in /var/www/html/index.php on line 15

PHPで配列の存在しないキーにアクセスすると発生するこのエラー。PHP 8.0以降ではWarningに昇格し、無視できなくなりました。この記事では全パターンの原因と解決方法をコード付きで解説します。

この記事で解決できること

• 「Warning: Undefined array key」エラーの原因と仕組み
• isset()・null合体演算子(??)・array_key_exists() の使い分け
• $_GET / $_POST / $_SESSION / $_FILES / $_SERVER 別の対処法
• 多次元配列・ループ・JSON・APIデータでのエラー対策
• PHP 7.x → 8.0 バージョンアップ時の移行チェックリスト
• Laravel・WordPress など フレームワーク別の対処法
• 実務で使える安全なコードテンプレート

Warning: Undefined array key "username" in /var/www/html/index.php on line 15

<?php
$user = [
    'name' => '田中太郎',
    'email' => 'tanaka@example.com',
];

// 存在するキーへのアクセス → 正常
echo $user['name']; // 田中太郎

// 存在しないキーへのアクセス → エラー！
echo $user['age'];  // Warning: Undefined array key "age"

エラー出力

Warning: Undefined array key "age" in /var/www/html/index.php on line 10

注意：PHP 7.x では「Notice: Undefined index」だったため無視されがちでしたが、PHP 8.0+では「Warning: Undefined array key」に昇格しました。Warningはerror_reportingの設定によってはアプリケーションの動作に影響を与えるため、必ず修正すべきです。

Notice: Undefined index: username in /var/www/html/index.php on line 15
Notice: Undefined offset: 5 in /var/www/html/index.php on line 20

Warning: Undefined array key "username" in /var/www/html/index.php on line 15
Warning: Undefined array key 5 in /var/www/html/index.php on line 20

ポイント：PHP 8.0+では「Undefined index」と「Undefined offset」が統一されて「Undefined array key」になりました。文字列キーも数値キーも同じメッセージです。

// $array["key"] にアクセスした時の内部処理
1. 指定されたキー "key" のハッシュ値を計算
2. ハッシュテーブルから該当するバケットを検索
3a. キーが見つかった場合 → 対応する値を返す
3b. キーが見つからない場合 → Warning を発生 + null を返す

<?php
$config = ['debug' => true];

// 1. Warning: Undefined array key "database"（nullが返る）
$db = $config['database'];

// 2. Warning: Trying to access array offset on null
$host = $db['host'];

// 3. Fatal error: Uncaught TypeError
strlen($host);

注意：「Undefined array key」を放置すると、nullが後続の処理に渡されて連鎖的にエラーが発生します。早い段階で適切に対処することが重要です。

<?php
$fruits = [
    'apple' => 'りんご',
    'banana' => 'バナナ',
    'orange' => 'オレンジ',
];

// "grape" は配列に存在しない
echo $fruits['grape'];
// Warning: Undefined array key "grape"

<?php
$fruits = [
    'apple' => 'りんご',
    'banana' => 'バナナ',
];

// 方法1: if文でチェック
if (isset($fruits['grape'])) {
    echo $fruits['grape'];
} else {
    echo 'キーが存在しません';
}

// 方法2: 三項演算子と組み合わせ
$grape = isset($fruits['grape']) ? $fruits['grape'] : 'デフォルト値';
echo $grape; // デフォルト値

ポイント：isset() は言語構造（関数ではない）なので非常に高速です。配列キーの存在チェックで最も推奨される方法です。

<?php
$fruits = [
    'apple' => 'りんご',
    'banana' => 'バナナ',
];

// キーが存在しない場合はデフォルト値を使用
$grape = $fruits['grape'] ?? 'デフォルト値';
echo $grape; // デフォルト値

// 上記は以下と同等
$grape = isset($fruits['grape']) ? $fruits['grape'] : 'デフォルト値';

// チェーンも可能（左から順に評価）
$value = $config['primary'] ?? $config['secondary'] ?? 'default';

ポイント：null合体演算子（??）は、isset() + 三項演算子よりも簡潔に書けます。PHP 7.0以上であれば、最もおすすめの方法です。

<?php
$data = [
    'name' => '田中',
    'age' => null,      // キーは存在するが、値がnull
    'email' => '',     // キーは存在し、値は空文字
];

// isset(): キーが存在し、かつ値がnullでない場合にtrue
var_dump(isset($data['name']));    // bool(true)
var_dump(isset($data['age']));     // bool(false) - nullなのでfalse
var_dump(isset($data['phone']));   // bool(false) - 存在しない

// array_key_exists(): キーが存在する場合にtrue（値は問わない）
var_dump(array_key_exists('name', $data));   // bool(true)
var_dump(array_key_exists('age', $data));    // bool(true) - nullでもtrue
var_dump(array_key_exists('phone', $data));  // bool(false)

<?php
$data = [
    'name' => '田中',
    'email' => '',
    'age' => 0,
];

// empty() は「空」と判断される値に対してtrueを返す
// 空 = null, false, 0, '', '0', [], 未定義

if (!empty($data['name'])) {
    echo '名前: ' . $data['name']; // 名前: 田中
}

// キーが存在しなくてもエラーにならない
if (!empty($data['phone'])) {
    echo $data['phone'];
} else {
    echo '電話番号は未設定です';
}

注意：empty() は 0 や空文字も「空」と判定します。数値の 0 が有効な値として扱われる場合（年齢が0歳など）は、isset() や ?? を使ってください。

<?php
// デフォルト値を定義
$defaults = [
    'name' => '',
    'email' => '',
    'age' => 0,
    'phone' => '',
];

// 実際のデータ（一部のキーのみ）
$input = [
    'name' => '田中太郎',
    'email' => 'tanaka@example.com',
];

// array_merge でデフォルト値を上書き
$data = array_merge($defaults, $input);

// すべてのキーに安全にアクセスできる
echo $data['name'];  // 田中太郎
echo $data['phone']; // （空文字、エラーにならない）
echo $data['age'];   // 0

ポイント：array_merge() を使うと、デフォルト値と実際のデータを簡単にマージできます。$defaults を先に、$input を後に指定することで、入力値がデフォルト値を上書きします。

<?php
// フォーム送信前に直接アクセスするとエラー
$username = $_POST['username'];
// Warning: Undefined array key "username"

$password = $_POST['password'];
// Warning: Undefined array key "password"

<?php
// 方法1: null合体演算子
$username = $_POST['username'] ?? '';
$password = $_POST['password'] ?? '';

// 方法2: リクエストメソッドを先にチェック
if ($_SERVER['REQUEST_METHOD'] === 'POST') {
    $username = $_POST['username'] ?? '';
    $password = $_POST['password'] ?? '';
    // ログイン処理...
}

<!-- name属性は "user_name" -->
<form method="post">
    <input type="text" name="user_name">
    <button type="submit">送信</button>
</form>

<?php
// HTML側は "user_name" なのに "username" で参照している
$name = $_POST['username'];  // Warning: Undefined array key "username"

// 正しくは
$name = $_POST['user_name'] ?? '';  // OK

ポイント：エラーメッセージの「”username”」部分を確認し、HTML側のname属性と一致しているか確認しましょう。大文字小文字やアンダースコア、ハイフンの違いにも注意してください。

<form method="post">
    <label>
        <input type="checkbox" name="agree" value="1">
        利用規約に同意する
    </label>
    <button type="submit">送信</button>
</form>

<?php
// チェックされていない場合、$_POST['agree'] は存在しない
$agree = $_POST['agree'];
// Warning: Undefined array key "agree"

<?php
// チェックボックスは isset() でチェック
$agree = isset($_POST['agree']); // true or false

// または null合体演算子でデフォルト値
$agree = $_POST['agree'] ?? '0';

if ($agree) {
    echo '同意されました';
} else {
    echo '利用規約に同意してください';
}

<?php
// URL: https://example.com/search.php
// パラメータなしでアクセスした場合

// エラーが出るコード
$keyword = $_GET['q'];
// Warning: Undefined array key "q"

$page = $_GET['page'];
// Warning: Undefined array key "page"

// 修正後のコード
$keyword = $_GET['q'] ?? '';
$page = (int)($_GET['page'] ?? 1);
$sort = $_GET['sort'] ?? 'date';
$order = $_GET['order'] ?? 'desc';

<?php
// filter_input() は存在しないキーでもWarningが出ない

// GETパラメータの取得
$keyword = filter_input(INPUT_GET, 'q', FILTER_SANITIZE_SPECIAL_CHARS);
$page = filter_input(INPUT_GET, 'page', FILTER_VALIDATE_INT) ?: 1;

// POSTパラメータの取得
$email = filter_input(INPUT_POST, 'email', FILTER_VALIDATE_EMAIL);
$age = filter_input(INPUT_POST, 'age', FILTER_VALIDATE_INT, [
    'options' => ['min_range' => 0, 'max_range' => 150]
]);

// 存在チェックとバリデーションが同時にできる
if ($email === false) {
    echo 'メールアドレスの形式が不正です';
} elseif ($email === null) {
    echo 'メールアドレスが入力されていません';
} else {
    echo 'メールアドレス: ' . $email;
}

<?php
$errors = [];
$data = [];

if ($_SERVER['REQUEST_METHOD'] === 'POST') {
    // 1. データの取得（null合体演算子でデフォルト値）
    $data = [
        'name'  => trim($_POST['name'] ?? ''),
        'email' => trim($_POST['email'] ?? ''),
        'age'   => $_POST['age'] ?? '',
        'agree' => isset($_POST['agree']),
    ];

    // 2. バリデーション
    if ($data['name'] === '') {
        $errors[] = '名前を入力してください';
    }
    if (!filter_var($data['email'], FILTER_VALIDATE_EMAIL)) {
        $errors[] = '有効なメールアドレスを入力してください';
    }
    if (!$data['agree']) {
        $errors[] = '利用規約に同意してください';
    }

    // 3. エラーがなければ処理実行
    if (empty($errors)) {
        // データベース保存などの処理
    }
}

<?php
// session_start() を忘れている！

// $_SESSION は初期化されていないため空
$username = $_SESSION['username'];
// Warning: Undefined array key "username"

<?php
// 必ず最初に session_start() を呼ぶ
session_start();

// さらに isset() でチェック
$username = $_SESSION['username'] ?? 'ゲスト';

注意：session_start() はHTMLを出力する前に呼ぶ必要があります。HTML出力後にsession_start()を呼ぶと「Cannot send session cookie – headers already sent」エラーが発生します。

<?php
session_start();

// セッション変数の安全な取得パターン

// パターン1: null合体演算子
$userId = $_SESSION['user_id'] ?? null;
$role = $_SESSION['role'] ?? 'guest';
$cart = $_SESSION['cart'] ?? [];

// パターン2: isset() で分岐
if (isset($_SESSION['user_id'])) {
    // ログイン済み
    echo 'ようこそ、' . htmlspecialchars($_SESSION['username'] ?? '') . 'さん';
} else {
    // 未ログイン
    echo 'ログインしてください';
}

<?php
session_start();

// セッションタイムアウトの設定（30分）
$timeout = 1800; // 30分 = 1800秒

// 最終アクセス時刻をチェック
if (isset($_SESSION['last_activity'])) {
    if (time() - $_SESSION['last_activity'] > $timeout) {
        // セッションタイムアウト
        session_unset();
        session_destroy();
        header('Location: /login.php?timeout=1');
        exit;
    }
}

// 最終アクセス時刻を更新
$_SESSION['last_activity'] = time();

<?php
session_start();

/**
 * ログイン状態をチェック
 */
function isLoggedIn(): bool
{
    return isset($_SESSION['user_id']) && $_SESSION['user_id'] > 0;
}

/**
 * セッションからユーザー情報を安全に取得
 */
function getSessionUser(): array
{
    return [
        'id'       => $_SESSION['user_id'] ?? null,
        'name'     => $_SESSION['username'] ?? 'ゲスト',
        'email'    => $_SESSION['email'] ?? '',
        'role'     => $_SESSION['role'] ?? 'guest',
        'loggedIn' => isLoggedIn(),
    ];
}

// 使用例
$user = getSessionUser();
if ($user['loggedIn']) {
    echo 'ようこそ、' . htmlspecialchars($user['name']) . 'さん';
} else {
    header('Location: /login.php');
    exit;
}

<?php
// ファイルが選択されていない場合にエラー
$fileName = $_FILES['upload']['name'];
// Warning: Undefined array key "upload"

<?php
// ファイルの存在とエラーチェック
if (isset($_FILES['upload']) && $_FILES['upload']['error'] === UPLOAD_ERR_OK) {
    $fileName = $_FILES['upload']['name'];
    $tmpPath = $_FILES['upload']['tmp_name'];
    $fileSize = $_FILES['upload']['size'];

    // ファイル処理...
    move_uploaded_file($tmpPath, 'uploads/' . basename($fileName));
} else {
    $error = $_FILES['upload']['error'] ?? UPLOAD_ERR_NO_FILE;
    echo 'ファイルアップロードエラー: コード ' . $error;
}

<!-- enctype がない → $_FILES は空 -->
<form method="post">
    <input type="file" name="upload">
    <button>アップロード</button>
</form>

<!-- enctype を追加 -->
<form method="post" enctype="multipart/form-data">
    <input type="file" name="upload">
    <button>アップロード</button>
</form>

<?php
function handleFileUpload(string $fieldName): array
{
    $result = ['success' => false, 'message' => '', 'path' => ''];

    // 1. ファイルフィールドの存在チェック
    if (!isset($_FILES[$fieldName])) {
        $result['message'] = 'ファイルフィールドが見つかりません';
        return $result;
    }

    // 2. アップロードエラーチェック
    $error = $_FILES[$fieldName]['error'] ?? UPLOAD_ERR_NO_FILE;
    if ($error !== UPLOAD_ERR_OK) {
        $messages = [
            UPLOAD_ERR_INI_SIZE   => 'ファイルサイズが上限を超えています（php.ini）',
            UPLOAD_ERR_FORM_SIZE  => 'ファイルサイズが上限を超えています（フォーム）',
            UPLOAD_ERR_PARTIAL    => 'ファイルが部分的にしかアップロードされていません',
            UPLOAD_ERR_NO_FILE    => 'ファイルが選択されていません',
            UPLOAD_ERR_NO_TMP_DIR => '一時フォルダが見つかりません',
            UPLOAD_ERR_CANT_WRITE => 'ディスクへの書き込みに失敗しました',
        ];
        $result['message'] = $messages[$error] ?? '不明なエラーが発生しました';
        return $result;
    }

    // 3. ファイル情報の安全な取得
    $name = $_FILES[$fieldName]['name'] ?? '';
    $tmpPath = $_FILES[$fieldName]['tmp_name'] ?? '';
    $size = $_FILES[$fieldName]['size'] ?? 0;

    // 4. ファイル移動
    $dest = 'uploads/' . uniqid() . '_' . basename($name);
    if (move_uploaded_file($tmpPath, $dest)) {
        $result['success'] = true;
        $result['path'] = $dest;
    } else {
        $result['message'] = 'ファイルの保存に失敗しました';
    }

    return $result;
}

<?php
// これらのキーは環境によって存在しない場合がある

// リモートIPアドレス（CLIでは存在しない）
$ip = $_SERVER['REMOTE_ADDR'] ?? '0.0.0.0';

// HTTPSかどうか（HTTPの場合は存在しない）
$isHttps = ($_SERVER['HTTPS'] ?? 'off') !== 'off';

// リクエストURI
$uri = $_SERVER['REQUEST_URI'] ?? '/';

// ホスト名
$host = $_SERVER['HTTP_HOST'] ?? 'localhost';

// リファラー（直接アクセスの場合は存在しない）
$referer = $_SERVER['HTTP_REFERER'] ?? '';

// ユーザーエージェント
$ua = $_SERVER['HTTP_USER_AGENT'] ?? '';

<?php
/**
 * クライアントIPアドレスを安全に取得
 */
function getClientIp(): string
{
    // プロキシ経由のIPを優先的にチェック
    $headers = [
        'HTTP_CLIENT_IP',
        'HTTP_X_FORWARDED_FOR',
        'HTTP_X_FORWARDED',
        'HTTP_FORWARDED_FOR',
        'HTTP_FORWARDED',
        'REMOTE_ADDR',
    ];

    foreach ($headers as $header) {
        $ip = $_SERVER[$header] ?? null;
        if ($ip !== null) {
            // カンマ区切りの場合は最初のIPを取得
            $ip = trim(explode(',', $ip)[0]);
            if (filter_var($ip, FILTER_VALIDATE_IP)) {
                return $ip;
            }
        }
    }

    return '0.0.0.0';
}

<?php
// CLIかWebかを判定
$isCli = (php_sapi_name() === 'cli');

if ($isCli) {
    // CLI実行時は $_SERVER にHTTP関連のキーがない
    $host = 'localhost';
    $method = 'CLI';
} else {
    $host = $_SERVER['HTTP_HOST'] ?? 'localhost';
    $method = $_SERVER['REQUEST_METHOD'] ?? 'GET';
}

<?php
// $_ENV は php.ini の variables_order によっては空
// getenv() を使うのがより確実

// 方法1: $_ENV + null合体演算子
$dbHost = $_ENV['DB_HOST'] ?? 'localhost';

// 方法2: getenv()（より確実）
$dbHost = getenv('DB_HOST') ?: 'localhost';
$dbName = getenv('DB_NAME') ?: 'mydb';
$dbUser = getenv('DB_USER') ?: 'root';
$dbPass = getenv('DB_PASS') ?: '';

ポイント：環境変数の取得は getenv() を使うのが最も確実です。$_ENV は php.ini の variables_order 設定に依存するため、環境によっては空になることがあります。

<?php
$config = [
    'database' => [
        'host' => 'localhost',
        'name' => 'mydb',
    ],
];

// 第1階層のキーが存在しない場合
echo $config['cache']['driver'];
// Warning: Undefined array key "cache"
// Warning: Trying to access array offset on null

// 第2階層のキーが存在しない場合
echo $config['database']['port'];
// Warning: Undefined array key "port"

<?php
$config = [
    'database' => [
        'host' => 'localhost',
        'name' => 'mydb',
    ],
];

// 方法1: isset() は多次元配列に対応している
if (isset($config['cache']['driver'])) {
    echo $config['cache']['driver'];
}
// isset() は途中のキーが存在しなくてもエラーにならない

// 方法2: null合体演算子
$driver = $config['cache']['driver'] ?? 'file';
// ただし、PHP 8.0では $config['cache'] が null を返し、
// null['driver'] でWarningが出る場合がある

// 方法3: より安全なネストアクセス
$driver = ($config['cache'] ?? [])['driver'] ?? 'file';

注意：PHP 8.0+では、null に対して配列アクセスすると「Trying to access array offset on null」Warningが発生します。ネストが深い場合は、段階的にチェックするか、ヘルパー関数を使いましょう。

<?php
/**
 * 多次元配列から安全に値を取得する
 * 
 * @param array  $array   対象の配列
 * @param string $key     ドット区切りのキー（例: 'database.host'）
 * @param mixed  $default デフォルト値
 * @return mixed
 */
function array_get(array $array, string $key, $default = null)
{
    $keys = explode('.', $key);

    foreach ($keys as $segment) {
        if (!is_array($array) || !array_key_exists($segment, $array)) {
            return $default;
        }
        $array = $array[$segment];
    }

    return $array;
}

// 使用例
$config = [
    'database' => [
        'host' => 'localhost',
        'connections' => [
            'mysql' => ['port' => 3306],
        ],
    ],
];

echo array_get($config, 'database.host');                     // localhost
echo array_get($config, 'database.connections.mysql.port');  // 3306
echo array_get($config, 'cache.driver', 'file');           // file（デフォルト値）
echo array_get($config, 'database.port', 3306);            // 3306（デフォルト値）

ポイント：このarray_get()関数を作っておくと、多次元配列のアクセスが非常に簡潔になります。Laravel を使っている場合は、標準の data_get() や Arr::get() を利用しましょう。

<?php
$users = [
    ['name' => '田中', 'email' => 'tanaka@example.com', 'age' => 25],
    ['name' => '佐藤', 'email' => 'sato@example.com'],  // age がない！
    ['name' => '鈴木', 'age' => 30],                      // email がない！
];

foreach ($users as $user) {
    // 一部のユーザーにキーがないためエラー
    echo $user['name'] . ' - ' . $user['email'] . ' - ' . $user['age'];
    // Warning: Undefined array key "age" (佐藤のデータ)
    // Warning: Undefined array key "email" (鈴木のデータ)
}

<?php
// 方法1: null合体演算子で個別にデフォルト値
foreach ($users as $user) {
    $name  = $user['name'] ?? '不明';
    $email = $user['email'] ?? '未設定';
    $age   = $user['age'] ?? '不明';
    echo "{$name} - {$email} - {$age}";
}

// 方法2: array_merge でデフォルト値を設定
$defaults = ['name' => '不明', 'email' => '未設定', 'age' => 0];

foreach ($users as $user) {
    $user = array_merge($defaults, $user);
    echo "{$user['name']} - {$user['email']} - {$user['age']}";
}

<?php
$users = [
    ['name' => '田中', 'email' => 'tanaka@example.com'],
    ['name' => '佐藤'],  // email がない
    ['name' => '鈴木', 'email' => 'suzuki@example.com'],
];

// array_column() はキーが存在しない要素をスキップする
$emails = array_column($users, 'email');
// ['tanaka@example.com', 'suzuki@example.com']
// 佐藤のデータはスキップされる（エラーなし）

// name をキーにしてemailを取得
$emailByName = array_column($users, 'email', 'name');
// ['田中' => 'tanaka@example.com', '鈴木' => 'suzuki@example.com']

<?php
$users = [
    ['name' => '田中', 'age' => 25],
    ['name' => '佐藤'],
    ['name' => '鈴木', 'age' => 30],
];

$defaults = ['name' => '不明', 'age' => 0, 'email' => ''];

// 全要素にデフォルト値をマージ
$normalizedUsers = array_map(
    fn($user) => array_merge($defaults, $user),
    $users
);

// 全要素が同じ構造になるので安全にアクセスできる
foreach ($normalizedUsers as $user) {
    echo "{$user['name']} ({$user['age']}歳)" . PHP_EOL;
}
// 田中 (25歳)
// 佐藤 (0歳)
// 鈴木 (30歳)

<?php
$json = '{"name":"田中","email":"tanaka@example.com"}';
$data = json_decode($json, true); // 連想配列として取得

// JSON に含まれていないキーへのアクセス
echo $data['phone'];
// Warning: Undefined array key "phone"

<?php
$json = '{"name":"田中","email":"tanaka@example.com"}';
$data = json_decode($json, true);

// 1. json_decode の失敗チェック
if ($data === null && json_last_error() !== JSON_ERROR_NONE) {
    echo 'JSONパースエラー: ' . json_last_error_msg();
    exit;
}

// 2. null合体演算子でデフォルト値
$name  = $data['name'] ?? '不明';
$email = $data['email'] ?? '';
$phone = $data['phone'] ?? '未登録';

<?php
// 外部APIからデータを取得
$response = file_get_contents('https://api.example.com/users/1');
$result = json_decode($response, true);

// 正常レスポンス: {"status":"ok","data":{"id":1,"name":"田中"}}
// エラーレスポンス: {"status":"error","message":"User not found"}

// ステータスチェック
$status = $result['status'] ?? 'error';

if ($status === 'ok') {
    // dataキーの存在を確認してからアクセス
    $userData = $result['data'] ?? [];
    $id   = $userData['id'] ?? 0;
    $name = $userData['name'] ?? '不明';
} else {
    $message = $result['message'] ?? 'エラーが発生しました';
    echo $message;
}

<?php
/**
 * JSONデータのバリデーション
 * 必須キーの存在をチェック
 */
function validateJsonData(array $data, array $requiredKeys): array
{
    $missing = [];
    foreach ($requiredKeys as $key) {
        if (!array_key_exists($key, $data)) {
            $missing[] = $key;
        }
    }
    return $missing;
}

// 使用例
$json = '{"name":"田中","email":"tanaka@example.com"}';
$data = json_decode($json, true);

$missing = validateJsonData($data, ['name', 'email', 'phone']);

if (!empty($missing)) {
    echo '必須フィールドが不足: ' . implode(', ', $missing);
    // 必須フィールドが不足: phone
} else {
    // すべてのキーが存在するので安全にアクセス可能
    echo $data['name'];
}

<?php
function fetchApiData(string $url): array
{
    $ch = curl_init($url);
    curl_setopt_array($ch, [
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_TIMEOUT => 10,
    ]);

    $response = curl_exec($ch);
    $httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
    $error = curl_error($ch);
    curl_close($ch);

    // 通信エラー
    if ($response === false) {
        return ['error' => '通信エラー: ' . $error];
    }

    // JSONデコード
    $data = json_decode($response, true);
    if ($data === null) {
        return ['error' => 'JSONパースエラー'];
    }

    return $data;
}

// 使用例
$result = fetchApiData('https://api.example.com/users/1');

// エラーチェック
if (isset($result['error'])) {
    echo 'エラー: ' . $result['error'];
} else {
    // 安全にアクセス
    $name = $result['name'] ?? '不明';
    echo 'ユーザー名: ' . $name;
}

<?php
// 開発環境：すべてのエラーを表示（推奨）
error_reporting(E_ALL);
ini_set('display_errors', '1');

// 本番環境：エラーは表示せずログに記録（推奨）
error_reporting(E_ALL);
ini_set('display_errors', '0');
ini_set('log_errors', '1');
ini_set('error_log', '/var/log/php/error.log');

// Warning を非表示にする（非推奨）
error_reporting(E_ALL & ~E_WARNING);
// ↑ これはエラーを隠しているだけで、問題は解決していない

<?php
// 悪い例：@でエラーを抑制
$value = @$array['key']; // エラーは出ないが、問題は残っている

// 良い例：適切にチェック
$value = $array['key'] ?? null; // 明示的にデフォルト値を設定

非推奨：@演算子は以下の理由で使用すべきではありません。

• パフォーマンスが低下する（内部的にerror_reportingを変更している）
• デバッグが困難になる（エラーが完全に隠される）
• PHP 8.0以降では@を使っても一部のエラーが抑制されなくなった
• コードの意図が不明確になる

; 開発環境の推奨設定
error_reporting = E_ALL
display_errors = On
display_startup_errors = On
log_errors = On

; 本番環境の推奨設定
error_reporting = E_ALL
display_errors = Off
display_startup_errors = Off
log_errors = On
error_log = /var/log/php/error.log

// 文字列キーの場合
Notice: Undefined index: username in /path/to/file.php on line 10

// 数値キーの場合
Notice: Undefined offset: 5 in /path/to/file.php on line 15

// 変数が未定義の場合
Notice: Undefined variable: name in /path/to/file.php on line 20

// 文字列キーも数値キーも統一メッセージ
Warning: Undefined array key "username" in /path/to/file.php on line 10
Warning: Undefined array key 5 in /path/to/file.php on line 15

// 変数が未定義の場合
Warning: Undefined variable $name in /path/to/file.php on line 20

// null へのアクセス（PHP 8.0 で新たに追加）
Warning: Trying to access array offset on null in /path/to/file.php on line 25

<?php
$array = ['key' => null];

// PHP 7.x: Notice + null
// PHP 8.0+: Warning + null
$value = $array['nonexistent'];

// PHP 7.x: Notice（暗黙的にnull→空文字に変換）
// PHP 8.0+: TypeError: strlen(): Argument must be of type string, null given
$len = strlen($value);

// 安全な書き方
$value = $array['nonexistent'] ?? '';
$len = strlen($value); // OK: 0

ポイント：PHP 8.0への移行は、まず開発環境で E_ALL を有効にしてエラーログを確認し、一つずつ修正していくのが最も安全です。grep で $_GET[ や $_POST[ を検索して、チェックなしのアクセスを洗い出しましょう。

<?php
use IlluminateSupportArr;

$config = [
    'database' => [
        'host' => 'localhost',
        'port' => 3306,
    ],
];

// 1. data_get() - ドット記法で安全にアクセス
$host = data_get($config, 'database.host');           // 'localhost'
$driver = data_get($config, 'cache.driver', 'file');  // 'file'（デフォルト値）

// 2. Arr::get() - 配列専用のドット記法アクセス
$port = Arr::get($config, 'database.port', 3306);   // 3306

// 3. Arr::has() - キーの存在チェック
if (Arr::has($config, 'database.host')) {
    // キーが存在する
}

// 4. optional() - nullセーフなアクセス
$user = null;
echo optional($user)->name; // null（エラーにならない）

// 5. Request の安全な取得
$name = $request->input('name', 'デフォルト');
$page = $request->integer('page', 1);
$tags = $request->input('tags', []);

<?php
// 1. get_option() - デフォルト値付き
$site_name = get_option('blogname', 'My Site');

// 2. get_post_meta() - メタデータの安全な取得
$meta = get_post_meta($post_id, 'custom_field', true);
if (empty($meta)) {
    $meta = 'デフォルト値';
}

// 3. wp_parse_args() - デフォルト値のマージ
$defaults = [
    'posts_per_page' => 10,
    'orderby' => 'date',
    'order' => 'DESC',
];
$args = wp_parse_args($user_args, $defaults);

// 4. sanitize系関数 + null合体演算子
$search = sanitize_text_field($_GET['s'] ?? '');
$page = absint($_GET['paged'] ?? 1);

// 5. 配列型のメタデータ
$settings = get_option('my_plugin_settings', []);
$color = $settings['color'] ?? '#333333';
$fontSize = $settings['font_size'] ?? '16px';

ポイント：WordPressでは wp_parse_args() が array_merge() と同等の機能を持ちます。プラグインやテーマの設定値を扱う際に活用しましょう。

<?php
// CakePHP - Hashクラス
use CakeUtilityHash;

$data = ['user' => ['name' => '田中']];

// ドット記法で安全にアクセス
$name = Hash::get($data, 'user.name');        // '田中'
$email = Hash::get($data, 'user.email', ''); // ''（デフォルト値）

// リクエストデータの取得
$name = $this->request->getData('name', 'default');
$page = $this->request->getQuery('page', 1);

<?php
// Symfony - Request オブジェクト
use SymfonyComponentHttpFoundationRequest;

$request = Request::createFromGlobals();

// GET パラメータの安全な取得
$page = $request->query->getInt('page', 1);
$keyword = $request->query->get('q', '');

// POST パラメータ
$name = $request->request->get('name', 'default');

// セッション
$userId = $request->getSession()->get('user_id', null);

<?php
/**
 * お問い合わせフォーム処理
 * Warning: Undefined array key を発生させない安全な実装
 */

$errors = [];
$success = false;

// デフォルト値を定義
$formData = [
    'name'    => '',
    'email'   => '',
    'subject' => '',
    'message' => '',
    'agree'   => false,
];

if ($_SERVER['REQUEST_METHOD'] === 'POST') {
    // POST データを安全に取得
    $formData = [
        'name'    => trim($_POST['name'] ?? ''),
        'email'   => trim($_POST['email'] ?? ''),
        'subject' => trim($_POST['subject'] ?? ''),
        'message' => trim($_POST['message'] ?? ''),
        'agree'   => isset($_POST['agree']),
    ];

    // バリデーション
    if ($formData['name'] === '') {
        $errors['name'] = '名前を入力してください';
    }
    if (!filter_var($formData['email'], FILTER_VALIDATE_EMAIL)) {
        $errors['email'] = '有効なメールアドレスを入力してください';
    }
    if ($formData['message'] === '') {
        $errors['message'] = 'メッセージを入力してください';
    }

    if (empty($errors)) {
        // メール送信処理...
        $success = true;
    }
}
// HTMLテンプレートで $formData を安全に使用
// すべてのキーにデフォルト値があるためエラーにならない

<?php
// PDO でデータを取得
$stmt = $pdo->prepare('SELECT * FROM users WHERE id = ?');
$stmt->execute([$userId]);
$user = $stmt->fetch(PDO::FETCH_ASSOC);

// fetch() はデータがない場合 false を返す
if ($user === false) {
    echo 'ユーザーが見つかりません';
    exit;
}

// カラムが NULL の場合も考慮
$name  = $user['name'] ?? '不明';
$email = $user['email'] ?? '';
$phone = $user['phone'] ?? '未登録';

// 複数行の結果を安全に処理
$stmt = $pdo->query('SELECT * FROM products');
$products = $stmt->fetchAll(PDO::FETCH_ASSOC);

foreach ($products as $product) {
    $name  = $product['name'] ?? '不明';
    $price = $product['price'] ?? 0;
    $stock = $product['stock'] ?? 0;
    echo "{$name}: {$price}円 (在庫: {$stock})" . PHP_EOL;
}

<?php
/**
 * 設定ファイルの安全な読み込みクラス
 */
class Config
{
    private array $data = [];

    public function __construct(string $filePath)
    {
        if (file_exists($filePath)) {
            $this->data = require $filePath;
        }
    }

    /**
     * ドット記法で設定値を取得
     */
    public function get(string $key, $default = null)
    {
        $keys = explode('.', $key);
        $value = $this->data;

        foreach ($keys as $segment) {
            if (!is_array($value) || !isset($value[$segment])) {
                return $default;
            }
            $value = $value[$segment];
        }

        return $value;
    }
}

// 使用例
$config = new Config('config/app.php');
$dbHost = $config->get('database.host', 'localhost');
$debug  = $config->get('app.debug', false);

<?php
/**
 * CSVファイルを連想配列として安全に読み込む
 */
function readCsvSafe(string $filePath, array $defaults = []): array
{
    $rows = [];

    if (($handle = fopen($filePath, 'r')) === false) {
        return [];
    }

    // ヘッダー行を読み込む
    $headers = fgetcsv($handle);
    if ($headers === false) {
        fclose($handle);
        return [];
    }

    // データ行を処理
    while (($row = fgetcsv($handle)) !== false) {
        // ヘッダーとデータを紐付け
        // カラム数が異なる場合もエラーにならない
        $data = [];
        foreach ($headers as $i => $header) {
            $data[$header] = $row[$i] ?? ($defaults[$header] ?? '');
        }

        // デフォルト値をマージ
        $rows[] = array_merge($defaults, $data);
    }

    fclose($handle);
    return $rows;
}

// 使用例
$defaults = ['name' => '不明', 'email' => '', 'age' => 0];
$users = readCsvSafe('data/users.csv', $defaults);

// 全行に同じキーが保証されるので安全
foreach ($users as $user) {
    echo $user['name'] . ': ' . $user['email'] . PHP_EOL;
}

<?php
// 検索条件のデフォルト値
$searchDefaults = [
    'keyword'  => '',
    'category' => '',
    'sort'     => 'date',
    'order'    => 'desc',
    'page'     => 1,
    'per_page' => 20,
];

// $_GET から安全にパラメータを取得
$search = [
    'keyword'  => trim($_GET['keyword'] ?? $searchDefaults['keyword']),
    'category' => $_GET['category'] ?? $searchDefaults['category'],
    'sort'     => $_GET['sort'] ?? $searchDefaults['sort'],
    'order'    => $_GET['order'] ?? $searchDefaults['order'],
    'page'     => max(1, (int)($_GET['page'] ?? $searchDefaults['page'])),
    'per_page' => min(100, max(1, (int)($_GET['per_page'] ?? $searchDefaults['per_page']))),
];

// ホワイトリストで値を検証
$allowedSort = ['date', 'name', 'price', 'popular'];
if (!in_array($search['sort'], $allowedSort, true)) {
    $search['sort'] = 'date';
}

Warning: Undefined array key "xxx" が発生
│
├─ エラーメッセージの "xxx" 部分を確認
│  └─ どのキーが未定義か特定する
│
├─ そのキーはどこから来るデータ？
│  ├─ $_GET / $_POST → ?? でデフォルト値を設定
│  ├─ $_SESSION → session_start() + ?? でチェック
│  ├─ $_FILES → isset() + error コードチェック
│  ├─ $_SERVER → ?? でフォールバック値
│  ├─ JSONデータ → json_decode結果チェック + ??
│  ├─ DBの結果 → fetch結果のfalseチェック + ??
│  └─ 自作の配列 → 初期化漏れ or ロジック確認
│
├─ 解決方法を選択
│  ├─ デフォルト値を使いたい → $array['key'] ?? 'default'
│  ├─ 存在チェックだけ   → isset($array['key'])
│  ├─ null も区別したい  → array_key_exists('key', $array)
│  ├─ 空もチェックしたい → !empty($array['key'])
│  └─ 複数キーにデフォルト → array_merge($defaults, $input)
│
└─ 修正完了！

結論：null合体演算子（??）を使おう

ほとんどのケースでは、null合体演算子（??）でデフォルト値を設定するだけで解決できます。

// これだけで Undefined array key エラーを防げる
$value = $array['key'] ?? 'デフォルト値';

PHP 7.0以降であれば使えるので、レガシーコードでない限り積極的に活用してください。コードが簡潔になり、意図も明確になります。