• Skip to primary navigation
  • Skip to main content
  • Skip to primary sidebar
  • Skip to footer

株式会社ハイファイブクリエイト

東京都を拠点にWebサイト制作やシステム構築、WordPress保守管理やウェブコンサルティングを提供。

  • SERVICE
  • ABOUT
  • WORKS
  • BLOG
  • NEWS
  • CONTACT
ホーム / ブログ / WordPress / テスト環境や開発環境を用意したら有効化しておきたいデバッグモード

テスト環境や開発環境を用意したら有効化しておきたいデバッグモード

池田祐太郎 | 2022年10月25日 更新 | 2022年8月9日 公開 コメントを書く

以前、WordPress におけるテスト環境の作り方を書きました。

WordPressのテストサイト・検証用環境の作り方

テスト環境を作成した後は、「本番環境」と「検証用途としてのテスト環境」の2つの環境が存在する状態となります。テスト環境は文字通りテストを行う環境となり、一般のアクセスはありません。そこで、テスト環境上では WordPress に関するエラーなどを早期発見できるよう、デバッグモードを有効化しておくことをおすすめします。

エラー解消がどうしてもできず、エラーが表示されると崩れてしまう場合等は状況に応じてデバッグモードを無効化にしておくなどしましょう。

ここでは、開発環境・検証環境においても同様にテスト環境としてみなしています。

目次

  • 1 WordPress のデバッグモードとは
  • 2 WordPress のデバッグモードの設定方法
  • 3 本番環境でデバッグモードを有効化したいときは
    • 3.1 デバッグのログ出力は WP_DEBUG_LOG を true
    • 3.2 ページに出力しないようにするには WP_DEBUG_DISPLAY を false
  • 4 エラー内容を把握し、安心できる WordPress 運営を

WordPress のデバッグモードとは

WordPress ではエラーが発生した場合はエラーのレベルにより実行が中断されたり、実行はされるものの構文に問題が有り適切に処理できなかったり、警告としてエラーを表示したりというケースと、表面上にエラー内容を出力しないものの将来的にエラーになりえるといった軽微なエラーのケースがあります。

エラー内容にはサーバーのパス情報やファイル名等セキュリティリスクになり得る情報が含まれているため、関係者以外には見えないのが望ましいです。

ただ、エラーが発生した場合はエラーを解消するデバッグ作業を行う必要があり、デバッグをするにはエラー内容を表示・確認することでエラー詳細を知ることができます。

このエラー詳細を表示するために、WordPress にはデバッグモードを有効化するための設定があります。デバッグモードを有効化すると、PHP や WordPress コア、プラグイン、テーマといった様々な範囲のエラー内容を画面に表示してくれます。将来の PHP で非推奨となることがわかっている関数についても教えてくれるため、PHP の更新前には確認しておくことをお勧めします。

デバッグモードを有効化し、エラーメッセージが表示されている例

この画像で隠している場所にファイル名やパス情報が記載されています。誰でもアクセスできる本番環境に表示されているのは避けるべきです。セキュリティリスクのため、デバッグモードは本番環境ではなるべく無効化のままとし、テスト環境で有効化するようにしましょう。本番環境でデバッグを行う場合は後述の方法を参考にしてください。

WordPress のデバッグモードの設定方法

WordPress の構成ファイルの中に、「wp-config.php」という WordPress の設定ファイルがあります。

WordPress に関する重要な情報を含む設定ファイルの wp-config.php

ファイルをテキストエディタで開きます。日本語版をダウンロードしていると、最後の方に「編集が必要なのはここまでです ! WordPress でブログをお楽しみください」という文字が書いてあるはずです。通常であればその直上や付近に define('WP_DEBUG', false); と書かれているはずです。

WP_DEBUG が false になっているとエラーは表示されない

false を true に変更し、保存するとデバッグモードが有効化されます。これだけでとても簡単です。

エラー非表示(デバッグモード無効): define('WP_DEBUG', false);

エラー表示(デバッグモード有効): define('WP_DEBUG', true);

保存後、エラーが表示されているかトップページや各ページ、また管理画面内の各ページにアクセスしてみましょう。何も表示されていなければ、現時点で発生しているエラーはありません。

ちなみに、あえてプラグインを古いバージョンにダウングレードし、エラーを表示させてみるとこんな感じに表示されます。今回は管理画面に Deprecated エラーが表示されました。

あえて古いプラグインを有効化してエラーを表示させた例

本番環境でデバッグモードを有効化したいときは

上の画像にもある通り、wp-config.php 内にデバッグモードの説明と注意書きがあります。

開発者へ: WordPress デバッグモード
この値を true にすると、開発中に注意 (notice) を表示します。
テーマおよびプラグインの開発者には、その開発環境においてこの WP_DEBUG を使用することを強く推奨します。
その他のデバッグに利用できる定数については Codex をご覧ください。

http://wpdocs.osdn.jp/WordPress%E3%81%A7%E3%81%AE%E3%83%87%E3%83%90%E3%83%83%E3%82%B0

「開発者へ」と書かれているため「自分には関係ないや」と思いがちですが、エラー対処を行う人はこの文章を注意してみる必要があります。デバッグモードは開発環境で使用することを強く推奨とかかれており、これは本番環境で利用しないほうがいいことを意味します。

ただ、どうしても本番環境でしか再現できないエラーなどがあると思います。そういったときは、「デバッグのログ出力」と「ページに出力しない」設定を行うことで表面上はエラー内容が表示されずにログファイルに出力されるようになります。どちらもデバッグモードを有効化した上で( define('WP_DEBUG', true); の状態)、wp-config.php ファイルに追記します。

デバッグのログ出力は WP_DEBUG_LOG を true

