PHPのバージョンを上げる作業で一番知りたいのは、「結局、何が引っかかるのか」です。

当社は2026年11月、自社サイトを PHP 7.4.33 から 8.3.36 へ移行しました。
対象の .php ファイルは1,702本。全部を機械的に走査して、
非互換を7種類見つけています。実際の件数とともに公開します。


見つかった7種類

# 種類 件数 PHPのどこで消えたか
1 波括弧による文字列・配列のオフセット 2 8.0 で削除
2 create_function() 8 8.0 で削除
3 PHP4形式のコンストラクタ 7 8.0 で削除
4 $this->WP_Widget() 形式の呼び出し 7 本体APIの変更
5 動的プロパティの宣言なし利用 5 8.2 で非推奨
6 必須引数の前に任意引数 1 8.0 で非推奨
7 未定義変数の参照 2 警告の扱いが変更

1. 波括弧のオフセット(2件)

php
$res[$entry]{'status'} // 8.0 でエラー
$res[$entry]['status'] // 正しい書き方

これが一番やっかいでした。 理由は後述します。

2. create_function()(8件)

php
create_function('', 'return register_widget("X");') // 削除済み
function () { return register_widget('X'); } // 無名関数へ

3. PHP4形式のコンストラクタ(7件)

クラス名と同じ名前のメソッドをコンストラクタとして使う書き方です。

php
class MyWidget {
function MyWidget() { ... } // 8.0 でただのメソッドになる
function __construct() { ... } // 正しい書き方
}

実害が出たのはここでした。 コンストラクタとして認識されなくなるため、
ウィジェットを登録した瞬間に「引数が足りない」というエラーで止まります。


探し方 ―― php -l では見つからない

最初、全ファイルに構文チェック(php -l)をかけました。
結果は「エラー0件」。しかし実際にはエラーが出ます。

理由は、波括弧オフセットが「構文エラー」ではなく「コンパイル時エラー」だからです。
文法としては正しく、実行しようとした段階で初めて弾かれます。

そこで、PHPでソースコードをトークンに分解して探す方法に切り替えました。
「{ の直前が変数、または ] なら、それは波括弧オフセット」という判定です。

最初は「直前が変数」だけを見ていて、見つかりませんでした。
実際のコードは $res[$entry]{'status'} ── 直前は ] だったからです。
実物を見て条件を直すしかありませんでした。


やらかした話 ―― 直したつもりが壊した

PHP4形式のコンストラクタを __construct に置き換える処理を自動化したところ、
2箇所で「同じメソッドが二重に定義されている」というエラーを出しました。

原因は名前空間です。

php
namespace categoryPosts;
class Widget {
function Widget() { ... } // これは PHP4形式ではない
function __construct() { ... } // すでに存在する
}

名前空間の中では、クラス名と同じ名前のメソッドはもともとコンストラクタではありません。
そこを機械的に書き換えたため、既存の __construct と衝突しました。

対処:走査する前に「このファイルに namespace 宣言があるか」を判定し、
あれば対象から外すようにしました。あわせて、書き換えたファイルが構文チェックを
通らなかったら、自動でバックアップから戻す
仕組みも入れています。

結果、本番では誤って書き換えたファイルは0件でした。

教訓は2つです。

  1. 機械的な一括置換は、例外パターンを先に洗い出してから。
  2. 「直したあとに壊れていないか確認し、壊れていたら自動で戻す」まで含めて自動化する。

効果

デバッグ表示を有効にして、1ページあたりに出る警告の数を測りました。

実施前 実施後
1ページあたりの警告 約2,100件 0件
HTMLのサイズ 約530KB 約42KB

HTMLが530KBもあったのは、警告メッセージそのものがページに出力されていたためです。
約490KBが警告でした。表示速度にも影響します。


手順で一番大事なこと

コードを直してから、バージョンを上げる。 これに尽きます。

× PHPを8.3に切り替える → 真っ白 → 原因を探す
○ 7.4 のままコードを直す → 残り0件を確認 → 8.3 に切り替える

後者なら、切り替えた瞬間には何も起きません。実際、何も起きませんでした。


これから移行される方へ

  1. 全ファイルを機械的に走査する。 目視では必ず漏れます
  2. php -l を信用しすぎない。 構文エラーにならない非互換があります
  3. 一括置換は例外パターンを洗ってから。 特に名前空間
  4. 書き換え前のファイルを必ず残す。 自動で戻せるようにしておく
  5. バージョンを上げるのは最後。 順番を逆にしない

同じことを、御社のサイトでも

当社はこの作業を、まず自社のサイトで通しました。 手順も、つまずいた箇所も、
すべて自分たちで経験したものです。人のサイトで試したことはありません。

同じ内容を、御社のサイトでもお引き受けします。

内容
現状の棚卸し 引き継ぎ時の7点、表示速度、検索エンジンから見た状態を実測してご報告します
バージョンの現行化 WordPress・PHP の更新。止めずに段階を踏んで上げます
表示速度の改善 画像・キャッシュ・プラグインの整理。当社は自社サイトでサーバ応答を21分の1にしました
運用保守 更新の継続、バックアップ、障害時の対応
作り直すかどうかの判断 直して使うか、作り直すか。作り直さないほうが安い場合はそう申し上げます

「まず現状を見てほしい」という段階からご相談いただけます。
調査だけで終わっても構いません。

お問い合わせはこちら


ソフトシンク株式会社は2006年から、金融・保険の基幹システムを中心に
受託開発と運用保守を手がけています。
長く使われてきたシステムの引き継ぎ・現行化についても同様に承ります。