問題の概要
PHP 8.0や8.1にアップグレードすると、予期せぬトラブルに遭遇することがよくあります。サイトが500エラーでクラッシュし、ログを確認すると波括弧（curly braces）に関する致命的なエラー（Fatal Error）が記録されている場合があります。これは、PHP 8で配列の要素や文字列の文字に {} を使ってアクセスする古い手法が完全に廃止されたために起こります。
この構文は、実はPHP 4時代からの遺物です。PHP 7.4の時点で非推奨（deprecated）として警告されていましたが、2020年リリースのPHP 8.0で正式に廃止されました。かつては軽微な警告だったものが、現在ではスクリプトの実行を停止させるエラーとなっています。
エラー箇所の特定
エラーログには通常、問題のあるファイルと行番号が示されています。古いバージョンのCodeIgniterや初期のLaravel、あるいは2010年頃に作成された独自のエンジンを使用しているレガシーなコードベースでは、以下のようなコードが見つかるはずです。
// PHP 7.4では動作しますが、PHP 8.0以降では失敗します
$data = ['apple', 'orange'];
echo $data{0};
$message = "Hello";
echo $message{1};
PHP 8ではオフセットに対して {} を認識しなくなったため、エンジンは即座に処理を中断します。これはロジックのバグというよりも、構文上の欠陥として扱われます。
修正手順
1. 手動での置換
修正方法は非常にシンプルです。波括弧を標準的な角括弧 [] に置き換えるだけです。この構文は汎用的であり、現在使用されているすべてのPHPバージョンで動作します。
// モダンで互換性のある記述方法
$data = ['apple', 'orange'];
echo $data[0];
$message = "Hello";
echo $message[1];
2. コマンドラインで該当箇所を一括検索
数千行のコードを手動で探すのは非効率です。LinuxやmacOSのターミナルが使用できる場合は、grep を使ってプロジェクトディレクトリ全体を数秒でスキャンできます。
grep -rE "\$[a-zA-Z0-9_]+\{[a-zA-Z0-9_\'\"]+\}" .
このコマンドは、$変数名{キー} というパターンを再帰的に検索します。変更を加える前に、結果が実際の配列アクセスであることを確認してください。PHP 8でも引き続き有効な "{$variable}" のような変数展開（変数補間）と混同しないよう注意が必要です。
3. Automated Refactoring with Rector
大規模なプロジェクトでは、手動編集に頼るべきではありません。Rectorは、PHPのバルクアップグレードを安全に行うための強力なツールです。ソースコードをスキャンし、数百ものファイルに対して一括で修正を適用できます。
まず、Composer経由でRectorをインストールします。
composer require rector/rector --dev
設定を初期化した後、ソースフォルダに対して実行コマンドを走らせます。
vendor/bin/rector process src
Rectorは賢く、不正なオフセット構文と有効な文字列補間を区別できるため、手動での品質確認（QA）にかかる時間を大幅に節約できます。
4. IDEの検索・置換機能を使用する
VS CodeやPhpStormでの作業を好む場合は、正規表現（Regex）検索を使用してください。これは、特定のテーマやプラグインのみを素早くクリーンアップする場合に最適です。
検索（Find）: \$(\w+)\{([^\}]+)\}
置換（Replace）: $$1[$2]
プロのヒント: 常に最初に「検索」を実行して、一致するリストを確認してください。正規表現は、複雑にネストされた文字列内で誤検知（偽陽性）を起こす可能性があります。
動作確認
変更を適用した後は、修正が正しく機能しているか確認する必要があります。以下の3つのステップをお勧めします。
- ファイルの構文チェック（Lint）:
php -l ファイル名.phpを実行します。リンターは実際にコードを実行することなく構文をチェックします。 - ログの監視: サイト内を操作しながら
error_logを監視（tail）し、新たな致命的エラーが発生しないか確認します。 - vendorフォルダの確認: エラーが
/vendor/や/plugins/ディレクトリ内で発生している場合は、公式のアップデートを探してください。サードパーティのコードを手動で修正するのは危険です。なぜなら、次にcomposer updateを実行した際に変更が消えてしまうからです。
最後に
ローカルの開発環境を本番サーバーと同期させておくことが、こうしたトラブルを防ぐ最善の方法です。ローカルでPHP 8.1を使用して開発していれば、これらの構文の問題を本番環境のユーザーに影響が出る数ヶ月前に発見できるはずです。