フォームメール機能の解説

フォームメール機能の使い方

2000/03/31

基本

　フォームメール機能とは、ブラウザに表示されたフォーム文からメールを作成して送信する機能のことである。フォーム文で利用するテキスト文のみならず、ラジオボタンやチェックボタンに応じてメールを作成することができる。

　まずは、次のサンプル１に移動し、自分のメールアドレスと適当な文字列を入れてメールを送信してみて下さい。感じがつかめると思います。

　さて、この機能を利用するには、フォーム文を埋め込んだHTMLファイルと、それと同じディレクトリにメールのベースファイルが必要である。上記サンプルの場合には、sample1.htmlと mail.txtが設定ベースファイルである。

フォームファイル (sample1.html)	置換元ファイル (mail.txt)
<html> <head><title>メールサンプル</title></head> <body bgcolor=white> <h2>メールサンプルその１</h2> <form method="post" action="/php-bin/mail.php"> <input type=hidden name="BASEFILE" value="mail.txt"> <input type=hidden name="RETURL" value="thanks.html"> <h3>問い合わせ</h3> 電子メール送信先：<input type=text name="SENDTO"> <br> 名前：<input type=text name="USER"> <br> タイトル：<input type=text name="TITLE"> <br> <select name="SEL"> <option value="Select_1">選択１ <option value="Select_2" selected>選択２ <option value="Select_3">選択３ </select> <br> <input type=radio name="RADIO" value="YES">YES<br> <input type=radio name="RADIO" value="NO" checked>NO<br> <br> <input type=checkbox name="CHECK1" checked>チェック１ <input type=checkbox name="CHECK2">チェック２ <br> <textarea name="COMMENT" cols=60 rows=5> </textarea> <br> <hr> <input type="submit" value="SEND!"> </html> </body> </html>	From: postmaster@maap.net To: {SENDTO:EMAIL} Subject: {TITLE} {USER:NOTNULL}さん、こんにちわ。プルダウンで{SEL}が選択されました。ラジオボタンは{RADIO}です。 {CHECK1:IF}チェック１はonです。 {CHECK2:IF}チェック２はonです。コメントは、以下のとおりです。 ------ {COMMENT} ------ ここまで。

フォームファイル
(sample1.html)

置換元ファイル
(mail.txt)

<html>
<head><title>メールサンプル</title></head>
<body bgcolor=white>

<h2>メールサンプルその１</h2>

<form method="post" action="/php-bin/mail.php">
<input type=hidden name="BASEFILE" value="mail.txt">
<input type=hidden name="RETURL" value="thanks.html">

<h3>問い合わせ</h3>
電子メール送信先：<input type=text name="SENDTO">
<br>
名前：<input type=text name="USER">
<br>
タイトル：<input type=text name="TITLE">
<br>
<select name="SEL">
  <option value="Select_1">選択１
  <option value="Select_2" selected>選択２
  <option value="Select_3">選択３
</select>
<br>
<input type=radio name="RADIO" value="YES">YES<br>
<input type=radio name="RADIO" value="NO" checked>NO<br>
<br>
<input type=checkbox name="CHECK1" checked>チェック１
<input type=checkbox name="CHECK2">チェック２
<br>
<textarea name="COMMENT" cols=60 rows=5>
</textarea>
<br>
<hr>
<input type="submit" value="SEND!">

</html>
</body>
</html>

From: postmaster@maap.net
To: {SENDTO:EMAIL}
Subject: {TITLE}

{USER:NOTNULL}さん、こんにちわ。

プルダウンで{SEL}が選択されました。
ラジオボタンは{RADIO}です。

{CHECK1:IF}チェック１はonです。
{CHECK2:IF}チェック２はonです。

コメントは、以下のとおりです。
------
{COMMENT}
------
ここまで。

　まずは、フォームファイルから。これは全く通常通りのフォーマットである。市販ツールで作成していただいても構わない（多分漢字コードも問わないはずだ）。ただし、以下の点には注意してほしい。

<form>のaction="/php-bin/mail.php3"とすること
BASEFILEという名前のinput文には、メール置換元のファイル名を記載しておくこと。
同様にRETURLには、メール送信後に表示したいファイルのURLを記載すること。
基本的にはNAME="○○"の○○の部分は大文字を用いて記載すること。小文字のみの場合には内部で使用している変数で上書きされる可能性がある。

　つぎに、置換のベースファイル。こちらは、メールにしたいテキストファイルをテキストエディタなどで作成しておいてください。世の中のメールはJIS漢字コードでやりとりされますが、このファイルは自動的にコード変換しますので、 SJISやEUC漢字コードでも構いません。

　ぱっと見てわかっていただけると思いますが、フォーム文で入力された文字に置き換えたい部分は{××}としておきます。××は、左のフォーム文で NAME="××"としているものが代入されます。ですが、中には{××:△△}という記述もあることにお気づきでしょう。この△△がオプション指定子になります。

　現在、オプション指定子には以下のものがあります（要望があれば追加することも検討します）。

NOTNULL	空欄だとエラーになるもの（スペース１個でもエラーにはなりませんので注意してください）
EMAIL	電子メール形式。@以降の文字をきりだし、DNSにそのメールサーバが存在するかをチェックしているので不正防止にある程度の効果あり。
IF	チェックボックスがオン、あるいはテキストに文字が入力された時だけ、その対象行をメール送信する。（例）CHECK1とCHECK2にIFオプションがついている。このうちCHECK2にだけチェックが入った時、「CHECK1はonです」は送信されず、「CHECK2はonです」は送信される。このオプションがつくと、その変数は値が代入されているかを見るためだけに使われ、何の値が入力されたかというものまでは展開されないので注意したい。例えば、「こんにちわ、{USER:IF}さん」というので、USERに田中一郎が入っていたとしても、このままでは「こんにちわ、さん」と送信されてしまう。名前をきちんと入れたいときには、「こんにちわ、{USER:IF}{USER}さん」と２回書く。
IFNOT	上記IFの逆。サンプル２でその使い方が出てくるが、チェックする/しないなどで表示する文章を変更したいときに便利。

［基本｜確認HTML表示｜複数行対応｜ FAQ ］