プログラミング初心者のPHP修羅の道＃9〜PHP8上級問題を徹底追求する〜

名前空間の基本

・namespaceより前に宣言されたクラスは宣言した名前空間には含まれない（「<?php」以外の全ての文字や改行などは存在不可）

・明示的に名前空間を宣言せずにクラスの宣言を行った場合、グローバル名前空間としてトップ階層の名前空間に属するものとみなされる

・「非修飾名」とは、名前空間を含まない名前のこと相対パスのようなイメージ

・「修飾名」とは、名前空間の階層区切りを含んだ名前のこと相対パスのようなイメージ

・「完全修飾名」とは、「\」で始まる修飾名のことで絶対パスのようなイメージ

/*このファイルはaaa/bbb/ccc/Myclass.php*/
namespace aaa\bbb\ccc;

class Myclass{
  public static function showClass():void{
    print __CLASS__;
  }
}

//非修飾名
namespace aaa\bbb\ccc{
    require_once 'MyClass.php';
    print MyClass::showClass().' :非修飾名'."\n";
}
//修飾名
namespace aaa\bbb{
    require_once 'MyClass.php';
    print ccc\MyClass::showClass().' :修飾名'."\n";
}
//完全修飾名
namespace{
    require_once 'MyClass.php';
    print \aaa\bbb\ccc\MyClass::showClass().' :完全修飾名';
}

/*
出力結果
aaa\bbb\ccc\MyClass :非修飾名
aaa\bbb\ccc\MyClass :修飾名
aaa\bbb\ccc\MyClass :完全修飾名
*/

useキーワードの基本

・use命令はクラス、関数、制御文などのスコープの内部で呼び出せないため、必ずグローバルスコープかnamespaceブロック配下で呼び出す（use命令はコンパイルのタイミングでインポートを実行するため）

・インポートの有効範囲はファイル単位（現在のファイルでのみ認識）

//現在のクラスを出力するファイル(MyClass.php)
namespace aaa\bbb\ccc;

class MyClass{
  public static function showClass():void{
    print __CLASS__;
  }
}

//Main.php
require_once 'MyClass.php';

use aaa\bbb\ccc\MyClass;

print MyClass::showClass(); //出力結果：aaa\bbb\ccc\MyClass
//require_once 'Included.php';

//Included.php
print MyClass::showClass();
/*
インクルード先のこのファイルでは型のインポートが認識されないため、
not found となる
*/

・定数(use const)、関数(use function)のインポートも可能

・名前空間をインポートした場合は、名前空間の最後＋定数名/関数名でそれぞれ定数/関数を呼び出せる

//MyClass.php
namespace aaa\bbb\ccc{
    
    const AUTHER = 'PHP太郎';
    
    function hoge():string{
        return 'Hello World';
    }
}

//Main.php
require_once 'MyClass.php';

use const aaa\bbb\ccc\AUTHER;
print AUTHER; //出力結果：PHP太郎
print PHP_EOL;

use function aaa\bbb\ccc\hoge;
print hoge(); //出力結果：Hello World
print PHP_EOL;

/*名前空間をインポート*/
use aaa\bbb\ccc;

print ccc\AUTHER; //出力結果：PHP太郎
print PHP_EOL;
print ccc\hoge(); //出力結果：Hello World

・as句を付与することでエイリアス（別名）をつけることが可能

//現在のクラスを出力するファイル(MyClass.php)
namespace aaa\bbb\ccc{
    class MyClass{
        public static function showClass():void{
            print __CLASS__;
        }
    }
}

//Main.php
require_once 'MyClass.php';
require_once 'MyClass2.php';

use aaa\bbb\ccc\MyClass;
print MyClass::showClass(); //出力結果：aaa\bbb\ccc\MyClass
print PHP_EOL;

use aaa\bbb\ccc\ddd\MyClass as AnotherClass;
print AnotherClass::showClass(); //出力結果：aaa\bbb\ccc\ddd\AnotherClass

//現在のクラスを出力するファイル(MyClass2.php)
namespace aaa\bbb\ccc\ddd{
    class MyClass{
        public static function showClass():void{
            print __CLASS__;
        }
    }
}

・use命令のグループ化も可能

//現在のクラスを出力するファイル(MyClass.php)
namespace aaa\bbb\ccc{
    class MyClass{
        public static function showClass():void{
            print __CLASS__;
        }
    }
    
    class AnotherClass{
        public static function showClass():void{
            print __CLASS__;
        }
    }
}

//Main.php
require_once 'MyClass.php';

use aaa\bbb\ccc\{MyClass, AnotherClass as Ano};

print MyClass::showClass(); //出力結果：aaa\bbb\ccc\MyClass
print PHP_EOL;
print Ano::showClass(); //出力結果：aaa\bbb\ccc\AnotherClass