介護ヘルパーからITエンジニアになった話
PHPのコードを整理してメモアプリを公開する|関数・requireでパスワードを安全にしまう方法を初心者向けに解説【シリーズ最終回】
プログラミング学習

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

PHPのコードを整理してメモアプリを公開する|関数・requireでパスワードを安全にしまう方法を初心者向けに解説【シリーズ最終回】

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

目次

前回の記事で、メモを書く・一覧で見る・消すことができる、自分専用のメモアプリができました。

前回の最後に、contact.php・admin/inquiries.php・memo/index.phpの3つを見比べてもらいました。どのファイルにも、データベースのパスワードが同じように書いてあり、htmlspecialchars(…, ENT_QUOTES, 'UTF-8')の長い形も何度も出てきます。

シリーズの途中で、こんな約束をしていました。

  • htmlspecialcharsの長い形を短く書けるようにする方法は、後の記事で紹介します(5本目・6本目)
  • パスワードを別のファイルに分けて、もっと安全にしまう方法は、後の記事で紹介します(7本目)
  • 同じことを1か所にまとめて書く方法は、後の記事で紹介します(8本目)

この最終回で、この3つをまとめて片づけます。そして、整理したメモアプリを、スマホからも使えるように公開します。

この記事は「エックスサーバーで動かすPHP入門」シリーズの12本目、最終回です。メモアプリの作り方は、前回の記事で説明しています。

👉 PHPでメモアプリを作る|データベースに書く・一覧・削除を1ファイルで作る方法を初心者向けに解説

この記事でやること

完成しても、画面の見た目や動きは何も変わりません。変わるのは、コードの中身です。

  1. htmlspecialcharsを短く書くための自分の関数h()を作る
  2. データベースの4つの情報とh()を、common.phpという1つのファイルにまとめる
  3. common.phpを、ブラウザからは開けない場所(public_htmlの外)に置く
  4. 3つのファイルを、common.phpを読み込む形に書きかえる
  5. メモアプリをスマホで開いて使う

このように、動きは変えずに、コードを読みやすく・直しやすく整えることを、プログラミングの世界ではリファクタリングと呼びます。仕事でもよく使う言葉なので、名前だけ覚えておいてください。

同じことを何度も書いている

まずは、今どれだけ同じことを書いているかを数えてみます。

ファイル データベースの4つの情報 htmlspecialchars(…, ENT_QUOTES, 'UTF-8')
contact.php 1組 3回
admin/inquiries.php 1組 3回
memo/index.php 1組 2回

同じことを何度も書いていると、次のようなことが起きます。

  • 直すときに、全部直さないといけない … データベースのパスワードを変えたら、3つのファイルを全部書きかえる必要があります。1つでも忘れると、そのページだけAccess deniedのエラーになります
  • 書きまちがえやすい … ENT_QUOTESや'UTF-8'を、8回とも正しく書くのは大変です
  • パスワードがあちこちにある … パスワードが書かれたファイルが多いほど、うっかり人に見せてしまう心配も増えます

そこで、同じことは1か所にだけ書いて、ほかのファイルからはそれを使うようにします。そのために使うのが、関数とrequireです。

自分で関数を作る(h)

これまで「命令」と呼んできたものは「関数」

このシリーズでは、htmlspecialchars・trim・count・dateなどを「命令」と呼んできました。9本目のCall to undefined functionのところで、「function=命令」と説明しましたね。

PHPの言葉では、これらを関数(かんすう、function)と呼びます。( )の中に値を渡すと、何かの仕事をして、結果を返してくれるものです。

これまで使ってきた関数は、全部PHPが最初から用意してくれていたものでした。実は、関数は自分で作ることもできます。よく使う長い書き方に短い名前を付けて、1つの関数にまとめられるのです。

関数 h を作る

練習のために、public_htmlにh_test.phpを作り、次のコードを入力して保存してください。

<?php
function h($text) {
    return htmlspecialchars($text, ENT_QUOTES, 'UTF-8');
}

