คุณทริกเกอร์ฟังก์ชันผ่านคำขอ HTTP ได้โดยใช้ functions.https
ซึ่งช่วยให้คุณเรียกใช้ฟังก์ชันแบบซิงโครนัสผ่านเมธอด HTTP ที่รองรับต่อไปนี้ GET
, POST
, PUT
, DELETE
และ OPTIONS
ตัวอย่างในหน้านี้อิงตามฟังก์ชันตัวอย่างที่ทริกเกอร์เมื่อคุณส่งคำขอ HTTP GET
ไปยังปลายทางของฟังก์ชัน ฟังก์ชันตัวอย่างจะดึงข้อมูลเวลาปัจจุบันของเซิร์ฟเวอร์ จัดรูปแบบเวลาตามที่ระบุในพารามิเตอร์การค้นหาของ URL และส่งผลลัพธ์ในการตอบกลับ HTTP
ทริกเกอร์ฟังก์ชันที่มีคำขอ HTTP
ใช้ functions.https
เพื่อสร้างฟังก์ชันที่จัดการเหตุการณ์ HTTP ตัวแฮนเดิลเหตุการณ์สำหรับฟังก์ชัน HTTP จะคอยตรวจจับเหตุการณ์ onRequest()
ซึ่งรองรับเราเตอร์และแอปที่จัดการโดยเว็บเฟรมเวิร์ก Express
การใช้ออบเจ็กต์คำขอและการตอบกลับ Express
ออบเจ็กต์คำขอใช้เป็นอาร์กิวเมนต์สำหรับ onRequest()
และช่วยให้คุณเข้าถึงพร็อพเพอร์ตี้ของคำขอ HTTP ที่ไคลเอ็นต์ส่ง และออบเจ็กต์ Response ให้คุณส่งการตอบกลับกลับไปยังไคลเอ็นต์
exports.date = functions.https.onRequest((req, res) => { // ... });
ใช้แอป Express ที่มีอยู่
เมื่อใช้ App เป็นอาร์กิวเมนต์สำหรับ onRequest()
คุณจะส่งผ่านแอป Express เต็มรูปแบบไปยังฟังก์ชัน HTTP ได้ โค้ดต้นแบบสามารถย้าย
ไปยังมิดเดิลแวร์ได้ดังที่แสดงด้านล่างนี้
const express = require('express');
const cors = require('cors');
const app = express();
// Automatically allow cross-origin requests
app.use(cors({ origin: true }));
// Add middleware to authenticate requests
app.use(myMiddleware);
// build multiple CRUD interfaces:
app.get('/:id', (req, res) => res.send(Widgets.getById(req.params.id)));
app.post('/', (req, res) => res.send(Widgets.create()));
app.put('/:id', (req, res) => res.send(Widgets.update(req.params.id, req.body)));
app.delete('/:id', (req, res) => res.send(Widgets.delete(req.params.id)));
app.get('/', (req, res) => res.send(Widgets.list()));
// Expose Express API as a single Cloud Function:
exports.widgets = functions.https.onRequest(app);
เรียกใช้ฟังก์ชัน HTTP
หลังจากทำให้ฟังก์ชัน HTTP ใช้งานได้แล้ว คุณจะเรียกใช้ผ่าน URL ที่ไม่ซ้ำกันของตัวเองได้ URL จะมีข้อมูลต่อไปนี้ตามลําดับ
- ภูมิภาค (หรือหลายภูมิภาค) ที่คุณทำให้ฟังก์ชันใช้งานได้ ฟังก์ชันที่ใช้งานจริงบางอย่างอาจต้องตั้งค่าตำแหน่งอย่างชัดเจนเพื่อลดเวลาในการตอบสนองของเครือข่าย
- รหัสโปรเจ็กต์ Firebase
cloudfunctions.net
- ชื่อฟังก์ชัน
ตัวอย่างเช่น URL ที่จะเรียกใช้ date()
มีลักษณะดังนี้
https://us-central1-<project-id>.cloudfunctions.net/date
หากคุณพบข้อผิดพลาดด้านสิทธิ์เมื่อทำให้ฟังก์ชันใช้งานได้ โปรดตรวจสอบว่าได้กำหนดบทบาท IAM ที่เหมาะสมให้กับผู้ใช้ที่ใช้คำสั่งการทำให้ใช้งานได้
เมื่อใช้การกำหนดเส้นทางแอป Express ระบบจะเพิ่มชื่อฟังก์ชันเป็นคำนำหน้าเส้นทาง URL ในแอปที่คุณกำหนด เช่น URL ที่จะเรียกใช้ Getter ในตัวอย่างแอป Express ด้านบนจะเป็นดังนี้
https://us-central1-<project-id>.cloudfunctions.net/widgets/<id>
หากเรียกใช้ฟังก์ชัน HTTP หลังไฟร์วอลล์หรือตัวกรอง IP คุณจะค้นหาที่อยู่ IP ที่ Google ใช้แสดงฟังก์ชัน HTTP ได้
ใช้โมดูลมิดเดิลแวร์ด้วย Cloud Functions
หากคุณจำเป็นต้องแทรกทรัพยากร Dependency ของมิดเดิลแวร์สำหรับสิ่งต่างๆ เช่น การรองรับคุกกี้หรือ CORS ให้เรียกใช้ทรัพยากรเหล่านี้ภายในฟังก์ชัน ตัวอย่างเช่น หากต้องการเปิดใช้การรองรับ CORS ให้เพิ่มการบล็อกต่อไปนี้
// Enable CORS using the `cors` express middleware. cors(req, res, () => { // ... });
อ่านค่าจากคำขอ
ตารางต่อไปนี้แสดงสถานการณ์ที่พบบ่อยบางส่วนประเภทเนื้อหา | เนื้อความของคำขอ | พฤติกรรม |
---|---|---|
application/json |
'{"name":"John"}' |
request.body.name เท่ากับ "John" |
application/octet-stream |
"ข้อความของฉัน" | request.body เท่ากับ "6d792074657874" (ไบต์ดิบของคำขอ โปรดดูเอกสารประกอบเกี่ยวกับบัฟเฟอร์ของ Node.js) |
text/plain |
"ข้อความของฉัน" | request.body เท่ากับ "ข้อความของฉัน" |
application/x-www-form-urlencoded |
"name=จอห์น" | request.body.name เท่ากับ "John" |
การแยกวิเคราะห์นี้ดำเนินการโดยโปรแกรมแยกวิเคราะห์เนื้อหาต่อไปนี้
- โปรแกรมแยกวิเคราะห์เนื้อหา JSON
- โปรแกรมแยกวิเคราะห์เนื้อหาดิบ
- โปรแกรมแยกวิเคราะห์เนื้อหาข้อความ
- โปรแกรมแยกวิเคราะห์เนื้อหาแบบฟอร์มที่เข้ารหัส URL
สมมติว่ามีการเรียกฟังก์ชันด้วยคำขอต่อไปนี้
curl -X POST -H "Content-Type:application/json" -H "X-MyHeader: 123" YOUR_HTTP_TRIGGER_ENDPOINT?foo=baz -d '{"text":"something"}'
ข้อมูลที่ส่งจะปรากฏในรูปแบบต่อไปนี้
พร็อพเพอร์ตี้/วิธีการ | ค่า |
---|---|
req.method |
"โพสต์" |
req.get('x-myheader') |
"123" |
req.query.foo |
"Baz" |
req.body.text |
"บางอย่าง" |
req.rawBody |
ไบต์ดิบ (ไม่ได้แยกวิเคราะห์) ของคำขอ |
ในตัวอย่างฟังก์ชัน date()
ฟังก์ชันจะทดสอบทั้งพารามิเตอร์ของ URL และส่วนเนื้อหาของค่า format
เพื่อตั้งค่ารูปแบบวันที่/เวลาที่จะใช้
let format = req.query.format; format = req.body.format;
สิ้นสุดฟังก์ชัน HTTP
สิ้นสุดฟังก์ชัน HTTP ด้วย send()
, redirect()
หรือ end()
เสมอ มิฉะนั้น ฟังก์ชันอาจยังคงทำงานอยู่และถูกบังคับให้สิ้นสุดการใช้งาน โปรดดูเพิ่มเติมที่
Sync, Async และ Promises
หลังจากเรียกข้อมูลและจัดรูปแบบเวลาของเซิร์ฟเวอร์โดยใช้โมดูล Node.js moment
แล้ว ฟังก์ชัน date()
จะสรุปด้วยการส่งผลลัพธ์ในการตอบสนอง HTTP ดังนี้
const formattedDate = moment().format(`${format}`); functions.logger.log('Sending Formatted date:', formattedDate); res.status(200).send(formattedDate);
การเชื่อมต่อฟังก์ชัน HTTP กับโฮสติ้งของ Firebase
คุณเชื่อมต่อฟังก์ชัน HTTP กับโฮสติ้งของ Firebase ได้ คำขอในเว็บไซต์โฮสติ้งของ Firebase สามารถส่งผ่านพร็อกซีไปยังฟังก์ชัน HTTP ที่เจาะจงได้ ซึ่งจะช่วยให้คุณใช้โดเมนที่กำหนดเองกับฟังก์ชัน HTTP ได้ ดูข้อมูลเพิ่มเติมเกี่ยวกับการเชื่อมต่อ Cloud Functions กับโฮสติ้งของ Firebase