PHP
downloads | documentation | faq | getting help | mailing lists | wiki | reporting bugs | php.net sites | links | conferences | my php.net

search for in the

名前空間の定義> <Objects and references
Last updated: Fri, 14 Nov 2008

view this page in

名前空間

目次

名前空間の概要

PHP における名前空間は、PHP のライブラリが巨大化したときの スコープの問題を解決するために設計されています。 PHP では、すべてのクラス定義はグローバルです。 したがって、ライブラリの作者がさまざまな公開 API を作成する際には、 他のライブラリの同様の機能との競合に注意する必要があります。 お互いに名前が重複しないよう、一意な名前を選択する必要があるのです。 このとき、通常はクラス名を先頭に付加することで一意な名前を作成します。 たとえばデータベースのクラスなら、その先頭に My_Library_DB を付加するなどといったことです。 ライブラリが巨大化するにつれて、このプレフィックスもどんどん追加され、 非常に長ったらしい名前になってしまいます。

名前空間を使用すると、そのクラスを参照する際に毎回長い名前を使用する必要がなくなります。 コードの可読性を保ったまま、グローバル空間の共用の問題を解決することができます。

名前空間は、PHP 5.3.0 以降で使用可能です。 このセクションの内容は実験的なものであり、変更される可能性があります。



名前空間の定義> <Objects and references
Last updated: Fri, 14 Nov 2008
 
add a note add a note User Contributed Notes
名前空間
greg at chiaraquartet dot net
22-Sep-2008 05:32
the previously submitted note is incorrect.

A::foo();
is identical to
::A::foo();

in the global namespace.

The only way to successfully call the static method is to instantiate A and call it like:

<?php
$a
= new A;
$a->foo();
?>

or to use reflection.  This limitation is addressed in patches I have proposed, so the implementation may yet be usable in this regard.
nickf
01-Sep-2008 03:01
In response to Amir Abiri's comment:

In this example:
<?php
//---
// global.php
class A {
  public static function
foo() {
    echo
"static function";
  }
}

//----
// namespace.php
namespace A;
function
foo() {
  echo
"namespace function";
}
?>
The way to call each of these functions is like so:
<?php
A
::foo();  // "namespace function"
::A::foo(); // "static function"
?>
This could get pretty confusing, but at least now you know. :)
j dot s dot lubbers at gmail dot com
01-Aug-2008 12:02
This is my 'ultimate' autoload functie:
<?php
   
function __autoload($class) {
        require(
'../includes/classes/' . str_replace('::', '/', strtolower($class)) . '.php');
    }

   
//When you do:
   
$object = new PDF::Document();
?>

it will include the file:
../includes/classes/pdf/document.php

as you will notice I like to keep my includes outside the webroot.

document.php
<?php
    namespace PDF
;

    class
Document {
       
//etc...
   
}
?>
Tito
16-Jul-2008 06:31
you can use __autoload to automaticly include Classes with a "use" / "new" statement.
yarco dot w at gmail dot com
01-Jul-2008 10:19
So do you mean if i want to use a class, i need to do extra two steps?

1) require/include that file
2) use the namespace

What about to add a trigger something like:

function __auto_namespace($names, $class)
{
  if ($class === null)
  {
    set_include_dir(implode('/', $names));
  }
  else
  {
    require_once implode('/', $names).'/'.$class.'.php';
  }
}

Then when we:
use NAMESPACE1::NAMESPACE2;
or
use NAMESPACE1::NAMESPACE2::CLASS1;

php could auto include the file we needed.
Amir Abiri
26-Dec-2007 02:31
So, if I understand correctly there is a possible ambiguity that can cause a function or method to become "masked".

If I have:

global.php:
<?php
class A
{
    static public function
foo()
    {
    }
}

A::foo(); // Will statically call method foo() of class ::A.
?>

If I now added the following to my project:

A.php:
<?php
namespace A
;

function
foo()
{
}
?>

The function call above would instead call this new function.

It shouldn't be a problem most of the time and specially if certain basic practices are followed (For example, don't name classes and namespaces the same name, and always keep different packages in their own separate namespaces), but it's something to keep in mind.

名前空間の定義> <Objects and references
Last updated: Fri, 14 Nov 2008
 
 
show source | credits | sitemap | contact | advertising | mirror sites