เรียกใช้ฟังก์ชันผ่านคำขอ HTTP

คุณเรียกใช้ฟังก์ชันผ่านคำขอ HTTP ด้วยตัวแฮนเดิลคำขอได้ ซึ่งจะช่วยให้คุณเรียกใช้ฟังก์ชันผ่านวิธีการ HTTP ที่รองรับต่อไปนี้ได้ GET, POST, PUT, DELETE และ OPTIONS

ตัวเลือก HTTP เพิ่มเติม

ตัวเลือก คำอธิบาย
region ฟังก์ชัน HTTP อาจระบุอาร์เรย์ของภูมิภาคและภูมิภาคเดียว เมื่อระบุหลายภูมิภาค ระบบจะทําให้ฟังก์ชันแต่ละอินสแตนซ์ใช้งานได้สําหรับแต่ละภูมิภาค
timeoutSeconds (timeout_sec สำหรับ Python) ฟังก์ชัน HTTP อาจระบุการหมดเวลาได้นานถึง 1 ชั่วโมง
cors ฟังก์ชัน HTTP อาจระบุนโยบาย CORS คุณตั้งค่านี้เป็น true เพื่ออนุญาตต้นทางทั้งหมด หรือ string, regex หรือ array เพื่อระบุต้นทางที่อนุญาตได้ ค่าเริ่มต้นจะเป็น false/ไม่มีนโยบาย CORS หากไม่ได้ตั้งค่าไว้อย่างชัดแจ้ง

การกำหนดค่า CORS (การแชร์ทรัพยากรแบบข้ามต้นทาง)

ใช้ตัวเลือก cors เพื่อควบคุมว่าต้นทางใดบ้างที่เข้าถึงฟังก์ชันได้ โดยค่าเริ่มต้น ฟังก์ชัน HTTP จะไม่มีการกำหนดค่า CORS ซึ่งหมายความว่าคำขอข้ามต้นทางใดๆ ที่ส่งไปยังฟังก์ชันจะทำให้เกิดข้อผิดพลาดนี้

request has been blocked by CORS policy: No 'Access-Control-Allow-Origin' header is present on the requested resource.

นอกจากนี้ คุณยังปิดใช้ CORS อย่างชัดเจนได้โดยตั้งค่าตัวเลือก cors เป็น false สำหรับฟังก์ชัน

หากต้องการอนุญาตคำขอข้ามต้นทางบางรายการ แต่ไม่อนุญาตทั้งหมด คุณสามารถส่งรายการ โดเมนที่เฉพาะเจาะจงหรือนิพจน์ทั่วไปที่ควรได้รับอนุญาตได้ ตัวอย่างเช่น หากคุณเป็นเจ้าของโดเมน firebase.com และ flutter.com และ firebase.com มีโดเมนย่อยได้หลายโดเมน คุณอาจต้องการตั้งค่าตัวเลือก cors เป็น [/firebase\.com$/, 'https://flutter.com'] สำหรับ Node.js หรือ [r'firebase\.com$', r'https://flutter\.com'] สำหรับ Python

Node.js

const { onRequest } = require("firebase-functions/v2/https");

exports.sayHello = onRequest(
  { cors: [/firebase\.com$/, "https://flutter.com"] },
  (req, res) => {
    res.status(200).send("Hello world!");
  }
);

Python

from firebase_functions import https_fn, options

@https_fn.on_request(
    cors=options.CorsOptions(
        cors_origins=[r"firebase\.com$", r"https://flutter\.com"],
        cors_methods=["get", "post"],
    )
)
def say_hello(req: https_fn.Request) -> https_fn.Response:
    return https_fn.Response("Hello world!")

หากฟังก์ชันควรพร้อมใช้งานอย่างเปิดเผย เช่น หากฟังก์ชันนั้นให้บริการ API หรือเว็บไซต์สาธารณะ ให้ตั้งค่าcorsเป็น true

ทริกเกอร์ฟังก์ชันด้วยคำขอ HTTP

ใช้ตัวแฮนเดิลคำขอสำหรับแพลตฟอร์มของคุณ (onRequest() หรือ on_request) เพื่อสร้างฟังก์ชันที่จัดการเหตุการณ์ HTTP ตัวอย่างในส่วนนี้อิงตามตัวอย่าง "เซิร์ฟเวอร์เวลา" ที่ทริกเกอร์เมื่อคุณส่งคำขอ HTTP GET ไปยังปลายทางของฟังก์ชัน ฟังก์ชันตัวอย่าง จะดึงเวลาปัจจุบันของเซิร์ฟเวอร์ จัดรูปแบบเวลาตามที่ระบุไว้ในพารามิเตอร์การค้นหาของ URL และส่งผลลัพธ์ในการตอบกลับ HTTP

