はじめに
PHPのバージョンアップやWordPressの更新により、以前は問題なかったコードでも非推奨となり、大量の「Deprecated」警告がログに出力されることがあります。これらの警告は、今後のPHPの機能削除や変更を予告する重要な情報ですが、大量に出るとシステムの正常な動作に影響を与える可能性があります。
本記事では、「Deprecated」警告が出る原因とその解決策について詳しく説明します。
症状・背景
- PHPのバージョンアップ後に大量の「Deprecated」警告がログに出力される
- WordPressの更新後、プラグインやテーマから非推奨なPHPコードを使用している可能性がある
- サイトパフォーマンスに影響が出る場合がある（サーバーコンソールで大量にログが出力されると処理速度が低下する）
- フロントエンドのユーザーインターフェース上に出力されることがあり、ユーザビリティを損なう可能性がある
手順・設定方法
ステップ1: サイトとログを確認する
# WordPressサイトにアクセスして、管理画面から「システム情報」をチェック
wp core version --path=/var/www/html/your-wordpress-site/
# ログファイルを開いて非推警告を探します。
tail -f /var/log/apache2/error.log | grep "PHP Deprecated"ステップ2: 非推奨コードの特定と修正
# WordPressプラグインディレクトリを検索して、非推奨なコードを探す
grep -r 'trigger_error\(.*"Deprecated'.*'\)' /var/www/html/your-wordpress-site/wp-content/plugins/
# 非推奨コードの修正またはアップデートを実行
wp plugin update --allステップ3: テーマやカスタムスクリプトの更新
# WordPressテーマディレクトリを検索して、非推奨なコードを探す
grep -r 'trigger_error\(.*"Deprecated'.*'\)' /var/www/html/your-wordpress-site/wp-content/themes/
# テーマのオフィシャルページから最新版をダウンロードし、更新する
wget https://downloads.wordpress.org/theme/twentytwentytwo.2.1.zip
unzip twentytwentytwo.2.1.zip -d /var/www/html/your-wordpress-site/wp-content/themes/
# カスタムスクリプトの修正
nano /var/www/html/your-wordpress-site/wp-content/mu-plugins/custom-code.phpステップ4: PHP設定を確認・更新
# PHPの現在のバージョンと設定を確認
php -v
cat /etc/php/7.3/apache2/php.ini | grep 'display_startup_errors'
# 非推奨警告の出力を無効にするため、php.iniを編集します。
sed -i 's/display_startup_errors = On/display_startup_errors = Off/' /etc/php/7.3/apache2/php.ini
service apache2 restart注意事項
- PHPの非推奨警告は将来的な問題解決に役立つ情報ですが、大量に出るとサイトパフォーマンスに影響を与える可能性があります。
- 非推奨コードを修正またはアップデートする前に、その変更が他の部分に影響しないことを確認してください。
- PHP設定の変更は慎重に行い、予期せぬ問題が出ないようテスト環境で実施することをおすすめします。
- 重要なデータはバックアップを取ってから更新や設定変更を行うこと。
まとめ
1. 非推奨警告の特定: ログファイルやサイト内を探して非推奨コードを見つけます。
2. プラグインとテーマの更新: 管理画面から最新版に更新します。必要であれば公式ページを確認します。
3. カスタムスクリプトの修正: 自作のPHPスクリプトは特に注意が必要で、最新のバージョンや代替方法を探します。
4. PHP設定の調整: php.iniファイルを開いて非推奨警告を無効化する設定を行います。
5. テストとバックアップ: 変更後は必ずサイトが正常に動作することを確認し、変更前の状態に戻せるようバックアップを取ります。
関連記事: