<?php
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/shared-manual.inc';
$TOC = array();
$TOC_DEPRECATED = array();
$PARENTS = array();
include_once dirname(__FILE__) ."/toc/book.yaf.inc";
$setup = array (
  'home' => 
  array (
    0 => 'index.php',
    1 => 'PHP Manual',
  ),
  'head' => 
  array (
    0 => 'UTF-8',
    1 => 'zh',
  ),
  'this' => 
  array (
    0 => 'class.yaf-request-http.php',
    1 => 'Yaf_Request_Http',
    2 => 'The Yaf_Request_Http class',
  ),
  'up' => 
  array (
    0 => 'book.yaf.php',
    1 => 'Yaf',
  ),
  'prev' => 
  array (
    0 => 'yaf-request-abstract.setrouted.php',
    1 => 'Yaf_Request_Abstract::setRouted',
  ),
  'next' => 
  array (
    0 => 'yaf-request-http.construct.php',
    1 => 'Yaf_Request_Http::__construct',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'zh',
    'path' => 'reference/yaf/yaf-request-http.xml',
  ),
  'history' => 
  array (
  ),
  'extra_header_links' => 
  array (
    'rel' => 'alternate',
    'href' => '/manual/en/feeds/class.yaf-request-http.atom',
    'type' => 'application/atom+xml',
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<div id="class.yaf-request-http" class="reference">

 <h1 class="title">The Yaf_Request_Http class</h1>
 

 <div class="partintro"><p class="verinfo">(Yaf &gt;=1.0.0)</p>


  <div class="section" id="yaf-request-http.intro">
   <h2 class="title">简介</h2>
   <p class="para">
    来自客户端的任何请求都会初始化为 <span class="classname"><strong class="classname">Yaf_Request_Http</strong></span>。可以通过该类的方法获取请求信息，像是 uri query 和 post 参数等。
    <blockquote class="note"><p><strong class="note">注意</strong>: 
     <p class="para">
      为了安全，$_GET/$_POST 在 Yaf 中为只读，这意味着如果在全局变量中设置了值，将无法从 <span class="methodname"><a href="yaf-request-http.getquery.php" class="methodname">Yaf_Request_Http::getQuery()</a></span>
      或 <span class="methodname"><a href="yaf-request-http.getpost.php" class="methodname">Yaf_Request_Http::getPost()</a></span> 获取。
     </p>
     <p class="para">
      但确实有些用途需要这些功能，比如单元测试。因此 Yaf 可以使用 --enable-yaf-debug 编译，这将允许 Yaf 通过脚本读取用户设置的值。
     </p>
     <p class="para">
      在这种情况下，Yaf 将会抛出 E_STRICT 警告来提醒：正在调试模式下运行 yaf。
     </p>
    </p></blockquote>
   </p>
  </div>


  <div class="section" id="yaf-request-http.synopsis">
   <h2 class="title">类摘要</h2>


   <div class="classsynopsis">
    <span class="ooclass"><strong class="classname"></strong></span>


    <div class="classsynopsisinfo">
     <span class="ooclass">
      <span class="modifier">class</span> <strong class="classname">Yaf_Request_Http</strong>
     </span>
     
     <span class="ooclass">
      <span class="modifier">extends</span>
       <a href="class.yaf-request-abstract.php" class="classname">Yaf_Request_Abstract</a>
     </span>
     {</div>

    <div class="classsynopsisinfo classsynopsisinfo_comment">/* 属性 */</div>

    
    <div class="classsynopsisinfo classsynopsisinfo_comment">/* 方法 */</div>
    <div class="constructorsynopsis dc-description">
   <span class="modifier">public</span> <span class="methodname"><a href="yaf-request-http.construct.php" class="methodname">__construct</a></span>(<span class="methodparam"><span class="type"><a href="language.types.string.php" class="type string">string</a></span> <code class="parameter">$request_uri</code><span class="initializer"> = ?</span></span>, <span class="methodparam"><span class="type"><a href="language.types.string.php" class="type string">string</a></span> <code class="parameter">$base_uri</code><span class="initializer"> = ?</span></span>)</div>

    <div class="methodsynopsis dc-description"><span class="modifier">public</span> <span class="methodname"><a href="yaf-request-http.get.php" class="methodname">get</a></span>(<span class="methodparam"><span class="type"><a href="language.types.string.php" class="type string">string</a></span> <code class="parameter">$name</code></span>, <span class="methodparam"><span class="type"><a href="language.types.string.php" class="type string">string</a></span> <code class="parameter">$default</code><span class="initializer"> = ?</span></span>): <span class="type"><a href="language.types.mixed.php" class="type mixed">mixed</a></span></div>
<div class="methodsynopsis dc-description"><span class="modifier">public</span> <span class="methodname"><a href="yaf-request-http.getcookie.php" class="methodname">getCookie</a></span>(<span class="methodparam"><span class="type"><a href="language.types.string.php" class="type string">string</a></span> <code class="parameter">$name</code></span>, <span class="methodparam"><span class="type"><a href="language.types.string.php" class="type string">string</a></span> <code class="parameter">$default</code><span class="initializer"> = ?</span></span>): <span class="type"><a href="language.types.mixed.php" class="type mixed">mixed</a></span></div>
<div class="methodsynopsis dc-description"><span class="modifier">public</span> <span class="methodname"><a href="yaf-request-http.getfiles.php" class="methodname">getFiles</a></span>(): <span class="type"><a href="language.types.void.php" class="type void">void</a></span></div>
<div class="methodsynopsis dc-description"><span class="modifier">public</span> <span class="methodname"><a href="yaf-request-http.getpost.php" class="methodname">getPost</a></span>(<span class="methodparam"><span class="type"><a href="language.types.string.php" class="type string">string</a></span> <code class="parameter">$name</code></span>, <span class="methodparam"><span class="type"><a href="language.types.string.php" class="type string">string</a></span> <code class="parameter">$default</code><span class="initializer"> = ?</span></span>): <span class="type"><a href="language.types.mixed.php" class="type mixed">mixed</a></span></div>
<div class="methodsynopsis dc-description"><span class="modifier">public</span> <span class="methodname"><a href="yaf-request-http.getquery.php" class="methodname">getQuery</a></span>(<span class="methodparam"><span class="type"><a href="language.types.string.php" class="type string">string</a></span> <code class="parameter">$name</code></span>, <span class="methodparam"><span class="type"><a href="language.types.string.php" class="type string">string</a></span> <code class="parameter">$default</code><span class="initializer"> = ?</span></span>): <span class="type"><a href="language.types.mixed.php" class="type mixed">mixed</a></span></div>
<div class="methodsynopsis dc-description"><span class="modifier">public</span> <span class="methodname"><a href="yaf-request-http.getraw.php" class="methodname">getRaw</a></span>(): <span class="type"><a href="language.types.mixed.php" class="type mixed">mixed</a></span></div>
<div class="methodsynopsis dc-description"><span class="modifier">public</span> <span class="methodname"><a href="yaf-request-http.getrequest.php" class="methodname">getRequest</a></span>(): <span class="type"><a href="language.types.void.php" class="type void">void</a></span></div>
<div class="methodsynopsis dc-description"><span class="modifier">public</span> <span class="methodname"><a href="yaf-request-http.isxmlhttprequest.php" class="methodname">isXmlHttpRequest</a></span>(): <span class="type"><a href="language.types.boolean.php" class="type bool">bool</a></span></div>

    
    <div class="classsynopsisinfo classsynopsisinfo_comment">/* 继承的方法 */</div>
    <div class="methodsynopsis dc-description"><span class="modifier">public</span> <span class="methodname"><a href="yaf-request-abstract.clearparams.php" class="methodname">Yaf_Request_Abstract::clearParams</a></span>(): <span class="type"><a href="language.types.boolean.php" class="type bool">bool</a></span></div>
<div class="methodsynopsis dc-description"><span class="modifier">public</span> <span class="methodname"><a href="yaf-request-abstract.getactionname.php" class="methodname">Yaf_Request_Abstract::getActionName</a></span>(): <span class="type"><a href="language.types.void.php" class="type void">void</a></span></div>
<div class="methodsynopsis dc-description"><span class="modifier">public</span> <span class="methodname"><a href="yaf-request-abstract.getbaseuri.php" class="methodname">Yaf_Request_Abstract::getBaseUri</a></span>(): <span class="type"><a href="language.types.void.php" class="type void">void</a></span></div>
<div class="methodsynopsis dc-description"><span class="modifier">public</span> <span class="methodname"><a href="yaf-request-abstract.getcontrollername.php" class="methodname">Yaf_Request_Abstract::getControllerName</a></span>(): <span class="type"><a href="language.types.void.php" class="type void">void</a></span></div>
<div class="methodsynopsis dc-description"><span class="modifier">public</span> <span class="methodname"><a href="yaf-request-abstract.getenv.php" class="methodname">Yaf_Request_Abstract::getEnv</a></span>(<span class="methodparam"><span class="type"><a href="language.types.string.php" class="type string">string</a></span> <code class="parameter">$name</code></span>, <span class="methodparam"><span class="type"><a href="language.types.string.php" class="type string">string</a></span> <code class="parameter">$default</code><span class="initializer"> = ?</span></span>): <span class="type"><a href="language.types.void.php" class="type void">void</a></span></div>
<div class="methodsynopsis dc-description"><span class="modifier">public</span> <span class="methodname"><a href="yaf-request-abstract.getexception.php" class="methodname">Yaf_Request_Abstract::getException</a></span>(): <span class="type"><a href="language.types.void.php" class="type void">void</a></span></div>
<div class="methodsynopsis dc-description"><span class="modifier">public</span> <span class="methodname"><a href="yaf-request-abstract.getlanguage.php" class="methodname">Yaf_Request_Abstract::getLanguage</a></span>(): <span class="type"><a href="language.types.void.php" class="type void">void</a></span></div>
<div class="methodsynopsis dc-description"><span class="modifier">public</span> <span class="methodname"><a href="yaf-request-abstract.getmethod.php" class="methodname">Yaf_Request_Abstract::getMethod</a></span>(): <span class="type"><a href="language.types.string.php" class="type string">string</a></span></div>
<div class="methodsynopsis dc-description"><span class="modifier">public</span> <span class="methodname"><a href="yaf-request-abstract.getmodulename.php" class="methodname">Yaf_Request_Abstract::getModuleName</a></span>(): <span class="type"><a href="language.types.void.php" class="type void">void</a></span></div>
<div class="methodsynopsis dc-description"><span class="modifier">public</span> <span class="methodname"><a href="yaf-request-abstract.getparam.php" class="methodname">Yaf_Request_Abstract::getParam</a></span>(<span class="methodparam"><span class="type"><a href="language.types.string.php" class="type string">string</a></span> <code class="parameter">$name</code></span>, <span class="methodparam"><span class="type"><a href="language.types.string.php" class="type string">string</a></span> <code class="parameter">$default</code><span class="initializer"> = ?</span></span>): <span class="type"><a href="language.types.mixed.php" class="type mixed">mixed</a></span></div>
<div class="methodsynopsis dc-description"><span class="modifier">public</span> <span class="methodname"><a href="yaf-request-abstract.getparams.php" class="methodname">Yaf_Request_Abstract::getParams</a></span>(): <span class="type"><a href="language.types.array.php" class="type array">array</a></span></div>
<div class="methodsynopsis dc-description"><span class="modifier">public</span> <span class="methodname"><a href="yaf-request-abstract.getrequesturi.php" class="methodname">Yaf_Request_Abstract::getRequestUri</a></span>(): <span class="type"><a href="language.types.void.php" class="type void">void</a></span></div>
<div class="methodsynopsis dc-description"><span class="modifier">public</span> <span class="methodname"><a href="yaf-request-abstract.getserver.php" class="methodname">Yaf_Request_Abstract::getServer</a></span>(<span class="methodparam"><span class="type"><a href="language.types.string.php" class="type string">string</a></span> <code class="parameter">$name</code></span>, <span class="methodparam"><span class="type"><a href="language.types.string.php" class="type string">string</a></span> <code class="parameter">$default</code><span class="initializer"> = ?</span></span>): <span class="type"><a href="language.types.void.php" class="type void">void</a></span></div>
<div class="methodsynopsis dc-description"><span class="modifier">public</span> <span class="methodname"><a href="yaf-request-abstract.iscli.php" class="methodname">Yaf_Request_Abstract::isCli</a></span>(): <span class="type"><a href="language.types.boolean.php" class="type bool">bool</a></span></div>
<div class="methodsynopsis dc-description"><span class="modifier">public</span> <span class="methodname"><a href="yaf-request-abstract.isdispatched.php" class="methodname">Yaf_Request_Abstract::isDispatched</a></span>(): <span class="type"><a href="language.types.boolean.php" class="type bool">bool</a></span></div>
<div class="methodsynopsis dc-description"><span class="modifier">public</span> <span class="methodname"><a href="yaf-request-abstract.isget.php" class="methodname">Yaf_Request_Abstract::isGet</a></span>(): <span class="type"><a href="language.types.boolean.php" class="type bool">bool</a></span></div>
<div class="methodsynopsis dc-description"><span class="modifier">public</span> <span class="methodname"><a href="yaf-request-abstract.ishead.php" class="methodname">Yaf_Request_Abstract::isHead</a></span>(): <span class="type"><a href="language.types.boolean.php" class="type bool">bool</a></span></div>
<div class="methodsynopsis dc-description"><span class="modifier">public</span> <span class="methodname"><a href="yaf-request-abstract.isoptions.php" class="methodname">Yaf_Request_Abstract::isOptions</a></span>(): <span class="type"><a href="language.types.boolean.php" class="type bool">bool</a></span></div>
<div class="methodsynopsis dc-description"><span class="modifier">public</span> <span class="methodname"><a href="yaf-request-abstract.ispost.php" class="methodname">Yaf_Request_Abstract::isPost</a></span>(): <span class="type"><a href="language.types.boolean.php" class="type bool">bool</a></span></div>
<div class="methodsynopsis dc-description"><span class="modifier">public</span> <span class="methodname"><a href="yaf-request-abstract.isput.php" class="methodname">Yaf_Request_Abstract::isPut</a></span>(): <span class="type"><a href="language.types.boolean.php" class="type bool">bool</a></span></div>
<div class="methodsynopsis dc-description"><span class="modifier">public</span> <span class="methodname"><a href="yaf-request-abstract.isrouted.php" class="methodname">Yaf_Request_Abstract::isRouted</a></span>(): <span class="type"><a href="language.types.boolean.php" class="type bool">bool</a></span></div>
<div class="methodsynopsis dc-description"><span class="modifier">public</span> <span class="methodname"><a href="yaf-request-abstract.isxmlhttprequest.php" class="methodname">Yaf_Request_Abstract::isXmlHttpRequest</a></span>(): <span class="type"><a href="language.types.boolean.php" class="type bool">bool</a></span></div>
<div class="methodsynopsis dc-description"><span class="modifier">public</span> <span class="methodname"><a href="yaf-request-abstract.setactionname.php" class="methodname">Yaf_Request_Abstract::setActionName</a></span>(<span class="methodparam"><span class="type"><a href="language.types.string.php" class="type string">string</a></span> <code class="parameter">$action</code></span>, <span class="methodparam"><span class="type"><a href="language.types.boolean.php" class="type bool">bool</a></span> <code class="parameter">$format_name</code><span class="initializer"> = true</span></span>): <span class="type"><a href="language.types.void.php" class="type void">void</a></span></div>
<div class="methodsynopsis dc-description"><span class="modifier">public</span> <span class="methodname"><a href="yaf-request-abstract.setbaseuri.php" class="methodname">Yaf_Request_Abstract::setBaseUri</a></span>(<span class="methodparam"><span class="type"><a href="language.types.string.php" class="type string">string</a></span> <code class="parameter">$uir</code></span>): <span class="type"><a href="language.types.boolean.php" class="type bool">bool</a></span></div>
<div class="methodsynopsis dc-description"><span class="modifier">public</span> <span class="methodname"><a href="yaf-request-abstract.setcontrollername.php" class="methodname">Yaf_Request_Abstract::setControllerName</a></span>(<span class="methodparam"><span class="type"><a href="language.types.string.php" class="type string">string</a></span> <code class="parameter">$controller</code></span>, <span class="methodparam"><span class="type"><a href="language.types.boolean.php" class="type bool">bool</a></span> <code class="parameter">$format_name</code><span class="initializer"> = true</span></span>): <span class="type"><a href="language.types.void.php" class="type void">void</a></span></div>
<div class="methodsynopsis dc-description"><span class="modifier">public</span> <span class="methodname"><a href="yaf-request-abstract.setdispatched.php" class="methodname">Yaf_Request_Abstract::setDispatched</a></span>(): <span class="type"><a href="language.types.void.php" class="type void">void</a></span></div>
<div class="methodsynopsis dc-description"><span class="modifier">public</span> <span class="methodname"><a href="yaf-request-abstract.setmodulename.php" class="methodname">Yaf_Request_Abstract::setModuleName</a></span>(<span class="methodparam"><span class="type"><a href="language.types.string.php" class="type string">string</a></span> <code class="parameter">$module</code></span>, <span class="methodparam"><span class="type"><a href="language.types.boolean.php" class="type bool">bool</a></span> <code class="parameter">$format_name</code><span class="initializer"> = true</span></span>): <span class="type"><a href="language.types.void.php" class="type void">void</a></span></div>
<div class="methodsynopsis dc-description"><span class="modifier">public</span> <span class="methodname"><a href="yaf-request-abstract.setparam.php" class="methodname">Yaf_Request_Abstract::setParam</a></span>(<span class="methodparam"><span class="type"><a href="language.types.string.php" class="type string">string</a></span> <code class="parameter">$name</code></span>, <span class="methodparam"><span class="type"><a href="language.types.string.php" class="type string">string</a></span> <code class="parameter">$value</code><span class="initializer"> = ?</span></span>): <span class="type"><a href="language.types.boolean.php" class="type bool">bool</a></span></div>
<div class="methodsynopsis dc-description"><span class="modifier">public</span> <span class="methodname"><a href="yaf-request-abstract.setrequesturi.php" class="methodname">Yaf_Request_Abstract::setRequestUri</a></span>(<span class="methodparam"><span class="type"><a href="language.types.string.php" class="type string">string</a></span> <code class="parameter">$uir</code></span>): <span class="type"><a href="language.types.void.php" class="type void">void</a></span></div>
<div class="methodsynopsis dc-description"><span class="modifier">public</span> <span class="methodname"><a href="yaf-request-abstract.setrouted.php" class="methodname">Yaf_Request_Abstract::setRouted</a></span>(<span class="methodparam"><span class="type"><a href="language.types.string.php" class="type string">string</a></span> <code class="parameter">$flag</code><span class="initializer"> = ?</span></span>): <span class="type"><a href="language.types.void.php" class="type void">void</a></span></div>


   }</div>


  </div>

  

  <div class="section" id="yaf-request-http.props">
   <h2 class="title">属性</h2>
   <dl>
    
     <dt id="yaf-request-http.props.module"><var class="varname">module</var></dt>
     <dd>
      <p class="para"/>
     </dd>
    
    
     <dt id="yaf-request-http.props.controller"><var class="varname">controller</var></dt>
     <dd>
      <p class="para"/>
     </dd>
    
    
     <dt id="yaf-request-http.props.action"><var class="varname">action</var></dt>
     <dd>
      <p class="para"/>
     </dd>
    
    
     <dt id="yaf-request-http.props.method"><var class="varname">method</var></dt>
     <dd>
      <p class="para"/>
     </dd>
    
    
     <dt id="yaf-request-http.props.params"><var class="varname">params</var></dt>
     <dd>
      <p class="para"/>
     </dd>
    
    
     <dt id="yaf-request-http.props.language"><var class="varname">language</var></dt>
     <dd>
      <p class="para"/>
     </dd>
    
    
     <dt id="yaf-request-http.props.exception"><var class="varname">_exception</var></dt>
     <dd>
      <p class="para"/>
     </dd>
    
    
     <dt id="yaf-request-http.props.base-uri"><var class="varname">_base_uri</var></dt>
     <dd>
      <p class="para"/>
     </dd>
    
    
     <dt id="yaf-request-http.props.uri"><var class="varname">uri</var></dt>
     <dd>
      <p class="para"/>
     </dd>
    
    
     <dt id="yaf-request-http.props.dispatched"><var class="varname">dispatched</var></dt>
     <dd>
      <p class="para"/>
     </dd>
    
    
     <dt id="yaf-request-http.props.routed"><var class="varname">routed</var></dt>
     <dd>
      <p class="para"/>
     </dd>
    
   </dl>
  </div>



 </div>

 































































<h2>目录</h2><ul class="chunklist chunklist_reference"><li><a href="yaf-request-http.construct.php">Yaf_Request_Http::__construct</a> — Yaf_Request_Http 构造方法</li><li><a href="yaf-request-http.get.php">Yaf_Request_Http::get</a> — 从客户端检索变量</li><li><a href="yaf-request-http.getcookie.php">Yaf_Request_Http::getCookie</a> — 检索 Cookie 变量</li><li><a href="yaf-request-http.getfiles.php">Yaf_Request_Http::getFiles</a> — The getFiles purpose</li><li><a href="yaf-request-http.getpost.php">Yaf_Request_Http::getPost</a> — 检索 POST 变量</li><li><a href="yaf-request-http.getquery.php">Yaf_Request_Http::getQuery</a> — 获取 query 参数</li><li><a href="yaf-request-http.getraw.php">Yaf_Request_Http::getRaw</a> — Retrieve Raw request body</li><li><a href="yaf-request-http.getrequest.php">Yaf_Request_Http::getRequest</a> — The getRequest purpose</li><li><a href="yaf-request-http.isxmlhttprequest.php">Yaf_Request_Http::isXmlHttpRequest</a> — 是否为Ajax请求</li></ul>
</div>
<?php manual_footer($setup); ?>