<?php
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/shared-manual.inc';
$TOC = array();
$TOC_DEPRECATED = array();
$PARENTS = array();
include_once dirname(__FILE__) ."/toc/language.basic-syntax.inc";
$setup = array (
  'home' => 
  array (
    0 => 'index.php',
    1 => 'PHP Manual',
  ),
  'head' => 
  array (
    0 => 'UTF-8',
    1 => 'zh',
  ),
  'this' => 
  array (
    0 => 'language.basic-syntax.phptags.php',
    1 => 'PHP 标签',
    2 => 'PHP 标签',
  ),
  'up' => 
  array (
    0 => 'language.basic-syntax.php',
    1 => '基本语法',
  ),
  'prev' => 
  array (
    0 => 'language.basic-syntax.php',
    1 => '基本语法',
  ),
  'next' => 
  array (
    0 => 'language.basic-syntax.phpmode.php',
    1 => '从 HTML 中分离',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'zh',
    'path' => 'language/basic-syntax.xml',
  ),
  'history' => 
  array (
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<div id="language.basic-syntax.phptags" class="sect1">
   <h2 class="title">PHP 标签</h2>
   <p class="para">
   当 PHP 处理文件时，通过识别起始和结束标签 <code class="literal">&lt;?php</code> 和 <code class="literal">?&gt;</code> 来定义
   PHP 代码执行的边界。PHP 解析器会忽略这些标签之外的内容，从而使 PHP 能够无缝嵌入到各种文档类型中。
   </p>

   <p class="para">
    必须在 <code class="literal">&lt;?php</code> 后跟随一个空白字符（空格、制表符或换行符），以确保正确的 token 分隔。省略此空白字符将导致语法错误。
   </p>

   <p class="para">
    PHP 还包含短输出标签 <code class="literal">&lt;?=</code>，这是 <code class="code">&lt;?php echo</code> 的简写形式。
   </p>
   <p class="para">
    <div class="example" id="example-1">
     <p><strong>示例 #1 PHP 开始和结束标签</strong></p>
     <div class="example-contents">
<div class="annotation-interactive phpcode"><code><span style="color: #000000">1.  <span style="color: #0000BB">&lt;?php </span><span style="color: #007700">echo </span><span style="color: #DD0000">'if you want to serve PHP code in XHTML or XML documents,<br />                use these tags'</span><span style="color: #007700">; </span><span style="color: #0000BB">?&gt;<br /></span><br />2.  You can use the short echo tag to <span style="color: #0000BB">&lt;?= </span><span style="color: #DD0000">'print this string' </span><span style="color: #0000BB">?&gt;</span>.<br />    It's equivalent to <span style="color: #0000BB">&lt;?php </span><span style="color: #007700">echo </span><span style="color: #DD0000">'print this string' </span><span style="color: #0000BB">?&gt;</span>.<br /><br />3.  &lt;? echo 'this code is within short tags, but will only work '.<br />            'if short_open_tag is enabled'; ?&gt;</span></code></div>
     </div>

    </div>
   </p>

   <p class="para">
    短标签 (第三个示例) 是被默认开启的，但是也可以通过
    <a href="ini.core.php#ini.short-open-tag" class="link">short_open_tag</a>
    <var class="filename">php.ini</var> 来直接禁用。如果 PHP 在被安装时使用了 <strong class="option unknown">--disable-short-tags</strong>
    的配置，该功能则是被默认禁用的。
   </p>
   <p class="para">
    <blockquote class="note"><p><strong class="note">注意</strong>: 
     <p class="para">
      因为短标签可以被禁用，所以建议使用普通标签 (<code class="code">&lt;?php ?&gt;</code> 和 <code class="code">&lt;?= ?&gt;</code>) 来最大化兼容性。
     </p>
    </p></blockquote>
   </p>

  <p class="para">
    如果文件以 PHP 代码结尾，最好在文件末尾删除 PHP 结束标签。这可以避免在 PHP
    结束标签之后意外添加空白字符或者换行符，导致
    PHP 开始输出缓冲，进而引发不必要的影响，而脚本中此时并无输出的意图。
   </p>
   <p class="para">
    <div class="example" id="example-2">
     <p><strong>示例 #2 仅包含 PHP 代码的文件</strong></p>
     <div class="example-contents">
<div class="annotation-interactive phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br /></span><span style="color: #007700">echo </span><span style="color: #DD0000">"Hello world\n"</span><span style="color: #007700">;<br /><br /></span><span style="color: #FF8000">// ... 更多代码<br /><br /></span><span style="color: #007700">echo </span><span style="color: #DD0000">"Last statement\n"</span><span style="color: #007700">;<br /><br /></span><span style="color: #FF8000">// 脚本在此结束，未使用 PHP 结束标签</span></span></code></div>
     </div>

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