【角蔵の備忘録】古いPHPサイトを新VPSへ集約した記録(2/4)古いPHPを動かす応急処置とDBの移植
ご注意:これは私の環境での作業記録です。新サーバーは Ubuntu 26.04 / Apache 2.4.66 / PHP 8.5 / MySQL 8.4、旧サーバーは CentOS 6・7 でした。バージョンが違えば、コマンドも挙動も変わります。特に今回の内容は応急処置で、お手本ではありません。root で作業しているため、sudo は付けていません。DB 名・ユーザー名・パスワードは伏せています。設定を変える前には、必ずバックアップを取ってください。
シリーズ:第1回 移転の理由と新サーバー構築/第2回 古いPHPとDBの移転(この記事)/第3回 SSL証明書/第4回 DNSとメール
PHP 8.5 で古いサイトが止まった原因は、PHP 7 以降で削除された関数を使っていたこと、そしてメール送信の仕組みがなかったことでした。今回はコードを書き換えずに、互換レイヤーを差し込んで動かしています。
注意:ここに書くのは「とりあえず動かす」ための応急処置です。セキュリティ面でも保守面でも、本来は mysqli や PDO にコードを書き換えるべきです。
1. 削除された関数を探す
grep -rln "mysql_" /var/www/html --include=*.php --include=*.htmlサーバーごとに必ず確認してください。 自分の場合、旧サーバーAのサイトでは0件だったのに、旧サーバーBのサイトでは使っていました。片方だけ見て安心すると、移したあとで止まります。
2. エラーログで止まった場所を確認する
tail -20 /var/log/apache2/error.log実際に出たエラーは次の3つです。
Call to undefined function mysql_connect()
→ mysql_* 関数は PHP 7 で削除Call to undefined function split()
→ split() も PHP 7 で削除/usr/sbin/sendmail: not found(mail() 実行時)
→ 新サーバーにメール送信の仕組みがない
3. 互換レイヤーを全 PHP の前に読み込ませる
mysql_* 関数は、mysqli で同じ名前の関数を再現する公開ライブラリ(GitHub の php7-mysql-shim)で補いました。split() は preg_split() で代用する関数を自分で1行書きました。この2つを1つのファイルにまとめ、auto_prepend_file で全 PHP の実行前に読み込ませています。
/var/www/prepend.php:
<?php
require "/var/www/mysql-compat.php";
function split($p, $s, $l = -1) { return preg_split("\x01" . $p . "\x01", $s, $l); }Apache 側の設定(1行だけのファイル):
echo 'php_value auto_prepend_file /var/www/prepend.php' > /etc/apache2/conf-available/prepend.conf
a2enconf prepend
systemctl restart apache2注意
auto_prepend_file は、このサーバーのすべての PHP に効きます。 新しく作るサイトにも読み込まれます。
外部のライブラリを読み込むので、中身を一度は読んでください。
自作の split() は簡易版です。旧 split() の POSIX 正規表現と、preg_split() の PCRE は細かい書き方が違います。区切り文字に \x01 を使っているのは、パターン内の / と衝突しないようにするためです。
4. 文字化けへの対処
DB は表示できるようになったものの、日本語が化けました。古い MySQL では、接続の文字コードが latin1 のまま UTF-8 の文字列を書き込んでいたためです。そこで、互換レイヤーの接続処理の直後で、接続の文字コードを latin1 に合わせました。
if ($conn instanceof mysqli) mysqli_set_charset($conn, 'latin1');注意:これは「古いデータの入れ方に合わせる」ための処置です。データの入り方はサイトによって違うので、自分の環境で必ず確認してください。
5. PHP 8 の警告
Undefined variable や Undefined array key という Warning が大量に出ます。PHP 8 では未定義の変数や配列キーに厳しくなったためです。動作は止まりませんが、ログが膨らむので、いずれ直す予定です。
6. mail() で送信できるようにする
DEBIAN_FRONTEND=noninteractive apt install -y postfixこれで sendmail のエラーは消えましたが、外部への送信(25番ポート)はタイムアウトしました。原因は、シンVPS がアカウント登録から最初の72時間、迷惑メール対策として OP25B(Outbound Port25 Blocking)をかけているためです。時間が経てば自動で外れるので、設定で回避する必要はありません。
その間に送信されたフォームメールは Postfix のキューで待機しています。Postfix は既定で最大5日間再送を試みるので、解除後に届きます。解除されたら、次のコマンドで溜まっているメールをすぐに送らせることができます。
postqueue -p # 送信待ちのメールを一覧表示
postqueue -f # すぐに再送させる注意:直接送信できるようになっても、迷惑メール扱いや受け取り拒否を避けるには、送信元ドメインの SPF レコードに新サーバーの IP を加え、IP の逆引き(PTR)も設定しておく必要があります。VPS 業者によって OP25B の扱い(期間・解除申請の要否)は違うので、自分の契約先の案内を確認してください。
7. DB の移転
旧サーバーBでダンプを取ります。
mysqldump -u root -p --single-transaction --routines --triggers \
--default-character-set=utf8mb4 --databases <DB名> | gzip > /root/<DB名>.sql.gz
zcat /root/<DB名>.sql.gz | grep -c "CREATE TABLE" # テーブル数の確認新VPS に運んで取り込み、専用ユーザーを作ります。
zcat /root/<DB名>.sql.gz | mysql
mysql -e "CREATE USER '<ユーザー>'@'localhost' IDENTIFIED BY '<パスワード>'; GRANT ALL ON <DB名>.* TO '<ユーザー>'@'localhost';"
mysql -e "SHOW TABLES FROM <DB名>;"つまずいた点
Ubuntu の MySQL 8.4 は、root がパスワードなし(OS の root ユーザーであればログインできる方式)になっています。PHP から root で接続していた古いコードは、ここで Access denied になりました。自分は root にパスワード認証を設定して回避しましたが、本来はアプリ用の専用ユーザーで接続するように直すべきです。
ダンプを取ったあとに旧サーバーへ書き込まれたデータは、新サーバーには入りません。フォームなどで DB に書き込むサイトは、DNS を切り替える直前にダンプを取り直すのが安全です。
次回は、DNS を切り替える前に Let's Encrypt の証明書を取る話です。