PHPでコメントしたユーザーの名前を表示させる方法

はじめに (対象読者・この記事でわかること)

この記事は、PHPを学び始めた方やWebサイトにコメント機能を実装したい方を対象にしています。特に、PHPとデータベースの基本的な知識がある方を想定しています。この記事を読むことで、PHPを使ってデータベースにコメントを保存し、表示する方法を理解できます。また、コメントしたユーザーの名前を表示させる実装方法を具体的に学べます。最近、ブログやSNSのコメント機能を実装する機会が増えており、ユーザーのエンゲージメント向上に重要です。本記事では、その基本となる機能の実装方法を解説します。

前提知識

この記事を読み進める上で、以下の知識があるとスムーズです。 - PHPの基本的な文法（変数、関数、配列など） - HTML/CSSの基本的な知識 - MySQLデータベースの基本的な操作 - フォーム送信と受け取りの基本的な理解

コメントシステムの基本と重要性

Webサイトにおけるコメント機能は、ユーザーとのインタラクションを促進し、コミュニティ形成に不可欠です。特にブログ、ニュースサイト、SNSなどでは、ユーザーの意見やフィードバックを収集し、サイトの活性化に繋がります。

コメントシステムを実装する際の基本的な流れは以下の通りです： 1. ユーザーがコメントフォームに入力 2. フォームデータをサーバーに送信 3. サーバー（PHP）でデータを処理 4. データベースにコメントを保存 5. コメントを表示するページでデータベースから情報を取得 6. ユーザーにコメントを表示

この記事では、特に「コメントしたユーザーの名前を表示させる」部分に焦点を当てて解説します。ユーザー名を表示することで、コメントの責任が明確になり、コミュニケーションの質が向上します。

コメントシステムの実装方法

ステップ1：データベースの設計

まず、コメントを保存するためのデータベーステーブルを作成します。以下は基本的なコメントテーブルの設計例です。

Sql

CREATE TABLE comments (
    id INT AUTO_INCREMENT PRIMARY KEY,
    username VARCHAR(50) NOT NULL,
    comment_text TEXT NOT NULL,
    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
);

このテーブルには、コメントID、ユーザー名、コメント内容、作成日時の4つのフィールドがあります。ユーザー名を保存するためのusernameフィールドを追加している点が重要です。

ステップ2：コメント投稿フォームの作成

次に、ユーザーがコメントを投稿するためのHTMLフォームを作成します。

Html

<!DOCTYPE html>
<html lang="ja">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>コメント投稿</title>
    <style>
        body {
            font-family: Arial, sans-serif;
            max-width: 800px;
            margin: 0 auto;
            padding: 20px;
        }
        .comment-form {
            margin-bottom: 30px;
        }
        .comment-form input,
        .comment-form textarea {
            width: 100%;
            padding: 8px;
            margin-bottom: 10px;
            border: 1px solid #ddd;
            border-radius: 4px;
        }
        .comment-form button {
            background-color: #4CAF50;
            color: white;
            padding: 10px 15px;
            border: none;
            border-radius: 4px;
            cursor: pointer;
        }
        .comments-list {
            margin-top: 30px;
        }
        .comment {
            border-bottom: 1px solid #eee;
            padding: 10px 0;
        }
        .comment-author {
            font-weight: bold;
            color: #333;
        }
        .comment-date {
            color: #666;
            font-size: 0.8em;
        }
    </style>
</head>
<body>
    <h1>コメントフォーム</h1>

    <form class="comment-form" action="post_comment.php" method="POST">
        <input type="text" name="username" placeholder="お名前" required>
        <textarea name="comment" rows="5" placeholder="コメントを入力" required></textarea>
        <button type="submit">コメントを投稿</button>
    </form>

    <div class="comments-list">
        <h2>コメント一覧</h2>
        <?php
        // データベース接続情報
        $host = 'localhost';
        $username = 'db_user';
        $password = 'db_password';
        $dbname = 'your_database';

        try {
            // PDOを使用してデータベースに接続
            $pdo = new PDO("mysql:host=$host;dbname=$dbname;charset=utf8", $username, $password);
            $pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);

            // コメントを取得して表示
            $stmt = $pdo->query("SELECT * FROM comments ORDER BY created_at DESC");

            while ($row = $stmt->fetch(PDO::FETCH_ASSOC)) {
                echo '<div class="comment">';
                echo '<div class="comment-author">' . htmlspecialchars($row['username']) . '</div>';
                echo '<div class="comment-date">' . date('Y/m/d H:i', strtotime($row['created_at'])) . '</div>';
                echo '<div class="comment-text">' . nl2br(htmlspecialchars($row['comment_text'])) . '</div>';
                echo '</div>';
            }
        } catch (PDOException $e) {
            echo 'エラー: ' . $e->getMessage();
        }
        ?>
    </div>
</body>
</html>

このHTMLフォームには、ユーザー名を入力するテキストボックスとコメント内容を入力するテキストエリアがあります。また、投稿されたコメントを表示する部分も含まれています。

ステップ3：コメントを保存するPHPスクリプトの作成

次に、フォームから送信されたデータを処理し、データベースに保存するPHPスクリプトを作成します。

Php

<?php
// post_comment.php