$name = '<b>たろう</b>';
echo h($name);

ブラウザでサーバー名.xsrv.jp/h_test.phpを開くと、画面に<b>たろう</b>と、そのままの文字で表示されます。太字にはなりません。htmlspecialcharsを通したときと同じですね。

1行ずつ見ていきましょう。

  • 1行目: ここからPHPです
  • 2行目: hという名前の関数を作ります。( )の中の$textには、この関数を使うときに渡された値が入ります
  • 3行目: $textをhtmlspecialcharsに通して、その結果を返します
  • 4行目: 関数の終わり
  • 6行目: $nameに、タグの入った文字を入れる
  • 7行目: 作った関数hに$nameを渡して、返ってきた結果をechoで表示する

2〜4行目:function で関数を作る

function h($text) {
    return htmlspecialchars($text, ENT_QUOTES, 'UTF-8');
}
  • function … 「ここから関数を作ります」という合図です
  • h … 作る関数の名前です。hはHTMLのhで、htmlspecialcharsを短くする関数には、この名前がよく使われます
  • ($text) … 関数に渡された値を受け取る変数です。h($name)と使えば、$nameの中身が$textに入ります
  • {から}まで … 関数を使ったときに実行される中身です。ifの{ }と同じく、中は4つ分右にずらします

関数の名前は自分で決められますが、htmlspecialcharsのようにPHPがすでに使っている名前は使えません。

3行目:return で結果を返す

    return htmlspecialchars($text, ENT_QUOTES, 'UTF-8');

return(リターン)は「返す」という意味です。returnのうしろの結果が、関数を使った場所に返されます。

7行目のecho h($name);は、次の順番で動きます。

  1. h($name)で、関数hが呼び出される。$nameの中身(<b>たろう</b>)が$textに入る
  2. 3行目で、$textをhtmlspecialcharsに通した結果(&lt;b&gt;たろう&lt;/b&gt;)が返される
  3. h($name)のところが、返された結果に置きかわり、それがechoで表示される

つまり、h($name)と書くと、htmlspecialchars($name, ENT_QUOTES, 'UTF-8')と書いたのと同じ結果になります。長い形を、何度でもh(…)の短い形で書けるようになったわけです。

returnを書き忘れると、関数は何も返しません。試しに3行目のreturn を消して再読み込みすると、画面には何も表示されなくなります。関数を作ったら、returnがあるか確かめましょう。

試し終わったら、h_test.phpは削除しておいてください。

関数の中の $text は、関数の中だけのもの

もう1つ大事なことがあります。関数の中で使う変数は、その関数の中だけのものです。

2行目の$textは、関数hの中でしか使えません。反対に、関数の外で作った$nameを、関数の中でそのまま使うこともできません。関数の中で使いたい値は、( )で渡すのが決まりです。

関数は、外とは仕切られた小さな部屋のようなものです。値は( )から入れて、結果はreturnで出してもらう、と覚えておきましょう。

共通のファイル common.php を作る

common.php の中身

次に、3つのファイルで同じように使うもの(データベースの4つの情報と、関数h)を、common.phpという1つのファイルにまとめます。common(コモン)は「共通の」という意味です。

<?php
// データベースにつなぐための4つの情報
$dbHost = 'localhost';
$dbName = 'サーバーID_contact';
$dbUser = 'サーバーID_user';
$dbPass = 'MySQLユーザーのパスワード';

// htmlspecialchars を短く書くための関数
function h($text) {
    return htmlspecialchars($text, ENT_QUOTES, 'UTF-8');
}
  • 1行目: ここからPHPです
  • 2〜6行目: データベースにつなぐための4つの情報。自分の4つに書きかえます(今のcontact.phpに書いてあるものと同じです)
  • 8〜11行目: さっき作った関数h

このファイルは、ブラウザで開いて何かを表示するためのものではなく、ほかのPHPのファイルから読み込んで使うための部品です。

