無料相談→
  1. ホーム
  2. コラム
  3. 引き継いだ PHP の「すいません」を探した。PHP 8 移行で困ったのは別の場所だった
コラム 保守運用
公開日

引き継いだ PHP の「すいません」を探した。PHP 8 移行で困ったのは別の場所だった

古いPHPシステムを調べる開発者と、移行前に確かめるサーバー設定・退避ファイルを描いたイラスト

この記事の要約

PHP 8移行で確認するのは、互換性のないコードだけではありません。公開ディレクトリの退避ファイル、サーバー設定、未定義キーと空欄の判定まで、引き継ぎで見落としやすい点をたどります。複数案件を再構成した話に、公式Dockerイメージでの実行例を添えています。

複数の引き継ぎ案件をもとに再構成した話です。件数や時系列も含めて組み直しており、コメントやファイル名も書き換えてあります。特定の案件のものではありません。記事中の実行結果は、公式 Docker イメージ php:7.1-apache(PHP 7.1.33)と php:8.3-apache(PHP 8.3.37)で取り直したものです。検証日:2026年11月20日。

PHP 7.1 で動いている会員サイトを引き継いだ。自前のコードだけで 2,000 ファイルを超えていて、仕様書はない。PHP 8 に上げてほしいという依頼だった。

互換性チェッカーを回す前に、grep -rn "すいません" を打った。前任者が自分で「ここはまずい」と思った場所には、何か書いてあるだろうと思ったからだ。10 件出てきた。

「すいません」10 件の中身

10 件とも同じコメントだった。

<div></div><?php /* すいません 4列にしたいので こんなやり方 */ ?>
<div></div><?php /* すいません 4列にしたいので こんなやり方 */ ?>

入力欄が 2 つの行を 4 列のグリッドに揃えるために、空の div を 2 つ足している。CSS で解決できなかったことへの謝罪で、PHP のバージョンとは関係がない。これは放置した。

古いコードと残されたメモを照らし合わせ、引き継ぎの手がかりを探す開発者のイラスト

「仮!」

謝罪の言葉ではないが、ついでに「仮」でも検索した。8 件あって、うち 4 件が同じ形をしていた。

if (isset($_SESSION['MEMBER_ID'])) {
    $member_id = $_SESSION['MEMBER_ID'];
} else {
    //header("Location:./login.php");
    $member_id = 0;
}
//仮!

未ログインならログイン画面へ飛ばす処理がコメントアウトされていて、会員 ID 0 のまま先に進む。書いた人は一時的なつもりだったはずだが、このファイルが申込・確認・完了の各画面にコピーされ、「仮!」も一緒にコピーされていた。その状態で何年か本番で動いていたことになる。

これも PHP 8 とは直接関係しない。ただ、仕様として「ログインなしで申し込める」のか、ただの戻し忘れなのかはコードからは判断できないので、お客さんに確認する項目に入れた。

ほかに、こういうコメントもあった。

$zoom = 100; // ← 過渡期の問題。未設定の場合は100%で処理しているので、データ自体にNULLが入るようにしてください

誰に向けた依頼なのかは分からない。データには今も NULL ではなく 100 が入っている。

ルートに残っていた退避ファイル

コメントの次に、公開ディレクトリのファイル一覧を見た。

index.php.20220329
php.ini.20220313
entry-confirm(w).php
member-register-backup.php
list-output_bak.php
map-display.php72
community-functions(save! htaccess対応前).php

日付付きの退避、_bak、(w)、save!。map-display.php72 は PHP 7.2 に上げたときに退避したものらしいが、本体の map-display.php はもう無く、退避側だけが残っていた。

PHP 8 への移行で問題になるのは、この退避ファイルのほうだった。

サーバーを替えると退避ファイルの扱いが変わる

古い Apache の設定では、.php を PHP に渡すのに AddHandler を使っていることがある。AddHandler はファイル名の途中にある拡張子にも反応するので、この設定なら index.php.20220329 も PHP として実行されうる(Apache の mod_mime の説明)。実行されれば、退避した時点の更新処理や認証処理がそのまま動く。今の画面で直した不具合も、退避ファイルの側には残っている。

Apache 版の公式 Docker イメージ(php:*-apache)は、FilesMatch で末尾が .php のファイルだけを PHP に渡す。

# php:8.3-apache の /etc/apache2/conf-enabled/docker-php.conf(抜粋)
<FilesMatch \.php$>
    SetHandler application/x-httpd-php
</FilesMatch>

同じ退避ファイルを両方の設定に置いて、ブラウザと同じように GET してみた。

