<?php
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/shared-manual.inc';
$TOC = array();
$TOC_DEPRECATED = array();
$PARENTS = array();
include_once dirname(__FILE__) ."/toc/tutorial.inc";
$setup = array (
  'home' => 
  array (
    0 => 'index.php',
    1 => 'PHP Manual',
  ),
  'head' => 
  array (
    0 => 'UTF-8',
    1 => 'zh',
  ),
  'this' => 
  array (
    0 => 'tutorial.forms.php',
    1 => '处理表单',
    2 => '处理表单',
  ),
  'up' => 
  array (
    0 => 'tutorial.php',
    1 => '简明教程',
  ),
  'prev' => 
  array (
    0 => 'tutorial.useful.php',
    1 => '实用的脚本',
  ),
  'next' => 
  array (
    0 => 'tutorial.whatsnext.php',
    1 => '下一步做什么？',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'zh',
    'path' => 'chapters/tutorial.xml',
  ),
  'history' => 
  array (
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<div id="tutorial.forms" class="section">
  <div class="info"><h1 class="title">处理表单</h1></div>
  <p class="para">
   PHP 一个很有用的特点体现在它处理 HTML
   表单的方式。需要理解的非常重要的原理，是表单的任何元素都在
   PHP 脚本中自动生效。请参阅本手册中“<a href="language.variables.external.php" class="link">PHP 的外部变量</a>”以获取关于在
   PHP 中使用表单的详细信息及范例。以下是 HTML 表单的范例：
  </p>
  <p class="para">
   <div class="example" id="example-1">
    <div class="info"><p><strong>示例 #1 一个简单的 HTML 表单</strong></p></div>
     <div class="example-contents">
<div class="htmlcode"><pre class="htmlcode">&lt;form action=&quot;action.php&quot; method=&quot;post&quot;&gt;
    &lt;label for=&quot;name&quot;&gt;Your name:&lt;/label&gt;
    &lt;input name=&quot;name&quot; id=&quot;name&quot; type=&quot;text&quot;&gt;

    &lt;label for=&quot;age&quot;&gt;Your age:&lt;/label&gt;
    &lt;input name=&quot;age&quot; id=&quot;age&quot; type=&quot;number&quot;&gt;

    &lt;button type=&quot;submit&quot;&gt;Submit&lt;/button&gt;
&lt;/form&gt;</pre>
</div>
     </div>

   </div>
  </p>
  <p class="para">
   该表单中并没有什么特殊的地方，其中没有使用任何特殊的标识符。当用户填写了该表单并点击了提交按钮，页面
   <var class="filename">action.php</var> 将被调用。在该文件中，可以加入如下内容：
  </p>
  <p class="para">
   <div class="example" id="example-2">
    <div class="info"><p><strong>示例 #2 打印来自表单的数据</strong></p></div>
    <div class="example-contents">
<div class="phpcode"><code><span style="color: #000000">Hi <span style="color: #0000BB">&lt;?php </span><span style="color: #007700">echo </span><span style="color: #0000BB">htmlspecialchars</span><span style="color: #007700">(</span><span style="color: #0000BB">$_POST</span><span style="color: #007700">[</span><span style="color: #DD0000">'name'</span><span style="color: #007700">]); </span><span style="color: #0000BB">?&gt;</span>.<br />You are <span style="color: #0000BB">&lt;?php </span><span style="color: #007700">echo (int) </span><span style="color: #0000BB">$_POST</span><span style="color: #007700">[</span><span style="color: #DD0000">'age'</span><span style="color: #007700">]; </span><span style="color: #0000BB">?&gt;</span> years old.</span></code></div>
    </div>

    <div class="example-contents"><p>
     该脚本的输出可能是：
    </p></div>
     <div class="example-contents screen">
<div class="cdata"><pre>
Hi Joe. You are 22 years old.
</pre></div>
    </div>
   </div>
  </p>
  <p class="para">
   除了<span class="function"><a href="function.htmlspecialchars.php" class="function">htmlspecialchars()</a></span> 和 <code class="literal">(int)</code>
   部分，这段程序做什么用显而易见。<span class="function"><a href="function.htmlspecialchars.php" class="function">htmlspecialchars()</a></span>
   使得 HTML 之中的特殊字符被正确的编码，从而不会被使用者在页面注入 HTML 标签或者
   Javascript 代码。例如 age 字段，我们明确知道他是一个数值，因此我们将它<a href="language.types.type-juggling.php#language.types.typecasting" class="link">转换</a>为一个<span class="type"><a href="language.types.integer.php" class="type int">int</a></span>来自动的消除任何不必要的字符。也可以使用 PHP 的 <a href="ref.filter.php" class="link">filter</a> 扩展来自动完成该工作。PHP
   将自动设置 <var class="varname"><a href="reserved.variables.post.php" class="classname">$_POST['name']</a></var> 和
   <var class="varname"><a href="reserved.variables.post.php" class="classname">$_POST['age']</a></var> 变量。在这之前我们使用了超全局变量
   <var class="varname"><a href="reserved.variables.server.php" class="classname">$_SERVER</a></var>，现在我们引入了超全局变量
   <var class="varname"><a href="reserved.variables.post.php" class="classname">$_POST</a></var>，它包含了所有的
   POST 数据。请注意我们的表单提交数据的<em>方法</em>（method）。如果使用了
   <em>GET</em> 方法，那么表单中的信息将被储存到超全局变量
   <var class="varname"><a href="reserved.variables.get.php" class="classname">$_GET</a></var>
   中。如果并不关心请求数据的来源，也可以用超全局变量
   <var class="varname"><a href="reserved.variables.request.php" class="classname">$_REQUEST</a></var>，它包含了所有
   GET、POST 和 COOKIE 的数据。
  </p>
 </div><?php manual_footer($setup); ?>