介護ヘルパーからITエンジニアになった話
PHPでお問い合わせフォームを作る|入力を受け取って表示し、未入力チェックまで初心者向けに解説
プログラミング学習

エックスサーバーで動かすPHP入門  05 / 12

PHPでお問い合わせフォームを作る|入力を受け取って表示し、未入力チェックまで初心者向けに解説

※この記事にはプロモーション(広告)を含みます

目次

Webサイトでよく見る「お問い合わせ」のページ。名前やメッセージを入力欄に書いて「送信」ボタンを押すと、「お問い合わせを受け付けました」と表示されます。

このとき、裏では何が起きているのでしょうか。

実は、HTMLのフォームが入力された内容をサーバーに送り、PHPがそれを受け取っているのです。HTMLだけでは、入力された内容を受け取ることはできません。ここがPHPの出番です。

この記事では、お問い合わせフォームを作って、入力された内容をPHPで受け取り、画面に表示するところまでを1行ずつ解説します。入力されていない欄があれば「〇〇を入力してください」とエラーを出す仕組みも作ります。

受け取った内容を、実際にメールで自分に届くようにするのは、次の記事で扱います。

読み終わるころには、1本目の記事で紹介した「フォームに入力された内容を受け取る」コードも、自分で読めるようになっているはずです。

この記事は「エックスサーバーで動かすPHP入門」シリーズの5本目です。if文とforeachは、前回の記事で説明しています。

👉 PHPのif文とforeachを初心者向けに解説|条件で表示を変えて、配列を一覧にしよう

この記事でやること

この記事では、次のようなお問い合わせフォームを作ります。

  • 「お名前」「メールアドレス」「お問い合わせ内容」の3つを入力して送信する
  • 入力されていない欄があれば、「お名前を入力してください」のようなエラーを表示する
  • 全部入力されていれば、「お問い合わせを受け付けました」と入力した内容を表示する

この記事は、前回の記事でif文とforeachを使えるようになった前提で進めます。

今回はpractice.phpではなく、新しくcontact.htmlとcontact.phpを作ります。どちらもファイルマネージャでpublic_htmlの中に作ってください。作り方は、これまでのpractice.phpと同じです。

フォームのしくみ(HTMLが送って、PHPが受け取る)

送信ボタンを押すと、入力した内容がサーバーに届く

お問い合わせフォームは、次の2つの部品でできています。

  • HTMLのフォーム … 入力欄と送信ボタンを表示する。送信ボタンを押すと、入力された内容をサーバーに送る
  • PHP … サーバーに届いた内容を受け取って、表示したりチェックしたりする

流れを図にすると、次のようになります。

【ブラウザ】contact.html
  名前やメッセージを入力して「送信する」を押す
        ↓ 入力した内容を送る
【サーバー】contact.php
  PHPが内容を受け取って、表示するHTMLを作る
        ↓ 作ったHTMLを返す
【ブラウザ】
  「お名前:たろう」のように表示される

2本目の記事で「PHPはサーバーで動いて、できあがったHTMLをブラウザに返す」と説明しました。フォームでは、その前に「ブラウザからサーバーへ、入力した内容を送る」という動きが1つ加わります。

contact.html を作る

まずは、入力欄と送信ボタンがあるだけのフォームを、ふつうのHTMLで作ります。ファイルマネージャでpublic_htmlにcontact.htmlを新しく作り、次のコードを入力して保存してください。

<!DOCTYPE html>
<html lang="ja">
<head>
  <meta charset="UTF-8">
  <title>お問い合わせ</title>
</head>
<body>
  <h1>お問い合わせ</h1>
  <form action="contact.php" method="post">
    <p>
      お名前<br>
      <input type="text" name="name">
    </p>
    <p>
      メールアドレス<br>
      <input type="email" name="email">
    </p>
    <p>
      お問い合わせ内容<br>
      <textarea name="message" rows="5" cols="40"></textarea>
    </p>
    <button type="submit">送信する</button>
  </form>
</body>
</html>

ブラウザでサーバー名.xsrv.jp/contact.htmlを開くと、入力欄が3つと「送信する」ボタンが表示されます。

1〜8行目と24〜25行目は、これまでと同じふつうのHTMLです。9行目からがフォームです。

  • 9行目: フォームの始まり。入力された内容をcontact.phpに、postという送り方で送る
  • 10〜13行目: 「お名前」の入力欄
  • 14〜17行目: 「メールアドレス」の入力欄
  • 18〜21行目: 「お問い合わせ内容」の入力欄(何行も書ける大きな欄)
  • 22行目: 「送信する」ボタン
  • 23行目: フォームの終わり

9行目の<form>タグには、大事な指定が2つあります。

  • action="contact.php" … 送り先。「入力された内容をcontact.phpに送ってください」という意味です。actionは英語で「動作」という意味で、「送信したら、どのファイルを動かすか」を書きます
  • method="post" … 送り方。post(ポスト)は「郵便を出す」という意味です。送り方にはpostとgetの2種類があり、お問い合わせフォームではpostを使います(ちがいは、あとで説明します)

<form>から</form>までの間にある入力欄の内容が、送信ボタンを押したときにまとめて送られます。

まだcontact.phpを作っていないので、今「送信する」を押すと「404 Not Found(ページが見つかりません)」になります。送り先がまだないからなので、心配いりません。

入力欄のタグ

フォームで使ったタグを見ていきましょう。

タグ 表示されるもの
<input type="text"> 1行の入力欄
<input type="email"> メールアドレス用の1行の入力欄
<textarea></textarea> 何行も書ける大きな入力欄
<button type="submit"></button> 送信ボタン
  • <input>(インプット) … 「入力」という意味。typeで入力欄の種類を決めます。<input>には終わりのタグ</input>がありません
  • type="email" … 見た目はtype="text"とほぼ同じですが、送信するときにブラウザが「メールアドレスの形になっているか」を調べてくれます。「@」がない文字を入れて送信しようとすると、ブラウザがメッセージを出して止めてくれます
  • <textarea>(テキストエリア) … 何行も書ける入力欄。rows="5"は高さ(5行分)、cols="40"は幅(半角40文字分くらい)です。<input>とちがって、終わりのタグ</textarea>が必要です
  • <button type="submit"> … submit(サブミット)は「提出する」という意味。このボタンを押すと、フォームの内容が送信されます。<button>と</button>の間に書いた文字が、ボタンに表示されます

