第 51 章 PHPとHTML

PHPとHTMLは深く関係しています：PHPはHTMLを生成し、HTMLにはPHPに送信される情報が記述されています。

1. フォームから、もしくはURLから値を渡す場合にはどういったエンコード/デコードが必要なのですか？
2. <input type="image">タグを使おうとしているのですが、変数 $foo.xと$foo.yが使えません。どうすればよいのですか？
3. HTMLフォームで配列を使用するにはどうすればよいですか？
4. "select multiple"タグで選択された全ての結果を取得するにはどうすればよいですか？

1. フォームから、もしくはURLから値を渡す場合にはどういったエンコード/デコードが必要なのですか？

エンコードが重要になる場面はいくつかあります。 string $dataというエンコードされていない文字列データを渡す場合について考えてみると：

HTMLを通じて渡す場合：文字列にはどのような値が含まれるか分からないので、データは必ずhtmlspecialcharsを行い、ダブルクオートで囲まなければなりません。
URLを通じて渡す場合: URLはいくつかのパーツから成り立ちます。このデータをそのパーツのうちの一つであると解釈させたいならば、 urlencode()でエンコードしなければなりません。

例 51-1HTMLのhidden要素
<?php echo "<input type=hidden value=\"" . htmlspecialchars($data) . "\">\n"; ?>

注意 $dataをurlencode()をしてはいけません。なぜなら、その作業はブラウザに任されているからです。一般に普及している全てのブラウザは正しくこの処理を行ってくれます。ただ、この処理はメソッド(GETやPOST)が何であるかにかかわらずに行われる、ということに気をつけてください。この処理に気づくのはGETリクエストのときだけになるでしょう。なぜならPOSTリクエストの内容は通常目に触れることは無いからです。

例 51-2ユーザによって編集するデータ

<?php
    echo "<textarea name=mydata>\n";
    echo htmlspecialchars($data)."\n";
    echo "</textarea>";
?>

注意ブラウザはエスケープされたシンボルを解釈するので、dataは意図したとおりに表示されます。
フォームの内容を送信するとき、GETかPOSTかにかかわらずdataはブラウザによってURLエンコードされ、PHPによってURLデコードされます。要は、URLエンコード/デコードを自分で行う必要はなく、これらの処理は全て自動的に行われる、と言うことです。

例 51-3URL中の場合

<?php
    echo "<a href=\"" . htmlspecialchars("/nexpage.php?stage=23&data=" .
        urlencode($data)) . "\">\n";
?>

注意この例では、実はGETリクエストを摸擬しています。このため、data を手動でurlencode()する必要があります。

注意全てのURLをhtmlspecialchars()する必要があります。なぜなら、このURLはHTMLのvalue属性として扱われるからです。この場合は、ブラウザはまずhtmlspecialchars()されたデータを元に戻し、それからURLを渡します。URLは urlencode()されているので、PHPはこれを正しく解釈することができます。
URL中の&が& に置き換えられていることに気づくでしょう。もしあなたがこれを忘れても、ほとんどのブラウザは元に戻してくれますが、必ずそうしてくれるとは限りませんので、URLが動的に変更されるものでなくても URLはhtmlspecialchars()されるべきです。

2. <input type="image">タグを使おうとしているのですが、変数 $foo.xと$foo.yが使えません。どうすればよいのですか？

以下のようなタグを使えば、標準のボタンの代わりに画像を使用してフォームを送信することができます：
<input type="image" src="image.gif" name="foo">
ユーザが画像のどこかをクリックすると、そのフォームの内容にfoo.x とfoo.yという2つの変数が追加され、サーバに送信されます。

PHPでは$foo.xと$foo.yという名前は変数名として正しくないので、自動的に$foo_xと$foo_yという名前に変換されます。要は、ピリオドがアンダースコアに置き換えられる、と言うことです。

3. HTMLフォームで配列を使用するにはどうすればよいですか？

フォームの内容をPHPスクリプトで配列として受け取るには、 <input>, <select> or <textarea>といった要素のnameを以下のように指定します：
<input name="MyArray[]"> <input name="MyArray[]"> <input name="MyArray[]"> <input name="MyArray[]">
変数名の最後にあるブラケットに注意してください。これにより、フォームの内容が配列として扱われます。異なる要素に同じ名前をつけることで要素を配列にグループ分けすることができます。
<input name="MyArray[]"> <input name="MyArray[]"> <input name="MyOtherArray[]"> <input name="MyOtherArray[]">
上記のHTMLの場合、MyArrayとMyOtherArrayという2つの配列が生成され、 PHPスクリプトに送信されます。また、配列に特定のキーを設定することもできます。
<input name="AnotherArray[]"> <input name="AnotherArray[]"> <input name="AnotherArray[email]"> <input name="AnotherArray[phone]">
この場合、配列AnotherArrayのキーは0, 1, emailそしてphoneとなります。

注意 HTMLに配列のキーを指定するかどうかは自由です。キーを指定しなかった場合はフォームに現れる順番に番号がつけられます。最初の例だと、キーは0, 1, 2, 3となります。

配列関数と PHPの外部から来る変数も参照して下さい。

4. "select multiple"タグで選択された全ての結果を取得するにはどうすればよいですか？

"select multiple"タグを使うと、ユーザはリストから複数の項目を選択することができるようになります。選択された項目はフォームの actionで指定されたハンドラに渡されます。問題は、これらの値が全て同じ名前で渡されることです。つまり、
<select name="var" multiple>
選択されたそれぞれの項目はactionのハンドラに次のように渡されます：
var=option1 var=option2 var=option3
それぞれの項目は前の変数$varの値を上書きしてしまいます。この問題を解決するには、PHPの"フォームの値を配列にする"機能を使います。以下のようにするとよいでしょう。
<select name="var[]" multiple>
こうすればPHPに$varを配列として扱うように知らせることができ、各項目のvalueの値は配列の要素としてvar[]に追加されます。最初の項目は$var[0]になり、次の項目は $var[1]...というようになります。 count()関数を使えば選択された項目の数を知ることができます。またもし必要ならsort()関数を使ってソートを行うこともできます。

JavaScriptを使っている場合、フォーム要素に要素名を使って(訳注： document.myform.myelement.value等の様に)アクセスしようとすると、要素名に含まれる[]が問題となることがあるので気をつけてください。この場合は、数字で表されるフォーム要素のIDを使用するか、シングルクオートで要素名を囲んでフォーム要素の配列のインデックスとしてアクセスして下さい。例えば、以下のようにします：
variable = documents.forms[0].elements['var[]'];