PHPのエイリアスと名前空間インポート：use演算子の使い方を徹底解説

はじめに

名前空間の重要な機能のひとつが、外部の完全修飾名に対してエイリアス（別名）を付けられることです。これは一般に「インポート」と呼ばれます。PHPの名前空間では、次のような種類のエイリアス／インポートがサポートされています。

• クラス名のエイリアス
• インターフェース名のエイリアス
• 名前空間名のエイリアス
• 関数名・定数名のエイリアス（インポート）

PHPでは、use 演算子を使ってエイリアスを作成します。

use 演算子の基本

ひとつのファイル内に複数の名前空間を宣言し、それぞれに同名の関数を定義しても、名前空間が異なるため競合せずに共存できます。

#test1.php
<?php
namespace mynamespace;
function sayhello(){
    echo "Hello from mynamespace\n";
}
sayhello();

namespace mynewspace;
function sayhello(){
    echo "Hello from my new space\n";
}
sayhello();
?>

出力結果：

Hello from mynamespace
Hello from my new space

なお、PHP 5.6 以降では関数や定数も use function／use const を使ってインポートでき、as で別名を付けることも可能です。

<?php
use function mynamespace\sayhello as hello; // 関数のエイリアス
use const mynamespace\MYCONST as MC;        // 定数のエイリアス
?>

複数の use 宣言をまとめる

use はカンマで区切ることで、1つの宣言で複数のクラスやインターフェースをまとめてインポートできます。

<?php
namespace mynamespace;
class myclass{
    function test() { echo "myclass in mynamespace\n"; }
}
class testclass{
    static function test() { echo "testclass in mynamespace\n"; }
}

use \mynamespace\myclass as myclass, \mynamespace\testclass;

$a = new myclass();
$a->test();

$b = new \mynamespace\testclass();
$b->test();
?>

出力結果：

myclass in mynamespace
testclass in mynamespace

インポートと動的な名前

変数に格納した文字列を使って、インポート済みのクラスを動的にインスタンス化することもできます。

<?php
namespace mynamespace;
class myclass{
    function test() { echo "myclass in mynamespace\n"; }
}
class testclass{
    static function test() { echo "testclass in mynamespace\n"; }
}

use \mynamespace\myclass as myclass;

$a = new myclass;  // エイリアス名でインスタンス化
$b = 'myclass';
$c = new $b;       // 変数経由でも同じクラスを参照できる
?>

use の記述位置に関するルール

use は、ファイルの最も外側（グローバルスコープ）か、名前空間宣言の中でのみ記述できます。インポート処理は実行時ではなくコンパイル時に行われるため、関数内などのブロックスコープでは使えません。したがって、次のコードは不正です。

<?php
function myfunction(){
    use myspace\myclass; // エラー：関数内では use は使えない
}
?>

また、include や require で読み込まれたファイルは、親ファイルのインポート設定を引き継ぎません。エイリアスのルールはファイルごとに独立しています。