name="〇〇" が「受け取るときの名前(キー)」になる

入力欄のタグには、どれもname="〇〇"が付いています。

<input type="text" name="name">
<input type="email" name="email">
<textarea name="message" rows="5" cols="40"></textarea>

このnameは、入力された内容に付ける名前です。送信すると、次のように「名前」と「入力された内容」がセットになってサーバーに届きます。

name    → たろう
email   → taro@example.com
message → はじめまして

どこかで見た形ですね。3本目の記事で習った連想配列の「キー => 値」とそっくりです。実は、PHPで受け取るときには、本当に連想配列になって届きます。name="〇〇"に書いた名前が、そのまま連想配列のキーになるのです。

1つ目の入力欄はname="name"と、同じ言葉が2回続いていて少しややこしいですね。前のnameは「この入力欄の名前は」という決まった書き方、うしろの"name"は自分で付けた名前(「お名前」の欄なのでnameにしました)です。うしろの名前は、半角の英数字で自由に付けられます。

PHPで受け取る($_POST)

contact.php を作る

次は、送り先のcontact.phpを作ります。ファイルマネージャでpublic_htmlにcontact.phpを新しく作り、次のコードを入力して保存してください。

<?php
echo $_POST['name'];
  • 1行目: ここからPHPです
  • 2行目: 送られてきた内容のうち、キーが'name'のもの(お名前の欄に入力された内容)を表示する

保存したら、サーバー名.xsrv.jp/contact.htmlを開いて、お名前の欄に「たろう」と入力し、「送信する」を押してみてください。

たろう

入力した「たろう」が表示されました。アドレスバーを見ると、contact.htmlからcontact.phpに変わっています。action="contact.php"に書いたとおり、contact.phpに送られて、PHPが受け取った内容を表示しているのです。

$_POST は「送られてきた内容が入った連想配列」

$_POST(ダラー・アンダーバー・ポスト)は、postで送られてきた内容が入っている連想配列です。自分で作らなくても、フォームから送信されるとPHPが自動で作ってくれます。

名前は全部大文字で、$のあとに_(アンダーバー)が付きます。_はShift + ろのキーで入力できます。

連想配列なので、$_POST['name']のように[' ']でキーを書けば、中身を取り出せます。3本目の記事の$taro['name']と同じ書き方です。

中身をまとめて見たいときは、print_rが使えます。contact.phpを次のように書き換えて保存し、contact.htmlから3つとも入力して送信してみましょう。

<?php
echo '<pre>';
print_r($_POST);
echo '</pre>';
  • 2行目: 改行やスペースを書いたとおりに表示する<pre>タグを表示する
  • 3行目: $_POSTの中身をまとめて表示する
  • 4行目: </pre>タグを表示する
Array
(
    [name] => たろう
    [email] => taro@example.com
    [message] => はじめまして
)

3本目の記事でprint_r($taro)を表示したときと同じ形ですね。<input>や<textarea>に書いたnameが、そのままキーになっているのがわかります。

うまく受け取れないときは、このようにprint_r($_POST)で中身を確かめるのが近道です。

3つとも受け取って表示する

3つの内容を、それぞれ表示してみましょう。contact.phpを次のように書き換えます。

<?php
$name = $_POST['name'];
$email = $_POST['email'];
$message = $_POST['message'];
echo 'お名前:' . $name . '<br>';
echo 'メールアドレス:' . $email . '<br>';
echo 'お問い合わせ内容:' . $message;
  • 2行目: お名前の欄に入力された内容を、変数$nameに入れる
  • 3行目: メールアドレスの欄に入力された内容を、変数$emailに入れる
  • 4行目: お問い合わせ内容の欄に入力された内容を、変数$messageに入れる
  • 5行目: 「お名前:」と$nameと改行のタグを、.でつなげて表示する
  • 6行目: 「メールアドレス:」と$emailと改行のタグを表示する
  • 7行目: 「お問い合わせ内容:」と$messageを表示する
お名前:たろう
メールアドレス:taro@example.com
お問い合わせ内容:はじめまして

2〜4行目で、いったん変数に入れてから使っているのがポイントです。$_POST['name']のままでも動きますが、何度も使うときに長くて読みにくくなります。$nameのような短い名前の変数に入れておくと、そのあとのコードがすっきりします。

なお、お問い合わせ内容の欄で改行して書いても、表示では1行につながります。HTMLでは、<br>がないと改行されないからです。今回はこのままで進めます。

post と get のちがい

<form>のmethod(送り方)には、postのほかにget(ゲット)もあります。試しに、contact.htmlの9行目をmethod="get"に書き換えて保存し、もう一度送信してみてください。

<form action="contact.php" method="get">

アドレスバーを見ると、次のように入力した内容がURLのうしろに付いています。

サーバー名.xsrv.jp/contact.php?name=たろう&email=taro@example.com&message=はじめまして

そして画面には、Warning: Undefined array key "name"のようなメッセージが出て、内容が表示されません。getで送った内容は$_POSTではなく、$_GETという別の連想配列に入るからです(このメッセージの意味は、あとでくわしく説明します)。

post get
送った内容 URLに出ない URLのうしろに付く
PHPで受け取る連想配列 $_POST $_GET
向いている使い方 お問い合わせ、会員登録など サイト内の検索など

URLは、ブラウザの履歴に残ったり、だれかに送ったりするものです。お問い合わせの内容やメールアドレスがURLに出てしまうのは困りますね。なので、お問い合わせフォームではpostを使います。

試し終わったら、contact.htmlの9行目をmethod="post"にもどして保存しておいてください。

受け取った内容をそのまま表示してはいけない(htmlspecialchars)

