PHP ยิง HTTP request ไปเซิร์ฟเวอร์อื่น



งานเว็บสมัยใหม่ต้องคุยกับ API ภายนอกตลอด — payment gateway, ส่ง SMS/อีเมล, ดึงข้อมูลสภาพอากาศ PHP มี cURL ในตัว

GET แบบง่าย

<?php
declare(strict_types=1);

$ch = curl_init('https://api.github.com/repos/php/php-src');

curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,          // คืน response เป็นสตริง (ไม่ echo)
    CURLOPT_FOLLOWLOCATION => true,          // ตาม redirect
    CURLOPT_TIMEOUT => 10,                   // ทั้ง request ไม่เกิน 10 วิ
    CURLOPT_CONNECTTIMEOUT => 5,             // เชื่อมต่อไม่เกิน 5 วิ
    CURLOPT_USERAGENT => 'comscidev-tutorial/1.0',
]);

$body = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
$error = curl_error($ch);
curl_close($ch);

if ($body === false) {
    throw new RuntimeException("cURL error: $error");
}
if ($status !== 200) {
    throw new RuntimeException("HTTP $status");
}

$data = json_decode($body, true, flags: JSON_THROW_ON_ERROR);
echo $data['full_name'], ' ⭐ ', $data['stargazers_count'], "\n";

CURLOPT_TIMEOUT สำคัญที่สุด — ไม่ตั้ง = ถ้า API ปลายทางค้าง request ของเราค้างตาม ผู้ใช้รอไม่จบ และ php-fpm worker ถูกจองจนหมด

POST JSON

<?php
declare(strict_types=1);

function postJson(string $url, array $payload, array $headers = []): array
{
    $ch = curl_init($url);
    curl_setopt_array($ch, [
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_POST => true,
        CURLOPT_POSTFIELDS => json_encode($payload, JSON_UNESCAPED_UNICODE),
        CURLOPT_HTTPHEADER => array_merge([
            'Content-Type: application/json',
            'Accept: application/json',
        ], $headers),
        CURLOPT_TIMEOUT => 15,
        CURLOPT_CONNECTTIMEOUT => 5,
    ]);

    $body = curl_exec($ch);
    $status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
    $err = curl_error($ch);
    curl_close($ch);

    if ($body === false) {
        throw new RuntimeException("เชื่อมต่อไม่ได้: $err");
    }

    $decoded = json_decode($body, true) ?? [];

    if ($status >= 400) {
        throw new RuntimeException(
            "API ตอบ $status: " . ($decoded['message'] ?? $body)
        );
    }

    return $decoded;
}

$result = postJson('https://httpbin.org/post', [
    'name' => 'สมชาย',
    'amount' => 500,
]);
print_r($result['json']);

ส่ง Authorization header

<?php
$result = postJson('https://api.example.com/charge', $payload, [
    'Authorization: Bearer ' . $apiToken,
]);

ดึง response header ด้วย

<?php
$headers = [];
curl_setopt($ch, CURLOPT_HEADERFUNCTION, function ($ch, $line) use (&$headers) {
    $parts = explode(':', $line, 2);
    if (count($parts) === 2) {
        $headers[strtolower(trim($parts[0]))] = trim($parts[1]);
    }
    return strlen($line);
});
// ... curl_exec ...
echo $headers['x-ratelimit-remaining'] ?? 'ไม่ทราบ', "\n";

reuse connection เมื่อยิงหลายครั้ง

curl_init ใหม่ทุกครั้งเสียเวลา handshake ถ้ายิงปลายทางเดิมหลายรอบ reuse handle:

<?php
$ch = curl_init();
curl_setopt_array($ch, [CURLOPT_RETURNTRANSFER => true, CURLOPT_TIMEOUT => 10]);

foreach ($ids as $id) {
    curl_setopt($ch, CURLOPT_URL, "https://api.example.com/items/$id");
    $body = curl_exec($ch);
    // ...
}
curl_close($ch);

ทำไมไม่ใช้ file_get_contents กับ URL

