เขียน RESTful API ด้วย PHP แบบมือโปร

ถ้าคุณเป็นนักพัฒนา PHP แล้วเคยต้องสร้าง API เพื่อให้ระบบอื่น ๆ มาเรียกใช้ แต่ยังงง ๆ ว่า "ต้องทำยังไงให้ API ใช้งานง่าย ปลอดภัย และเป็นมาตรฐาน?" 🤔

บทความนี้จะพาคุณไปทำความเข้าใจ RESTful API และวิธีสร้างมันขึ้นมาด้วย PHP แบบมือโปร 💡
พร้อมตัวอย่างโค้ดจริง (มี CRUD: Create, Read, Update, Delete) ที่สามารถใช้งานได้ทันที!

1. RESTful API คืออะไร? แล้วทำไมต้องใช้มัน? 🤷‍♂️

✅ RESTful API คืออะไร?

RESTful API เป็น API ที่ออกแบบตามหลัก REST (Representational State Transfer)
REST ช่วยให้ API ทำงานได้อย่างเป็นมาตรฐาน โดยใช้ HTTP Method ในการควบคุมข้อมูล เช่น:

HTTP Method	ใช้ทำอะไร?	ตัวอย่าง
GET	ดึงข้อมูล	/users (ดึงข้อมูลผู้ใช้ทั้งหมด)
POST	เพิ่มข้อมูล	/users (เพิ่มผู้ใช้ใหม่)
PUT	อัปเดตข้อมูล	/users/1 (แก้ไขข้อมูลผู้ใช้ ID=1)
DELETE	ลบข้อมูล	/users/1 (ลบผู้ใช้ ID=1)

✅ RESTful API มีประโยชน์ยังไง?

✔ รองรับหลายแพลตฟอร์ม (Frontend, Mobile, IoT)
✔ โค้ดสะอาดและเข้าใจง่าย (ใช้ HTTP Method ตามมาตรฐาน)
✔ สเกลได้ง่าย (รองรับปริมาณผู้ใช้เยอะ ๆ ได้)

2. เตรียมตัวก่อนเริ่มสร้าง RESTful API ด้วย PHP 🛠️

📌 สิ่งที่ต้องมี

✅ PHP 7 หรือใหม่กว่า
✅ MySQL หรือ Database ที่รองรับ
✅ Composer (ใช้สำหรับติดตั้งไลบรารี)

📌 ติดตั้ง Composer และ Slim Framework

เราจะใช้ Slim Framework ช่วยจัดการ API ให้ง่ายขึ้น

composer require slim/slim:^4.0 slim/psr7

📌 Slim คืออะไร?

Slim เป็น Micro Framework สำหรับ PHP ที่ช่วยให้สร้าง RESTful API ได้เร็วและง่ายกว่าเขียนเองตั้งแต่ต้น

3. เริ่มสร้าง RESTful API ด้วย PHP

3.1 สร้างโครงสร้างโปรเจกต์

จัดโครงสร้างไฟล์ให้เป็นระเบียบแบบนี้

restful-api-php/
│── public/
│   ├── index.php  (ไฟล์หลักของ API)
│── src/
│   ├── Database.php  (จัดการฐานข้อมูล)
│   ├── UserController.php  (ควบคุม API ผู้ใช้)
│── composer.json

3.2 เชื่อมต่อฐานข้อมูล (Database.php)

สร้างไฟล์ src/Database.php สำหรับจัดการการเชื่อมต่อ MySQL

<?php
class Database {
    private $host = "localhost";
    private $db_name = "restful_api";
    private $username = "root";
    private $password = "";
    public $conn;

    public function getConnection() {
        $this->conn = null;
        try {
            $this->conn = new PDO("mysql:host=" . $this->host . ";dbname=" . $this->db_name, $this->username, $this->password);
            $this->conn->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
        } catch (PDOException $exception) {
            echo "Database error: " . $exception->getMessage();
        }
        return $this->conn;
    }
}
?>

3.3 สร้าง API สำหรับจัดการผู้ใช้ (UserController.php)

สร้างไฟล์ src/UserController.php และเพิ่มโค้ดนี้

<?php
require_once "Database.php";

class UserController {
    private $db;

    public function __construct() {
        $database = new Database();
        $this->db = $database->getConnection();
    }

    // ดึงข้อมูลผู้ใช้ทั้งหมด
    public function getUsers($response) {
        $query = "SELECT * FROM users";
        $stmt = $this->db->prepare($query);
        $stmt->execute();
        $users = $stmt->fetchAll(PDO::FETCH_ASSOC);

        return $response->withJson($users);
    }

    // เพิ่มผู้ใช้ใหม่
    public function createUser($request, $response) {
        $data = $request->getParsedBody();
        $query = "INSERT INTO users (name, email) VALUES (:name, :email)";
        $stmt = $this->db->prepare($query);
        $stmt->bindParam(":name", $data['name']);
        $stmt->bindParam(":email", $data['email']);
        $stmt->execute();

        return $response->withJson(["message" => "User created successfully"]);
    }
}
?>

3.4 ตั้งค่า Route ใน index.php

สร้างไฟล์ public/index.php และตั้งค่า API Route

<?php
require '../vendor/autoload.php';
require '../src/UserController.php';

$app = new \Slim\App();

// สร้าง instance ของ UserController
$userController = new UserController();

// Route: GET /users (ดึงข้อมูลผู้ใช้ทั้งหมด)
$app->get('/users', function ($request, $response, $args) use ($userController) {
    return $userController->getUsers($response);
});

// Route: POST /users (เพิ่มผู้ใช้ใหม่)
$app->post('/users', function ($request, $response, $args) use ($userController) {
    return $userController->createUser($request, $response);
});

// เริ่มต้น API
$app->run();
?>

📌 วิธีทดสอบ API

1️⃣ รันเซิร์ฟเวอร์ด้วย PHP

php -S localhost:8000 -t public

2️⃣ ทดสอบดึงข้อมูลผู้ใช้

เปิดเว็บเบราว์เซอร์แล้วไปที่ http://localhost:8000/users

3️⃣ ทดสอบเพิ่มผู้ใช้ใหม่

ใช้ Postman หรือ cURL ส่ง POST ไปที่ /users พร้อม JSON:

{
    "name": "John Doe",
    "email": "john@example.com"
}

4. จัดการข้อผิดพลาดใน API (Error Handling)

เราควรให้ API ตอบกลับข้อความที่ชัดเจน เมื่อเกิดข้อผิดพลาด

// กรณีหา Resource ไม่เจอ
$app->get('/users/{id}', function ($request, $response, $args) use ($userController) {
    $user = $userController->getUserById($args['id']);
    
    if (!$user) {
        return $response->withJson(["error" => "User not found"], 404);
    }

    return $response->withJson($user);
});

5. สรุป: RESTful API ด้วย PHP แบบมือโปร

🔥 สิ่งที่คุณได้เรียนรู้
✅ RESTful API คืออะไร และใช้ HTTP Method ยังไง
✅ วิธีสร้าง API ด้วย PHP + Slim Framework
✅ วิธีเชื่อมต่อฐานข้อมูลและจัดการข้อมูลด้วย CRUD
✅ วิธีทำ Error Handling ให้ API ใช้งานง่าย

💡 API เป็นหัวใจสำคัญของเว็บยุคใหม่ ถ้าอยากพัฒนา PHP แบบมือโปร ต้องเข้าใจ RESTful API! 🚀