PHPでできることを初心者向けに解説|レンタルサーバーで作れるものと始め方
PHPを使うと、HTMLだけでは作れない「動きのあるWebサイト」が作れます。この記事では、PHPでできることを実際のコード付きで紹介し、レンタルサーバーで動かすまでの流れを解説します。
エックスサーバーで動かすPHP入門 05 / 12
目次
Webサイトでよく見る「お問い合わせ」のページ。名前やメッセージを入力欄に書いて「送信」ボタンを押すと、「お問い合わせを受け付けました」と表示されます。
このとき、裏では何が起きているのでしょうか。
実は、HTMLのフォームが入力された内容をサーバーに送り、PHPがそれを受け取っているのです。HTMLだけでは、入力された内容を受け取ることはできません。ここがPHPの出番です。
この記事では、お問い合わせフォームを作って、入力された内容をPHPで受け取り、画面に表示するところまでを1行ずつ解説します。入力されていない欄があれば「〇〇を入力してください」とエラーを出す仕組みも作ります。
受け取った内容を、実際にメールで自分に届くようにするのは、次の記事で扱います。
読み終わるころには、1本目の記事で紹介した「フォームに入力された内容を受け取る」コードも、自分で読めるようになっているはずです。
この記事は「エックスサーバーで動かすPHP入門」シリーズの5本目です。if文とforeachは、前回の記事で説明しています。
👉 PHPのif文とforeachを初心者向けに解説|条件で表示を変えて、配列を一覧にしよう
この記事では、次のようなお問い合わせフォームを作ります。
この記事は、前回の記事でif文とforeachを使えるようになった前提で進めます。
今回はpractice.phpではなく、新しくcontact.htmlとcontact.phpを作ります。どちらもファイルマネージャでpublic_htmlの中に作ってください。作り方は、これまでのpractice.phpと同じです。
お問い合わせフォームは、次の2つの部品でできています。
流れを図にすると、次のようになります。
【ブラウザ】contact.html
名前やメッセージを入力して「送信する」を押す
↓ 入力した内容を送る
【サーバー】contact.php
PHPが内容を受け取って、表示するHTMLを作る
↓ 作ったHTMLを返す
【ブラウザ】
「お名前:たろう」のように表示される2本目の記事で「PHPはサーバーで動いて、できあがったHTMLをブラウザに返す」と説明しました。フォームでは、その前に「ブラウザからサーバーへ、入力した内容を送る」という動きが1つ加わります。
まずは、入力欄と送信ボタンがあるだけのフォームを、ふつうの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行目からがフォームです。
contact.phpに、postという送り方で送る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="〇〇"が付いています。
<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にしました)です。うしろの名前は、半角の英数字で自由に付けられます。
次は、送り先のcontact.phpを作ります。ファイルマネージャでpublic_htmlにcontact.phpを新しく作り、次のコードを入力して保存してください。
<?php
echo $_POST['name'];'name'のもの(お名前の欄に入力された内容)を表示する保存したら、サーバー名.xsrv.jp/contact.htmlを開いて、お名前の欄に「たろう」と入力し、「送信する」を押してみてください。
たろう入力した「たろう」が表示されました。アドレスバーを見ると、contact.htmlからcontact.phpに変わっています。action="contact.php"に書いたとおり、contact.phpに送られて、PHPが受け取った内容を表示しているのです。
$_POST(ダラー・アンダーバー・ポスト)は、postで送られてきた内容が入っている連想配列です。自分で作らなくても、フォームから送信されるとPHPが自動で作ってくれます。
名前は全部大文字で、$のあとに_(アンダーバー)が付きます。_はShift + ろのキーで入力できます。
連想配列なので、$_POST['name']のように[' ']でキーを書けば、中身を取り出せます。3本目の記事の$taro['name']と同じ書き方です。
中身をまとめて見たいときは、print_rが使えます。contact.phpを次のように書き換えて保存し、contact.htmlから3つとも入力して送信してみましょう。
<?php
echo '<pre>';
print_r($_POST);
echo '</pre>';<pre>タグを表示する$_POSTの中身をまとめて表示する</pre>タグを表示するArray
(
[name] => たろう
[email] => taro@example.com
[message] => はじめまして
)3本目の記事でprint_r($taro)を表示したときと同じ形ですね。<input>や<textarea>に書いたnameが、そのままキーになっているのがわかります。
うまく受け取れないときは、このようにprint_r($_POST)で中身を確かめるのが近道です。
3つの内容を、それぞれ表示してみましょう。contact.phpを次のように書き換えます。
<?php
$name = $_POST['name'];
$email = $_POST['email'];
$message = $_POST['message'];
echo 'お名前:' . $name . '<br>';
echo 'メールアドレス:' . $email . '<br>';
echo 'お問い合わせ内容:' . $message;$nameに入れる$emailに入れる$messageに入れる$nameと改行のタグを、.でつなげて表示する$emailと改行のタグを表示する$messageを表示するお名前:たろう
メールアドレス:taro@example.com
お問い合わせ内容:はじめまして2〜4行目で、いったん変数に入れてから使っているのがポイントです。$_POST['name']のままでも動きますが、何度も使うときに長くて読みにくくなります。$nameのような短い名前の変数に入れておくと、そのあとのコードがすっきりします。
なお、お問い合わせ内容の欄で改行して書いても、表示では1行につながります。HTMLでは、<br>がないと改行されないからです。今回はこのままで進めます。
<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"にもどして保存しておいてください。
ここまでで、入力された内容を受け取って表示できるようになりました。でも、今のcontact.phpには大きな問題があります。
contact.htmlのお名前の欄に、次のように入力して送信してみてください。
<b>たろう</b>表示はこうなります。
お名前:たろう文字だけだとわかりにくいですが、画面では「たろう」が太字で表示されます。「<b>たろう</b>」という文字が表示されるのではなく、「たろう」が太字になってしまいました。<b>は文字を太字にするHTMLのタグです。
PHPは、受け取った<b>たろう</b>をechoでそのままHTMLの中に書き出しました。ブラウザはそれを見て「これはタグだ」と判断し、太字にしたのです。つまり、入力する人が、ページにHTMLのタグを書きこめてしまう状態になっています。
太字になるくらいなら、まだ笑い話です。問題は、<script>タグを入れられたときです。<script>は、ブラウザでプログラム(JavaScript)を動かすためのタグです。
受け取った内容をそのまま表示するページがあると、悪意のある人が<script>タグを入れて、そのページを見たほかの人のブラウザで、勝手にプログラムを動かせてしまうことがあります。偽物のログイン画面を出したり、情報をぬすんだりするのに使われます。
このような攻撃を「XSS(クロスサイト・スクリプティング)」といいます。今は名前だけ覚えておけば大丈夫です。Webサイトを作る人なら、必ず対策しなければいけない攻撃の1つです。
対策は簡単です。表示する前に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');$nameをhtmlspecialcharsで安全な形に変えてから、「お名前:」と改行のタグにつなげて表示する$emailも同じように変えてから表示する$messageも同じように変えてから表示するもう一度、お名前に<b>たろう</b>と入れて送信してみましょう。
お名前:<b>たろう</b>今度は太字にならず、入力したとおりの文字として表示されました。
ブラウザで右クリックして「ページのソースを表示」を選ぶと、PHPが作ったHTMLが見られます。
お名前:<b>たろう</b><br><が<に、>が>に変わっています。これは、HTMLで「<という文字そのもの」を表す書き方です。ブラウザは<を見ると、タグの始まりではなく、ただの「<」という文字として表示します。
htmlspecialcharsは、HTMLで特別な意味を持つ文字を、次のように変えてくれます。
| 元の文字 | 変わったあと |
|---|---|
< |
< |
> |
> |
& |
& |
" |
" |
' |
' |
<script>も同じように<script>に変わるので、プログラムとして動くことはありません。名前のとおり、HTMLのspecial(特別な)chars(文字)を変える命令です。
htmlspecialcharsのうしろの( )には、,(カンマ)で区切って3つのものを渡しています。
htmlspecialchars($name, ENT_QUOTES, 'UTF-8')$name … 変えたいもの。ここに入力された内容を入れますENT_QUOTES(エント・クオーツ) … "だけでなく'も変える、という指定です。'や"はタグの中で特別な意味を持つので、両方とも変えておきます'UTF-8' … 文字の種類(文字コード)。このシリーズで作るファイルはUTF-8なので、そう伝えます3本目の記事で使ったprint_r($fruits)は、( )に1つだけ渡していました。htmlspecialcharsのように、命令によっては,で区切って何個も渡すものがあります。渡す順番は決まっているので、入れかえないようにしましょう。
2つ目のENT_QUOTESは'で囲みません。PHPがあらかじめ用意している決まった言葉なので、そのまま大文字で書きます。
ここで覚えてほしいルールは1つです。
入力された内容を画面に表示するときは、必ずhtmlspecialcharsを通す。
「この欄にタグを入れる人なんていないだろう」と思っても、例外を作らないことが大事です。1か所でも忘れると、そこからXSSの攻撃を受けてしまいます。
とはいえ、htmlspecialchars($name, ENT_QUOTES, 'UTF-8')は長くて、毎回書くのは面倒ですよね。これを短く書けるようにする方法は、シリーズの後の記事で紹介します。今は、この長い形のまま書いていきましょう。
今は、フォームがcontact.html、受け取りがcontact.phpと、2つのファイルに分かれています。
このあと作る「未入力ならエラーを出す」では、エラーのメッセージと一緒にもう一度フォームを表示したくなります。そのためには、フォームと受け取りが同じファイルにあったほうが便利です。そこで、contact.php1つにまとめましょう。
ここでは説明を短くするために、入力欄は「お名前」だけにして進めます。3つそろえた完成版は、このあとで紹介します。
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>$nameに入れて、PHPを終わる$nameをhtmlspecialcharsで変えてから表示するcontact.php13行目の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 121つ目の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'];
}
?>$nameに、空の文字''を入れておくpostで送信されてきたなら$nameに入れる3行目の$_SERVER(ダラー・アンダーバー・サーバー)は、$_POSTと同じようにPHPが自動で作ってくれる連想配列です。今アクセスしてきたのがどんなリクエストなのか、といった情報が入っています。
その中の'REQUEST_METHOD'(リクエスト・メソッド)には、ページがどんな方法で開かれたかが入っています。
postで送信されたとき … 'POST''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つ、間をあけずに書きます。
今のままだと、何も入力せずに「送信する」を押しても、そのまま受け付けてしまいます。お問い合わせを受けた側は、名前もメッセージもわからなくて困りますね。
そこで、送信されてきた内容が空っぽではないかを調べて、空っぽならエラーを出すようにします。このように、送られてきた内容が正しいかどうかを調べることを「入力チェック」といいます。
チェックの前に、ひと手間かけます。お名前の欄に、スペースだけを入れて送信されたらどうでしょうか。見た目は空っぽですが、PHPから見ると「スペースという文字が入っている」ので、空っぽとは判断されません。
そこで、trim(トリム)という命令を使います。trimは英語で「切りそろえる」という意味で、文字列の前とうしろにある空白(スペースや改行)を取り除いてくれます。
$name = trim($_POST['name'] ?? '');$_POST['name'] ?? '' … 送られてきたお名前を取り出す(なければ空の文字)trim( ) … それの前後の空白を取り除く$name = … 取り除いた結果を$nameに入れるたとえば' たろう 'のように前後にスペースが付いていたら'たろう'に、' 'のようにスペースだけなら''(空の文字)になります。これで、スペースだけの入力も「未入力」とみなせるようになります。
取り除かれるのは前とうしろだけで、'たろう やまだ'のように間にあるスペースはそのまま残ります。
ひとつだけ注意があります。trimが取り除くのは半角のスペースや改行で、全角スペース(「 」)は取り除きません。PHP 8.4以上なら、全角スペースも取り除けるmb_trimという命令が使えます。今は「trimは半角だけ」と知っておけば大丈夫です。
空っぽかどうかは、前回習った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[] = 'メールアドレスを入力してください';
}$errorsを作る。[]は中身が空っぽの配列$nameに入れる$emailに入れる$errorsの最後に、「お名前を入力してください」を追加する6行目の$errors[] = …;は、3本目の記事で$fruits[] = 'ぶどう';として果物を追加したのと同じ書き方です。[]の中に番号を書かずに=で入れると、配列の最後に追加されるのでした。
5行目と8行目は、elseifではなく、別々のif文にしているのがポイントです。elseifだと「最初に当てはまった1つだけ」しか実行されないので、お名前が空っぽのときにメールアドレスのチェックがとばされてしまいます。全部の欄を1つずつ調べたいので、if文を並べています。
両方とも空っぽで送信されたら、$errorsの中身は次のようになります。
Array
(
[0] => お名前を入力してください
[1] => メールアドレスを入力してください
)エラーがたまったかどうかは、count(カウント)という命令で調べます。countは英語で「数える」という意味で、配列に入っている数を教えてくれます。
count($errors)20つまり、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; ?>$errorsからエラーを1つずつ取り出して$errorに入れ、くり返す<li>の中に表示する前回の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文字以内で入力してください';
}ここでは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で"も"に変えているのは、このためです。
<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の中身をすべて消して、次のコードを入力して保存してください。
<?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つずつ見ていきましょう。
$errorsを、空っぽで作る$sentを作り、falseを入れておくpostで送信されてきたなら$sentにtrueを入れる(受け付けた)9行目と30行目のfalseとtrueは、前回の記事で「条件の答えは、trueかfalseのどちらか」と説明したものです。trueとfalseは、変数に入れておくこともできます。'で囲まずに、そのまま書きます。
$sentは、最初はfalse(まだ受け付けていない)にしておき、送信されてエラーがなかったときだけtrue(受け付けた)に書き換えます。こうしておくと、下のHTMLで$sentを見るだけで「受け付けたのかどうか」がわかります。sentは英語で「送られた」という意味です。
16行目と28行目は空の行です。何もしませんが、「受け取る」「チェックする」「結果を決める」のまとまりごとに空けておくと、読みやすくなります。
$sentがtrue)ならhtmlspecialcharsを通して表示するcontact.phpvalueに、さっき入力したお名前を入れておくvalueに、さっき入力したメールアドレスを入れておく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行目の空っぽのままなので、エラーなしのフォームだけが表示されます。
ブラウザでサーバー名.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本目の記事で、「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>$nameに空の文字を入れておくpostで送信されてきたならhtmlspecialcharsで安全な形に変えて、$nameに入れる$nameが空の文字ではないならこの記事で作ったコードと、ちがうところを見てみましょう。
htmlspecialcharsを通しています。今回は「表示するときに通す」書き方にしましたが、このように受け取ったときに変えておく書き方もあります<form>にactionがありません。actionを書かないと、今開いているページ自身に送信されます。今回のaction="contact.php"と同じ動きですplaceholder(プレースホルダー) … 入力欄が空のときに、うすい文字で表示される「お手本」です。valueとちがって、送信はされません<?= $name ?> … <?php echo $name; ?>を短く書いたものです。<?=は「<?php echo」の省略形で、最後の;もいりません$_SERVER['REQUEST_METHOD']、??、htmlspecialchars、!==、:とendif;――ほとんどが、この記事と前回までの記事で習ったことでできていますね。
フォームで出やすいまちがいと、そのときに表示されるメッセージをまとめました。フォームのHTMLと、PHPの$_POST['…']の両方を見比べるのがコツです。
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)も別のものとして扱われるので、注意してください。
送信したらアドレスバーに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"のようなつづりまちがいでも、同じことが起きます。
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 3Passing 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」や「ページが見つかりません」と表示されるパターンです。
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']のように取り出す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の使い方とエックスサーバーでの注意点を初心者向けに解説
PHPを使うと、HTMLだけでは作れない「動きのあるWebサイト」が作れます。この記事では、PHPでできることを実際のコード付きで紹介し、レンタルサーバーで動かすまでの流れを解説します。
エックスサーバーで初めてのPHPを動かしてみましょう。ファイルマネージャでPHPファイルを作り、ブラウザに「Hello World」を表示するまでを解説します。<?phpやechoの意味、よくあるエラーの直し方も1行ずつ説明します。
PHPの「変数」と「配列」を、超初心者向けに1行ずつ解説します。値を入れておく箱を作り、echoで表示しながら、文字のつなぎ方や数字の計算、連想配列まで覚えましょう。前回作った自己紹介ページも変数で書き直します。