よく見ると、最後に?>(PHPの終わり)を書いていません。PHPだけのファイルでは、最後の?>は書かなくてよいことになっています。むしろ、?>のうしろにうっかり空白や空の行が入ると、それが画面に出てしまい、header('Location: …')での移動がうまくいかなくなることがあります。なので、部品のファイルでは?>を書かないのが一般的です。

common.php は public_html の外に置く

このファイルには、データベースのパスワードが書いてあります。そこで、ブラウザからは絶対に開けない場所に置きます。それが、public_htmlの外です。

エックスサーバーでは、ドメインごとのフォルダの中は、次のようになっています。

サーバー名.xsrv.jp/          ← ドメイン名のフォルダ
├ common.php                  ← ★ここに作る(ブラウザからは開けない)
├ htpasswd/ log/ mail/ など   ← エックスサーバーが作ったフォルダ(さわらない)
└ public_html/                ← ここから下が、インターネットに公開される
   ├ contact.php
   ├ admin/
   │  └ inquiries.php
   └ memo/
      └ index.php

2本目で、public_htmlは「インターネットに公開するファイルを置く場所」で、ここに置いたファイルがブラウザから見られるようになる、と説明しました。言いかえると、URLで開けるのはpublic_htmlの中だけです。public_htmlの外には、それを指すURLがありません。サーバー名.xsrv.jp/common.phpを開いても、public_htmlの中を探しにいくので、見つからずに終わります。

7本目では、「.phpのファイルは、ブラウザで開いても実行結果しか表示されないので、パスワードは見えない」と説明しました。これは正しいのですが、設定のまちがいなどで万が一PHPが動かない状態になると、.phpのファイルの中身がそのまま表示されてしまうこともあります。そもそもURLがない場所に置いておけば、そんな心配もありません。

エックスサーバーの公式マニュアル「初期フォルダについて」によると、ドメイン名のフォルダの中には、public_htmlのほかにhtpasswd(アクセス制限のパスワードのファイル)・log・mailなどのフォルダが最初から作られています。8本目でかけたアクセス制限のパスワードも、実はpublic_htmlの外のhtpasswdにしまわれているのです。マニュアルには「初期フォルダは削除しないように注意してください。」とあるので、これらのフォルダはさわらないでください。

ファイルマネージャで common.php を作る

2本目でファイルマネージャを開いたとき、まずサーバー名.xsrv.jpのフォルダをダブルクリックして、その中のpublic_htmlを開きましたね。common.phpを置くのは、そのサーバー名.xsrv.jpのフォルダの中(public_htmlの1つ上)です。

  1. ファイルマネージャを開き、サーバー名.xsrv.jpのフォルダをダブルクリックする(public_htmlは開かない)
  2. public_htmlやlogなどのフォルダが並んでいることを確かめる
  3. そこに、新しいファイルcommon.phpを作り、さっきのコードを入力して保存する

public_htmlの中に作らないように気をつけてください。common.phpとpublic_htmlが、同じ並びに見えていればOKです。

require で common.php を読み込む

require は「このファイルの中身を、ここに入れて」

作ったcommon.phpを使うには、require(リクワイア)を使います。requireは「必要とする」という意味です。

require __DIR__ . '/../../common.php';

requireは、指定したファイルの中身を、その場所に書いたのと同じことにする命令です。この1行を書くと、common.phpの2〜11行目(4つの情報と関数h)を、そこにそのまま書いたのと同じになります。なので、そのあとの行では$dbHostやh()をふつうに使えます。

もしcommon.phpが見つからなかったら、requireはFatal errorでPHPを止めます。データベースの情報がないと、どうせ先に進めないので、止まってくれたほうが原因がすぐわかります。

__DIR__ は「このファイルがあるフォルダ」

requireのうしろの__DIR__ . '/../../common.php'は、common.phpがどこにあるかを表しています。.は、3本目で習った文字と文字をつなぐ記号です。

__DIR__(ダー、ディレクトリ)は、「このPHPのファイルが入っているフォルダの場所」に置きかわる、特別な言葉です。DIRはdirectory(ディレクトリ=フォルダ)の略で、前後に_(アンダースコア)が2つずつ付きます。

