フォームが PHP スクリプトに投稿された時、フォームから渡された全て の変数は PHP により自動的にスクリプトから使用可能となります。 この情報にアクセスする手段は複数あります。例を以下に示します。
例1 簡単なHTMLフォーム
<form action="foo.php" method="post"> Name: <input type="text" name="username" /><br /> Email: <input type="text" name="email" /><br /> <input type="submit" name="submit" value="Submit me!" /> </form>
PHP 5.4.0 以降、HTML フォームからデータにアクセスする方法は二種類だけとなります。 現在使える方法を、以下にまとめます。
例2 簡単なPOST HTMLフォームからのデータにアクセスする
<?php
echo $_POST['username'];
echo $_REQUEST['username'];
?>
古いバージョンの PHP では、これら以外にもユーザーの入力にアクセスする方法がありました。 それを以下にまとめます。詳細は、最後の変更履歴を参照ください。
例3 ユーザーの入力にアクセスするための古い方法
<?php
// 注意:これらの方法は、現在はサポートされていません。
// 現在使えるのは、先ほどの方法だけです。
// import_request_variables() を使う方法:この関数は PHP 5.4.0 で削除されました
import_request_variables('p', 'p_');
echo $p_username;
// 長い形式の定義済み変数を使う方法:この変数は PHP 5.4.0 で削除されました
echo $HTTP_POST_VARS['username'];
// register_globals を使う方法:この機能は PHP 5.4.0 で削除されました
echo $username;
?>
GETフォームを使用した場合も同じですが、かわりに適当な定義済みの GET変数を使用するところが異なります。 GETは、QUERY_STRING (URLの'?'の後の情報)にも代入されます。 例えば、 http://www.example.com/test.php?id=3には、 $_GET['id']によりアクセス可能なGETデータ が含まれます。 $_REQUEST も参照ください。
注意:
変数名のドットやスペースはアンダースコアに変換されます。 たとえば <input name="a.b" /> は $_REQUEST["a_b"] となります。
PHPではフォーム変数のコンテキスト内で配列が使用可能です(FAQの関連箇所も参照してください)。 例えば、関連する変数をグループ化したり、select inputで複数の値を 取得するといったことが可能です。フォームを同じスクリプトに投稿し、 投稿したデータを表示する例を示します。
例4 より複雑なフォーム変数
<?php if ($_POST) { echo '<pre>'; echo htmlspecialchars(print_r($_POST, true)); echo '</pre>'; } ?> <form action="" method="post"> Name: <input type="text" name="personal[name]" /><br /> Email: <input type="text" name="personal[email]" /><br /> Beer: <br /> <select multiple name="beer[]"> <option value="warthog">Warthog</option> <option value="guinness">Guinness</option> <option value="stuttgarter">Stuttgarter Schwabenbräu</option> </select><br /> <input type="submit" value="submit me!" /> </form>
フォームを投稿する際、次のタグのように標準の投稿ボタンの代わりに 画像を使用することができます。
<input type="image" src="image.gif" name="sub" />
画像のどこかがクリックされた場合、二つの変数 sub_x および sub_y が付け加えられてこのフォームはサーバーに転送されます。これらの変 数は、ユーザーがこの画像をクリックした座標を示しています。経験の ある人は、ブラウザにより送られた変数の名前においてアンダースコア がピリオドになってしまっていることを心配するかもしれません。 しかし、PHP はピリオドをアンダースコアに自動的に変換します。
PHP は、» RFC 6265 に定義されたHTTP Cookieを完全にサポートします。Cookieは、リモート ブラウザにデータを保持し、再訪するユーザーを追跡し、特定する機構 です。setcookie() 関数によりCookieをセットす ることができます。Cookieは、HTTP ヘッダの一部なので、SetCookie 関数をブラウザに何かを出力する前にコールする必要があります。 この制約は、header() 関数のものと同じです。 Cookieのデータは、$_COOKIE のような適当なCookieデータ 配列で参照可能です。また、 $_REQUESTでも 参照可能です。詳細および例については、 setcookie()のマニュアルページを参照してください。
単一のCookieに複数の値を代入したい場合は、配列として 代入することが可能です。以下に例を示します。
<?php
setcookie("MyCookie[foo]", 'Testing 1', time()+3600);
setcookie("MyCookie[bar]", 'Testing 2', time()+3600);
?>
上記スクリプトにおいては、2つの異なるCookieを生成されますが、 この場合、スクリプトでは MyCookie という単一の配列になります。 一つのCookieに複数の値を設定したい場合、最初の値に serialize()または explode()を用いることを考えてください。
Cookieは、パスまたはドメインが異ならない限り、 以前のクッキーをブラウザ上の同じ名前の変数に置き換えることに 注意してください。 さて、買い物かご(Shopping Cart) プログラムの場合、カウンタを保持し、 受け渡したいと思うかもしれません。 これは、次のようになります。
例5 setcookie()の例
<?php
if (isset($_COOKIE['count'])) {
$count = $_COOKIE['count'] + 1;
} else {
$count = 1;
}
setcookie('count', $count, time()+3600);
setcookie("Cart[$count]", $item, time()+3600);
?>
通常、PHP はスクリプトに渡された変数の名前を変更しません。しかし、 ドット(ピリオド、終止符)はPHPの変数名で有効な文字ではないというこ とに注意する必要があります。次の例を見てみましょう。
<?php
$varname.ext; /* 無効な変数名 */
?>
重要なことを記述しておくと、このため、外部変数に含まれるドットを PHP は自動的にアンダースコアに変換します。
PHPは、変数の型を定義し、必要に応じて変換します。このため、ある変 数の型がある時点で常に明らかであるわけではありません。PHPは、変数 の型を調べる複数の関数をサポートしています。それらは、 gettype(), is_array(), is_float(), is_int(), is_object(), is_string() です。 型の章も参照ください。
バージョン | 説明 |
---|---|
5.4.0 | グローバル変数の登録機能、 マジッククォートおよび register_long_arrays が削除されました。 |
5.3.0 | グローバル変数の登録機能、 マジッククォートおよび register_long_arrays が非推奨となりました。 |
4.2.0 | register_globals のデフォルトが off になりました。 |
4.1.0 | スーパーグローバル配列、 つまり $_POST や $_GET が使えるようになりました。 |