【PHP】Warning: Uninitialized string offset の原因と解決方法｜範囲外と多バイトの罠

PHPで「Warning: Uninitialized string offset」は、文字列の存在しない位置（オフセット）にアクセスしたときに出る警告です。ループのインデックスのずれが原因のことが多く、さらに日本語などの多バイト文字では別の落とし穴もあります。この記事では原因と正しい対処をまとめます。

エラーの原因

文字列の長さを超えた位置にアクセスすると発生します。インデックスは0始まりなので、長さ5の文字列の有効な位置は 0〜4 です。$str[5] は存在しないため警告になります。

<?php
$str = "Hello"; // 長さ5、有効な位置は 0〜4
echo $str[5];    // Warning: Uninitialized string offset 5

対処法：issetで範囲を確認する

アクセス前に isset($str[$offset]) で確認します。範囲外なら false を返すため、安全に分岐できます。

<?php
$str = "Hello";
$offset = 5;

if (isset($str[$offset])) {
    echo $str[$offset];
} else {
    echo "その位置に文字はありません";
}

よくある原因：ループのオフセットずれ

実際によくあるのが、ループ条件のoff-by-one（1つずれ）です。<= を使うと最後に範囲外へアクセスしてしまいます。strlen() 未満（<）で回すのが正解です。

<?php
$str = "Hello";

// NG: <= だと最後に $str[5] にアクセスして警告
for ($i = 0; $i <= strlen($str); $i++) {
    echo $str[$i];
}

// OK: < で回す
for ($i = 0; $i < strlen($str); $i++) {
    echo $str[$i];
}

補足：負のオフセットは末尾から数える

PHPでは負のオフセットが使え、末尾から数えた文字を取得できます。$str[-1] は最後の文字です（ただし範囲外の負の値はやはり警告になります）。

<?php
$str = "Hello";
echo $str[-1]; // o（最後の文字）
echo $str[-5]; // H（先頭）

最大の落とし穴：日本語など多バイト文字

ここが重要です。$str[$i] は「バイト単位」でのアクセスです。UTF-8の日本語は1文字が3バイトなどになるため、$str[0] は壊れた1バイトを返し、文字化けやオフセットずれの原因になります。

<?php
$str = "あいう";
echo strlen($str);    // 9（バイト数）
echo mb_strlen($str); // 3（文字数）

var_dump($str[0]);    // string(1) "?" ← 壊れた1バイト

日本語などを1文字ずつ正しく扱うには、mb_substr() を使います。ループも mb_strlen() で回します。

<?php
$str = "あいう";

echo mb_substr($str, 0, 1); // あ（正しく1文字）

// 1文字ずつ処理する
for ($i = 0; $i < mb_strlen($str); $i++) {
    echo mb_substr($str, $i, 1) . "\n"; // あ / い / う
}

// PHP 7.4+ なら mb_str_split も便利
foreach (mb_str_split($str) as $ch) {
    echo $ch . "\n";
}

よくある質問（FAQ）

まとめ

このエラーへの対処を整理します。

• 原因は範囲外の文字位置へのアクセス（0始まり）
• アクセス前に isset($str[$offset]) で確認
• ループは $i < strlen($str)（<= は off-by-one）
• 負のオフセット $str[-1] は末尾から数える
• 日本語など多バイトは mb_substr()（$str[$i] はバイト単位で壊れる）

関連として、substrとmb_substrの使い方・文字列の長さを正確に取得する方法・Undefined variable の解決方法もあわせて読むと、PHPの文字列処理に強くなれます。