手机版

PHP的命名空间FAQ: things you need to know about namespaces

2019-09-07 阅读 :

(PHP 5 >= 5.3.0, PHP 7)

This FAQ is split into two sections: common questions, and some specifics of implementation that are helpful to understand fully.

First, the common questions.

  1. If I don't use namespaces, should I care about any of this?
  2. How do I use internal or global classes in a namespace?
  3. How do I use namespaces classes functions, or constants in their own namespace?
  4. How does a name like /my/name or /name resolve?
  5. How does a name like my/name resolve?
  6. How does an unqualified class name like name resolve?
  7. How does an unqualified function name or unqualified constant name like name resolve?

 

There are a few implementation details of the namespace implementations that are helpful to understand.

  1. Import names cannot conflict with classes defined in the same file.
  2. Nested namespaces are not allowed.
  3. Neither functions nor constants can be imported via the use statement.
  4. Dynamic namespace names (quoted identifiers) should escape backslash.
  5. Undefined Constants referenced using any backslash die with fatal error
  6. Cannot override special constants NULL, TRUE, FALSE, ZEND_THREAD_SAFE or ZEND_DEBUG_BUILD

 

If I don't use namespaces, should I care about any of this?

No. Namespaces do not affect any existing code in any way, or any as-yet-to-be-written code that does not contain namespaces. You can write this code if you wish:

 

Example #1 Accessing global classes outside a namespace


<?php
$a 
= new /stdClass;

 

This is functionally equivalent to:

 

Example #2 Accessing global classes outside a namespace


<?php
$a 
= new stdClass;

 

How do I use internal or global classes in a namespace?

 

Example #3 Accessing internal classes in namespaces


<?php
namespace foo;
$a = new /stdClass;

function 
test(/ArrayObject $typehintexample null) {}

$a = /DirectoryIterator::CURRENT_AS_FILEINFO;

// extending an internal or global class
class MyException extends /Exception {}
?>

 

How do I use namespaces classes, functions, or constants in their own namespace?

 

Example #4 Accessing internal classes, functions or constants in namespaces


<?php
namespace foo;

class 
MyClass {}

// using a class from the current namespace as a type hint
function test(MyClass $typehintexample null) {}
// another way to use a class from the current namespace as a type hint
function test(/foo/MyClass $typehintexample null) {}

// extending a class from the current namespace
class Extended extends MyClass {}

// accessing a global function
$a = /globalfunc();

// accessing a global constant
$b = /INI_ALL;
?>

 

How does a name like /my/name or /name resolve?

Names that begin with a / always resolve to what they look like, so /my/name is in fact my/name, and /Exception is Exception.

Example #5 Fully Qualified names


<?php
namespace foo;
$a = new /my/name(); // instantiates "my/name" class
echo /strlen('hi'); // calls function "strlen"
$a = /INI_ALL// $a is set to the value of constant "INI_ALL"
?>

 

How does a name like my/name resolve?

Names that contain a backslash but do not begin with a backslash like my/name can be resolved in 2 different ways.

If there is an import statement that aliases another name to my, then the import alias is applied to the my in my/name.

Otherwise, the current namespace name is prepended to my/name.

 

Example #6 Qualified names


<?php
namespace foo;
use 
blah/blah as foo;

$a = new my/name(); // instantiates "foo/my/name" class
foo/bar::name(); // calls static method "name" in class "blah/blah/bar"
my/bar(); // calls function "foo/my/bar"
$a my/BAR// sets $a to the value of constant "foo/my/BAR"
?>

 

How does an unqualified class name like name resolve?

Class names that do not contain a backslash like name can be resolved in 2 different ways.

If there is an import statement that aliases another name to name, then the import alias is applied.

Otherwise, the current namespace name is prepended to name.

 

Example #7 Unqualified class names


<?php
namespace foo;
use 
blah/blah as foo;

$a = new name(); // instantiates "foo/name" class
foo::name(); // calls static method "name" in class "blah/blah"
?>

 

How does an unqualified function name or unqualified constant name like name resolve?

Function or constant names that do not contain a backslash like name can be resolved in 2 different ways.

First, the current namespace name is prepended to name.

Finally, if the constant or function name does not exist in the current namespace, a global constant or function name is used if it exists.

 

Example #8 Unqualified function or constant names


<?php
namespace foo;
use 
blah/blah as foo;

const 
FOO 1;

function 
my() {}
function 
foo() {}
function 
sort(&$a)
{
    
sort($a);
    
$a array_flip($a);
    return 
$a;
}


my(); // calls "foo/my"
$a strlen('hi'); // calls global function "strlen" because "foo/strlen" does not exist
$arr = array(1,3,2);
$b sort($arr); // calls function "foo/sort"
$c foo(); // calls function "foo/foo" - import is not applied

$a FOO// sets $a to value of constant "foo/FOO" - import is not applied
$b INI_ALL// sets $b to value of global constant "INI_ALL"
?>

 

Import names cannot conflict with classes defined in the same file.

The following script combinations are legal:

file1.php


