X-RateLimit-Remaining – PlusMagi's Blog By Pitt Phunsanit

ในโลกของการพัฒนา API สมัยใหม่ การรับประกันความเสถียรและความพร้อมใช้งานของบริการ (Availability) ถือเป็นหัวใจสำคัญ ภาระงานส่วนเกินที่เกิดจากการเรียกใช้ API อย่างหนาแน่นหรือผิดปกติจากผู้ใช้งานคนใดคนหนึ่ง อาจส่งผลให้ระบบโดยรวมเกิดภาวะโอเวอร์โหลด (Overload) และล่มได้

บทนำและแนวคิดสำคัญ: Rate Limiting คืออะไร?

Rate Limiting หรือการจำกัดอัตราการเรียกใช้งาน คือกลไกทางเทคนิคที่ทำหน้าที่เป็น “ยามหน้าประตู” ของ API มันจะตรวจจับและควบคุมว่าผู้ใช้แต่ละราย (ซึ่งระบุตัวตนผ่าน IP Address, API Key หรือ User ID) สามารถส่งคำขอ (Request) มายังระบบได้สูงสุดกี่ครั้ง ภายในช่วงเวลาที่กำหนด

Rate Limiting ทำงานอย่างไร?

การระบุตัวตน (Identification): ระบบต้องทราบว่าใครกำลังเรียกใช้งาน โดยทั่วไปจะใช้ IP Address หรือ API Key เป็นตัวระบุหลัก เพื่อให้สามารถนับโควตาแยกกันได้
การนับจำนวน (Counting): เมื่อมีการร้องขอเข้ามา ระบบจะทำการนับเพิ่มขึ้น 1 สำหรับผู้ใช้รายนั้น ๆ โดยต้องดำเนินการนี้แบบ Atomic เพื่อป้องกัน Race Condition
การกำหนดขีดจำกัด (Thresholding): ระบบเปรียบเทียบจำนวนที่นับได้กับโควตาที่ตั้งไว้ (เช่น 10 ครั้งต่อนาที)
การตอบสนอง (Response): หากยังไม่เกินโควตา คำขอจะถูกประมวลผล แต่หากเกินแล้ว ระบบจะต้องบล็อกคำขอนั้นทันที และส่งรหัสสถานะ HTTP 429 Too Many Requests กลับไปให้ผู้เรียกใช้

💡 ความสำคัญระดับ Senior Developer: Rate Limiting ไม่ได้มีไว้เพียงแค่ป้องกันการใช้งานที่ผิดปกติเท่านั้น แต่ยังเป็นเครื่องมือสำคัญในการรักษาทรัพยากร (Resource Protection) ของเซิร์ฟเวอร์ ทำให้มั่นใจว่าบริการของเราจะสามารถทำงานได้อย่างเสถียรแม้ในช่วงที่มีทราฟฟิกสูง ซึ่งช่วยให้เราวางแผนขยายระบบได้แม่นยำขึ้น

ตัวอย่างการใช้งานและรูปแบบโค้ด (Code Examples): การใช้ Redis ใน PHP

ในการทำ Rate Limiting ให้มีประสิทธิภาพสูงและ Latency ต่ำ เราไม่ควรใช้ฐานข้อมูล SQL ทั่วไป แต่ควรเลือกใช้ In-Memory Data Store อย่าง Redis เพราะมีความเร็วในการอ่าน/เขียนข้อมูลที่รวดเร็วกว่ามาก และรองรับคำสั่งแบบ Atomic (เช่น INCR) ซึ่งจำเป็นอย่างยิ่งสำหรับการนับโควตา

แนวคิดหลัก: Fixed Window Counter Algorithm

<?php
/**
 * ไฟล์: RateLimitMiddleware.php
 * แนวคิด: จำลองการทำงานใน Middleware Layer ของ PHP Framework 
 */

// ต้องมั่นใจว่าได้ติดตั้ง Redis extension และมีการเชื่อมต่อแล้ว
class RateLimiter {
    private $redis;
    private $limit = 10;         // โควตา: อนุญาตให้เรียกใช้งานได้สูงสุด 10 ครั้ง
    private $windowSeconds = 60; // ช่วงเวลา: ทุก ๆ 60 วินาที (1 นาที)