<?php
// ทำได้ แต่มีปัญหา
$json = file_get_contents('https://api.example.com/data');
  • พึ่ง allow_url_fopen ที่ production หลายที่ปิด (ด้วยเหตุผลด้านความปลอดภัย)
  • ไม่มี timeout ที่ดี (ต้องทำผ่าน stream context)
  • อ่าน status code / error ยาก — พังแล้วได้แค่ false + warning
  • ไม่ตาม redirect, ไม่ทำ POST สะดวก

ถ้าจำเป็นต้องใช้ ตั้ง context:

<?php
$context = stream_context_create([
    'http' => [
        'method' => 'GET',
        'timeout' => 10,
        'header' => "Accept: application/json\r\n",
        'ignore_errors' => true,   // ยังอ่าน body ได้แม้ status 4xx/5xx
    ],
]);
$json = file_get_contents($url, false, $context);
// status อยู่ใน $http_response_header[0]

cURL ควบคุมได้ดีกว่าในทุกด้าน

ทางที่สะอาดกว่า: Guzzle

งานจริงส่วนใหญ่ใช้ไลบรารีแทนเขียน cURL ดิบ:

composer require guzzlehttp/guzzle
<?php
use GuzzleHttp\Client;

$client = new Client([
    'base_uri' => 'https://api.example.com',
    'timeout' => 10,
    'headers' => ['Authorization' => 'Bearer ' . $token],
]);

$response = $client->post('/charge', [
    'json' => ['amount' => 500, 'currency' => 'THB'],
]);

$status = $response->getStatusCode();          // 200
$data = json_decode((string) $response->getBody(), true);

Guzzle จัดการ retry, redirect, error (4xx/5xx throw เป็น exception), async ได้ และเป็น PSR-18 (ClientInterface) ทำให้ type hint และ mock ตอนเทสต์ได้

เรื่องที่คนมักพลาด

  • ไม่ตั้ง CURLOPT_TIMEOUT — API ปลายทางช้า → request เราค้าง → worker หมด → เว็บล่มทั้งเว็บ ตั้งเสมอ
  • ลืม CURLOPT_RETURNTRANSFER => true — curl_exec คืน true แล้ว echo response ออกไปปนกับหน้าเว็บเรา
  • ไม่เช็ค status code — API ตอบ 500 พร้อม body ว่าง เราเอาไป json_decode ได้ null แล้วพังที่อื่น
  • json_decode โดยไม่เช็ค — ปลายทางตอบ HTML (หน้า error ของ proxy) เราได้ null
  • CURLOPT_SSL_VERIFYPEER => false เพื่อ “แก้” ปัญหา cert — เปิดช่อง MITM อย่าทำ แก้ที่ CA bundle แทน
  • ยิง API ในลูปแบบ synchronous 100 ครั้ง — ช้ามาก ใช้ curl_multi_* หรือ Guzzle async / pool
  • เอา URL จากผู้ใช้มายิงตรง ๆ (SSRF) — ผู้ใช้ใส่ http://169.254.169.254/ หรือ http://localhost:6379 ดึงข้อมูลภายใน ตรวจ host/scheme ก่อนเสมอ

สรุป

  • cURL: curl_init → curl_setopt_array → curl_exec → curl_getinfo(RESPONSE_CODE) → curl_close
  • ตั้ง CURLOPT_RETURNTRANSFER, CURLOPT_TIMEOUT, CURLOPT_CONNECTTIMEOUT เสมอ
  • เช็คทั้ง curl_error (เชื่อมต่อ), status code (>= 400), และผล json_decode
  • POST JSON: CURLOPT_POSTFIELDS => json_encode(...) + header Content-Type: application/json
  • เลี่ยง file_get_contents($url) — ควบคุมยาก, พึ่ง allow_url_fopen
  • งานจริงใช้ Guzzle (PSR-18) — retry, error เป็น exception, mock ได้
  • ระวัง SSRF เมื่อ URL มาจากผู้ใช้

จบเฟสเว็บ บทถัดไปเข้าเฟสฐานข้อมูล เริ่มที่การเชื่อมต่อด้วย PDO — วิธีมาตรฐานที่ปลอดภัยและใช้ได้กับหลายฐานข้อมูล