<?php
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/shared-manual.inc';
$TOC = array();
$TOC_DEPRECATED = array();
$PARENTS = array();
include_once dirname(__FILE__) ."/toc/language.attributes.inc";
$setup = array (
  'home' => 
  array (
    0 => 'index.php',
    1 => 'PHP Manual',
  ),
  'head' => 
  array (
    0 => 'UTF-8',
    1 => 'zh',
  ),
  'this' => 
  array (
    0 => 'language.attributes.syntax.php',
    1 => '注解语法',
    2 => '注解语法',
  ),
  'up' => 
  array (
    0 => 'language.attributes.php',
    1 => '注解',
  ),
  'prev' => 
  array (
    0 => 'language.attributes.overview.php',
    1 => '注解概览',
  ),
  'next' => 
  array (
    0 => 'language.attributes.reflection.php',
    1 => '使用反射 API 读取注解',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'zh',
    'path' => 'language/attributes.xml',
  ),
  'history' => 
  array (
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<div id="language.attributes.syntax" class="sect1">
   <h2 class="title">注解语法</h2>

   <p class="para">
    注解语法由几个关键组件组成。属性声明以 <code class="literal">#[</code> 开始，以 <code class="literal">]</code>
    结束。内部可以列出一个或多个注解，注解之间用逗号分隔。注解名称如<a href="language.namespaces.basics.php" class="link">使用命名空间基础</a>中所述，可以是未限定、限定或完全限定的。注解的参数是可选的，并用圆括号
    <code class="literal">()</code> 括起来。参数只能是字面值或常量表达式，同时支持位置参数和命名参数语法。
   </p>

   <p class="para">
    注解名称及其参数会解析为类，并在通过反射 API 请求注解实例时，将参数传递给其构造方法。因此，建议为每个注解都引入对应的类。
   </p>

   <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: #FF8000">// a.php<br /></span><span style="color: #007700">namespace </span><span style="color: #0000BB">MyExample</span><span style="color: #007700">;<br /><br />use </span><span style="color: #0000BB">Attribute</span><span style="color: #007700">;<br /><br />#[</span><span style="color: #0000BB">Attribute</span><span style="color: #007700">]<br />class </span><span style="color: #0000BB">MyAttribute<br /></span><span style="color: #007700">{<br />    const </span><span style="color: #0000BB">VALUE </span><span style="color: #007700">= </span><span style="color: #DD0000">'value'</span><span style="color: #007700">;<br /><br />    private </span><span style="color: #0000BB">$value</span><span style="color: #007700">;<br /><br />    public function </span><span style="color: #0000BB">__construct</span><span style="color: #007700">(</span><span style="color: #0000BB">$value </span><span style="color: #007700">= </span><span style="color: #0000BB">null</span><span style="color: #007700">)<br />    {<br />        </span><span style="color: #0000BB">$this</span><span style="color: #007700">-&gt;</span><span style="color: #0000BB">value </span><span style="color: #007700">= </span><span style="color: #0000BB">$value</span><span style="color: #007700">;<br />    }<br />}<br /><br /></span><span style="color: #FF8000">// b.php<br /><br /></span><span style="color: #007700">namespace </span><span style="color: #0000BB">Another</span><span style="color: #007700">;<br /><br />use </span><span style="color: #0000BB">MyExample\MyAttribute</span><span style="color: #007700">;<br /><br />#[</span><span style="color: #0000BB">MyAttribute</span><span style="color: #007700">]<br />#[</span><span style="color: #0000BB">\MyExample\MyAttribute</span><span style="color: #007700">]<br />#[</span><span style="color: #0000BB">MyAttribute</span><span style="color: #007700">(</span><span style="color: #0000BB">1234</span><span style="color: #007700">)]<br />#[</span><span style="color: #0000BB">MyAttribute</span><span style="color: #007700">(</span><span style="color: #0000BB">value</span><span style="color: #007700">: </span><span style="color: #0000BB">1234</span><span style="color: #007700">)]<br />#[</span><span style="color: #0000BB">MyAttribute</span><span style="color: #007700">(</span><span style="color: #0000BB">MyAttribute</span><span style="color: #007700">::</span><span style="color: #0000BB">VALUE</span><span style="color: #007700">)]<br />#[</span><span style="color: #0000BB">MyAttribute</span><span style="color: #007700">(array(</span><span style="color: #DD0000">"key" </span><span style="color: #007700">=&gt; </span><span style="color: #DD0000">"value"</span><span style="color: #007700">))]<br />#[</span><span style="color: #0000BB">MyAttribute</span><span style="color: #007700">(</span><span style="color: #0000BB">100 </span><span style="color: #007700">+ </span><span style="color: #0000BB">200</span><span style="color: #007700">)]<br />class </span><span style="color: #0000BB">Thing<br /></span><span style="color: #007700">{<br />}<br /><br />#[</span><span style="color: #0000BB">MyAttribute</span><span style="color: #007700">(</span><span style="color: #0000BB">1234</span><span style="color: #007700">), </span><span style="color: #0000BB">MyAttribute</span><span style="color: #007700">(</span><span style="color: #0000BB">5678</span><span style="color: #007700">)]<br />class </span><span style="color: #0000BB">AnotherThing<br /></span><span style="color: #007700">{<br />}</span></span></code></div>
    </div>

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