どんな場所が入っているのか、実際に見てみましょう。memoフォルダにdir_test.phpを作り、次の2行を入力して保存してください。

<?php
echo __DIR__;

サーバー名.xsrv.jp/memo/dir_test.phpを開くと、次のように表示されます。

/home/xsample/xsample.xsrv.jp/public_html/memo

xsampleのところには、あなたのサーバーIDが入ります。10本目のエラー文のin /home/…に出てきた場所と同じ形ですね。/で区切られた1つ1つがフォルダの名前で、右に行くほど、中のフォルダになっています。

確かめ終わったら、dir_test.phpは削除してください(サーバーIDが見えてしまうためです)。

../ は「1つ上のフォルダ」

__DIR__のうしろの/../../common.phpにある..(ドット2つ)は、「1つ上のフォルダ」という意味です。memo/index.phpから見ると、次のようにたどります。

書き方 指している場所
__DIR__ …/サーバー名.xsrv.jp/public_html/memo(index.phpがあるフォルダ)
__DIR__ . '/..' …/サーバー名.xsrv.jp/public_html(1つ上)
__DIR__ . '/../..' …/サーバー名.xsrv.jp(2つ上)
__DIR__ . '/../../common.php' …/サーバー名.xsrv.jp/common.php(2つ上にあるcommon.php)

つまり、「このファイルのフォルダから、2つ上にのぼったところにあるcommon.php」という意味です。

ファイルによって、のぼる回数がちがうので注意してください。

  • memo/index.phpとadmin/inquiries.php … public_htmlの中のフォルダに入っているので、2つ上('/../../common.php')
  • contact.php … public_htmlにそのまま入っているので、1つ上('/../common.php')

なぜ__DIR__から書くのかというと、PHPが「どこから数えて1つ上なのか」を取りちがえないようにするためです。requireでほかのファイルを読み込むときは、__DIR__ . '/…'の形で書くと覚えておきましょう。

3つのファイルを書きかえる

memo/index.php(完成版)

前回のmemo/index.phpからの変更点は、次の3つです。

  1. 最初にrequireでcommon.phpを読み込む(1〜3行目)
  2. データベースの4つの情報を消す
  3. htmlspecialchars(…, ENT_QUOTES, 'UTF-8')をh(…)にする(76行目と88行目)

index.phpの中身をすべて消して、次のコードを入力して保存してください。今回は、このファイルにパスワードを書く必要はありません。

<?php
// 共通の設定(データベースの4つの情報と h())を読み込む
require __DIR__ . '/../../common.php';

// 日本の時間を使うように設定する
date_default_timezone_set('Asia/Tokyo');

// データベースにつなぐ
$dsn = 'mysql:host=' . $dbHost . ';dbname=' . $dbName . ';charset=utf8mb4';
$pdo = new PDO($dsn, $dbUser, $dbPass);

// 入力されたメモを入れる変数(最初は空の文字)
$body = '';
// エラーメッセージを入れる配列(最初は空)
$errors = [];

// ボタンが押されたときだけ、動く
if ($_SERVER['REQUEST_METHOD'] === 'POST') {
    // どのボタンが押されたか(add=保存する、delete=削除)
    $action = $_POST['action'] ?? '';

    // 「保存する」が押されたとき
    if ($action === 'add') {
        $body = trim($_POST['body'] ?? '');

        if ($body === '') {
            $errors[] = 'メモを入力してください';
        } elseif (mb_strlen($body) > 1000) {
            $errors[] = 'メモは1000文字以内で入力してください';
        }

        // エラーがなければ、保存して、移動する
        if (count($errors) === 0) {
            $createdAt = date('Y-m-d H:i:s');
            $stmt = $pdo->prepare('INSERT INTO memos (body, created_at) VALUES (?, ?)');
            $stmt->execute([$body, $createdAt]);
            header('Location: index.php');
            exit;
        }
    }

    // 「削除」が押されたとき
    if ($action === 'delete') {
        $id = $_POST['id'] ?? '';
        $stmt = $pdo->prepare('DELETE FROM memos WHERE id = ?');
        $stmt->execute([$id]);
        header('Location: index.php');
        exit;
    }
}

