PHPの名前空間とクラス名のエイリアス、オートロード：Web業界で働くためのPHP入門（終）（1/3 ページ）

オープンソースのWeb開発向けスクリプト言語「PHP」の文法を一から学ぶための入門連載。最終回は、クラスの論理的な入れ物である名前空間とクラスを自動的に読み込むオートロードを解説します。

[齊藤新三（著）／山田祥寛（監修），WINGSプロジェクト]

今回の主な内容

• PHPの名前空間
  • 同名クラスは複数読み込めない
  • 名前空間の登場
• 名前空間の使い方
  • 名前空間の定義
  • 注意！「同一ファイルに複数の名前空間」
  • グローバル空間
  • クラスの3種の表し方
  • 名前空間のあるクラスの利用方法
  • コラム「名前空間付き関数と定数」
  • クラス名のエイリアス
  • コラム「名前空間付き関数と定数のuse」
• クラスの「オートロード」
  • オートロードの作り方
  • オートロードの利用方法
• コラム「Composer」
• 連載の終わりに
  • 今回のサンプルコード

　オープンソースのWeb開発向けスクリプト言語「PHP」の文法を一から学ぶための入門連載「Web業界で働くためのPHP入門」。今回は、いよいよ最終回です。クラスの論理的な入れ物である名前空間とクラスを自動的に読み込むオートロードを解説します。

PHPの名前空間

　「名前空間」とは、クラスの論理的な入れ物です。JavaやC#などは古くから名前空間をサポートしていますが、PHPではバージョンが5.3になってから導入されました（Javaの場合はパッケージと呼ばれます）。そのため、5.3以前から存在する多くのライブラリなどでは名前空間を導入していません。では、名前空間というのはどういった機能でしょうか。その名前空間が必要な理由から話を始めましょう。

同名クラスは複数読み込めない

　例えば、以下のような2ファイルがあるとします。

<?php
class OrderAdmin
{
    public function __construct()
    {
        print("businesses/OrderAdminがnewされました<br>");
    }
}

リスト1　phplesson/chap20/classes/businesses/OrderAdmin.php

<?php
class OrderAdmin
{
    public function __construct()
    {
        print("consumers/OrderAdminがnewされました<br>");
    }
}

リスト2　phplesson/chap20/classes/consumers/OrderAdmin.php

　これら2ファイルは、それぞれB2B向けの注文管理クラスとB2C向けの注文管理クラスを表しているとします。注文対象が違うとしても、同じ注文管理なので、クラス名が同じ「OrderAdmin」であり、それに伴ってファイル名も同じOrderAdmin.phpです。ただし、そのファイルが存在するパスが違います。

　なお、中の処理は何でも構いません。ここではコンストラクタのみを記述しています。

　この状態で、以下のphpファイルを実行したとします。これは、B2B向けの注文管理クラスとB2C向けの注文管理クラスを同時に使いたいケースを想定しています。

<?php
require_once("classes/businesses/OrderAdmin.php");  // （1）
require_once("classes/consumers/OrderAdmin.php");  // （2）
$orderAdmin = new OrderAdmin();  // （3）

リスト3　phplesson/chap20/useOrderAdminMiss.php

　実行結果は以下のようにエラーとなります。

Fatal error: Cannot declare class OrderAdmin, because the name is already in use in C:\xampp\htdocs\phplesson\chap20\classes\consumers\OrderAdmin.php on line 2

　これは、どういったエラーなのでしょうか。

　リスト3は（1）と（2）でリスト1とリスト2の2ファイルを読み込んでいます。先に説明したように、これら2ファイルは、パスと処理内容は異なりますが、クラス名は同じです。PHPでは、同じクラス名のクラスを複数読み込んだ場合、どのクラスを採用したらいいのか分からなくなるため、エラーとなります。エラー文面もそのことを表しています。

　なお、このエラーはクラスファイルを読み込んだ時点で発生するので、リスト3の（3）の行がなくてもエラーとなることには留意しておいてください。

名前空間の登場

　このように、中の処理は違うが同じ名前のクラスを1つの実行phpファイルで使いたいケースはあり得ます。これが使う以前の読み込み段階でエラーとなるのは困るので、回避する必要があります。

　このエラーを回避する方法として、まず思い付くのはクラス名を、例えば、BusinessOrderAdminとConsumerOrderAdminのように、全て別のものにすることです。こちらは有効ですが、クラス数が多くなると限界があります。

　そこで、登場するのが「名前空間」です。これは、ファイルパスとは別に、クラスそのものを入れておく論理的な入れ物のことです。例えるなら、クラスが存在する部屋です。

図1　名前空間はクラスの部屋