    public function __construct(Redis $redisClient) {
        $this->redis = $redisClient;
    }

    /**
     * ตรวจสอบ Rate Limit สำหรับ IP Address ที่กำหนด
     * @param string $identifier - ตัวระบุผู้เรียกใช้ เช่น $_SERVER['REMOTE_ADDR']
     * @return bool true ถ้ายังอยู่ในโควตา, false หากเกินแล้ว
     */
    public function checkRateLimit(string $identifier): bool {
        // 1. สร้าง Key เฉพาะสำหรับ IP นี้และช่วงเวลานี้
        $key = "rate_limit:{$identifier}:{$this->windowSeconds}";

        // 2. ใช้ Redis INCR: นับเพิ่มค่าของคีย์ (Atomic Operation)
        // INCR จะคืนค่าเป็นจำนวนล่าสุดที่นับได้
        $requestCount = $this->redis->incr($key);

        // 3. กำหนดวันหมดอายุให้กับ Key นี้เมื่อครั้งแรกที่ถูกใช้งาน
        // EXPIRE จะทำงานเฉพาะกับคีย์ที่ถูกสร้างขึ้นใหม่เท่านั้น ทำให้การ set expiry มีความเสถียร
        if ($requestCount == 1) {
            $this->redis->expire($key, $this->windowSeconds);
        }

        // 4. ตรวจสอบโควตา
        if ($requestCount > $this->limit) {
            return false; // เกินโควตา
        }

        // 5. หากยังไม่เกิน ให้ส่งข้อมูล Status ไปที่ Header สำหรับผู้เรียกใช้ (Best Practice)
        $remaining = $this->calculateRemainingRequests($key);
        header("X-RateLimit-Limit: " . $this->limit);
        header("X-RateLimit-Remaining: " . max(0, $remaining)); 
        header("X-RateLimit-Reset: " . $this->redis->ttl($key));

        return true;
    }

    /**
     * คำนวณจำนวนที่เหลือ (สำหรับการตอบกลับ Header)
     */
    private function calculateRemainingRequests(string $key): int {
        // ใช้ค่าที่ถูกนับไปแล้วเพื่อคำนวณความเหลือ
        $currentCount = (int)$this->redis->get($key);
        return $this->limit - ($currentCount > 0 ? (int)$currentCount : 0);
    }
}

// === ตัวอย่างการใช้งานใน API Endpoint (API Controller) ===
function handleApiRequest() {
    // *** สมมติว่ามีการเชื่อมต่อ Redis Client แล้ว ***
    $redis = new Redis(); 
    if (!$redis->connect('127.0.0.1', 6379)) {
        // การจัดการ Failure: ถ้า Redis ล่ม ให้ Fail Open (อนุญาตให้ผ่านไปก่อน) หรือ Fail Closed (ปฏิเสธทั้งหมด)
        error_log("Redis connection failed.");
    }

    $limiter = new RateLimiter($redis);
    $clientIdentifier = $_SERVER['REMOTE_ADDR']; // ใช้ IP Address เป็นตัวระบุ

    if (!$limiter->checkRateLimit($clientIdentifier)) {
        // *** ส่วนที่สำคัญ: ถ้าเกินโควตา ต้องคืนสถานะ 429 ทันที ***
        http_response_code(429);
        header('Content-Type: application/json');
        echo json_encode([
            'status' => 'error',
            'message' => 'Too Many Requests. คุณใช้งานเกินโควตาที่กำหนดแล้ว กรุณาลองใหม่ในอีกไม่กี่วินาที'
        ]);
        exit(); // หยุดการทำงานของสคริปต์ทันที
    }

    // ถ้าผ่าน Rate Limit ทั้งหมด: ดำเนินการประมวลผล API
    http_response_code(200);
    header('Content-Type: application/json');
    echo json_encode([
        'status' => 'success',
        'message' => 'API Request สำเร็จ!'
    ]);
}

// handleApiRequest(); 
?>

ข้อควรระวัง Security และ Best Practices