การใช้ออบเจ็กต์คำขอและการตอบกลับ

ออบเจ็กต์คำขอช่วยให้คุณเข้าถึงพร็อพเพอร์ตี้ของคำขอ HTTP ที่ไคลเอ็นต์ส่งมาได้ และออบเจ็กต์การตอบกลับช่วยให้คุณส่งการตอบกลับไปยังไคลเอ็นต์ได้

Node.js

exports.date = onRequest(
    {timeoutSeconds: 1200, region: ["us-west1", "us-east1"]},
    (req, res) => {
// ...
});

Python

@https_fn.on_request(cors=options.CorsOptions(cors_origins="*", cors_methods=["get", "post"]))
def date(req: https_fn.Request) -> https_fn.Response:
    """Get the server's local date and time."""

การใช้แอป Express หรือ Flask ที่มีอยู่

การใช้แอปเป็นอาร์กิวเมนต์สำหรับ ตัวแฮนเดิลคำขอ คุณจะส่งแอปแบบเต็มไปยังฟังก์ชัน HTTP ได้

Node.js

const { onRequest } = require('firebase-functions/v2/https');

const express = require('express');
const app = express();

// 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 = onRequest(app);

Python

from firebase_admin import initialize_app, db
from firebase_functions import https_fn
import flask

initialize_app()
app = flask.Flask(__name__)

# Build multiple CRUD interfaces:


@app.get("/widgets")
@app.get("/widgets/<id>")
def get_widget(id=None):
    if id is not None:
        return db.reference(f"/widgets/{id}").get()
    else:
        return db.reference("/widgets").get()


@app.post("/widgets")
def add_widget():
    new_widget = flask.request.get_data(as_text=True)
    db.reference("/widgets").push(new_widget)
    return flask.Response(status=201, response="Added widget")


# Expose Flask app as a single Cloud Function:


@https_fn.on_request()
def httpsflaskexample(req: https_fn.Request) -> https_fn.Response:
    with app.request_context(req.environ):
        return app.full_dispatch_request()

เรียกใช้ฟังก์ชัน HTTP

หลังจากที่ติดตั้งใช้งานฟังก์ชัน HTTP แล้ว คุณจะเรียกใช้ฟังก์ชันดังกล่าวผ่าน URL ที่ไม่ซ้ำกันของฟังก์ชันเองได้ ใช้เอาต์พุต URL ที่ตรงกันจาก CLI หลังจากทําการติดตั้งใช้งาน

เช่น URL ที่จะเรียกใช้ date() จะมีลักษณะดังนี้

https://us-central1-<project-id>.cloudfunctions.net/date

เมื่อใช้การกำหนดเส้นทางแอป Express และ Flask ระบบจะเพิ่มชื่อฟังก์ชันเป็นคำนำหน้า เส้นทาง URL ในแอปที่คุณกำหนด

อ่านค่าจากคำขอ

ในตัวอย่างฟังก์ชัน date() ฟังก์ชันจะทดสอบทั้งพารามิเตอร์ URL และเนื้อหาสำหรับค่า format เพื่อตั้งค่ารูปแบบวันที่/เวลาที่จะใช้

Node.js

let format = req.query.format;
format = req.body.format;

Python

format = req.args["format"] if "format" in req.args else None

สิ้นสุดฟังก์ชัน HTTP

หลังจากดึงและจัดรูปแบบเวลาของเซิร์ฟเวอร์แล้ว date() ฟังก์ชัน จะสรุปโดยการส่งผลลัพธ์ในการตอบกลับ HTTP ดังนี้

Node.js

ปิดท้ายฟังก์ชัน HTTP ด้วย send(), redirect(), หรือ end() เสมอ ไม่เช่นนั้น ฟังก์ชันอาจทำงานต่อไปและระบบอาจบังคับให้หยุดทำงาน ดูเพิ่มเติม Sync, Async และ Promises

const formattedDate = moment().format(`${format}`);
logger.log("Sending formatted date:", formattedDate);
res.status(200).send(formattedDate);

Python

formatted_date = datetime.now().strftime(format)
print(f"Sending Formatted date: {formatted_date}")
return https_fn.Response(formatted_date)

การผสานรวมกับ Firebase Hosting

คุณเชื่อมต่อฟังก์ชัน HTTP กับ Firebase Hosting ได้ คำขอในFirebase Hostingเว็บไซต์ของคุณสามารถพร็อกซีไปยังฟังก์ชัน HTTP ที่เฉพาะเจาะจงได้ นอกจากนี้ยังช่วยให้คุณใช้โดเมนที่กำหนดเองกับฟังก์ชัน HTTP ได้ด้วย ดูข้อมูลเพิ่มเติมเกี่ยวกับ การเชื่อมต่อ Cloud Functions กับ Firebase Hosting