# 実行結果(抜粋。ヘッダーは一部だけ、ファイルの中身は一部を省略)
# AddHandler application/x-httpd-php .php を足した場合
HTTP/1.1 200 OK
Content-Type: text/html; charset=UTF-8
EXECUTED-AS-PHP

# 公式イメージの設定のまま
HTTP/1.1 200 OK
<?php
$db_password = "dummy-secret";
echo "EXECUTED-AS-PHP";

今回の検証環境では、公式イメージの設定のままだと PHP として実行されず、ファイルの中身がそのまま返ってきた。Content-Type も付かないので、ブラウザによってはそのまま表示され、ダウンロードされることもある。どちらにしてもソースが外に出る。include している DB 接続ファイルのパスも読める。

PHP のバージョンを上げるときは、サーバーか Docker イメージも一緒に替えることが多い。替えた時点で、古い処理が動く危険がソースが漏れる危険に変わる。どちらの設定でも公開ディレクトリに置いておいてよいファイルではないので、移行の前に消すか、公開ディレクトリの外に移す。今回は移行作業の最初にこれをやった。

公開側に残っていた退避ファイルを、公開ディレクトリの外の保管場所へ整理するイラスト

php.ini の退避ファイル

php.ini.20220313 は消す前に、今の php.ini と差分を取った。退避版では output_buffering が無効で、今の php.ini では有効になっていた。ファイル名の日付を信じるなら、2022 年 3 月ごろに変えたことになる。

コードを検索すると、HTML を出力したあとで header() を呼んでいる画面が何か所もあった。

<html>
<head>...</head>
<body>
<?php
if ($_POST['event_id'] == NULL) {
    header("Location:./entry-check.php");
}

出力がブラウザへ送られたあとでは、header() は効かない。それでも動いていたのは、output_buffering で出力がバッファに溜まり、まだ送られていなかったからだ。たぶん「リダイレクトが効かない」という問題が起きて、コードではなく php.ini で直したのだと思う。

公式 Docker イメージには php.ini-development と php.ini-production が入っているが、どちらかを php.ini として置かないと読み込まれない(Docker Hub の php イメージの説明)。何も置かないと output_buffering は 0 になる。この画面を php:8.3-apache に置き、event_id を付けずに POST した結果がこれだ。

# 実行結果(抜粋。ヘッダーは一部だけ、本文の HTML は省略)
# php.ini を置かない場合
HTTP/1.1 200 OK
Warning: Undefined array key "event_id" in /var/www/html/redirect.php on line 5
Warning: Cannot modify header information - headers already sent by (output started at /var/www/html/redirect.php:1) in /var/www/html/redirect.php on line 6

# output_buffering = 4096 を入れた場合
HTTP/1.1 302 Found
Location: ./entry-check.php
Warning: Undefined array key "event_id" in /var/www/html/redirect.php on line 5

php.ini を置かない場合はリダイレクトされず、header() は Warning を出す(PHP マニュアルの header())。未定義キーの Warning は output_buffering を入れても出ていて、これは次の節で扱う。この Warning が画面に出るかログにだけ残るかは設定による。利用者から見ると、原因の分からないまま画面が先に進まない。

対応としては php.ini-production をもとに新しい環境の php.ini を作り、output_buffering を入れて、まず挙動を合わせた。エラーは画面に出さず、ログで見る設定にしている(PHP マニュアルのエラー設定)。header() を正しい位置に移すのはそのあとにして、画面ごとに進めている。

移行前後のサーバー設定を並べ、違いを一つずつ確認している開発者のイラスト

PHP の版や期限、環境の情報を残す台帳については、こちらに整理しています。コラムPHPのサポート期限を管理するには|環境台帳と更新予定の作り方

謝っていない書き方のほうが多い

同じ画面の $_POST['event_id'] == NULL という書き方は、全体で 500 か所ほどあった。

送られてこなかったキーを読むと、PHP 7 までは Notice、PHP 8 からは Warning になる(PHP 8.0 の互換性のない変更)。差はそれだけではなかった。php.ini を置かないときの error_reporting の既定値が違う。

# php -r 'echo error_reporting();' の結果(括弧内は定数での書き方)
php:7.1-apache  error_reporting=22519  (E_ALL & ~E_NOTICE & ~E_STRICT & ~E_DEPRECATED)
php:8.3-apache  error_reporting=32767  (E_ALL)

PHP 7.1 では Notice が既定で報告されないので、未定義キーを読んでも何も出ない。PHP 8.3 では Warning として報告され、display_errors も既定で有効なので画面に出力される。HTML より前で header() を呼んでいる画面でも、この Warning が先に出力されてリダイレクトが効かなくなる。

