PHP入門:フォームの受け取りができる小さなページの作り方

PHP入門:フォームの受け取りができる小さなページの作り方 PHP

こんにちは!ともです。Webページにフォームを置いて、送られた内容を受け取るところまでを体験したい。フレームワークの作例から入る方法もありますが、その前に「フォームの送信が、どうやってプログラムに届くのか」を素の仕組みで押さえておくと、理解がぐっと楽になります。

この記事では、フレームワークを使わない「素のPHP」で、名前とメッセージを受け取って「受け付けました」と表示する小さなフォームページを作ります。画面と受け取り処理を、1つのファイルにまとめた形です。

なお、この作例では受け取った内容をデータベースへ保存しません。表示したら終わりで、記録は残らない形です。保存まで含めた形は、PHPのフレームワークの作例で扱っています。

Laravel入門:フォームとデータ保存ができる小さなアプリの作り方

【この記事で分かること】

この記事で分かること
この記事で分かること
  • 素のPHPで作るフォームページの完成形
  • 必要なものとコスト
  • PHPの用意と、組み込みサーバーの起動手順
  • フォームのHTMLの書き方(送信の約束ごと)
  • 送信された値の受け取り方($_POST)
  • 受け取った値を安全に表示する方法(htmlspecialchars)

【完成品のイメージ:送ると「受け付けました」と返る】

完成品のイメージ:送ると「受け付けました」と返る
完成品のイメージ:送ると「受け付けました」と返る

完成すると、ブラウザで開けるフォームのページが手に入ります。名前とメッセージを書いて送信すると、同じページに「受け付けました。〇〇さん、メッセージを受け取りました」と、入力した内容が表示されます。

流れは「フォームを表示する→送信を受け取る→受け付けたことを表示する」という往復です。PHPのページは、ブラウザから開かれるたびにプログラムが実行され、その結果のHTMLが返されます。この「開くたびに動く」という感覚をつかむことが、この作例の目的です。

先に線引きをしておくと、この作例で受け取った内容は保存されません。ページを閉じたり再読み込みしたりすれば、表示されていた内容は消えます。「受け取って、その場で返す」までが担当範囲で、「ためておく」部分はフレームワーク側の作例に譲る、という分け方です。

フォームの見た目部分はHTMLで作ります。HTML自体が初めての場合は、入口の記事もあわせてどうぞ。

HTML・CSS入門:自己紹介ページを1枚作って表示する手順

【必要なものとコスト】

必要なものとコスト
必要なものとコスト

PHPは無料で公開されているオープンソースです。自分のパソコンの中で動かす範囲では、料金はかかりません。

項目内容
使うツールPHP/ブラウザ/テキストエディタ
料金の目安無料(約0円)
前提ターミナルの基本操作

バージョンの目安として、2026年11月時点でPHPの現行系列は8.4系あたりまで進んでいますが、この記事では広く使われている8.3以上を用意します。PHPのフレームワークLaravelの現行系列(13系)もPHP 8.3以上を前提にしているため、この範囲でそろえておくと先の作例にもつながります。

【難易度と進め方の目安】

難易度と進め方の目安
難易度と進め方の目安

難易度は低めです。作るのは1ファイルだけで、データベースも使いません。目安の所要時間は、PHPの用意込みで1時間前後です。

進め方は「PHPの用意→フォームの作成→受け取り処理の追加→組み込みサーバーで起動→送信して確認」の順番です。エディタはVS Codeがあると、ファイルの作成と修正がしやすくなります。

VS Codeのインストールと初期設定

【インストール・初期設定】

インストール・初期設定
インストール・初期設定

PHPは公式サイト(php.net)から入手します。Windows向けには公式の配布ファイルがあり、Macの場合はHomebrewなどから入れる方法が案内されています。環境で手順が異なるため、公式サイトのダウンロード案内に沿って、PHP 8.3以上を用意してください。

用意できたら、ターミナルでバージョンを確認します。

# PHPのバージョンを表示する(8.3以上が目安)
php -v

バージョンが表示されれば、PHPは動いています。次に、「php-form」という作業用のフォルダを作り、その中に form.php というファイルを用意します。このファイルに、フォームと受け取り処理をまとめて書いていきます。

動作確認には、PHPに最初から付いている「組み込みサーバー」を使います。専用のサーバーソフトを別途入れる必要はありません。起動の仕方は、作り方の最後で実行します。

【作り方の骨格1:フォームのHTMLを用意する】

作り方の骨格1:フォームのHTMLを用意する
作り方の骨格1:フォームのHTMLを用意する

まず、form.php にフォームの画面部分を書きます。PHPのファイルは、プログラムの部分(<?php から ?> で囲まれた範囲)の外側に書いたものが、そのままHTMLとして表示されます。最初は画面だけを用意します。

<!DOCTYPE html>
<html lang="ja">
<head>
  <!-- 文字コードをUTF-8に指定する(日本語の文字化けを防ぐ) -->
  <meta charset="UTF-8">
  <title>お問い合わせフォーム</title>
</head>
<body>
  <h1>お問い合わせ</h1>

  <!-- 送信先はこのファイル自身、方式はPOSTにする -->
  <form method="post" action="">
    <!-- 名前の入力欄(name属性の名前が、受け取り側での目印になる) -->
    <p>
      <label>名前 <input type="text" name="name"></label>
    </p>
    <!-- メッセージの入力欄 -->
    <p>
      <label>メッセージ <textarea name="message"></textarea></label>
    </p>
    <!-- 送信ボタン -->
    <button type="submit">送信する</button>
  </form>
