array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ja', ), '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' => 'ja', 'path' => 'language/predefined/variables/post.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

$_POST

(PHP 4 >= 4.1.0, PHP 5, PHP 7, PHP 8)

$_POST — HTTP POST リクエストから得られるフォームデータ

説明

Content-Type に application/x-www-form-urlencoded あるいは multipart/form-data を用いた HTTP リクエストで、 HTTP POST メソッドから現在のスクリプトに渡された変数の連想配列です。

例

例1 $_POST の例

<?php
echo 'Hello ' . htmlspecialchars($_POST["name"]) . '!';
?>

ユーザーがリクエストボディに name=Hannes を付けて POST リクエストを送信したとします。

上の例の出力は、 たとえば以下のようになります。

Hello Hannes!

注意

注意:

これは 'スーパーグローバル' あるいは自動グローバル変数と呼ばれるものです。 スクリプト全体を通してすべてのスコープで使用することができます。 関数やメソッドの内部で使用する場合にも global $variable; とする必要はありません。

注意: その他の content type (例: application/json や application/xml) を指定して送信された POST データを読み取るには、 php://input を使わなければいけません。 application/x-www-form-urlencoded と multipart/form-data を指定した場合にだけ動作する $_POST とは異なり、 php://input はリクエストボディの生データに直接アクセスします。

参考