// メモを、新しい順に全部取り出す
$stmt = $pdo->query('SELECT * FROM memos ORDER BY id DESC');
$memos = $stmt->fetchAll(PDO::FETCH_ASSOC);
?>
<!DOCTYPE html>
<html lang="ja">
<head>
  <meta charset="UTF-8">
  <meta name="viewport" content="width=device-width, initial-scale=1">
  <title>メモ</title>
</head>
<body>
  <h1>メモ</h1>

  <?php if (count($errors) > 0): ?>
    <ul>
      <?php foreach ($errors as $error): ?>
        <li><?php echo $error; ?></li>
      <?php endforeach; ?>
    </ul>
  <?php endif; ?>

  <form action="index.php" method="post">
    <input type="hidden" name="action" value="add">
    <textarea name="body" rows="4" cols="30"><?php echo h($body); ?></textarea>
    <br>
    <button type="submit">保存する</button>
  </form>

  <h2>メモ一覧(<?php echo count($memos); ?>件)</h2>
  <?php if (count($memos) === 0): ?>
    <p>まだメモはありません。</p>
  <?php else: ?>
    <?php foreach ($memos as $memo): ?>
      <hr>
      <p><?php echo $memo['created_at']; ?></p>
      <p><?php echo nl2br(h($memo['body'])); ?></p>
      <form action="index.php" method="post" onsubmit="return confirm('このメモを削除しますか?');">
        <input type="hidden" name="action" value="delete">
        <input type="hidden" name="id" value="<?php echo $memo['id']; ?>">
        <button type="submit">削除</button>
      </form>
    <?php endforeach; ?>
  <?php endif; ?>
</body>
</html>
  • 1〜3行目: common.phpを読み込む。ここから下で、$dbHostなどの4つと、関数hが使えるようになる
  • 5〜6行目: 日本の時間を使う設定(前回と同じ)
  • 8〜10行目: データベースにつなぐ。$dbHost・$dbName・$dbUser・$dbPassは、common.phpから来たもの
  • 12〜54行目: 前回と同じ(保存・削除・一覧の取り出し)
  • 76行目: <textarea>の中に入れるメモを、h()を通して表示する
  • 88行目: メモの本文を、h()を通してから、nl2brで改行を<br>にして表示する
  • それ以外は、前回と同じ

88行目のnl2br(h($memo['body']))も、8本目で説明した「内側から順番に」のルールで動きます。先に内側のh()で<や>をただの文字にして、その結果を外側のnl2brに渡します。「hが内側、nl2brが外側」です。

保存したら、サーバー名.xsrv.jp/memo/を開いてみてください。前回と同じように、メモの一覧が表示されれば成功です。データベースの4つの情報は、ちゃんとcommon.phpから読み込まれています。

admin/inquiries.php

8本目のinquiries.phpは、1〜6行目(<?phpとデータベースの4つの情報)を、次の3行に置きかえます。memo/index.phpと同じく、public_htmlの中のフォルダに入っているので、2つ上です。

<?php
// 共通の設定(データベースの4つの情報と h())を読み込む
require __DIR__ . '/../../common.php';

表の中の3行は、次のようにh()にします。

          <td><?php echo h($inquiry['name']); ?></td>
          <td><?php echo h($inquiry['email']); ?></td>
          <td><?php echo nl2br(h($inquiry['message'])); ?></td>

保存して、サーバー名.xsrv.jp/admin/inquiries.phpで、お問い合わせの一覧が前と同じように出るか確かめてください。

contact.php

contact.phpは、public_htmlにそのまま入っているので、1つ上です。1行目の<?phpのすぐ下に、次の3行を足します。

// 共通の設定(データベースの4つの情報と h())を読み込む
require __DIR__ . '/../common.php';

そして、次の5行(7本目で足した、データベースの4つの情報)を消します。

