メインコンテンツへスキップ
見出し画像

本番を止めずにPHP 7.4→8.2へ移行するためにやったこと|Amazon Linux 2・AMI・yum依存関係エラー

    はじめに

    2026年10月、PHPの重大なセキュリティ脆弱性に関する情報が公開されました。

    PHP公式では、認証されていないリモートユーザーによるコード実行につながる可能性がある脆弱性への対応として、PHP 8.2.35などのセキュリティ修正版がリリースされています。

    ちょうど管理しているAWS環境に、古いPHP 7.4で稼働しているWebサーバーが残っていたため、この機会にアップグレードを実施しました。

    今回の構成は以下です。

    • Amazon Linux 2

    • Nginx

    • PHP-FPM

    • AWS EC2

    • Application Load Balancer(ALB)

    PHPは 7.4.15から8.2.35 へ更新しました。

    作業中、php-jsonの依存関係によって通常のyum updateが失敗する問題が発生しましたが、yum shellで解決できました。

    この記事では、実際に実行したコマンドと対応方法を記録します。

    ※今回の対応は、古いPHP環境のリスクを低減するためのものです。Amazon Linux 2自体はサポート終了済みのため、OS移行も別途必要です。

    1. なぜPHPをアップグレードしたのか

    理由は大きく2つあります。

    PHP 7.4はすでにサポート終了

    PHP 7.4は2022年11月に公式サポートを終了しています。

    公式のセキュリティ修正が提供されなくなったバージョンを使い続けることは、Webサーバーの運用上のリスクになります。

    2026年10月に重大な脆弱性が公開された

    PHP公式は2026年10月21日、リモートコード実行につながる重大な脆弱性についてセキュリティアドバイザリを公開しました。

    PHP 8.2系では、8.2.35が修正版として公開されています。

    今回、Amazon Linux 2の公式リポジトリで取得可能だったPHP 8.2.35へ更新しました。

    ただし、PHP 8.2も2026年12月31日にセキュリティサポートが終了するため、長期的にはPHP 8.3以降への移行を検討する必要があります。

    2. 本番EC2を直接更新しない

    今回の作業では、既存EC2を直接更新しませんでした。

    まず既存EC2のAMIを取得し、そのAMIから新しいEC2を起動しています。

    構成イメージ:

    【更新前】
    
    ALB
     └── 既存EC2
          ├── Amazon Linux 2
          ├── Nginx
          └── PHP 7.4.15
    
    
    【検証中】
    
    ALB
     └── 既存EC2(PHP 7.4.15)
    
    新EC2(AMIから起動)
     ├── Amazon Linux 2
     ├── Nginx
     └── PHP 8.2.35

    新EC2でアップグレードと動作確認を行い、問題がなければALBの転送先を切り替える方針です。

    この方法なら、既存環境を残したまま検証でき、切り戻しも容易です。

    3. 現在のPHP環境を確認

    まずOSを確認します。

    cat /etc/os-release

    PHPのバージョンを確認します。

    php -v
    php-fpm -v

    結果:

    PHP 7.4.15

    インストールされているPHPパッケージも確認します。

    rpm -qa | grep '^php' | sort
    php-cli-7.4.15-1.amzn2.x86_64
    php-common-7.4.15-1.amzn2.x86_64
    php-fpm-7.4.15-1.amzn2.x86_64
    php-json-7.4.15-1.amzn2.x86_64
    php-mbstring-7.4.15-1.amzn2.x86_64
    php-mysqlnd-7.4.15-1.amzn2.x86_64
    php-pdo-7.4.15-1.amzn2.x86_64
    php-xml-7.4.15-1.amzn2.x86_64

    4. Amazon Linux ExtrasをPHP 8.2へ切り替える

    利用可能なPHPリポジトリを確認します。

    amazon-linux-extras list | grep -i php

    今回の環境では、PHP 7.4が有効で、PHP 8.2が利用可能でした。

    まずPHP 7.4のリポジトリを無効化します。

    sudo amazon-linux-extras disable php7.4

    続いてPHP 8.2を有効化します。

    sudo amazon-linux-extras enable php8.2

    yumのメタデータを更新します。

    sudo yum clean metadata
    sudo yum makecache

    更新可能なパッケージを確認します。

    sudo yum list updates 'php*'

    PHP 8.2.35が取得可能であることを確認できました。

    5. PHPアップグレードのDry Runでエラー発生

    まずは実際に更新せず、Dry Runを実行します。

    sudo yum update --assumeno 'php*'

    ところが、依存関係エラーが発生しました。

    エラー: パッケージ: php-json-7.4.15-1.amzn2.x86_64
    
    要求:
    php-common(x86-64) = 7.4.15-1.amzn2

    原因は、PHP 7.4のphp-jsonパッケージでした。

    php-jsonはPHP 7.4のphp-commonに依存しています。

    一方、アップグレードではphp-commonを8.2.35に更新するため、依存関係が競合してしまいます。

    PHP 8.2ではJSON機能がPHP本体に組み込まれているため、独立したphp-jsonパッケージは不要です。

    6. php-jsonだけを削除しようとすると…

    そこで、php-jsonだけを削除できるか確認しました。

    sudo yum remove --assumeno php-json

    しかし、結果は想定と異なりました。

    削除中:
     php-json
    
    依存性関連での削除:
     php-cli
     php-common
     php-fpm
     php-mbstring
     php-mysqlnd
     php-pdo
     php-xml

    php-jsonだけでなく、PHP関連パッケージがまとめて削除対象となりました。

    この状態で削除を実行すると、PHP-FPMも削除され、Webアプリケーションが動作しなくなる可能性があります。

    そこで、単独削除は行わず、別の方法を使うことにしました。

    7. yum shellで削除と更新を同時に実行

    今回うまくいったのが、yum shellを使用する方法です。

    yum shellでは、複数の操作を一つのトランザクションとして処理できます。

    まず起動します。

    sudo yum shell

    続いて以下を入力します。

    remove php-json
    update php-cli php-common php-fpm php-mbstring php-mysqlnd php-pdo php-xml
    ts solve
    ts list

    ts solveで依存関係を解決し、ts listで実行予定の内容を確認します。

    今回の結果は以下のとおりでした。

    操作パッケージバージョン更新php-cli8.2.35更新php-common8.2.35更新php-fpm8.2.35更新php-mbstring8.2.35更新php-mysqlnd8.2.35更新php-pdo8.2.35更新php-xml8.2.35削除php-json7.4.15

    トランザクションの要約
    
    更新  7 パッケージ
    削除  1 パッケージ

    想定どおりの結果になりました。

    問題がないことを確認してから、以下を実行します。

    run

    これでPHP 8.2.35へのアップグレードが完了しました。

    ポイントは、php-jsonの削除とPHP本体の更新を同じトランザクションで実行することです。

    8. アップグレード後の確認

    PHPのバージョンを確認します。

    php -v
    php-fpm -v

    結果:

    PHP 8.2.35

    PHP-FPMの設定を確認します。

    sudo php-fpm -t

    Nginxの設定も確認します。

    sudo nginx -t

    問題がなければPHP-FPMを再起動します。

    sudo systemctl restart php-fpm

    サービスの状態を確認します。

    sudo systemctl is-active nginx php-fpm

    PHP拡張モジュールも確認しておきます。

    php -m

    最後にエラーログを確認します。

    sudo journalctl -u php-fpm -n 100 --no-pager
    sudo tail -n 100 /var/log/nginx/error.log

    今回の環境では、PHP 8.2.35への更新後、基本動作に問題がないことを確認できました。

    なお、サービスの起動確認だけではアプリケーション全体の互換性を保証できません。実際のWebアクセスや主要機能の検証も必要です。

    9. ALB配下のEC2を安全に切り替える

    PHP更新後は、新EC2でアプリケーションの動作確認を行い、ALBの転送先を変更する予定です。

    おすすめは、新旧のEC2でターゲットグループを分ける方法です。

    ALB
     ├── 旧ターゲットグループ
     │    └── 旧EC2(PHP 7.4)
     │
     └── 新ターゲットグループ
          └── 新EC2(PHP 8.2.35)

    新ターゲットグループのヘルスチェックと動作を確認してから、ALBのリスナールールを変更します。

    問題があれば旧ターゲットグループへ戻すことで、比較的短時間で切り戻せます。

    ただし、データベース、セッション、アップロードファイル、定期処理などの状態管理については、事前に確認が必要です。

    10. 今回の対応で学んだこと

    今回の作業で特に重要だと感じたのは、以下の点です。

    1. PHPのメジャーアップグレードは、既存サーバーを直接更新しない

    AMIから新EC2を起動することで、本番環境への影響を抑えながら検証できました。

    2. yumのDry Runは必ず実施する

    通常のyum updateでは、php-jsonの依存関係エラーを事前に検出できました。

    3. 依存パッケージの削除対象を確認する

    php-jsonの単独削除では、PHP-FPMを含む複数のパッケージが削除対象になりました。

    4. yum shellで複数の操作を一つのトランザクションにまとめる

    今回のような依存関係の問題では、削除と更新を同時に扱うことで解決できるケースがあります。

    5. PHPを更新してもセキュリティ対策は終わらない

    PHP本体だけでなく、OS、Webサーバー、依存ライブラリ、アプリケーション全体の更新が必要です。

    11. 今後の課題:OSを含めた段階的なアップデート

    今回PHP 8.2.35へのアップグレードは完了しましたが、これで長期的なセキュリティ対策が完了したわけではありません。
    本来であればOSを含めた環境全体の刷新が望ましいものの、稼働中のシステムでは、アプリケーションの互換性や運用への影響も考慮する必要があります。

    Amazon Linux 2は2026年6月30日にサポートを終了しています。
    また、PHP 8.2のセキュリティサポートも2026年12月31日に終了します。

    そのため、今後は以下を検討しています。

    • Amazon Linux 2023への移行

    • PHP 8.3以降への更新

    • アプリケーションの互換性確認

    • 定期的なセキュリティアップデート運用の見直し

    今回の対応は、既存環境のリスクを低減するための一段階として位置づけています。

    まとめ

    Amazon Linux 2でPHP 7.4から8.2.35へアップグレードした際、php-jsonの依存関係エラーに遭遇しました。

    最終的にはyum shellを使い、php-jsonの削除とPHP関連パッケージの更新を同時に実行することで解決できました。

    PHPの脆弱性対策は、単に更新コマンドを実行するだけでなく、依存関係や本番環境への影響、切り戻し方法まで考慮することが重要だと改めて感じました。

    同じようにAmazon Linux 2で古いPHPを運用している方の参考になれば幸いです。


    参考リンク

    この記事は2026年10月時点の環境と実際の作業記録をもとに作成しています。実行する際は、各環境の構成や依存パッケージを確認し、バックアップと検証を行ってください。

     
     
    株式会社T-Garden 2007年ヤフーに新卒入社しモバイル検索などのPF開発に従事。ベンチャー・フリーランスでは主にソーシャルゲームの開発。現職ではEC・物流システム連携の構築から、売上・在庫等の社内データの可視化、RPAによる業務改善などのDXを推進。

    あなたへのおすすめ