<?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.definition.php',
    1 => '命名空间',
    2 => '定义命名空间',
  ),
  'up' => 
  array (
    0 => 'language.namespaces.php',
    1 => '概述',
  ),
  'prev' => 
  array (
    0 => 'language.namespaces.rationale.php',
    1 => '命名空间概述',
  ),
  'next' => 
  array (
    0 => 'language.namespaces.nested.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.definition" class="sect1">
  <h2 class="title">定义命名空间</h2>
  
  <p class="verinfo">(PHP 5 &gt;= 5.3.0, PHP 7, PHP 8)</p>
  <p class="para">
   虽然任意合法的 PHP 代码都可以包含在命名空间中，但只有以下类型的代码受命名空间的影响，它们是：类（包括抽象类、trait 和枚举）、接口、函数和常量。
  </p>
  <p class="para">
   命名空间通过关键字 <code class="literal">namespace</code>
   来声明。如果一个文件中包含命名空间，它必须在其它所有代码之前声明命名空间，除了一个以外：<a href="control-structures.declare.php" class="xref">declare</a>关键字。
   <div class="example" id="example-1">
    <p><strong>示例 #1 声明单个命名空间</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 />const </span><span style="color: #0000BB">CONNECT_OK </span><span style="color: #007700">= </span><span style="color: #0000BB">1</span><span style="color: #007700">;<br />class </span><span style="color: #0000BB">Connection </span><span style="color: #007700">{ </span><span style="color: #FF8000">/* ... */ </span><span style="color: #007700">}<br />function </span><span style="color: #0000BB">connect</span><span style="color: #007700">() { </span><span style="color: #FF8000">/* ... */  </span><span style="color: #007700">}<br /><br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
    </div>

   </div>
   <blockquote class="note"><p><strong class="note">注意</strong>: 
    <span class="simpara">
     完全限定名称（就是以反斜杠开头的名称）不能用于命名空间的声明。
     因为该结构会解析成相对命名空间表达式。
    </span>
   </p></blockquote>
   在声明命名空间之前唯一合法的代码是用于定义源文件编码方式的 <code class="literal">declare</code>
   语句。另外，所有非 PHP
   代码包括空白符都不能出现在命名空间的声明之前：
   <div class="example" id="example-2">
    <p><strong>示例 #2 声明单个命名空间</strong></p>
    <div class="example-contents">
     <div class="phpcode"><code><span style="color: #000000">&lt;html&gt;<br /><span style="color: #0000BB">&lt;?php<br /></span><span style="color: #007700">namespace </span><span style="color: #0000BB">MyProject</span><span style="color: #007700">; </span><span style="color: #FF8000">// 致命错误 -　命名空间必须是程序脚本的第一条语句<br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
    </div>

   </div>
  </p>
  <p class="para">
   另外，与 PHP 其它的语言特征不同，同一个命名空间可以定义在多个文件中，即允许将同一个命名空间的内容分割存放在不同的文件中。
  </p>
 </div><?php manual_footer($setup); ?>