<?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 => 'pt_BR',
  ),
  'this' => 
  array (
    0 => 'tutorial.forms.php',
    1 => 'Tratando Formul&aacute;rios',
    2 => 'Tratando Formul&aacute;rios',
  ),
  'up' => 
  array (
    0 => 'tutorial.php',
    1 => 'Um simples tutorial',
  ),
  'prev' => 
  array (
    0 => 'tutorial.useful.php',
    1 => 'Algo &Uacute;til',
  ),
  'next' => 
  array (
    0 => 'tutorial.whatsnext.php',
    1 => 'O que vem a seguir?',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'pt_BR',
    '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">Tratando Formulários</h1></div>
   <p class="para">
    Uma das características mais fortes do PHP é a forma como ele trata
    formulários HTML. O conceito básico que é importante entender é que qualquer
    elemento de formulário irá automaticamente ficar disponível para seus
    scripts PHP. Por favor leia a seção
    <a href="language.variables.external.php" class="link">Variáveis externas
    do PHP</a> para mais informações e exemplos de como usar formulários
    com PHP. Aqui vai um exemplo de formulário HTML:
   </p>
   <p class="para">
    <div class="example" id="example-1">
     <div class="info"><p><strong>Exemplo #1 Um simples formulário 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;nome&quot;&gt;Seu nome:&lt;/label&gt;
    &lt;input name=&quot;nome&quot; id=&quot;nome&quot; type=&quot;text&quot;&gt;

    &lt;label for=&quot;idade&quot;&gt;Sua idade:&lt;/label&gt;
    &lt;input name=&quot;idade&quot; id=&quot;idade&quot; type=&quot;number&quot;&gt;

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

    </div>
   </p>
   <p class="para">
    Não há nada de especial neste formulário. É um formulário HTML comum
    sem nenhuma etiqueta especial de qualquer tipo. Quando o usuário preencher este formulário
    e clicar no botão &quot;Enviar&quot;, a página <var class="filename">action.php</var>
    é chamada. Neste arquivo nós teremos algo como isto:
   </p>
   <p class="para">
    <div class="example" id="example-2">
     <div class="info"><p><strong>Exemplo #2 Imprimindo dados de nosso formulário</strong></p></div>
     <div class="example-contents">
<div class="phpcode"><code><span style="color: #000000">Olá, <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">'nome'</span><span style="color: #007700">]); </span><span style="color: #0000BB">?&gt;</span>.<br />Você tem <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">'idade'</span><span style="color: #007700">]; </span><span style="color: #0000BB">?&gt;</span> anos de idade.</span></code></div>
     </div>

     <div class="example-contents"><p>
      Um exemplo de saída deste script seria:
     </p></div>
     <div class="example-contents screen">
<div class="cdata"><pre>
Olá, Maria. Você tem 22 anos de idade.
</pre></div>
     </div>
    </div>
   </p>
   <p class="para">
    Para além de <span class="function"><a href="function.htmlspecialchars.php" class="function">htmlspecialchars()</a></span> e
    <code class="literal">(int)</code>, deve ser óbvio o que o script faz.
    <span class="function"><a href="function.htmlspecialchars.php" class="function">htmlspecialchars()</a></span> transforma caracteres que sejam
    especiais no HTML na sua forma codificada, de forma que não seja possível injetar etiquetas HTML
    ou JavaScript em sua página. O campo &quot;idade&quot;, por ser um
    número, pode ser simplesmente <a href="language.types.type-juggling.php#language.types.typecasting" class="link">convertido</a>
    para um <span class="type"><a href="language.types.integer.php" class="type int">int</a></span> que automaticamente eliminará qualquer
    caractere estranho. Você também pode fazer o PHP automaticamente fazer isso
    utilizando a extensão <a href="ref.filter.php" class="link">filter</a>.
    As variáveis <var class="varname"><a href="reserved.variables.post.php" class="classname">$_POST['nome']</a></var> e <var class="varname"><a href="reserved.variables.post.php" class="classname">$_POST['idade']</a></var>
    são criadas automaticamente pelo PHP. Anteriormente
    utilizamos a superglobal <var class="varname"><a href="reserved.variables.server.php" class="classname">$_SERVER</a></var>; acima
    mostramos que a superglobal <var class="varname"><a href="reserved.variables.post.php" class="classname">$_POST</a></var>
    contém todos os dados POST. Perceba como o
    <em>método</em> (method) do formulário é POST. Se fosse utilizado
    o método <em>GET</em>, os dados do formulário acabariam
    na superglobal <var class="varname"><a href="reserved.variables.get.php" class="classname">$_GET</a></var>.
    Você também pode utilizar a superglobal <var class="varname"><a href="reserved.variables.request.php" class="classname">$_REQUEST</a></var>,
    se não se importar com a origem do dado enviado. Ela
    conterá os dados mesclados das origens GET, POST e COOKIE.
   </p>
  </div><?php manual_footer($setup); ?>