versions.html で洗い出した改修点のうち、8.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+)」のように適用されたパッチバージョンを記載)。
rectorのような自動変換ツールでは拾いにくい設計判断(PDOのエラーモード変更、@演算子の挙動変化、リソース→オブジェクトの判定変更など)が中心です。全27件を照合する前にここで考え方を掴んでおくと、後続のツール出力を正しく判断できるようになります。check-required-items.sh で実コードを機械的に照合する: 簡易対応表27件(うち必須21件)を関数名・キーワードベースで自動生成したチェックリストと突き合わせ、実際にヒットする項目だけに絞り込みます。各項目には 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
--output 指定時はターミナル表示に加えて指定した形式(拡張子で自動判定)でファイルにも保存されます。ダブルクリック実行などでウィンドウがすぐ閉じてしまう場合に備え、実行完了時にEnterキー入力待ちで一時停止します。
rector/rector にはPHPバージョンごとのアップグレードルールセット(Php74, Php80 … Php84)があり、括弧なし三項演算子・${var}補間・nullable引数の明示化など機械的な修正の大部分を自動化できます。まずRectorをdry-runし、自動修正できない差分だけを手作業で潰すと大幅に時間短縮できます。display_errors = On error_reporting = E_ALL log_errors = On error_log = /var/log/php_migration_errors.log
php -m で現在ロードしている拡張を確認し、8.0でコア同梱から外れた xmlrpc 等がある場合はPECL経由の再インストールを計画に入れる。優先順位を付けず、P0から順に全件対応することを推奨します。
上記で紹介した約9件は「特に影響が大きい/気づきにくい」項目の抜粋です。compact()のように単体では優先度が低い項目も含め、versions.htmlに掲載した全項目をここに一覧化しています。ご利用中のコードで該当する関数・記法を使っていなければ対応不要です。
※ P0〜P3は各項目の説明文をもとにキーワードベースで自動判定した目安です。実際の危険度はコードでの使用状況によって変わるため、参考程度にご利用ください。優先順位を付けずP0から全件対応することを推奨します。
| # | Ver | 優先度 | 分類 | 対象機能/関数 | 内容 |
|---|