PHP 7.1 → 8.2.35 対応ソリューション(優先順位付き)

versions.html で洗い出した改修点のうち、7.1から8.2.35へ一気に上げる際にまず着手すべき項目を、必要性(放置した場合の危険度)と影響範囲(コードベースのどれだけ広くに関わるか)から優先度付けしました。各項目の右側にサンプルコード/設定例を付けています。時間が限られている場合は P0 → P1 の順に潰し、P2・P3 は後回しにしても致命的な障害にはなりにくい構成です。2026年10月22日リリースの 8.5.12 / 8.4.27 / 8.3.36 / 8.2.35 までのパッチリリースで挙動が変わった項目も含めています(項目名に「(8.4.27+/8.5.12+)」のように適用されたパッチバージョンを記載)。

時間がない中で一気に8.2.35へ上げるための進め方
  1. まずP0〜P3の75件に目を通す: サンプルコード付きのこの75件は「特に影響が大きい/気づきにくい」項目の抜粋で、rectorのような自動変換ツールでは拾いにくい設計判断(PDOのエラーモード変更、@演算子の挙動変化、リソース→オブジェクトの判定変更など)が中心です。全343件を照合する前にここで考え方を掴んでおくと、後続のツール出力を正しく判断できるようになります。
  2. check-required-items.sh で実コードを機械的に照合する: 簡易対応表343件(うち必須247件)を関数名・キーワードベースで自動生成したチェックリストと突き合わせ、実際にヒットする項目だけに絞り込みます。各項目には P0〜P3 の優先度が付くので、レポート内でも P0 から順に確認できます。
    実行例
    ./check-required-items.sh /path/to/your-project
    # 推奨(P3)項目も含めて照合する場合
    ./check-required-items.sh /path/to/your-project --include-recommended
    # ヒットしなかった項目・自動パターンなしの項目も確認する場合
    ./check-required-items.sh /path/to/your-project --verbose
    # Markdown / HTML ファイルにもレポートを保存する場合
    ./check-required-items.sh /path/to/your-project --output=report.md
    ./check-required-items.sh /path/to/your-project --output=report.html --include-recommended
    ヒットした項目番号(#数字)は、index.html下部の簡易対応表や versions.html / 改修点-優先順.html の同じ番号と対応しています。パターンは関数名・定数名などから自動生成した簡易的なものなので、最終判断は実際のコードを見て行ってください。ヒットしたファイルは省略せず全件表示され、--output 指定時はターミナル表示に加えて指定した形式(拡張子で自動判定)でファイルにも保存されます。ダブルクリック実行などでウィンドウがすぐ閉じてしまう場合に備え、実行完了時にEnterキー入力待ちで一時停止します。
  3. 自動変換ツールを使う: rector/rector にはPHPバージョンごとのアップグレードルールセット(Php74, Php80 … Php84)があり、括弧なし三項演算子・${var}補間・nullable引数の明示化など機械的な修正の大部分を自動化できます。まずRectorをdry-runし、自動修正できない差分だけを手作業で潰すと大幅に時間短縮できます。
  4. 静的解析で「気づかない挙動変化」を洗い出す: PHPStan/Psalmを最高レベルで実行し、P1に分類した「エラーは出ないが結果が変わる」系(比較演算子、型変換など)を先に机上で検出する。
  5. ステージング環境はPHP 8.2.35 + フルエラー表示で通す: 一気に上げるとP0のFatal Errorが最初にまとめて出るため、下記の設定で早期に洗い出す。
    php.ini(検証環境限定)
    display_errors = On
    error_reporting = E_ALL
    log_errors = On
    error_log = /var/log/php_migration_errors.log
  6. 拡張モジュールの棚卸し: php -m で現在ロードしている拡張を確認し、8.0でコア同梱から外れた xmlrpc 等がある場合はPECL経由の再インストールを計画に入れる。
P0 致命的なエラー 放置すると致命的エラー(Fatal/TypeError/ValueError)で処理が止まる。 P1 結果不安定 エラーは出ずに黙って結果が変わる。バグとして顕在化しにくい。 P2 他の必須対応 P0/P1には当てはまらないが、公式に必須(Backward Incompatible)とされている項目。 P3 推奨対応 非推奨(Deprecated)。現状は動作するが将来削除予定。

優先順位を付けず、P0から順に全件対応することを推奨します。

P0 — 致命的なエラー(このままでは動かない)

P1 — 結果不安定(黙って挙動が変わる)

P2 — 他の必須対応(必須だがP0/P1に当てはまらないもの)

P3 — 推奨対応(非推奨・現状は動作)

参考: 全項目 簡易対応表(サンプルコード省略・全343件)

上記で紹介した約75件は「特に影響が大きい/気づきにくい」項目の抜粋です。compact()のように単体では優先度が低い項目も含め、versions.htmlに掲載した全項目をここに一覧化しています。ご利用中のコードで該当する関数・記法を使っていなければ対応不要です。

P0 致命的なエラー — 実行時にFatal Error/未捕捉例外で処理が止まる(-件) P1 結果不安定 — エラーは出ないが結果が変わる・不安定になる(気づきにくいバグの温床)(-件) P2 他の必須対応 — 上記に当てはまらないが公式に必須(Backward Incompatible)とされている項目(-件) P3 推奨対応 — 非推奨(Deprecated)。現状は動作するが将来削除予定(-件)

※ P0〜P3は各項目の説明文をもとにキーワードベースで自動判定した目安です。実際の危険度はコードでの使用状況によって変わるため、参考程度にご利用ください。優先順位を付けずP0から全件対応することを推奨します。

対象バージョンで絞り込み:
#Ver優先度分類対象機能/関数内容