// データベースにつなぐための4つの情報
$dbHost = 'localhost';
$dbName = 'サーバーID_contact';
$dbUser = 'サーバーID_user';
$dbPass = 'MySQLユーザーのパスワード';

最後に、フォームの3か所をh()にします。

        <input type="text" name="name" value="<?php echo h($name); ?>">
…
        <input type="email" name="email" value="<?php echo h($email); ?>">
…
        <textarea name="message" rows="5" cols="40"><?php echo h($message); ?></textarea>

保存したら、サーバー名.xsrv.jp/contact.phpから、お問い合わせを1件送ってみてください。次の3つができれば成功です。

  • 「お問い合わせを送信しました。」と表示される
  • メールが届く
  • admin/inquiries.phpのいちばん上に、今送ったお問い合わせが出る

わざと名前に<b>たろう</b>と入れて、メールアドレスを空にして送ってみるのもおすすめです。エラーが出たときに、名前の欄に<b>たろう</b>がそのまま残っていれば、h()がちゃんと働いています。

common.php がブラウザから開けないことを確かめる

最後に、ブラウザでサーバー名.xsrv.jp/common.phpを開いてみてください。common.phpはpublic_htmlの外にあるので、エックスサーバーの青い画面に「404 File Not Found」「アクセスしようとしたページは見つかりませんでした。」と表示されれば、ねらいどおりです。

これで、データベースのパスワードはcommon.phpの1か所だけに、しかもブラウザからは開けない場所にしまわれました。パスワードを変えたときは、common.phpだけを書きかえれば、3つのページすべてに反映されます。

コードを人に見せたり、GitHubなどに公開したりするときも、common.phpだけを外しておけば、パスワードが出てしまう心配がありません。

メモアプリを公開して、スマホで使う

公開する前の片づけ

メモアプリも、お問い合わせフォームも、もうインターネット上で動いています。せっかくなので、ここでpublic_htmlの中を片づけておきましょう。シリーズの途中で作った練習用のファイルが残っていたら、削除します。

ファイル 作った記事 残しておくと困ること
mail_test.php 6本目 開かれるたびに、テストのメールが送られる
db_test.php 7本目 データベースのパスワードが書いてある
insert_test.php 7本目 開かれるたびに、お問い合わせが1件増える
select_test.php 8本目 だれでもお問い合わせ(個人情報)を見られる
white.php、h_test.php、dir_test.phpなど 9本目・この記事 エラーの文や、サーバーの場所(サーバーID)が見えてしまう

hello.php・practice.php・members.phpなど、2〜4本目の練習ファイルは、見られて困るものは入っていませんが、使わないなら消してしまってかまいません。

残すのは、contact.php・admin/inquiries.php・memo/index.phpの3つと、public_htmlの外のcommon.phpです。

また、9本目で紹介したとおり、エックスサーバーの公式マニュアルでは、display_errors(エラーを画面に出す設定)は「運用中はOffに変更することをお勧めします。」とされています。このまま勉強を続けるうちはONで大丈夫ですが、お問い合わせフォームを本当にお客さんに使ってもらうときは、OFFにすることを考えましょう。

スマホでメモアプリを開く

  1. スマホのブラウザで、サーバー名.xsrv.jp/memo/を開く
  2. ユーザー名とパスワードを聞かれるので、memoのアクセス制限で決めたものを入力する
  3. メモの一覧が表示される。入力欄にメモを書いて「保存する」を押すと、いちばん上に出る

前回入れたviewportの1行のおかげで、文字も入力欄も、スマホでちょうどいい大きさで表示されます。

スマホで書いたメモは、パソコンでサーバー名.xsrv.jp/memo/を開いても見られます。データはスマホでもパソコンでもなく、エックスサーバーのデータベースに入っているからです。これが、サーバーで動くWebアプリの便利なところです。

ホーム画面に置いて、アプリのように使う

