名前空間の使用法: エイリアス/インポート
(PHP 5 >= 5.3.0, PHP 7, PHP 8)
外部の完全修飾名をエイリアスで参照したりインポートしたりする機能は、 名前空間において非常に重要なものです。 これは、Unix 系のファイルシステムでファイルやディレクトリへのシンボリックリンクを作成することに似ています。
PHP は定数、関数、クラス、インターフェイス、名前空間のエイリアスやインポートをサポートしています。
エイリアス作成には use 演算子を使用します。
ここに、5 種類すべてのインポート方法の例を示します。
例1 use 演算子によるインポート/エイリアス
<?phpnamespace foo;use My\Full\Classname as Another;// これは use My\Full\NSname as NSname と同じですuse My\Full\NSname;// グローバルクラスをインポートしますuse ArrayObject;// 関数をインポートしますuse function My\Full\functionName;// 関数のエイリアスを定義しますuse function My\Full\functionName as func;// 定数をインポートしますuse const My\Full\CONSTANT;$obj = new namespace\Another; // foo\Another クラスのオブジェクトのインスタンスを作成します$obj = new Another; // My\Full\Classname クラスのオブジェクトのインスタンスを作成しますNSname\subns\func(); // My\Full\NSname\subns\func 関数をコールします$a = new ArrayObject(array(1)); // ArrayObject クラスのオブジェクトのインスタンスを作成します// "use ArrayObject" がなければ、foo\ArrayObject クラスのオブジェクトのインスタンスを作成することになりますfunc(); // 関数 My\Full\functionName を呼びますecho CONSTANT; // 定数 My\Full\CONSTANT の値を表示します?>
名前空間つきの名前 (完全修飾形式の名前空間は区切り文字を含んだ
Foo\Bar のようなもので、グローバルな場合は区切り文字を含まない
FooBar のようになります)
では先頭のバックスラッシュは不要で、推奨されないことに注意しましょう。
インポートする名前は完全修飾形式でなければならず、
現在の名前空間からの相対指定で処理されることはないからです。
PHP では、複数の use 文を同一行に置くための便利なショートカットもサポートしています。
例2 use 演算子によるインポート/エイリアスで、複数の use 文を組み合わせる例
<?phpuse My\Full\Classname as Another, My\Full\NSname;$obj = new Another; // My\Full\Classname クラスのオブジェクトのインスタンスを作成しますNSname\subns\func(); // My\Full\NSname\subns\func 関数をコールします?>
インポートはコンパイル時に行われるので、動的なクラス名、関数名や定数名には影響を及ぼしません。
例3 インポートと動的名
<?phpuse My\Full\Classname as Another, My\Full\NSname;$obj = new Another; // My\Full\Classname クラスのオブジェクトのインスタンスを作成します$a = 'Another';$obj = new $a; // Another クラスのオブジェクトのインスタンスを作成します?>
さらにインポートの影響が及ぶのは非修飾名および修飾名のみです。 完全修飾名は絶対的なものであり、インポートの影響を受けることはありません。
例4 インポートと完全修飾名
<?phpuse My\Full\Classname as Another, My\Full\NSname;$obj = new Another; // My\Full\Classname クラスのオブジェクトのインスタンスを作成します$obj = new \Another; // Another クラスのオブジェクトのインスタンスを作成します$obj = new Another\thing; // My\Full\Classname\thing クラスのオブジェクトのインスタンスを作成します$obj = new \Another\thing; // Another\thing クラスのオブジェクトのインスタンスを作成します?>
インポート時のスコープ規則
use キーワードの宣言は、ファイル内の一番外側のスコープ (グローバルスコープ)
あるいは名前空間宣言の中で行わなければなりません。
これは、インポートが実行時ではなくコンパイル時に行われるためです。
ブロック内のスコープではインポートできません。
次の例は、use キーワードの間違った使い方を示すものです。
例5 間違ったインポートの例
<?phpnamespace Languages;function toGreenlandic(){ use Languages\Danish; // ...}?>
注意:
インポート規則はファイル単位のものです。つまり、インクルードされたファイルは インクロード元の親ファイルのインポート規則を 引き継ぎません。
use 宣言のグループ化
同じ namespace から複数のクラスや関数そして定数をインポートする際には、
それらをひとつの use にまとめることができます。
<?phpuse some\namespace\ClassA;use some\namespace\ClassB;use some\namespace\ClassC as C;use function some\namespace\fn_a;use function some\namespace\fn_b;use function some\namespace\fn_c;use const some\namespace\ConstA;use const some\namespace\ConstB;use const some\namespace\ConstC;// 上記のコードは、グループ化されたuse宣言と同等です。use some\namespace\{ClassA, ClassB, ClassC as C};use function some\namespace\{fn_a, fn_b, fn_c};use const some\namespace\{ConstA, ConstB, ConstC};
