Debug Bar Constants

FAQ

インストール手順

1. インストールされてない場合は、 Debug Bar (https://wordpress.org/plugins/debug-bar/) をインストールします。
2. このプラグインの .zip ファイルを解凍し、その内容を /wp-content/plugins/ ディレクトリにアップロードします。または、WordPress インストール内の Plugin ディレクトリから直接インストールすることもできます。
3. 「プラグイン」メニューからプラグインを有効化します。

このプラグインを本番サイトで使用しないでください。このプラグインは、開発目的での使用のみを想定しています。

本番サイトで使用できますか?

やめてください! 定義されている定数の中にはデータベースの認証情報が含まれているので、このようなことは絶対にしないでください。
このプラグインは、開発目的でのみ使用されます。

定数とは ?

PHP.net から:

定数とは、単純な値の識別子 (名前) です。その名前が示すように、スクリプトの実行中にその値が変更されることはありません。定数は、デフォルトでは大文字と小文字を区別します。慣習上、定数の識別子は常に大文字になります。

スーパーグローバルと同様、定数のスコープはグローバルです。スコープに関係なく、スクリプト内のどこにいても定数にアクセスできます。スコープの詳細については、マニュアルの変数のスコープのセクションを参照してください。

WordPress 定数リストに、私の定数が見当たりません。何が原因ですか ?

おめでとう! リーン・プログラミングを実践している様ですね (或いは、何かが間違っているか… 😉 )。

表示される定数は、現在のリクエストで利用可能なものです。条件付きでインクルードされたファイルに定数を定義した場合 (例えば、特定のページにいるときだけファイルをインクルードする)、条件が満たされていない場合、これらの定数は使用できません。

各ページ/ほとんどのページで、定数の数が異なっています。どうして ?

前の回答を参照してください。

クラス定数とは ?

PHP.net: から:

同じままで変更できない定数値を、クラスごとに定義することも可能です。定数は、通常の変数と異なり、宣言や使用に $ シンボルを使用しません。

値は定数式でなければならず、(例えば)変数、プロパティ、数学演算の結果、関数呼び出しであってはなりません。

プラグインやテーマは、通常の定数の代わりにクラス定数を、なぜ使うのですか ?

独自の変数や定数でグローバル名前空間を散らかさないようにするのは、コーディングのグッド・プラクティスです。これはそれを避ける良い方法です。

定義されたクラス定数を理解することが、なぜ有用なのですか ?

あなたのプラグインやテーマが他のプラグインやテーマと相互作用する場合、それらの定数を使いたいかもしれません。
例: プラグインは、バージョン番号をクラス定数として保存しているかもしれません (グッド・プラクティス!)。あなたの側では、関連するプラグインがバージョンxにアップグレードされた場合にのみ、あなたのプラグインが動作するように設定されている可能性があります。その場合、あなたのプラグインが他のプラグインと相互作用する前に、他のプラグインのバージョン番号をチェックしたほうが良いでしょう。

使用する前に、クラス定数が存在するかどうかを常にチェックすることを忘れないでください! すべてのページで利用できるとは限りませんし、すべての WordPress インストールで利用できるとは限りません。

if( defined( 'class_name::constant_name' ) ) {
    // Your code here
}

WordPress クラス定数リストに、私のクラスが見当たりません。何が原因ですか ?

• プラグインやテーマのプログラムによっては、あなたのクラスが表示中のページに含まれていない (つまり宣言されていない) 可能性があります。
• クラスの名前は、PHP のネイティブ/拡張クラスの名前と同じにすることができます。PHP は通常、限られた数の拡張モジュールで構成されています。利用可能な拡張モジュールの多くは、ロード時にクラスを宣言し、WordPress クラス定数リストはこれらのクラスのためにフィルタリングされます。これらの PHP ネイティブ/拡張クラスの名前を、独自クラスに使わないことはグッドプラクティスです。クラス名を変更してみてください。それでもうまくいかない場合は、教えてください。私も見てみます。

-私のサーバーにロードされているエクステンションのものだけでなく-*すべての*ネイティブ/拡張 PHP クラスが、なぜフィルタリングされるのですか ?

簡単に: PHP のネイティブクラスや拡張クラスと同じ名前をつけるのはよくありません。

一般的に、プラグイン/テーマを開発する場合、- どの拡張モジュールがインストールされているか (されていないか) も含めて- 未知のサーバー構成を持つ、未知の人々のために開発することになりますから、あなたのクラスが PHP のネイティブ/拡張クラスと干渉しないようにしなければなりません。

WordPress クラス定数リストに、いくつかの PHP クラスとその定数があります。何が原因ですか ?

このリストからすべての PHP クラスを除外してみたが、見落としがあるかもしれません。また、このプラグインの最後のバージョンがリリースされてから、 PHP に新しい拡張モジュールやクラスが導入されたかもしれません。
除外リストに追加しますので、見つけたクラスを教えてください。

プラグインが有効にならないのは、なぜ ?

プラグインページの一番上にある美しく赤いバーに書いてあることを読みましたか ? そこに書いてある通り、このプラグインが動作するには Debug Bar プラグインが有効である必要があります。Debug Bar プラグインが有効でない場合、このプラグインは自動的に無効化されます。