毎回URLを入力するのは面倒なので、スマホのホーム画面にアイコンを置いておきましょう。

  • iPhone(Safari) … メモアプリを開いた状態で、共有ボタン(四角から矢印が出ているマーク)→「ホーム画面に追加」
  • Android(Chrome) … メモアプリを開いた状態で、右上の「︙」→「ホーム画面に追加」

ホーム画面のアイコンをタップすれば、すぐにメモアプリが開きます。自分で作ったアプリが、スマホのホーム画面に並ぶのはうれしいものです。

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

Failed to open stream: No such file or directory(require)

Warning: require(/home/…/public_html/memo/../common.php): Failed to open stream: No such file or directory in /home/…/memo/index.php on line 3

Fatal error: Uncaught Error: Failed opening required '/home/…/public_html/memo/../common.php' (include_path='.:/usr/…') in /home/…/memo/index.php:3

「requireで指定したファイルが見つかりません」という意味です。エラー文の中のrequire( )のかっこに、PHPが探しにいった場所が書かれているので、そこを見ます。

  • ..の数がちがう … 上の例は、memo/index.phpなのに'/../common.php'(1つ上)と書いたものです。memoの1つ上はpublic_htmlなので、そこにcommon.phpはありません。memoとadminの中は'/../../common.php'、contact.phpは'/../common.php'です
  • common.phpを置いた場所がちがう … ファイルマネージャで、common.phpがpublic_htmlと同じ並びにあるか確認してください。public_htmlの中に作っていると、見つかりません
  • ファイル名のつづり … common.phpと、requireの中の名前が同じか見比べてください(comon.phpなど)

Warning: Undefined variable $dbHost と [2002]

Warning: Undefined variable $dbHost in /home/…/memo/index.php on line 8
Warning: Undefined variable $dbName in /home/…/memo/index.php on line 8
Warning: Undefined variable $dbUser in /home/…/memo/index.php on line 9
Warning: Undefined variable $dbPass in /home/…/memo/index.php on line 9

Fatal error: Uncaught PDOException: SQLSTATE[HY000] [2002] No such file or directory in /home/…/memo/index.php:9

「$dbHostなどの変数がありません」と言われたあと、データベースにつながらずに止まっています。requireの行を書き忘れているか、common.phpの中の変数の名前がちがいます。index.phpの最初にrequireの行があるか、common.phpの$dbHostなどのつづりが、index.phpの$dsn = …とnew PDO(…)の行で使っている名前と同じか確認してください(上のエラー文はrequireの行を消して試したものなので、行番号が完成版より1つずつ上にずれています)。

エラーが2つ以上出たときは、10本目で説明したとおり一番上から見ます。一番上のUndefined variableが原因で、下の[2002]はその結果です。

Call to undefined function h()

Fatal error: Uncaught Error: Call to undefined function hh() in /home/…/memo/index.php:76

「hh()という関数はありません」という意味です(9本目・10本目と同じエラーです)。h(…)のつづりをまちがえているか、requireを書き忘れてhが作られていません。エラー文の"…"や( )の前に出ている名前が、自分の書いた名前です。

メモや名前が表示されない(エラーも出ない)

h()を通したところだけが、空っぽになるパターンです。common.phpのhの中で、returnを書き忘れていないか確認してください。returnがないと、関数は何も返さないので、echo h($body)は何も表示しません(実際に試すと、メモの日時だけが出て、本文が空っぽになりました)。

common.php をブラウザで開くと、中身が見えてしまう・真っ白になる

サーバー名.xsrv.jp/common.phpで何かが表示される(真っ白な画面も含む)なら、common.phpがpublic_htmlの中にあります。public_htmlの外(1つ上のフォルダ)に作り直して、public_htmlの中のほうは削除してください。

シリーズのふり返り

これで「エックスサーバーで動かすPHP入門」シリーズは、全12本が終わりです。ここまで読んでくださって、ありがとうございました。

1本目で「PHPでできること」として紹介したことを、実際にどこまでできるようになったか、ふり返ってみましょう。