ここまでで、入力された内容を受け取って表示できるようになりました。でも、今のcontact.phpには大きな問題があります。

名前に <b>たろう</b> と入れてみる

contact.htmlのお名前の欄に、次のように入力して送信してみてください。

<b>たろう</b>

表示はこうなります。

お名前:たろう

文字だけだとわかりにくいですが、画面では「たろう」が太字で表示されます。「<b>たろう</b>」という文字が表示されるのではなく、「たろう」が太字になってしまいました。<b>は文字を太字にするHTMLのタグです。

PHPは、受け取った<b>たろう</b>をechoでそのままHTMLの中に書き出しました。ブラウザはそれを見て「これはタグだ」と判断し、太字にしたのです。つまり、入力する人が、ページにHTMLのタグを書きこめてしまう状態になっています。

<script> を入れられると、ほかの人のブラウザで勝手にプログラムが動く

太字になるくらいなら、まだ笑い話です。問題は、<script>タグを入れられたときです。<script>は、ブラウザでプログラム(JavaScript)を動かすためのタグです。

受け取った内容をそのまま表示するページがあると、悪意のある人が<script>タグを入れて、そのページを見たほかの人のブラウザで、勝手にプログラムを動かせてしまうことがあります。偽物のログイン画面を出したり、情報をぬすんだりするのに使われます。

このような攻撃を「XSS(クロスサイト・スクリプティング)」といいます。今は名前だけ覚えておけば大丈夫です。Webサイトを作る人なら、必ず対策しなければいけない攻撃の1つです。

htmlspecialchars で「ただの文字」にする

対策は簡単です。表示する前にhtmlspecialchars(エイチティーエムエル・スペシャル・キャラズ)という命令を通します。contact.phpを次のように書き換えてください。

<?php
$name = $_POST['name'];
$email = $_POST['email'];
$message = $_POST['message'];
echo 'お名前:' . htmlspecialchars($name, ENT_QUOTES, 'UTF-8') . '<br>';
echo 'メールアドレス:' . htmlspecialchars($email, ENT_QUOTES, 'UTF-8') . '<br>';
echo 'お問い合わせ内容:' . htmlspecialchars($message, ENT_QUOTES, 'UTF-8');
  • 2〜4行目: 送られてきた3つの内容を、それぞれ変数に入れる(さっきと同じ)
  • 5行目: $nameをhtmlspecialcharsで安全な形に変えてから、「お名前:」と改行のタグにつなげて表示する
  • 6行目: $emailも同じように変えてから表示する
  • 7行目: $messageも同じように変えてから表示する

もう一度、お名前に<b>たろう</b>と入れて送信してみましょう。

お名前:<b>たろう</b>

今度は太字にならず、入力したとおりの文字として表示されました。

ブラウザで右クリックして「ページのソースを表示」を選ぶと、PHPが作ったHTMLが見られます。

お名前:&lt;b&gt;たろう&lt;/b&gt;<br>

<が&lt;に、>が&gt;に変わっています。これは、HTMLで「<という文字そのもの」を表す書き方です。ブラウザは&lt;を見ると、タグの始まりではなく、ただの「<」という文字として表示します。

htmlspecialcharsは、HTMLで特別な意味を持つ文字を、次のように変えてくれます。

元の文字 変わったあと
< &lt;
> &gt;
& &amp;
" &quot;
' &#039;

<script>も同じように&lt;script&gt;に変わるので、プログラムとして動くことはありません。名前のとおり、HTMLのspecial(特別な)chars(文字)を変える命令です。

htmlspecialcharsのうしろの( )には、,(カンマ)で区切って3つのものを渡しています。

htmlspecialchars($name, ENT_QUOTES, 'UTF-8')
  1. $name … 変えたいもの。ここに入力された内容を入れます
  2. ENT_QUOTES(エント・クオーツ) … "だけでなく'も変える、という指定です。'や"はタグの中で特別な意味を持つので、両方とも変えておきます
  3. 'UTF-8' … 文字の種類(文字コード)。このシリーズで作るファイルはUTF-8なので、そう伝えます

3本目の記事で使ったprint_r($fruits)は、( )に1つだけ渡していました。htmlspecialcharsのように、命令によっては,で区切って何個も渡すものがあります。渡す順番は決まっているので、入れかえないようにしましょう。

2つ目のENT_QUOTESは'で囲みません。PHPがあらかじめ用意している決まった言葉なので、そのまま大文字で書きます。

「表示するときは必ず htmlspecialchars」と覚える

ここで覚えてほしいルールは1つです。

入力された内容を画面に表示するときは、必ずhtmlspecialcharsを通す。

「この欄にタグを入れる人なんていないだろう」と思っても、例外を作らないことが大事です。1か所でも忘れると、そこからXSSの攻撃を受けてしまいます。

とはいえ、htmlspecialchars($name, ENT_QUOTES, 'UTF-8')は長くて、毎回書くのは面倒ですよね。これを短く書けるようにする方法は、シリーズの後の記事で紹介します。今は、この長い形のまま書いていきましょう。

1つのファイルにまとめる(フォームと受け取りを contact.php に)

今は、フォームがcontact.html、受け取りがcontact.phpと、2つのファイルに分かれています。

このあと作る「未入力ならエラーを出す」では、エラーのメッセージと一緒にもう一度フォームを表示したくなります。そのためには、フォームと受け取りが同じファイルにあったほうが便利です。そこで、contact.php1つにまとめましょう。

ここでは説明を短くするために、入力欄は「お名前」だけにして進めます。3つそろえた完成版は、このあとで紹介します。

action を自分自身にする

contact.phpを、次のように書き換えて保存してください。

<?php
$name = $_POST['name'];
?>
<!DOCTYPE html>
<html lang="ja">
<head>
  <meta charset="UTF-8">
  <title>お問い合わせ</title>
</head>
<body>
  <h1>お問い合わせ</h1>
  <p>お名前:<?php echo htmlspecialchars($name, ENT_QUOTES, 'UTF-8'); ?></p>
  <form action="contact.php" method="post">
    <p>
      お名前<br>
      <input type="text" name="name">
    </p>
    <button type="submit">送信する</button>
  </form>
