4 Steps Simple Comment System With PHP MYSQL AJAX

Welcome to a tutorial on how to create a simple comment system using PHP, MYSQL, and AJAX. Want to upgrade your website or eCommerce store? Allow users to enter comments on a post or product? Well, it really isn’t too difficult to create a comment (or feedback) system from scratch – Let us walk through a simple one in this guide, read on!

ⓘ I have included a zip file with all the source code at the start of this tutorial, so you don’t have to copy-paste everything… Or if you just want to dive straight in.

 

 

TABLE OF CONTENTS

Download & Notes	Comments System	Useful Bits & Links
The End

 

 

QUICK NOTES

• Create a database and import 1-comments.sql.
• Change the database settings to your own in 2-ajax-comments.php.
• Launch 3a-comments.html in your web browser, a friendly reminder to use http:// and not file://.

If you spot a bug, feel free to comment below. I try to answer short questions too, but it is one person versus the entire world… If you need answers urgently, please check out my list of websites to get help with programming.

 

 

SOURCE CODE DOWNLOAD

Click here to download all the example source code, I have released it under the MIT license, so feel free to build on top of it or use it in your own project.

 

 

 

STEP 1) COMMENTS DATABASE TABLE

CREATE TABLE `comments` (
  `comment_id` int(11) NOT NULL,
  `post_id` int(11) NOT NULL,
  `timestamp` datetime NOT NULL DEFAULT current_timestamp(),
  `name` varchar(255) NOT NULL,
  `message` text NOT NULL
) ENGINE=InnoDB DEFAULT CHARSET=utf8;

ALTER TABLE `comments`
  ADD PRIMARY KEY (`comment_id`);

ALTER TABLE `comments`
  MODIFY `comment_id` int(11) NOT NULL AUTO_INCREMENT;

Field	Description
comment_id	Primary key and auto-increment.
post_id	Foreign key. Use this to identify which comments belong to which post (or product).
timestamp	Date and time when the comment is posted.
name	Name of the user.
message	Comment message.

This should be easy enough, but you might want to change the structure a little to fit your own project. For example, it may make sense to add an email field, or use URL slugs instead of ID (change post_id to post_slug, use VARCHAR instead of INT).

 

 

STEP 2) PHP COMMENT AJAX HANDLER

<?php
// (A) CONNECT TO DATABASE - CHANGE SETTINGS TO YOUR OWN !
$dbhost = "localhost";
$dbname = "test";
$dbchar = "utf8";
$dbuser = "root";
$dbpass = "";
try {
  $pdo = new PDO(
    "mysql:host=$dbhost;dbname=$dbname;charset=$dbchar",
    $dbuser, $dbpass, [
      PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
      PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_NAMED
    ]
  );
} catch (Exception $ex) { exit($ex->getMessage()); }

if ($_POST["req"]) { switch ($_POST["req"]) {
  // (B) INVALID REQUEST
  default: echo "Invalid request"; break;
 
  // (C) SHOW COMMENTS
  case "show";
    $stmt = $pdo->prepare("SELECT `name`, `timestamp`, `message` FROM `comments` WHERE `post_id`=? ORDER BY `timestamp` ASC");
    $stmt->execute([$_POST["pid"]]);
    while ($r = $stmt->fetch()) { ?>
    <div class="crow">
      <div class="chead">
        <div class="cname"><?=$r["name"]?></div>
        <div class="ctime">[<?=$r["timestamp"]?>]</div>
      </div>
      <div class="cmsg"><?=$r["message"]?></div>
    </div>
    <?php }
    break;
 
  // (D) ADD COMMENT
  case "add":
    // (D1) CHECKS
    if (!isset($_POST["pid"]) || !isset($_POST["name"]) || !isset($_POST["msg"])) {
      exit("Please provide the Post ID, name, and message");
    }

    // (D2) INSERT
    try {
      $stmt = $pdo->prepare("INSERT INTO `comments` (`post_id`, `name`, `message`) VALUES (?,?,?)");
      $stmt->execute([$_POST["pid"], htmlentities($_POST["name"]), htmlentities($_POST["msg"])]);
    } catch (Exception $ex) { exit($ex->getMessage()); }
    echo "OK";
    break;
}}

// (E) CLOSE DATABASE CONNECTION
$stmt = null;
$pdo = null;

This may look complicated at first, but keep calm and look carefully. How this AJAX handler works is very simple, just post the request followed by the required parameters:

• To show the comments – $_POST = ["req"=>"show", "pid"=>888]
• To add a comment – $_POST = ["req"=>"add", "pid"=>888, "name"=>"John", "msg"=>"Hello"]

P.S. Remember to change the database settings to your own.

 

 

STEP 3) HTML COMMENTS PAGE

