Building Your First REST API with PHP

Published by Brayan K

A step-by-step guide to creating a RESTful API using PHP, with best practices for clean and secure API design.

πŸš€ Introduction

If you want to build modern backends, mobile apps, dashboards, authentication systems, or connect your website to a database… you must understand REST APIs.

A REST API allows different software to talk to each other through simple URLs and JSON. And the best part? PHP β€” yes, the same language powering WordPress β€” is still one of the easiest and fastest ways to build an API.

By the end of this guide, you'll know how to:

🧠 What Is a REST API?

A REST API (Representational State Transfer) is a structured way for clients (web apps, mobile apps, other servers) to request or send data using standard HTTP verbs:

The server responds using JSON, the universal data format.

{
  "success": true,
  "message": "User created successfully"
}

If you can return JSON β†’ you can build APIs.

🧰 What You Need Before Starting

/api
   /v1
      index.php
      users.php

πŸ“¦ Step 1 β€” Create Your API Folder

Inside your project or localhost:

mkdir api
cd api
mkdir v1

index.php will act as a router for now.

πŸ”§ Step 2 β€” Enable JSON Output

<?php
header("Content-Type: application/json; charset=UTF-8");

echo json_encode([
    "status" => "online",
    "message" => "API is running!"
]);
http://localhost/api/v1/index.php

You've just created your first API response.

πŸ—ƒοΈ Step 3 β€” Connect to the Database

Create a file db.php:

<?php

$host = "localhost";
$user = "root";
$pass = "";
$db   = "rest_api";

$conn = new mysqli($host, $user, $pass, $db);

if ($conn->connect_error) {
    die(json_encode([
        "success" => false,
        "error" => $conn->connect_error
    ]));
}

Then include it in users.php:

<?php
header("Content-Type: application/json");
require_once "../db.php";

You now have database access.

πŸ‘€ Step 4 β€” Build Your First GET Endpoint

if ($_SERVER["REQUEST_METHOD"] === "GET") {

    $result = $conn->query("SELECT * FROM users");

    $users = [];
    while ($row = $result->fetch_assoc()) {
        $users[] = $row;
    }

    echo json_encode([
        "success" => true,
        "data" => $users
    ]);
}
GET /api/v1/users.php

Your API returns all users!

πŸ“ Step 5 β€” Create a POST Endpoint (Add User)

Add this under the GET block:

if ($_SERVER["REQUEST_METHOD"] === "POST") {

    $data = json_decode(file_get_contents("php://input"), true);

    $name  = $conn->real_escape_string($data["name"]);
    $email = $conn->real_escape_string($data["email"]);

    $conn->query("INSERT INTO users (name, email) VALUES ('$name', '$email')");

    echo json_encode([
        "success" => true,
        "message" => "User created!"
    ]);
}
{
  "name": "John Doe",
  "email": "[email protected]"
}

πŸ› οΈ Step 6 β€” Add Update (PUT) Endpoint

if ($_SERVER["REQUEST_METHOD"] === "PUT") {

    $data = json_decode(file_get_contents("php://input"), true);

    $id    = intval($data["id"]);
    $name  = $conn->real_escape_string($data["name"]);
    $email = $conn->real_escape_string($data["email"]);

    $conn->query("UPDATE users SET name='$name', email='$email' WHERE id=$id");

    echo json_encode([
        "success" => true,
        "message" => "User updated!"
    ]);
}

πŸ—‘οΈ Step 7 β€” Add Delete Endpoint

if ($_SERVER["REQUEST_METHOD"] === "DELETE") {

    $data = json_decode(file_get_contents("php://input"), true);
    $id = intval($data["id"]);

    $conn->query("DELETE FROM users WHERE id=$id");

    echo json_encode([
        "success" => true,
        "message" => "User deleted!"
    ]);
}

πŸ§ͺ Step 8 β€” Test Everything

Open Postman or Thunder Client:

Create a user

POST /api/v1/users.php
{ "name": "Alice", "email": "[email protected]" }

Update a user

PUT /api/v1/users.php
{ "id": 1, "name": "Alice Updated", "email": "[email protected]" }

Delete a user

DELETE /api/v1/users.php
{ "id": 1 }

Everything should now work smoothly.

πŸ›‘οΈ Security Improvements (Real-World Best Practices)

To upgrade this API to professional level:

πŸ” 1. Add API Keys

Block requests without a valid key.

🚧 3. Add Rate Limiting

Stop brute force and spam.

🌍 4. Use Routing Libraries

Slim Framework or Laravel.

πŸ“¦ 6. Validate All Input

Never trust user data.

🧱 Folder Structure (Recommended)

/api
   /v1
      /controllers
      /models
      index.php
      users.php
   /config
      db.php

🌐 Turning Your API Into a Real Product

Once your REST API is working, you can use it to power:

A simple PHP API can grow into a full startup.

Related articles

Related lessons