</body>
</html>

約束ごとは2つです。1つ目は、送信方式(method)を post にすることです。POSTで送られた値は、住所(URL)には表示されず、プログラム側で受け取る形になります。2つ目は、各入力欄に付けた name 属性です。この名前が、受け取り側で値を取り出すときの目印になります。名前の付け忘れが、値を受け取れない原因の筆頭です。

【作り方の骨格2:送信を受け取って、安全に表示する】

作り方の骨格2:送信を受け取って、安全に表示する
作り方の骨格2:送信を受け取って、安全に表示する

次に、受け取りの処理を足します。処理はファイルの先頭に置きます。送信されたかどうかを判定し、値を受け取っておく部分です。

<?php
// 受け取った内容を入れる変数を、先に空の状態で用意する
$name = '';
$message = '';
$sent = false;

// 送信(POST)のときだけ、受け取り処理を行う
if ($_SERVER['REQUEST_METHOD'] === 'POST') {
  // 名前とメッセージを受け取る(値が無い場合は空文字にする)
  $name = $_POST['name'] ?? '';
  $message = $_POST['message'] ?? '';
  // 受け取ったことを記録する
  $sent = true;
}
?>

$_POST が、フォームから送られた値の置き場所です。$_POST['name'] のように、フォーム側の name 属性と同じ名前で取り出します。そして、受け取った内容の表示は、フォームの上あたりに次の形で置きます。

<?php if ($sent): ?>
  <!-- 受け付けたことを表示する -->
  <p>受け付けました。</p>
  <!-- 受け取った値は、必ず htmlspecialchars で無害化してから表示する -->
  <p><?= htmlspecialchars($name, ENT_QUOTES, 'UTF-8') ?> さん、メッセージを受け取りました。</p>
  <!-- メッセージは、無害化したうえで改行を反映して表示する -->
  <p><?= nl2br(htmlspecialchars($message, ENT_QUOTES, 'UTF-8')) ?></p>
<?php endif; ?>

ここで一番大切なのが htmlspecialchars です。受け取った値をそのまま画面に表示すると、値の中にHTMLのタグやスクリプトが混ざっていた場合、ブラウザがそれを「表示する文字」ではなく「実行する命令」として扱ってしまう危険があります(クロスサイトスクリプティングと呼ばれる問題です)。

htmlspecialchars は、< や > といったHTMLとして意味を持つ文字を、文字として表示される形に変換する関数です。「外から来た値は、表示する前に必ず無害化する」。これはPHPに限らず、フォームを扱うときの共通の約束ごとです。題材が自分の練習用でも、この一手間は最初から習慣にしてください。

最後に、組み込みサーバーを起動して動作を確認します。

# 作業フォルダへ移動する
cd php-form

# PHPの組み込みサーバーを起動する(ブラウザで http://localhost:8000/form.php を開く)
php -S localhost:8000

ブラウザでフォームを開き、送信して「受け付けました」と入力内容が表示されれば完成です。サーバーは「Ctrl+C」で止められます。

【つまずきやすい点】

つまずきやすい点
つまずきやすい点

よくあるつまずきは5つです。1つ目は、ファイルをダブルクリックで開いてしまうことです。PHPのファイルは、ブラウザで直接開いてもプログラムが動きません。必ず組み込みサーバーを起動し、http://localhost:8000/form.php の住所から開いてください。

2つ目は、送信しても値が空になることです。フォーム側の name 属性の付け忘れ、または受け取り側の名前との食い違いが原因の筆頭です。両方の名前がそろっているかを見比べてください。送信方式が get になっていると $_POST には入らない点も、あわせて確認します。

3つ目は、日本語の文字化けです。HTMLの先頭付近にある <meta charset="UTF-8"> の指定と、ファイル自体の保存形式(UTF-8)がそろっているかを確認してください。どちらか片方だけでも文字化けの原因になります。

4つ目は、画面が真っ白になることです。PHPの文法に誤りがあると、エラー内容が表示されず真っ白になることがあります。開発中は、ファイルの先頭にエラー表示を有効にする設定を一時的に置くと、原因の行が表示されて直しやすくなります。ただし、この設定は練習用の自分の環境だけに留め、公開するサーバーでは使わないでください。

5つ目は、再読み込みのときの挙動です。送信直後にページを再読み込みすると、「フォームを再送信しますか」とブラウザに聞かれることがあります。これは送信の仕組み上の挙動で、故障ではありません。この作例は保存をしない形のため、再読み込みしても前の入力内容は残りません。

【まとめ】

まとめ
まとめ

素のPHPの入門は、「PHPを用意する→フォームを書く→$_POST で受け取る→htmlspecialchars で無害化して表示する→組み込みサーバーで確認する」という流れで進みます。1ファイルの中に、フォームの往復の仕組みが全部入っているのが、この形の分かりやすさです。

「受け取った内容をデータベースに保存して、一覧で確認したい」という場合は、フレームワークで保存まで扱った作例が次の段階です。

Laravel入門:フォームとデータ保存ができる小さなアプリの作り方

なお、「自分で作るのではなく、業務の自動化そのものを相談したい」という場合は、作ってもらう選択肢もあります。

\ 業務の自動化やAI活用を、代わりに作ってほしい方はこちら /

コメント

タイトルとURLをコピーしました