記事 できるようになったこと
1本目 PHPで何ができるかを知った
2本目 エックスサーバーでPHPのファイルを作って、echoで表示した
3本目 変数と配列で、値を入れておけるようになった
4本目 ifで分けて、foreachでくり返せるようになった
5本目 フォームで入力を受け取り、チェックして、安全に表示した
6本目 フォームの内容を、メールで送った
7本目 データベースを作って、PDOで保存した
8本目 データベースから取り出して一覧にし、パスワードで守った
9本目 画面が真っ白になっても、原因を探せるようになった
10本目 エラーの文を読んで、自分で直せるようになった
11本目 書く・見る・消すができるメモアプリを作った
12本目 関数とrequireでコードを整理し、スマホで使えるように公開した

「保存して、取り出して、表示する」は、どんなに大きなWebサービスでも変わらない基本です。ブログも、通販サイトも、SNSも、中ではこのシリーズで作ったものと同じことを、もっと大きな規模でやっています。

次の一歩

シリーズはここで終わりですが、勉強はここからが楽しいところです。今回のメモアプリを育てながら、次のようなことに挑戦してみてください。

  • メモを編集できるようにする … 書いたメモを直すには、SQLのUPDATE(アップデート=書きかえる)を使います。DELETEと同じく、WHERE id = ?で直すメモをしぼりこみます。WHEREを忘れると全部のメモが書きかわってしまうのも同じです
  • ログイン機能を作る … 今は、エックスサーバーの「アクセス制限」でパスワードをかけています。これをPHPで作ると、「ユーザーごとに自分のメモだけが見える」ようなアプリにできます。パスワードをデータベースに保存するときは、そのままではなくpassword_hashという関数で変換してから保存するのがルールです
  • CSRF(シーサーフ)対策を知る … 今のメモアプリは、パスワードで守っていますが、パスワードを入力したことがあるブラウザで悪いサイトを開くと、そのサイトから勝手に「削除」のフォームを送られてしまうおそれが、理論上はあります。これを防ぐしくみを「CSRF対策」と呼びます。本格的なアプリを作るときに、必ず出てくる言葉です
  • Gitでコードの記録を残す … コードを書きかえる前の状態に戻したり、変更の記録を残したりできる道具です。エンジニアの仕事では、ほぼ必ず使います
  • フレームワーク(Laravel)を学ぶ … 今回自分で作ったh()やcommon.php、CSRF対策、ログイン機能などが、最初から用意されている「PHPの道具箱」です。このサイトも、Laravelで作っています

どれも、このシリーズで身につけた「フォームで受け取る → チェックする → データベースに入れる・取り出す → 安全に表示する」の延長線上にあります。わからないことが出てきても、エラーの文を読み、var_dumpで中身を見て、1つずつ確かめていけば、必ず前に進めます。

まとめ|同じことは1か所に書いて、パスワードは見えない場所にしまう

  • 関数はfunction 名前($受け取る変数) { return 結果; }で自分で作れる。returnのうしろの結果が、使った場所に返される
  • h()を作ると、htmlspecialchars($text, ENT_QUOTES, 'UTF-8')をh($text)と短く書ける。改行も表示するときはnl2br(h(…))
  • 関数の中の変数は、関数の中だけのもの。使いたい値は( )で渡す
  • require __DIR__ . '/…';で、ほかのファイルの中身を、そこに書いたのと同じことにできる。__DIR__は「このファイルがあるフォルダ」、..は「1つ上のフォルダ」
  • URLで開けるのはpublic_htmlの中だけ。パスワードを書いたcommon.phpはpublic_htmlの外に置く
  • 動きを変えずにコードを整えることを、リファクタリングという

前回のメモアプリの作り方をおさらいしたい方は、こちらをどうぞ。

👉 PHPでメモアプリを作る|データベースに書く・一覧・削除を1ファイルで作る方法を初心者向けに解説

シリーズを最初から読みたい方は、1本目の記事に、全部の記事の一覧があります。

👉 PHPでできることを初心者向けに解説|レンタルサーバーで作れるものと始め方

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

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

無料で試してみる →

関連記事