</body>
</html>
  • 1〜3行目: 送られてきたお名前を$nameに入れて、PHPを終わる
  • 4〜11行目: ふつうのHTML
  • 12行目: 「お名前:」のうしろに、$nameをhtmlspecialcharsで変えてから表示する
  • 13行目: フォームの始まり。送り先はcontact.php
  • 14〜17行目: お名前の入力欄
  • 18行目: 送信ボタン
  • 19〜21行目: フォームの終わりと、ふつうのHTML

13行目のaction="contact.php"に注目してください。このファイル自身もcontact.phpですね。つまり、送信すると、自分自身に内容を送ることになります。

フォームを表示するのも、送られてきた内容を受け取るのも、同じcontact.phpがやるということです。もうcontact.htmlは使わないので、消してしまってかまいません。

最初に開いたときは送信されていない

ブラウザでサーバー名.xsrv.jp/contact.phpを直接開いてみてください。フォームの上に、次のようなメッセージが表示されます。

Warning: Undefined array key "name" in ... on line 2

Deprecated: htmlspecialchars(): Passing null to parameter #1 ($string) of type string is deprecated in ... on line 12

1つ目のWarning: Undefined array key "name"は、「'name'というキーは、配列の中にありません」という意味です。

アドレスバーにURLを入れてページを開いたときは、まだ何も送信されていません。なので$_POSTは空っぽで、'name'というキーもありません。それなのに2行目で$_POST['name']を取り出そうとしたので、注意されたのです。