🔑 การเลือกตัวระบุ (Identifying the User):
API Key / Token (แนะนำที่สุด): ควรใช้ API Key หรือ JWT Token ที่ส่งมากับ Header แทน IP Address เพราะมันเชื่อมโยงการเรียกใช้งานกับบัญชีผู้ใช้งานที่แท้จริง ทำให้ป้องกัน False Positive เมื่อมีหลายคนอยู่ในเครือข่ายเดียวกัน
🚨 การจัดการสถานะ HTTP Code (Must Do):
เมื่อ Rate Limit ถูกละเมิด ต้องส่ง HTTP Status Code 429 Too Many Requests เสมอ และต้องเพิ่ม Header พิเศษเหล่านี้กลับไปให้ผู้เรียกใช้ด้วย เพื่อให้ Client สามารถนำข้อมูลไปแสดงผลและวางแผนการเรียกใช้งานครั้งต่อไปได้:
- X-RateLimit-Limit: จำนวนสูงสุดที่อนุญาต
- X-RateLimit-Remaining: เหลือโควตาเท่าไหร่
- X-RateLimit-Reset: เวลาที่เหลือจนกว่าจะรีเซ็ตโควตาได้ (เป็นวินาที)
🛡️ การจัดการ Failure ของ Redis (Circuit Breaker):
ในระบบ Production Grade หากการเชื่อมต่อกับ Redis ล้มเหลว (Redis Down) เราไม่ควรให้ API ล่มตามไปด้วย ควรใช้ Circuit Breaker Pattern:
- Fail Open: อนุญาตให้ Throughput สูงขึ้นชั่วคราว (ยอมเสี่ยง Overload เล็กน้อยเพื่อรักษา Availability)
- Fail Closed: ปฏิเสธคำขอทั้งหมดไปก่อนจนกว่า Redis จะกลับมาทำงานได้ (เน้นความมั่นคงของโควตาเป็นหลัก)
🌐 การป้องกันหลายชั้น (Layered Defense):
ควรใช้ Rate Limiting ในหลายระดับ:
1. Gateway Level: ใช้เครื่องมือภายนอก เช่น Cloudflare, AWS API Gateway หรือ Kong เพื่อบล็อก Request ระดับเครือข่ายก่อนที่มันจะเข้าถึง PHP App ของคุณ
2. Application Level: คือโค้ด Middleware ที่เราเขียนขึ้นมาเพื่อตรวจสอบโควตาภายใน (เป็นชั้นป้องกันสำรอง)

สรุปและการนำไปประยุกต์ใช้งาน

Rate Limiting ไม่ใช่แค่ฟีเจอร์เสริม แต่เป็นโครงสร้างพื้นฐานด้านความมั่นคงของระบบ (System Resilience) อย่างแท้จริง การผสาน PHP เข้ากับ In-Memory Store อย่าง Redis ทำให้เราสามารถสร้าง Middleware ที่รวดเร็ว มีประสิทธิภาพ และเชื่อถือได้ในการควบคุมการเข้าถึง API

Public API: กำหนดโควตาที่เข้มงวดเพื่อให้ทุกคนใช้งานได้อย่างเป็นธรรม และป้องกันการขูดข้อมูล (Scraping)
Signup/Login Endpoint: ใช้ Rate Limiting เพื่อป้องกัน Brute-Force Attacks หรือการสร้างบัญชีปลอมจำนวนมาก
One-time Actions: เช่น การรีเซ็ตรหัสผ่าน ควรจำกัด IP หรือ User ID ให้ไม่สามารถทำซ้ำได้ภายในช่วงเวลาสั้น ๆ เพื่อความปลอดภัยสูงสุด

การเข้าใจและนำ Rate Limiting ไปใช้ได้อย่างถูกต้อง จะช่วยให้ API ของคุณมีความยืดหยุ่น ปลอดภัย และพร้อมสำหรับการขยายตัวในอนาคตได้อย่างไม่มีปัญหา ทำให้ระบบของคุณเป็นไปตามมาตรฐานของ Enterprise-Grade Application

อ่านเพิ่มเติม