<?php
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/shared-manual.inc';
$TOC = array();
$TOC_DEPRECATED = array();
$PARENTS = array();
include_once dirname(__FILE__) ."/toc/reserved.variables.inc";
$setup = array (
  'home' => 
  array (
    0 => 'index.php',
    1 => 'PHP Manual',
  ),
  'head' => 
  array (
    0 => 'UTF-8',
    1 => 'zh',
  ),
  'this' => 
  array (
    0 => 'reserved.variables.post.php',
    1 => '$_POST',
    2 => '来自 HTTP POST 请求的表单数据',
  ),
  'up' => 
  array (
    0 => 'reserved.variables.php',
    1 => '预定义变量',
  ),
  'prev' => 
  array (
    0 => 'reserved.variables.get.php',
    1 => '$_GET',
  ),
  'next' => 
  array (
    0 => 'reserved.variables.files.php',
    1 => '$_FILES',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'zh',
    'path' => 'language/predefined/variables/post.xml',
  ),
  'history' => 
  array (
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<div id="reserved.variables.post" class="refentry">
 <div class="refnamediv">
  <h1 class="refname">$_POST</h1>
  <p class="refpurpose"><span class="refname">$_POST</span> &mdash; <span class="dc-title">来自 HTTP POST 请求的表单数据</span></p>

 </div>
 
 <div class="refsect1 description" id="refsect1-reserved.variables.post-description">
  <h3 class="title">说明</h3>
  <p class="para">
   当  HTTP POST 请求的 Content-Type 是 <code class="literal">application/x-www-form-urlencoded</code> 或 <code class="literal">multipart/form-data</code> 时，会将变量以关联数组形式传入当前脚本。
  </p>
 </div>

 
 <div class="refsect1 examples" id="refsect1-reserved.variables.post-examples">
  <h3 class="title">示例</h3>
  <p class="para">
   <div class="example" id="variable.post.basic">
    <p><strong>示例 #1 <var class="varname">$_POST</var> 范例</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">echo </span><span style="color: #DD0000">'Hello ' </span><span style="color: #007700">. </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: #DD0000">'!'</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
    </div>

    <div class="example-contents"><p>
     假设用户发送了一个包含 <code class="literal">name=Hannes</code> 的 POST 请求体。
    </p></div>
    <div class="example-contents"><p>以上示例的输出类似于：</p></div>
    <div class="example-contents screen">
<div class="examplescode"><pre class="examplescode">Hello Hannes!</pre>
</div>
    </div>
   </div>
  </p>
 </div>

 
 <div class="refsect1 notes" id="refsect1-reserved.variables.post-notes">
  <h3 class="title">注释</h3>
  <blockquote class="note"><p><strong class="note">注意</strong>: <p class="para">“Superglobal”也称为自动化的全局变量。这就表示其在脚本的所有作用域中都是可用的。不需要在函数或方法中用
<strong class="command">global $variable;</strong> 来访问它。</p></p></blockquote>
  <blockquote class="note"><p><strong class="note">注意</strong>: 
   <span class="simpara">
    读取与其他内容类型一起发送的 POST 数据（例如
    <code class="literal">application/json</code> 或 <code class="literal">application/xml</code>）
    必须使用 <a href="wrappers.php.php#wrappers.php.input" class="link"><var class="filename">php://input</var></a>。
    与仅适用于 <code class="literal">application/x-www-form-urlencoded</code> 和
    <code class="literal">multipart/form-data</code> 的 <var class="varname">$_POST</var> 不同，
    <var class="filename">php://input</var> 提供对请求正文中原始数据的直接访问。
   </span>
  </p></blockquote>
 </div>


 <div class="refsect1 seealso" id="refsect1-reserved.variables.post-seealso">
  <h3 class="title">参见</h3>
  <p class="para">
   <ul class="simplelist">
    <li><a href="language.variables.external.php" class="link">处理外部变量</a></li>
    <li><a href="book.filter.php" class="link">过滤器扩展</a></li>
   </ul>
  </p>
 </div>


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