สร้างไฟล์ PHP แรกสำหรับ API

ในบทที่แล้ว เราได้ทำการติดตั้ง PHP และ Web Server (XAMPP/MAMP) เป็นที่เรียบร้อยแล้ว ในบทนี้ เราจะมาสร้างไฟล์ PHP ไฟล์แรกของเรา เพื่อเริ่มต้นการพัฒนา API อย่างง่ายกันครับ

ทำไมต้องสร้างไฟล์ PHP?

PHP เป็นภาษาโปรแกรมมิ่งที่เราจะใช้ในการสร้าง API ของเรา ไฟล์ PHP จะเป็นที่ที่เราเขียนโค้ดเพื่อรับ Request จาก Client, ประมวลผลข้อมูล และส่ง Response กลับไป

สร้างไฟล์ `index.php`

โดยทั่วไปแล้ว ไฟล์แรกที่เราจะสร้างสำหรับ API มักจะมีชื่อว่า index.php ไฟล์นี้จะถูกเรียกใช้งานเมื่อมี Request เข้ามาที่ Root Directory ของ API ของเรา (เช่น http://localhost/my-api/)

ให้สร้างไฟล์ index.php ใน Directory ที่คุณตั้งค่าให้เป็น Document Root ของ Web Server ของคุณ (โดยปกติคือ htdocs ใน XAMPP หรือ Sites ใน MAMP)

เขียนโค้ด PHP เบื้องต้น

เปิดไฟล์ index.php ด้วย Text Editor ที่คุณถนัด (เช่น VS Code, Sublime Text, Notepad++) แล้วเขียนโค้ด PHP ต่อไปนี้ลงไป:

<?php

// กำหนด Header เป็น JSON
header('Content-Type: application/json');

// สร้าง Array ที่จะแปลงเป็น JSON
$response = array(
    'message' => 'Hello, API World!',
    'status' => 'success'
);

// แปลง Array เป็น JSON String
$json_response = json_encode($response);

// ส่ง JSON Response กลับไป
echo $json_response;

?>

โค้ดนี้ทำอะไรบ้าง?

<?php และ ?>: เป็น Tag ที่ใช้บอกว่าส่วนนี้เป็นโค้ด PHP
header('Content-Type: application/json');: กำหนด Header ของ Response ให้เป็น application/json ซึ่งบอกว่าเราจะส่งข้อมูลในรูปแบบ JSON กลับไป
$response = array(...);: สร้าง Array ที่มี Key message และ status
json_encode($response);: แปลง Array $response เป็น JSON String
echo $json_response;: ส่ง JSON String กลับไปให้ Client

ทดสอบการทำงาน

เปิด Web Browser ของคุณ แล้วพิมพ์ URL ของ API ของคุณลงไป (เช่น http://localhost/my-api/index.php หรือ http://localhost/my-api/ หากคุณตั้งค่า Web Server ให้ index.php เป็น Default Document)

คุณควรจะเห็นผลลัพธ์เป็น JSON ดังนี้:

{
    "message": "Hello, API World!",
    "status": "success"
}

ถ้าคุณเห็นผลลัพธ์แบบนี้ แสดงว่าคุณได้สร้างไฟล์ PHP แรกสำหรับ API ของคุณสำเร็จแล้ว! ยินดีด้วยครับ!

คำอธิบายเพิ่มเติม

Header: ในโลกของ HTTP, Header คือข้อมูลเพิ่มเติมที่แนบไปกับ Request และ Response Header จะบอกข้อมูลเกี่ยวกับ Request/Response เช่น Content Type, Encoding, Cache Control และอื่นๆ ในกรณีนี้ เราใช้ Header Content-Type เพื่อบอก Client ว่า Response ที่เราส่งกลับไปเป็น JSON

JSON (JavaScript Object Notation): เป็นรูปแบบข้อมูลที่ใช้กันอย่างแพร่หลายในการส่งข้อมูลระหว่าง Server และ Client มีความง่ายในการอ่านและเขียน ทั้งสำหรับมนุษย์และเครื่องจักร เราจะเรียนรู้เกี่ยวกับ JSON อย่างละเอียดในบทต่อๆ ไป

Array: ใน PHP, Array เป็นโครงสร้างข้อมูลที่สามารถเก็บข้อมูลได้หลายค่า โดยแต่ละค่าจะมี Key ที่ใช้ในการเข้าถึง ในตัวอย่างของเรา, $response เป็น Array ที่มี Key message และ status

ข้อควรระวัง

Case Sensitivity: PHP เป็นภาษาที่ Case Sensitive (ยกเว้นชื่อฟังก์ชัน) หมายความว่า $response และ $Response ถือว่าเป็นตัวแปรที่แตกต่างกัน
Semicolon: ทุก Statement ใน PHP ต้องจบด้วย Semicolon (;)
Error Reporting: หากคุณไม่เห็นผลลัพธ์ที่ถูกต้อง ให้ตรวจสอบ Error Log ของ Web Server ของคุณ (โดยปกติจะอยู่ใน Directory logs ของ XAMPP/MAMP) เพื่อดูว่ามี Error อะไรเกิดขึ้น

สรุป

ในบทนี้ เราได้เรียนรู้วิธีการสร้างไฟล์ PHP แรกสำหรับ API, การเขียนโค้ด PHP เบื้องต้น, และการส่ง JSON Response กลับไป ในบทต่อไป เราจะมาเรียนรู้เกี่ยวกับการส่งค่า Parameter ผ่าน URL (GET) กันครับ

สร้างไฟล์ PHP แรกสำหรับ API