เรียกใช้ฟังก์ชันผ่านคำขอ 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."""
main.py

สำคัญ: ตรวจสอบว่าฟังก์ชัน HTTP ทั้งหมด สิ้นสุดอย่างถูกต้อง การสิ้นสุดฟังก์ชันอย่างถูกต้องจะช่วยหลีกเลี่ยงค่าใช้จ่ายที่มากเกินไปจากฟังก์ชันที่ทำงานนานเกินไป

การใช้แอป 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()
main.py

เรียกใช้ฟังก์ชัน 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;
index.js

Python

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

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

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

Node.js

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

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

Python

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

การผสานรวมกับโฮสติ้งของ Firebase

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