Lesson11では名前空間について学習していきます。名前空間の存在は開発を行う段階から、開発後の運用に至るまで主に効率化へ該当します。

名前空間とは

簡単に説明すると名前空間とは関数名やクラス名などの競合を防ぐ為にグループ分けしておく仕組みのことを言います。 実際の現場では複数人でプロジェクトを遂行する場合がほとんどで、記述量も増え関数名やクラス名で重複が発生しやすくなります。

関数名やクラス名を変えるのも一つの手ですが、今後追加機能があったり、コード量が増えていくことを想定するとリスクも高く、開発のしづらい環境となってしまいます。 これらを防ぐために名前空間という仕組みを取り入れておくことが大切になります。

このように◯◯で定義されている◯◯関数を使用する。と限定することができれば、関数名が変わったり追加されたりしても処理に影響なく開発を進めていくことが実現できます。 又、開発者は「誰が見てもわかりやすく丁寧なコード」を心掛ける必要があるので、そういった意味でも名前空間を使用すると良いでしょう。

それでは実際に名前空間を使用してみましょう。 名前空間名は任意ですが、別ファイルの名前空間名の被らないよう注意してください。

名前空間　namespace

名前空間

namespace 名前空間;

例をもとに学習していきます。下記構成でファイルを作成しましょう。

XAMPP > htdocs > Lesson11 > subA.php

subA.php

<?php

namespace subA

function HelloMessage(){
  return "hello_A";
}

XAMPP > htdocs > Lesson11 > subB.php

subB.php

<?php

namespace subB

function HelloMessage(){
  return "hello_B";
}

続いて呼び出す側のファイルを作成します。

XAMPP > htdocs > Lesson11 > main.php

main.php

<?php
require_once "subA.php";
require_once "subB.php";

echo subA\HelloMessage();
echo "<br>"
echo subB\HelloMessage();

出力結果

hello_A
hello_B

このようにそれぞれのファイルで定義した同じ関数の呼び出しに成功しました。

続いてnamespaceと同時に「use」についても学習しましょう。 今回はsubAとsubBとしていますが、名前空間名が長い命名だったりすると毎回呼び出す際に手間になります。 useを使用することで呼び出す際の名前空間名を変更することが可能です。

名前空間　use

use

use 名前空間名 as 呼び出す際の名前空間名;

main.phpにuseを追加します。

XAMPP > htdocs > Lesson11 > main.php

main.php

<?php
require_once "subA.php";
require_once "subB.php";

// 追加
use subA as sA;
// 追加
use subB as sB;

echo sA\HelloMessage();
echo "<br>"
echo sB\HelloMessage();

出力結果

hello_A
hello_B

このように基本的にはnamespaceとuseはセットで使用していくことが多くあるので認識しておきましょう。上記は関数の呼び出しを行いましたが、クラスを使用している場合は下記になります。

subA.php

<?php
namespace subA;

class HelloMessageA
{
  function HelloMessage(){
    return "hello_A";
  }
}

subB.php

<?php
namespace subB;

class HelloMessageB
{
  function HelloMessage(){
    return "hello_B";
  }
}

main.php

<?php
require_once "subA.php";
require_once "subB.php";

use subA as sA;
use subB as sB;

//「new 名前空間\クラス名」でインスタンス化
$helloA = new sA\HelloMessageA;
$helloB = new sB\HelloMessageB;

// インスタンス化したクラスからメソッドを実行
echo $helloA->HelloMessage();
echo $helloB->HelloMessage();