<?php
if ($_POST['event_id'] == NULL) {
    header("Location:./entry-check.php");
    exit;
}
?>
# 実行結果(抜粋。ヘッダーは一部だけ、本文の HTML は省略)
# php:7.1-apache
HTTP/1.1 302 Found
Location: ./entry-check.php

# php:8.3-apache
HTTP/1.1 200 OK
Warning: Undefined array key "event_id" in /var/www/html/top.php on line 2
Warning: Cannot modify header information - headers already sent by (output started at /var/www/html/top.php:2) in /var/www/html/top.php on line 3

7.1 で問題なく動いていたコードが、何も変えずに 8.3 へ載せただけで止まる。

この 500 か所には何のコメントも付いていない。このコードの中では広く使われていた書き方だったからだ。「すいません」の 10 件と比べると、手間がかかったのは圧倒的にこちらだった。

isset() か ?? に置き換えれば Warning は消える。ただし判定の中身は同じではない(PHP マニュアルの isset()、比較演算子と ??)。フォームから届く値は文字列なので、よくある 4 つの場合で比べた。

# CLI での実行結果(見やすく整形)
キーが無い     == NULL: true   isset: false   ?? 'DEFAULT': 'DEFAULT'
空欄で送信 ""  == NULL: true   isset: true    ?? 'DEFAULT': ''
"0"            == NULL: false  isset: true    ?? 'DEFAULT': '0'
"1"            == NULL: false  isset: true    ?? 'DEFAULT': '1'

違うのは空欄で送信されたときだ。== NULL は空文字でも真になるので、元のコードでは空欄の送信も入力チェックで止まっていた。!isset() にそのまま置き換えると、空文字は「値がある」と判定され、空欄のフォームが先へ進むようになる。警告を消すことと入力の判定を正しくすることは別の作業で、後者は画面ごとに「値が来ないとき、空のときにどう振る舞うべきか」を確かめるしかない。

空欄などの入力条件を変えながら、フォームの動きと業務のルールを人が確認するイラスト

AI にも探させた。「PHP 8 で削除された each() を使っている場所」と頼むと 22 件返ってきて、全部 jQuery の $.each() だった。キーワードで拾える問題は少なく、拾えたものも 1 件ずつ人が見ることになる。

結局どこが壊れたか

今回の案件で、PHP 8 に上げる前後で手を入れたのはこうなった。

  • 公開ディレクトリの退避ファイル。移行前に全部移動
  • output_buffering に頼ったリダイレクト。php.ini で合わせてから順次修正
  • 未定義キーの読み出し 500 か所。?? への置き換えと、空の値の扱いを画面ごとに確認
  • 「仮!」のログイン判定。仕様をお客さんに確認中

「すいません」と書かれていた 10 か所は、どれにも入っていない。前任者が謝っていた場所は本人も問題を分かっていた場所なので、範囲が狭く、何をしたかも読めば分かる。手間がかかったのは、誰も問題だと思っていなかった書き方と、コードの外にある設定だった。

それでも grep から始めたのは無駄ではなかった。「すいません」の検索から退避ファイルに目が行き、php.ini の差分にたどり着いている。互換性チェッカーはコードしか見ないので、php.ini の退避ファイルは見つけてくれない。

謝罪コメントは消していない。「仮!」のように判断が要るものはチケットにして、決まったら消す。空の div の「すいません」は CSS を直すまでそのままにしておく。

参考

古い PHP システムの引き継ぎで、どこから調べるか迷ったら

引き継いだシステムでは、コードだけでなく、サーバー設定や日々の業務まで確かめる必要があります。「仕様書がない」「作った担当者がいない」「PHP を上げたいが、何が壊れるか分からない」。そんな段階から、Ouverへご相談いただけます。

Ouverでは、ソースコードとサーバー環境を調べ、引き継ぎの可否や、保守・改修の範囲を整理します。今のシステムを活かす方法、部分的に直す方法、作り直す方法も含め、業務への影響と優先順位を一緒に考えます。

他社開発システムの保守運用引き継ぎについて見る

古い業務システムの保守・改修の進め方を見る

引き継ぎ前に整理する項目と、移行・再構築を判断する考え方は、こちらのコラムで紹介しています。

コラムシステム保守の引き継ぎチェックリスト|後任と確認する4つのこと

コラムPHP 5から8へのバージョンアップか、再構築か?実例2件で見る判断基準

コラム一覧に戻る

何から相談すればいいか分からない、でOK。

業務システムの新規開発・刷新、保守運用引き継ぎ、業務改善のご相談をお受けしています。何を相談すればいいか決まっていない段階でも構いません。