<?php
namespace my/stuff;
class 
MyClass {}
?>

another.php


<?php
namespace another;
class 
thing {}
?>

file2.php


<?php
namespace my/stuff;
include 
'file1.php';
include 
'another.php';

use 
another/thing as MyClass;
$a = new MyClass// instantiates class "thing" from namespace another
?>

 

There is no name conflict, even though the class MyClass exists within the my/stuff namespace, because the MyClass definition is in a separate file. However, the next example causes a fatal error on name conflict because MyClass is defined in the same file as the use statement.
<?php
namespace my/stuff;
use 
another/thing as MyClass;
class 
MyClass {} // fatal error: MyClass conflicts with import statement
$a = new MyClass;
?>

Nested namespaces are not allowed.

PHP does not allow nesting namespaces
<?php
namespace my/stuff {
    namespace 
nested {
        class 
foo {}
    }
}

?>
However, it is easy to simulate nested namespaces like so:
<?php
namespace my/stuff/nested {
    class 
foo {}
}

?>

Neither functions nor constants can be imported via the use statement.

The only elements that are affected by use statements are namespaces and class names. In order to shorten a long constant or function, import its containing namespace
<?php
namespace mine;
use 
ultra/long/ns/name;

$a name/CONSTANT;
name/func();
?>

Dynamic namespace names (quoted identifiers) should escape backslash

It is very important to realize that because the backslash is used as an escape character within strings, it should always be doubled when used inside a string. Otherwise there is a risk of unintended consequences:

Example #9 Dangers of using namespaced names inside a double-quoted string


<?php
$a 
= new "dangerous/name"// /n is a newline inside double quoted strings!
$obj = new $a;

$a = new 'not/at/all/dangerous'// no problems here.
$obj = new $a;
?>
Inside a single-quoted string, the backslash escape sequence is much safer to use, but it is still recommended practice to escape backslashes in all strings as a best practice.

 

Undefined Constants referenced using any backslash die with fatal error

Any undefined constant that is unqualified like FOO will produce a notice explaining that PHP assumed FOO was the value of the constant. Any constant, qualified or fully qualified, that contains a backslash will produce a fatal error if not found.

Example #10 Undefined constants


<?php
namespace bar;
$a FOO// produces notice - undefined constants "FOO" assumed "FOO";
$a = /FOO// fatal error, undefined namespace constant FOO
$a Bar/FOO// fatal error, undefined namespace constant bar/Bar/FOO
$a = /Bar/FOO// fatal error, undefined namespace constant Bar/FOO
?>

 

Cannot override special constants NULL, TRUE, FALSE, ZEND_THREAD_SAFE or ZEND_DEBUG_BUILD

Any attempt to define a namespaced constant that is a special, built-in constant results in a fatal error

Example #11 Undefined constants


<?php
namespace bar;
const 
NULL 0// fatal error;
const true 'stupid'// also fatal error;
// etc.

?>

 

本文标题:PHP的命名空间FAQ: things you need to know about namespaces - 服务器教程_服务器技术_服务器知识_vps教程
本文地址:https://www.helloaliyun.com/tutorial/306.html

相关文章

  • CentOS 7 常用命令(系统关机、重启以及登出)

    关机:(系统的关机、重启以及登出 ) # 关闭系统(1)[root@localhost ~]# shutdown -h now # 关闭系统(2)[root@localhost ~]# init 0 # 关闭系统(3)[root@localhost ~]# telinit 0 # 按预定时间关闭系统[root@localhost...

    2019-12-07 服务器教程
  • linux重启命令 reboot与shutdown -r now的区别与联系

    在linux命令中reboot是重新启动,shutdown -r now是立即停止然后重新启动,都说他们两个是一样的,其实是有一定的区别的。shutdown命令可以安全地关闭或重启Linux系统,它在系统关闭之前给系统上的所有登录用户提示一条警告...

    2019-12-07 服务器教程
  • CentOS 7 如何使用命令重启或关机

    安装GNOME的朋友们首先切换到字符界面。切换到字符界面的方法如下: 先登陆进入系统,进入图形化界面,然后按Ctrl+Alt+F6(笔记本的是Ctrl+Alt+shift+Fn),进入字符界面。关机命令:shutdown或poweroffshutdown:shutdown -h now...

    2019-12-07 服务器教程
  • CentOS 7 正确关机重启的命令方法

    linux主要用于服务器领域,而在服务器上执行一项服务是永无止境的,除非遇到特殊情况,否则不会关机。和Windows不同,在linux系统下,很多进程是在后台执行的。在屏幕背后,可能有很多人同时在工作。如果直接按下电源的按钮,其他...

    2019-12-07 服务器教程
  • CentOS下的yum upgrade和yum update区别,没事别乱用!

    说明:生产环境对软件版本和内核版本要求非常精确,别没事有事随便的进行yum update操作!!!!!!!!!yum update: 升级所有包同时也升级软件和系统内核yum upgrade:只升级所有包,不升级软件和系统内核...

    2019-12-07 服务器教程
你可能感兴趣
热门浏览