2つ目のDeprecated(デプリケイテッド)は、「おすすめしない使い方です」という意味の注意です。$_POST['name']を取り出せなかったので、$nameには何も入っていないことを表すnull(ヌル)が入りました。htmlspecialcharsの1つ目(parameter #1)には文字列を渡すきまりなのに、nullを渡したので注意されています。

どちらも、原因は「送信されていないのに、送られてきた内容を使おうとしている」ことです。

送信されたときだけ処理する

そこで、「送信されたときだけ、受け取る」ようにします。前回習ったif文の出番です。1〜3行目を、次のように書き換えてください。

<?php
$name = '';
if ($_SERVER['REQUEST_METHOD'] === 'POST') {
    $name = $_POST['name'];
}
?>
  • 2行目: $nameに、空の文字''を入れておく
  • 3行目: もし、postで送信されてきたなら
  • 4行目: 送られてきたお名前を$nameに入れる
  • 5行目: if文の終わり

3行目の$_SERVER(ダラー・アンダーバー・サーバー)は、$_POSTと同じようにPHPが自動で作ってくれる連想配列です。今アクセスしてきたのがどんなリクエストなのか、といった情報が入っています。

その中の'REQUEST_METHOD'(リクエスト・メソッド)には、ページがどんな方法で開かれたかが入っています。

  • フォームからpostで送信されたとき … 'POST'
  • アドレスバーにURLを入れたり、リンクをクリックしたりして開いたとき … 'GET'

なので、$_SERVER['REQUEST_METHOD'] === 'POST'は「フォームから送信されてきたか?」という条件になります。前回習った===で、文字列が同じかどうかを比べていますね。'POST'は全部大文字で書きます。'post'と小文字で書くと、1文字でもちがえば別のものなので、いつまでもfalseになってしまいます。

2行目で先に$name = '';としているのは、送信されていないときにも$nameを使えるようにするためです。最初に開いたときは3行目の条件がfalseなので、4行目はとばされます。それでも$nameには''(空の文字)が入っているので、12行目のhtmlspecialcharsで注意されることはありません。

保存してcontact.phpを開き直すと、メッセージが消えて「お名前:」とフォームだけが表示されます。名前を入れて送信すれば、「お名前:たろう」と表示されます。

?? で「なければ空の文字」

もう1つ、念のための書き方を足しておきます。4行目を、次のように書き換えてください。

    $name = $_POST['name'] ?? '';

??(はてなマーク2つ)は、「左があれば左を、なければ右を使う」という記号です。

  • $_POST['name']がある … 送られてきたお名前を$nameに入れる
  • $_POST['name']がない … 右の''(空の文字)を$nameに入れる

「送信されたときだけ」にしたのに、どうして必要なのでしょうか。それは、送信されても'name'が届かないことがあるからです。たとえば、フォームのname="name"を書き忘れたり、つづりをまちがえたりすると、送信はされるのに$_POST['name']がありません。??を付けておけば、そんなときもWarningを出さずに、空の文字として扱えます。

?はShift + めのキーで入力できます。?を2つ、間をあけずに書きます。

入力チェック(未入力ならエラーを出す)

今のままだと、何も入力せずに「送信する」を押しても、そのまま受け付けてしまいます。お問い合わせを受けた側は、名前もメッセージもわからなくて困りますね。

そこで、送信されてきた内容が空っぽではないかを調べて、空っぽならエラーを出すようにします。このように、送られてきた内容が正しいかどうかを調べることを「入力チェック」といいます。

trim で前後の空白を取る

チェックの前に、ひと手間かけます。お名前の欄に、スペースだけを入れて送信されたらどうでしょうか。見た目は空っぽですが、PHPから見ると「スペースという文字が入っている」ので、空っぽとは判断されません。

そこで、trim(トリム)という命令を使います。trimは英語で「切りそろえる」という意味で、文字列の前とうしろにある空白(スペースや改行)を取り除いてくれます。

    $name = trim($_POST['name'] ?? '');
  • $_POST['name'] ?? '' … 送られてきたお名前を取り出す(なければ空の文字)
  • trim( ) … それの前後の空白を取り除く
  • $name = … 取り除いた結果を$nameに入れる

たとえば' たろう 'のように前後にスペースが付いていたら'たろう'に、' 'のようにスペースだけなら''(空の文字)になります。これで、スペースだけの入力も「未入力」とみなせるようになります。

取り除かれるのは前とうしろだけで、'たろう やまだ'のように間にあるスペースはそのまま残ります。

ひとつだけ注意があります。trimが取り除くのは半角のスペースや改行で、全角スペース(「 」)は取り除きません。PHP 8.4以上なら、全角スペースも取り除けるmb_trimという命令が使えます。今は「trimは半角だけ」と知っておけば大丈夫です。

if ($name === '') で未入力を調べる

空っぽかどうかは、前回習ったif文と===で調べられます。

    if ($name === '') {
        echo 'お名前を入力してください';
    }

''は、'を2つ続けて間に何も書かない空の文字です。「$nameが空の文字と同じなら」、つまり「お名前が入力されていなければ」という条件になります。

エラーを配列にためる

入力欄が3つあると、エラーも最大で3つ出ます。「お名前を入力してください」「メールアドレスを入力してください」……と、見つかったエラーを全部まとめて表示したいですね。

そこで、echoですぐ表示するのではなく、エラーのメッセージを配列にためていきます。

<?php
$errors = [];
$name = trim($_POST['name'] ?? '');
$email = trim($_POST['email'] ?? '');
if ($name === '') {
    $errors[] = 'お名前を入力してください';
}
if ($email === '') {
    $errors[] = 'メールアドレスを入力してください';
}
  • 2行目: エラーのメッセージをためておく配列$errorsを作る。[]は中身が空っぽの配列
  • 3行目: お名前を受け取り、前後の空白を取って$nameに入れる
  • 4行目: メールアドレスを受け取り、前後の空白を取って$emailに入れる
  • 5行目: もしお名前が空っぽなら
  • 6行目: 配列$errorsの最後に、「お名前を入力してください」を追加する
  • 7行目: if文の終わり
  • 8〜10行目: メールアドレスも同じように調べて、空っぽならエラーを追加する

6行目の$errors[] = …;は、3本目の記事で$fruits[] = 'ぶどう';として果物を追加したのと同じ書き方です。[]の中に番号を書かずに=で入れると、配列の最後に追加されるのでした。

5行目と8行目は、elseifではなく、別々のif文にしているのがポイントです。elseifだと「最初に当てはまった1つだけ」しか実行されないので、お名前が空っぽのときにメールアドレスのチェックがとばされてしまいます。全部の欄を1つずつ調べたいので、if文を並べています。

両方とも空っぽで送信されたら、$errorsの中身は次のようになります。

Array
(
    [0] => お名前を入力してください
    [1] => メールアドレスを入力してください
)

エラーがあれば foreach で表示、なければ「受け付けました」

エラーがたまったかどうかは、count(カウント)という命令で調べます。countは英語で「数える」という意味で、配列に入っている数を教えてくれます。

count($errors)
  • エラーが2つたまっていれば … 2
  • エラーが1つもなければ(空っぽの配列なら) … 0

つまり、count($errors) === 0なら「エラーなし」、count($errors) > 0なら「エラーあり」です。

エラーがあるときは、前回習ったforeachで1つずつ取り出して表示します。

<?php if (count($errors) > 0): ?>
  <ul>
    <?php foreach ($errors as $error): ?>
      <li><?php echo $error; ?></li>
    <?php endforeach; ?>
  </ul>
<?php endif; ?>
  • 1行目: もしエラーが1つ以上あるなら
  • 2行目: 箇条書きの始まり
  • 3行目: $errorsからエラーを1つずつ取り出して$errorに入れ、くり返す
  • 4行目: エラーのメッセージを<li>の中に表示する
  • 5行目: foreachの終わり
  • 6行目: 箇条書きの終わり
  • 7行目: if文の終わり

前回のmembers.phpと同じく、HTMLの中なので:とendforeach; / endif;で書いています。$errors(複数形)から1つずつ取り出したものを$error(単数形)と名付けるのも、前回と同じです。

4行目で$errorをhtmlspecialcharsなしで表示しているのは、エラーのメッセージが自分で書いた決まった文字で、入力された内容ではないからです。htmlspecialcharsが必要なのは、入力された内容を表示するときです。

文字数の上限をチェックする

お問い合わせ内容に、とても長い文章(たとえば何万文字も)を送られると困ることがあります。そこで、1000文字までという上限を付けましょう。

文字数は、mb_strlen(エムビー・ストレン)という命令で数えられます。strは「文字列(string)」、lenは「長さ(length)」の略です。

    if ($message === '') {
        $errors[] = 'お問い合わせ内容を入力してください';
    } elseif (mb_strlen($message) > 1000) {
        $errors[] = 'お問い合わせ内容は1000文字以内で入力してください';
    }
  • 1行目: もしお問い合わせ内容が空っぽなら
  • 2行目: 「お問い合わせ内容を入力してください」をエラーに追加する
  • 3行目: そうではなくて、もしお問い合わせ内容の文字数が1000より多いなら
  • 4行目: 「1000文字以内で入力してください」をエラーに追加する
  • 5行目: if文の終わり

ここではelseifを使っています。同じ欄について「空っぽ」と「長すぎる」が同時に当てはまることはないので、どちらか1つを出せば十分だからです。さっきの「欄ごとに別々のif文」とのちがいに注目してください。

PHPにはstrlen(mb_なし)という命令もありますが、これは日本語の文字数を正しく数えられません。たとえばstrlen('たろう')は3ではなく9になります(日本語1文字をデータの大きさで数えるため)。日本語の文字数を数えるときはmb_strlenと覚えておきましょう。mb_は「日本語のような文字(マルチバイト文字)に対応した」という印です。

エラーのときは入力した内容を残す

エラーが出てフォームがもう一度表示されたとき、入力欄が全部空っぽに戻っていたらどうでしょう。長いお問い合わせ内容を書いた人は、最初から書き直しになってしまいます。

そこで、エラーのときはさっき入力した内容を、入力欄に入れた状態で表示します。<input>タグのvalue(バリュー)に書いた文字は、最初から入力欄に入った状態で表示されます。

<input type="text" name="name" value="<?php echo htmlspecialchars($name, ENT_QUOTES, 'UTF-8'); ?>">

value="…"の"と"の間に、$nameを表示しています。お名前に「たろう」と入れて送信していれば、PHPが作るHTMLはvalue="たろう"になり、入力欄に「たろう」が入った状態で表示されます。

ここでもhtmlspecialcharsを忘れずに付けます。特にvalue="…"の中では、入力された"がそのまま出ると、valueがそこで終わってしまい、タグがこわれたり、うしろに好きな指定を書きこまれたりします。ENT_QUOTESで"も&quot;に変えているのは、このためです。

<textarea>にはvalueがありません。かわりに、<textarea>と</textarea>の間に書きます。

<textarea name="message" rows="5" cols="40"><?php echo htmlspecialchars($message, ENT_QUOTES, 'UTF-8'); ?></textarea>

<textarea>と<?phpの間、?>と</textarea>の間には、スペースや改行を入れないでください。<textarea>の中では、スペースや改行もそのまま入力欄に表示されてしまいます。

完成版 contact.php(全体を1行ずつ解説)

ここまでの内容を全部まとめると、次のようになります。contact.phpの中身をすべて消して、次のコードを入力して保存してください。

<?php
// 入力された内容を入れる変数(最初は空の文字)
$name = '';
$email = '';
$message = '';
// エラーメッセージを入れる配列(最初は空)
$errors = [];
// 受け付けたかどうか(最初はまだ受け付けていない)
$sent = false;

// 送信されたときだけ、受け取ってチェックする
if ($_SERVER['REQUEST_METHOD'] === 'POST') {
    $name = trim($_POST['name'] ?? '');
    $email = trim($_POST['email'] ?? '');
    $message = trim($_POST['message'] ?? '');

    if ($name === '') {
        $errors[] = 'お名前を入力してください';
    }
    if ($email === '') {
        $errors[] = 'メールアドレスを入力してください';
    }
    if ($message === '') {
        $errors[] = 'お問い合わせ内容を入力してください';
    } elseif (mb_strlen($message) > 1000) {
        $errors[] = 'お問い合わせ内容は1000文字以内で入力してください';
    }

    if (count($errors) === 0) {
        $sent = true;
    }
}
?>
<!DOCTYPE html>
<html lang="ja">
<head>
  <meta charset="UTF-8">
  <title>お問い合わせ</title>
</head>
<body>
  <h1>お問い合わせ</h1>

  <?php if ($sent === true): ?>
    <p>お問い合わせを受け付けました。</p>
    <p>お名前:<?php echo htmlspecialchars($name, ENT_QUOTES, 'UTF-8'); ?></p>
    <p>メールアドレス:<?php echo htmlspecialchars($email, ENT_QUOTES, 'UTF-8'); ?></p>
    <p>お問い合わせ内容:<?php echo htmlspecialchars($message, ENT_QUOTES, 'UTF-8'); ?></p>
  <?php else: ?>
    <?php if (count($errors) > 0): ?>
      <ul>
        <?php foreach ($errors as $error): ?>
          <li><?php echo $error; ?></li>
        <?php endforeach; ?>
      </ul>
    <?php endif; ?>

    <form action="contact.php" method="post">
      <p>
        お名前<br>
        <input type="text" name="name" value="<?php echo htmlspecialchars($name, ENT_QUOTES, 'UTF-8'); ?>">
      </p>
      <p>
        メールアドレス<br>
        <input type="email" name="email" value="<?php echo htmlspecialchars($email, ENT_QUOTES, 'UTF-8'); ?>">
      </p>
      <p>
        お問い合わせ内容<br>
        <textarea name="message" rows="5" cols="40"><?php echo htmlspecialchars($message, ENT_QUOTES, 'UTF-8'); ?></textarea>
      </p>
      <button type="submit">送信する</button>
    </form>
  <?php endif; ?>
</body>
</html>

長く見えますが、上の半分がPHP(受け取りとチェック)、下の半分がHTML(表示)に分かれています。1つずつ見ていきましょう。

上の半分:受け取りとチェック(1〜33行目)

  • 1行目: ここからPHPです
  • 2行目: コメント
  • 3〜5行目: お名前・メールアドレス・お問い合わせ内容を入れる変数を作り、空の文字を入れておく。送信されていないときも、下のHTMLでこれらの変数を使うため
  • 6行目: コメント
  • 7行目: エラーのメッセージをためる配列$errorsを、空っぽで作る
  • 8行目: コメント
  • 9行目: 受け付けたかどうかを入れる変数$sentを作り、falseを入れておく
  • 11行目: コメント
  • 12行目: もし、フォームからpostで送信されてきたなら
  • 13〜15行目: 3つの内容を受け取り(なければ空の文字)、前後の空白を取って、それぞれの変数に入れる
  • 17〜19行目: お名前が空っぽなら、エラーを追加する
  • 20〜22行目: メールアドレスが空っぽなら、エラーを追加する
  • 23〜27行目: お問い合わせ内容が空っぽなら「入力してください」、1000文字より多ければ「1000文字以内で」のエラーを追加する
  • 29行目: もしエラーが1つもなければ
  • 30行目: $sentにtrueを入れる(受け付けた)
  • 31行目: 29行目のif文の終わり
  • 32行目: 12行目のif文の終わり
  • 33行目: PHPの終わり

9行目と30行目のfalseとtrueは、前回の記事で「条件の答えは、trueかfalseのどちらか」と説明したものです。trueとfalseは、変数に入れておくこともできます。'で囲まずに、そのまま書きます。

$sentは、最初はfalse(まだ受け付けていない)にしておき、送信されてエラーがなかったときだけtrue(受け付けた)に書き換えます。こうしておくと、下のHTMLで$sentを見るだけで「受け付けたのかどうか」がわかります。sentは英語で「送られた」という意味です。

16行目と28行目は空の行です。何もしませんが、「受け取る」「チェックする」「結果を決める」のまとまりごとに空けておくと、読みやすくなります。

下の半分:表示(34〜74行目)

  • 34〜41行目: ふつうのHTML。ページのタイトルと見出し
  • 43行目: もし受け付けた($sentがtrue)なら
  • 44行目: 「お問い合わせを受け付けました。」と表示する
  • 45〜47行目: 入力されたお名前・メールアドレス・お問い合わせ内容を、htmlspecialcharsを通して表示する
  • 48行目: そうでなければ(まだ送信していない、またはエラーがある)
  • 49〜55行目: もしエラーがあれば、箇条書きで1つずつ表示する
  • 57行目: フォームの始まり。送り先は自分自身のcontact.php
  • 58〜61行目: お名前の入力欄。valueに、さっき入力したお名前を入れておく
  • 62〜65行目: メールアドレスの入力欄。valueに、さっき入力したメールアドレスを入れておく
  • 66〜69行目: お問い合わせ内容の入力欄。タグの間に、さっき入力した内容を入れておく
  • 70行目: 送信ボタン
  • 71行目: フォームの終わり
  • 72行目: 43行目のif文の終わり
  • 73〜74行目: ふつうのHTML

48行目の<?php else: ?>は、前回習ったelseを:の書き方にしたものです。{ }で書くなら} else {のところを、else:と書きます。

<?php if (条件): ?>
  条件がtrueのときに表示するHTML
<?php else: ?>
  条件がfalseのときに表示するHTML
<?php endif; ?>

このページでは、「受け付けました」の表示と、フォームの表示のどちらか一方だけが出ます。受け付けたあとにフォームまで出ていると、「まだ送れていないのかな?」とまぎらわしいからです。

場面ごとに、$sentと$errorsがどうなっているかをまとめると、次のとおりです。

場面 $sent $errors 表示されるもの
URLを入れて開いたとき false 空っぽ 空のフォームだけ
未入力の欄があって送信したとき false エラーあり エラーと、入力した内容が残ったフォーム
全部入力して送信したとき true 空っぽ 「受け付けました」と入力した内容

URLを入れて開いたときは12行目の条件がfalseなので、13〜31行目はまるごとはとばされます。$sentは9行目のfalseのまま、$errorsも7行目の空っぽのままなので、エラーなしのフォームだけが表示されます。

エックスサーバーで3つのパターンを試す

ブラウザでサーバー名.xsrv.jp/contact.phpを開いて、次の3つを試してみてください。

1. 何も入力せずに「送信する」を押す

・お名前を入力してください
・メールアドレスを入力してください
・お問い合わせ内容を入力してください

3つのエラーが表示され、その下にもう一度フォームが出ます。お名前だけ入れて送信すると、お名前のエラーだけが消えて、入れたお名前が入力欄に残っているはずです。

2. お名前に<b>たろう</b>と入れ、ほかの欄も入力して送信する

お問い合わせを受け付けました。
お名前:<b>たろう</b>
メールアドレス:taro@example.com
お問い合わせ内容:はじめまして

太字にならず、入力したとおりの文字で表示されれば、htmlspecialcharsがちゃんと効いています。

3. 3つとも正しく入力して送信する

お問い合わせを受け付けました。
お名前:たろう
メールアドレス:taro@example.com
お問い合わせ内容:はじめまして

「受け付けました」と表示され、フォームは表示されなくなります。

メールアドレスの欄に「taro」のように「@」のない文字を入れて送信しようとすると、PHPに届く前に、ブラウザがメッセージを出して止めます。これはtype="email"のはたらきです。

ただし、ブラウザのチェックは、仕組みを知っている人なら簡単にすり抜けられます。今回PHPでも未入力をチェックしているのは、ブラウザのチェックだけにたよらないためです。メールアドレスの形をPHPで調べる方法は、メールを送る次の記事で紹介する予定です。

(おまけ)1本目のフォームのコードを読んでみる

1本目の記事で、「PHPでできること」の例として次のコードを紹介しました。今なら読めるはずです。

<?php
$name = '';
if ($_SERVER['REQUEST_METHOD'] === 'POST') {
    $name = htmlspecialchars($_POST['name'] ?? '', ENT_QUOTES, 'UTF-8');
}
?>
<!DOCTYPE html>
<html lang="ja">
<head>
  <meta charset="UTF-8">
  <title>名前を入力</title>
</head>
<body>
  <form method="post">
    <input type="text" name="name" placeholder="お名前">
    <button type="submit">送信</button>
  </form>

  <?php if ($name !== ''): ?>
    <p>こんにちは、<?= $name ?>さん!</p>
  <?php endif; ?>
</body>
</html>
  • 2行目: $nameに空の文字を入れておく
  • 3行目: もしフォームからpostで送信されてきたなら
  • 4行目: 送られてきたお名前(なければ空の文字)をhtmlspecialcharsで安全な形に変えて、$nameに入れる
  • 14〜17行目: お名前の入力欄と送信ボタンがあるフォーム
  • 19行目: もし$nameが空の文字ではないなら
  • 20行目: 「こんにちは、〇〇さん!」と表示する
  • 21行目: if文の終わり

この記事で作ったコードと、ちがうところを見てみましょう。

  • 4行目 … 受け取るときに、すぐhtmlspecialcharsを通しています。今回は「表示するときに通す」書き方にしましたが、このように受け取ったときに変えておく書き方もあります
  • 14行目 … <form>にactionがありません。actionを書かないと、今開いているページ自身に送信されます。今回のaction="contact.php"と同じ動きです
  • 15行目のplaceholder(プレースホルダー) … 入力欄が空のときに、うすい文字で表示される「お手本」です。valueとちがって、送信はされません
  • 20行目の<?= $name ?> … <?php echo $name; ?>を短く書いたものです。<?=は「<?php echo」の省略形で、最後の;もいりません

$_SERVER['REQUEST_METHOD']、??、htmlspecialchars、!==、:とendif;――ほとんどが、この記事と前回までの記事で習ったことでできていますね。

よくあるつまずきと直し方

フォームで出やすいまちがいと、そのときに表示されるメッセージをまとめました。フォームのHTMLと、PHPの$_POST['…']の両方を見比べるのがコツです。

最初に開いただけで Warning: Undefined array key "name"

Warning: Undefined array key "name" in ... on line 2

ページを開いただけ(まだ送信していない)なのに出るときは、送信されていないのに$_POST['name']を使っているのが原因です。

<?php
$name = $_POST['name'];

次のように、if ($_SERVER['REQUEST_METHOD'] === 'POST')の中で受け取り、?? ''も付けておきましょう。

<?php
$name = '';
if ($_SERVER['REQUEST_METHOD'] === 'POST') {
    $name = trim($_POST['name'] ?? '');
}

送信したあとに出るときは、methodやつづりのまちがいかもしれません。このあとの2つも見てください。

入力したのに「お名前を入力してください」と出る

ちゃんと入力して送信したのに、未入力のエラーが出るパターンです。フォームのname="…"と、PHPの$_POST['…']のつづりがちがうのが、よくある原因です。

<input type="text" name="namae">
    $name = trim($_POST['name'] ?? '');

フォームはnamae、PHPはnameになっています。送られてくるのは$_POST['namae']なので、$_POST['name']はありません。??で空の文字になり、「入力されていない」と判断されてしまいます。

こういうときは、PHPの最初のほうに次の3行を足して、実際に何が届いているかを見てみましょう。

echo '<pre>';
print_r($_POST);
echo '</pre>';
Array
(
    [namae] => たろう
    [email] => taro@example.com
    [message] => はじめまして
)

キーがnamaeになっているので、つづりのちがいにすぐ気づけます。どちらかにそろえて直したら、足した3行は消しておきましょう。大文字・小文字のちがい(Nameとname)も別のものとして扱われるので、注意してください。

送信したら内容がURLに出た・受け取れない

送信したらアドレスバーにcontact.php?name=たろう&email=…のように内容が出て、Warning: Undefined array keyが表示される(またはエラーのメッセージが全部出る)パターンです。

<form>のmethod="post"を書き忘れているのが原因です。

<form action="contact.php">

methodを書かないと、送り方はgetになります。getで送った内容は$_POSTに入らないので、受け取れません。<form action="contact.php" method="post">と、method="post"を書き足してください。method="pots"のようなつづりまちがいでも、同じことが起きます。

Deprecated: htmlspecialchars(): Passing null to parameter #1

Warning: Undefined array key "name" in ... on line 2

Deprecated: htmlspecialchars(): Passing null to parameter #1 ($string) of type string is deprecated in ... on line 3

Passing null to parameter #1は、「1つ目にnull(何も入っていないもの)が渡されました」という意味です。$_POST['name']に?? ''を付けずに受け取ったとき、キーがないと変数にnullが入り、それをhtmlspecialcharsに渡すと出ます。

<?php
$name = $_POST['name'];
echo htmlspecialchars($name, ENT_QUOTES, 'UTF-8');

trimに渡したときは、Deprecated: trim(): Passing null to parameter #1と、命令の名前だけが変わります。上のWarning: Undefined array keyと一緒に出ることが多いので、まずは$_POST['…']のうしろに?? ''を付けているかを確認しましょう。

サーバーの設定によっては、Deprecatedは表示されないこともあります。表示されなくても、?? ''は付けておきましょう。

送信すると 404 Not Found

「送信する」を押すと、「404 Not Found」や「ページが見つかりません」と表示されるパターンです。

action="…"に書いたファイル名と、実際のファイル名がちがうのが原因です。

<form action="contakt.php" method="post">

contakt.phpというファイルはないので、「見つかりません」になります。actionのファイル名と、ファイルマネージャにあるファイル名が1文字もちがわずに同じかを確認してください。contact.phpをpublic_html以外のフォルダに作ってしまった場合も、同じように見つかりません。

再読み込みで「フォームを再送信しますか?」と出る

「受け付けました」の画面でブラウザの再読み込みボタンを押すと、「フォームの再送信を確認」のような画面が出ることがあります。

これはエラーではありません。postで送信したあとのページを再読み込みすると、ブラウザが「さっきの内容を、もう一度送りますか?」と確認してくれているのです。「続行」を押すと、同じ内容がもう一度送信されます。

今は表示するだけなので問題ありませんが、メールを送るようになると同じメールが2通届いてしまいます。これを防ぐ方法は、次の記事で紹介します。

まとめ|フォームの内容を受け取って、安全に表示できた

  • フォームは、<form action="送り先" method="post">の中に入力欄と送信ボタンを書く
  • 入力欄のname="〇〇"が、PHPで受け取るときのキーになる
  • postで送られた内容は、$_POSTという連想配列に入る。$_POST['name']のように取り出す
  • お問い合わせフォームでは、内容がURLに出ないpostを使う
  • 入力された内容を表示するときは、必ずhtmlspecialchars($name, ENT_QUOTES, 'UTF-8')を通す(XSS対策)
  • if ($_SERVER['REQUEST_METHOD'] === 'POST')で、送信されたときだけ受け取る。?? ''で、ないときは空の文字にする
  • trimで前後の空白を取り、=== ''で未入力を調べる。エラーは$errors[]で配列にためて、countで数を調べる
  • 日本語の文字数はmb_strlenで数える

これで、お問い合わせフォームの「受け取る」「チェックする」「表示する」ができるようになりました。前回のif文とforeach、3本目の連想配列と[]での追加――これまでに習ったことが、全部つながって1つのフォームになっています。

if文やforeachをおさらいしたい方は、前回の記事をどうぞ。

👉 PHPのif文とforeachを初心者向けに解説|条件で表示を変えて、配列を一覧にしよう

次の記事では、このフォームに入力された内容をメールで自分に届くようにします。今は「受け付けました」と表示するだけですが、本物のお問い合わせフォームと同じように、送信するたびにメールが届くようになります。

👉 PHPでお問い合わせフォームからメールを送る|mb_send_mailの使い方とエックスサーバーでの注意点を初心者向けに解説

今すぐエックスサーバーを試してみよう

10日間の無料お試し期間あり。使い勝手を確かめてから、料金を払うかどうか決められます。

無料で試してみる →

関連記事