<!-- (A) JS + CSS -->
<script src="3b-comments.js"></script>
<link href="3c-comments.css" rel="stylesheet">
 
<!-- (B) GIVE THIS PAGE A HIDDEN POST ID -->
<input type="hidden" id="pid" value="999"/>
 
<!-- (C) COMMENTS WILL LOAD HERE -->
<h1>COMMENTS</h1>
<div id="cwrap"></div>
 
<!-- (D) ADD NEW COMMENT -->
<form id="cadd" onsubmit="return comments.add(this)">
  <h1>Leave a reply</h1>
  <input type="text" id="cname" placeholder="Name" required/>
  <textarea id="cmsg" placeholder="Message" required></textarea>
  <input type="submit" value="Post Comment"/>
</form>

The HTML itself is very straightforward, but please make sure that your comments page has the following:

1. Include the comments Javascript on the page. Doh.
2. Tag the page with a unique ID, place it into a hidden field – <input type="hidden" id="pid" value="X"/>.
3. Create a container to load all the comments – <div id="cwrap">.
4. Finally, the “Add A Comment” form itself – <form id="cadd">.

 

 

STEP 4) COMMENTS JAVASCRIPT

var comments = {
  // (A) AJAX HELPER FUNCTION
  ajax : (data, after) => {
    // (A1) DATA TO SEND
    var fdata = new FormData();
    fdata.append("pid", document.getElementById("pid").value);
    for (let k in data) { fdata.append(k, data[k]); }
 
    // (A2) AJAX FETCH
    fetch("2-ajax-comments.php", { method: "POST", body: fdata })
    .then(res => res.text()).then(after)
    .catch((err) => { console.error(err); });
  },
  
  // (B) LOAD COMMENTS INTO <DIV ID="CWRAP">
  load : () => {
    comments.ajax(
      { req: "show" }, 
      (res) => { document.getElementById("cwrap").innerHTML = res; }
    );
  },
  
  // (C) ADD COMMENT
  add: () => {
    comments.ajax(
      // (C1) DATA TO SEND
      {
        req : "add",
        name : document.getElementById("cname").value,
        msg : document.getElementById("cmsg").value
      },
      
      // (C2) RELOAD COMMENTS + RESET FORM AFTER ADD
      (res) => {
        if (tres == "OK") {
          document.getElementById("cadd").reset();
          comments.load();
        } else { alert(res); }
      }
    );
    return false;
  }
};
window.addEventListener("DOMContentLoaded", comments.load);

Some beginners may panic at the sight of Javascript, but it is actually simple and straightforward again.

1. We will be using AJAX to drive the comments, and thus the need for this comments.ajax() helper function. Yep, all it does is nicely formulate the data and send out an AJAX request to the server-side 2-ajax-comments.php.
2. On window load, comments.load() will fire up. As you can guess, this does an AJAX call to the server to load the comments for the current page.
3. The comments.add() function is fired when the user adds a new comment. Again, this is AJAX-driven.

 

 

 

ANTI-SPAM

Need some spam protection? Check out Google reCAPTCHA – It’s free. Here’s an example of reCaptcha with a contact form if you are interested.

 

SORT COMMENTS IN ASCENDING OR DESCENDING ORDER

// (C) SHOW COMMENTS
ORDER BY `timestamp` ASC
ORDER BY `timestamp` DESC

 

MANUAL APPROVAL

Want to further fight spam? Manually approve and moderate the comments? First, you are going to need an additional “approved” flag in the comments table:

ALTER TABLE `comments` 
ADD `approved` TINYINT(1) NOT NULL DEFAULT '0' 
AFTER `message`, ADD INDEX (`approved`);

Then change the SQL to show only approved comments:

SELECT `name`, `timestamp`, `message`
FROM `comments` 
WHERE `post_id`=? AND `approved`=1 
ORDER BY `timestamp` ASC

Of course, don’t forget that you will need to manually approve the comments.

UPDATE `comments`
SET `approved`=1 
WHERE `comment_id`=?

 

ONLY REGISTERED USERS CAN COMMENT

First off, you need to have a user/login system in place. I will leave a link below to another tutorial if you want to follow up. Start the session, and show the “add comment” form only if the user is signed in.

<?php 
// START SESSION
session_start();

// ADD COMMENT - ONLY FOR REGISTERED USERS
if (is_array($_SESSION["user"])) { ?>
<form id="cadd" onsubmit="return comments.add(this)">
  ...
</form>
<?php }

For further protection, also restrict the PHP AJAX handler.

<?php
case "add":
  if (is_array($_SESSION["user"])) {
    // INSERT INTO ...
  }
  break;

 

EXTRA LINKS

• User Registration Form With Email Validation – Code Boxx
• User Login Page – Code Boxx