<?php
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/shared-manual.inc';
$TOC = array();
$TOC_DEPRECATED = array();
$PARENTS = array();
include_once dirname(__FILE__) ."/toc/language.namespaces.inc";
$setup = array (
  'home' => 
  array (
    0 => 'index.php',
    1 => 'PHP Manual',
  ),
  'head' => 
  array (
    0 => 'UTF-8',
    1 => 'zh',
  ),
  'this' => 
  array (
    0 => 'language.namespaces.nsconstants.php',
    1 => 'namespace 关键字和 __NAMESPACE__',
    2 => 'namespace 关键字和 __NAMESPACE__ 魔术常量',
  ),
  'up' => 
  array (
    0 => 'language.namespaces.php',
    1 => '概述',
  ),
  'prev' => 
  array (
    0 => 'language.namespaces.dynamic.php',
    1 => '命名空间和动态语言特征',
  ),
  'next' => 
  array (
    0 => 'language.namespaces.importing.php',
    1 => '别名和导入',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'zh',
    'path' => 'language/namespaces.xml',
  ),
  'history' => 
  array (
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<div id="language.namespaces.nsconstants" class="sect1">
  <h2 class="title">namespace 关键字和 __NAMESPACE__ 魔术常量</h2>
  
  <p class="verinfo">(PHP 5 &gt;= 5.3.0, PHP 7, PHP 8)</p>
  <p class="para">
   PHP支持两种抽象的访问当前命名空间内部元素的方法，<strong><code><a href="language.constants.magic.php#constant.namespace">__NAMESPACE__</a></code></strong>
   魔术常量和 <code class="literal">namespace</code> 关键字。
  </p>
  <p class="para">
   常量 <strong><code><a href="language.constants.magic.php#constant.namespace">__NAMESPACE__</a></code></strong> 的值是包含当前命名空间名称的字符串。在全局的，不包括在任何命名空间中的代码，它包含一个空的字符串。
   <div class="example" id="example-1">
    <p><strong>示例 #1 __NAMESPACE__ 示例, 在命名空间中的代码</strong></p>
    <div class="example-contents">
     <div class="phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br /></span><span style="color: #007700">namespace </span><span style="color: #0000BB">MyProject</span><span style="color: #007700">;<br /><br />echo </span><span style="color: #DD0000">'"'</span><span style="color: #007700">, </span><span style="color: #0000BB">__NAMESPACE__</span><span style="color: #007700">, </span><span style="color: #DD0000">'"'</span><span style="color: #007700">; </span><span style="color: #FF8000">// 输出 "MyProject"<br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
    </div>

   </div>
   <div class="example" id="example-2">
    <p><strong>示例 #2 __NAMESPACE__ 示例，全局代码</strong></p>
    <div class="example-contents">
     <div class="phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br /><br /></span><span style="color: #007700">echo </span><span style="color: #DD0000">'"'</span><span style="color: #007700">, </span><span style="color: #0000BB">__NAMESPACE__</span><span style="color: #007700">, </span><span style="color: #DD0000">'"'</span><span style="color: #007700">; </span><span style="color: #FF8000">// 输出 ""<br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
    </div>

   </div>
   常量 <strong><code><a href="language.constants.magic.php#constant.namespace">__NAMESPACE__</a></code></strong> 在动态创建名称时很有用，例如：
   <div class="example" id="example-3">
    <p><strong>示例 #3 使用 __NAMESPACE__ 动态创建名称</strong></p>
    <div class="example-contents">
     <div class="phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br /></span><span style="color: #007700">namespace </span><span style="color: #0000BB">MyProject</span><span style="color: #007700">;<br /><br />function </span><span style="color: #0000BB">get</span><span style="color: #007700">(</span><span style="color: #0000BB">$classname</span><span style="color: #007700">)<br />{<br />    </span><span style="color: #0000BB">$a </span><span style="color: #007700">= </span><span style="color: #0000BB">__NAMESPACE__ </span><span style="color: #007700">. </span><span style="color: #DD0000">'\\' </span><span style="color: #007700">. </span><span style="color: #0000BB">$classname</span><span style="color: #007700">;<br />    return new </span><span style="color: #0000BB">$a</span><span style="color: #007700">;<br />}<br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
    </div>

   </div>
  </p>
  <p class="para">
   关键字 <code class="literal">namespace</code> 可用来显式访问当前命名空间或子命名空间中的元素。它等价于类中的
   <code class="literal">self</code> 操作符。
   <div class="example" id="example-4">
    <p><strong>示例 #4 namespace 操作符，命名空间中的代码</strong></p>
    <div class="example-contents">
     <div class="phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br /></span><span style="color: #007700">namespace </span><span style="color: #0000BB">MyProject</span><span style="color: #007700">;<br /><br />use </span><span style="color: #0000BB">blah\blah </span><span style="color: #007700">as </span><span style="color: #0000BB">mine</span><span style="color: #007700">; </span><span style="color: #FF8000">// 参考 "使用命名空间：别名/导入"<br /><br /></span><span style="color: #0000BB">blah\mine</span><span style="color: #007700">(); </span><span style="color: #FF8000">// 调用函数 MyProject\blah\mine()<br /></span><span style="color: #0000BB">namespace\blah\mine</span><span style="color: #007700">(); </span><span style="color: #FF8000">// 调用函数 MyProject\blah\mine()<br /><br /></span><span style="color: #0000BB">namespace\func</span><span style="color: #007700">(); </span><span style="color: #FF8000">// 调用函数 MyProject\func()<br /></span><span style="color: #0000BB">namespace\sub\func</span><span style="color: #007700">(); </span><span style="color: #FF8000">// 调用函数 MyProject\sub\func()<br /></span><span style="color: #0000BB">namespace\cname</span><span style="color: #007700">::</span><span style="color: #0000BB">method</span><span style="color: #007700">(); </span><span style="color: #FF8000">// 调用 class MyProject\cname 的静态方法 "method"<br /></span><span style="color: #0000BB">$a </span><span style="color: #007700">= new </span><span style="color: #0000BB">namespace\sub\cname</span><span style="color: #007700">(); </span><span style="color: #FF8000">// class MyProject\sub\cname 的实例对象<br /></span><span style="color: #0000BB">$b </span><span style="color: #007700">= </span><span style="color: #0000BB">namespace\CONSTANT</span><span style="color: #007700">; </span><span style="color: #FF8000">// 设置 $b 的值为常量 MyProject\CONSTANT<br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
    </div>

   </div>
   <div class="example" id="example-5">
    <p><strong>示例 #5 namespace 操作符, 全局代码</strong></p>
    <div class="example-contents">
     <div class="phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br /><br />namespace\func</span><span style="color: #007700">(); </span><span style="color: #FF8000">// 调用函数 func()<br /></span><span style="color: #0000BB">namespace\sub\func</span><span style="color: #007700">(); </span><span style="color: #FF8000">// 调用函数 sub\func()<br /></span><span style="color: #0000BB">namespace\cname</span><span style="color: #007700">::</span><span style="color: #0000BB">method</span><span style="color: #007700">(); </span><span style="color: #FF8000">// 调用 class cname 的静态方法 "method"<br /></span><span style="color: #0000BB">$a </span><span style="color: #007700">= new </span><span style="color: #0000BB">namespace\sub\cname</span><span style="color: #007700">(); </span><span style="color: #FF8000">// class sub\cname 的实例对象<br /></span><span style="color: #0000BB">$b </span><span style="color: #007700">= </span><span style="color: #0000BB">namespace\CONSTANT</span><span style="color: #007700">; </span><span style="color: #FF8000">// 设置 $b 的值为常量 CONSTANT<br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
    </div>

   </div>
  </p>
 </div><?php manual_footer($setup); ?>