// データベース接続情報
$host = 'localhost';
$dbUsername = 'db_user';
$dbPassword = 'db_password';
$dbname = 'your_database';

try {
    // PDOを使用してデータベースに接続
    $pdo = new PDO("mysql:host=$host;dbname=$dbname;charset=utf8", $dbUsername, $dbPassword);
    $pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);

    // フォームから送信されたデータを取得
    $username = $_POST['username'];
    $comment = $_POST['comment'];

    // SQLインジェクション対策（プリペアドステートメントを使用）
    $stmt = $pdo->prepare("INSERT INTO comments (username, comment_text) VALUES (:username, :comment)");
    $stmt->bindParam(':username', $username);
    $stmt->bindParam(':comment', $comment);

    // クエリを実行
    $stmt->execute();

    // 投稿完了後、コメント一覧ページにリダイレクト
    header('Location: index.php');
    exit;
} catch (PDOException $e) {
    echo 'エラー: ' . $e->getMessage();
}
?>

このPHPスクリプトは、以下の処理を行います： 1. データベースに接続 2. フォームから送信されたユーザー名とコメントを取得 3. プリペアドステートメントを使用してSQLインジェクションを防止 4. コメントをデータベースに保存 5. 投稿完了後、コメント一覧ページにリダイレクト

ステップ4：コメントの表示

最後に、保存されたコメントを表示する方法です。これは先ほどのHTMLファイル内に既に含まれていますが、ここで詳しく説明します。

Php

// コメントを取得して表示
$stmt = $pdo->query("SELECT * FROM comments ORDER BY created_at DESC");

while ($row = $stmt->fetch(PDO::FETCH_ASSOC)) {
    echo '<div class="comment">';
    echo '<div class="comment-author">' . htmlspecialchars($row['username']) . '</div>';
    echo '<div class="comment-date">' . date('Y/m/d H:i', strtotime($row['created_at'])) . '</div>';
    echo '<div class="comment-text">' . nl2br(htmlspecialchars($row['comment_text'])) . '</div>';
    echo '</div>';
}

このコードは、データベースからコメントを取得し、HTMLとして出力します。ポイントは以下の通りです： 1. ORDER BY created_at DESCで新しいコメントから表示 2. htmlspecialchars()でXSS攻撃を防止 3. nl2br()で改行をHTMLの
タグに変換 4. ユーザー名を強調表示（CSSでcomment-authorクラスを適用）

ハマった点やエラー解決

エラー1：データベース接続エラー

問題: PDOExceptionが発生し、データベースに接続できない。

解決策: 1. データベースホスト名、ユーザー名、パスワード、データベース名が正しいか確認 2. データベースサーバーが稼働しているか確認 3. PDOが有効になっているか確認（php.iniでextension=pdo_mysqlが有効になっているか）

エラー2：文字化け

問題: コメントが文字化けして表示される。

解決策: 1. データベース接続時に文字セットを指定（charset=utf8） 2. HTMLのmetaタグで文字エンコーディングを指定（<meta charset="UTF-8">） 3. PHPファイル自体の文字エンコーディングがUTF-8であることを確認

エラー3：SQLインジェクション

問題: 悪意のあるユーザーがSQLインジェクション攻撃を試みる。

解決策: 1. 常にプリペアドステートメントを使用 2. ユーザー入力をhtmlspecialchars()でエスケープ 3. ユーザー入力の検証とサニタイズを行う

拡張機能：ログインユーザーの名前を自動表示する

もしユーザー認証システムを実装している場合、ログイン中のユーザー名を自動で表示させることができます。以下にその方法を示します。

Php

// セッションを開始
session_start();

// ユーザーがログインしているか確認
if (isset($_SESSION['logged_in']) && $_SESSION['logged_in'] === true) {
    // ログイン中のユーザー名を取得
    $username = $_SESSION['username'];

    // フォームのユーザー名フィールドを非表示にし、値を設定
    echo '<input type="hidden" name="username" value="' . htmlspecialchars($username) . '">';
    echo '<p>ログイン中: ' . htmlspecialchars($username) . '</p>';
} else {
    // ログインしていない場合は通常のフォームを表示
    echo '<input type="text" name="username" placeholder="お名前" required>';
}

このコードは、セッションに保存されたユーザー名を使用して、コメント投稿時にユーザー名を自動で設定します。ユーザー名フィールドは非表示にし、代わりに現在ログイン中のユーザー名を表示します。

まとめ

本記事では、PHPを使用したコメントシステムの実装方法、特にコメントしたユーザーの名前を表示させる方法を解説しました。

データベース設計: ユーザー名を保存するためのフィールドを含むテーブルの作成
フォーム作成: ユーザー名とコメントを入力するHTMLフォームの実装
PHPスクリプト: フォームデータを処理しデータベースに保存するバックエンドの実装
コメント表示: 保存されたコメントを取得し、ユーザー名を含めて表示する方法

この記事を通して、基本的なコメントシステムを構築する方法を学びました。これにより、Webサイトに双方向のコミュニケーション機能を追加できます。今後は、ログイン機能との連携やコメントへの返信機能の追加など、さらなる機能拡張に挑戦してみてください。

参考資料

参考にした記事、ドキュメント、書籍などがあれば、必ず記載しましょう。

PHPでコメントしたユーザーの名前を表示させる方法💬