<?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 => 'ja',
  ),
  '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' => 'ja',
    '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="sect1">
   <h2 class="title">フォームの処理</h2>
   <p class="para">
    PHP の最も強力な機能の一つは、HTML フォームを処理する手段です。
    理解するべき重要な基本概念は、あるフォームの中の全てのフォーム要素が、
    自動的に PHP スクリプトで利用可能になるということです。
    詳細は、マニュアルのセクション<a href="language.variables.external.php" class="link">
    外部から来る変数</a> および PHP
    でフォームを使用する例を参照ください。以下に HTML フォームの例を示します。
   </p>
   <p class="para">
    <div class="example" id="example-1">
     <p><strong>例1 簡単な HTML フォーム</strong></p>
     <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;名前:&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;年齢:&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">
    このフォームに関して特別なところはありません。これは通常の HTML
    フォームで特殊なタグは全く使用していません。
    ユーザーがこのフォームを記入し、投稿ボタンを押した時、
    <var class="filename">action.php</var> ページがコールされます。
    このファイルには、以下のようなコードを記述します。
   </p>
   <p class="para">
    <div class="example" id="example-2">
     <p><strong>例2 フォームからのデータを出力する</strong></p>
     <div class="example-contents">
<div class="phpcode"><code><span style="color: #000000">こんにちは、<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 />あなたは、<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> 歳です。</span></code></div>
     </div>

     <div class="example-contents"><p>
      このスクリプトの出力例は次のようになります。
      <div class="example-contents screen">
<div class="cdata"><pre>
こんにちは、Joe さん。あなたは、22 歳です。
</pre></div>
      </div>
     </p></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 フィールドには数値が入ることがわかっているので、これを
    <span class="type"><a href="language.types.integer.php" class="type int">int</a></span> 型に <a href="language.types.type-juggling.php#language.types.typecasting" class="link">変換</a> 
    します。これにより、おかしな文字が入力されることを防ぎます。
    これらの処理を PHP に自動的に行わせるためには、
    <a href="ref.filter.php" class="link">filter</a> 拡張モジュールを使用します。
    変数 <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> は PHP により自動的に設定されます。
    前の部分では、スーパーグローバル<var class="varname"><a href="reserved.variables.server.php" class="classname">$_SERVER</a></var> を使用しましたが、
    ここでは、全ての POST データを保持するスーパーグローバル
    <var class="varname"><a href="reserved.variables.post.php" class="classname">$_POST</a></var> を導入しています。
    フォームの<em>メソッド</em>が POST であることに注意してください。
    <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, FILE
    データの混ざったものが含まれます。
   </p>
  </div><?php manual_footer($setup); ?>