define('WP_DEBUG_LOG', true); と追記します。これにより、ログが発生すると debug.log ファイルが生成され、ログファイル内にエラー内容が出力されます。あとから確認するときにも便利です。ファイルが生成される場所はテーマやプラグイン等が配置されている wp-content 配下です。

wp-content 内に生成された debug.log ファイル

ちなみに、false にするとログ出力されません。

ページに出力しないようにするには WP_DEBUG_DISPLAY を false

define('WP_DEBUG_DISPLAY', false); と追記します。これにより、エラーが発生してもページ内にHTML出力されません。エラー内容をログファイルに出力するように設定しているのと組み合わせて利用します。

true にするとページにエラーが出力されます。

本番環境でエラー内容を表に出さずにログファイルに出力するようにまとめると以下となります。

define('WP_DEBUG', true); // エラーを表示するには true
define( 'WP_DEBUG_LOG', true ); // ログファイルに出力するには true
define( 'WP_DEBUG_DISPLAY', false ); // エラー内容を画面に出力しないようにするには false

エラー内容を把握し、安心できる WordPress 運営を

WordPress のデバッグモードの表示方法についての説明でした。テスト環境を構築したら是非デバッグモードは有効にしておき、いち早くエラーに気づける体制を作っておくことが安心した運営に繋がります。

「デバッグモードを有効にできるテスト環境がなく本番環境だけしかない」という場合だと、WordPress 本体や利用しているプラグイン、PHP といった更新を行ったタイミングで最悪の場合は致命的なエラーでサイトにアクセスができなくなってしまう可能性もあります。

テスト環境は本番環境とできるだけ同一の環境を再現するのが望ましいです。同一サーバー内に構築するテスト環境の構築方法は以下をご参考ください。

WordPressのテストサイト・検証用環境の作り方

WordPress 保守管理サポートでは、テスト環境の構築を含め、一部対応を含めたエラーの確認も行っています。安全に WordPress を運営したいという場合はお気軽にご相談ください。

ちなみに、「エラーメッセージを表示させず、見えないようにしたい」という場合は以下をご参考ください。
WordPress で PHP エラーメッセージを非表示にしたい時

メールコンサルティング
WordPress保守管理サービス

Filed Under: WordPress 関連タグ:保守管理

池田祐太郎

WordPressの導入を10年以上にわたって手掛けており、主に小〜中規模のコーポレートサイト・ECサイト・ブランドサイト等の企画・開発・保守・コンサルティングなどを行ってきました。2012年にハイファイブクリエイトを創業し、現在はWordPressの保守やコンサルティング、ディレクションや開発業務などを担当しています。 プロフィール詳細

Reader Interactions

コメントを残す コメントをキャンセル

メールアドレスが公開されることはありません。 ※ が付いている欄は必須項目です

For security, use of Google's reCAPTCHA service is required which is subject to the Google Privacy Policy and Terms of Use.

I agree to these terms.

この記事と関連する記事

WordPress のクロスサイト・スクリプティング被害にあった事例を共有します
2023年1月11日
タグ: セキュリティ, 保守管理
カテゴリー: WordPress
エラーログに wp-admin, wp-include 配下のファイルが含まれているエラーの対応方法
2022年11月15日
タグ: 保守管理
カテゴリー: TIPS
WordPress で PHP エラーメッセージを非表示にしたい時
2022年10月25日
タグ: php, 保守管理
カテゴリー: TIPS

人気記事

  1. git pull してもエラーが出てファイルが反映されないときの対処法
  2. 同一サーバー上に構築するWordPressのテスト環境の作り方
  3. WordPressの固定ページでタグやカテゴリーを使いたいときはカスタム投稿タイプを検討する
  4. サイト制作の要件定義書に普段書いている内容(ダウンロード可)
  5. WordPress において PHP 8.1 に更新していいかどうか検証
  6. [便利]困難な判断を10秒で AI が客観的に導き出すツールを試してみた

最初のサイドバー

WordPress保守管理サポート

Search

最近の投稿

  • [便利]困難な判断を10秒で AI が客観的に導き出すツールを試してみた
  • WordPress のクロスサイト・スクリプティング被害にあった事例を共有します
  • メール作業の生産性を向上させる最低限覚えておくべき Gmail のショートカットキー
  • タブ固定とタブ一発アクセスのショートカットキーの組み合わせでブラウザ作業の生産性を向上
  • メールフォームプラグイン MW WP Form を使いながら WP Rocket を使う場合にエラー回避する設定

カテゴリー

  • CSS初心者
  • HTML初心者
  • TIPS
  • WooCommerce
  • WordPress
  • エステサロン
  • お知らせ
  • キュレーション
  • サイトマップ
  • システム会社
  • デベロッパーツール入門
  • ブログ
  • ホームページ制作
  • ホームページ制作無料講座
  • メール
  • モバイル
  • 仕事のこと
  • 制作実績
  • 整体院
  • 美容院
  • 雑感

タグ

Android BtoC CMS css elementor git google workspace Gutenberg HTML iPhone jQuery Mac MAMP php SEO SNS ssh SSL Sublime Text Webサイト高速化 Windows WordPress WordPressカスタマイズ WordPressテーマ WordPress構築調査 WPRocket アクセス解析 アプリ クラウド クラウドソーシング サイト引っ越し サブスクリプション サーバー ショートカットキー スマホサイト スマートフォン ツール ブログ プラグイン マーケティング リニューアル 保守管理 改ざん 最適化 集客するサイト構築

アーカイブ

CONTACT

お問い合わせはこちら

Footer

  • PRIVACY POLICY
  • 情報セキュリティ基本方針
  • 特定商取引法に基づく表示
  • 転載/引用

© 2023 high five create All rights reserved.