وظائف الاستدعاء من خلال طلبات HTTP

يمكنك تنشيط دالة من خلال طلب HTTP باستخدام functions.https. يتيح لك ذلك استدعاء دالة متزامنة من خلال methods HTTP المتاحة التالية: GET وPOST وPUT وDELETE و OPTIONS.

تستند الأمثلة الواردة في هذه الصفحة إلى نموذج دالة يتم تفعيله عند إرسال طلب HTTP GET إلى نقطة نهاية الدوالّ. تسترد دالة النموذج وقت الخادم الحالي، وتنسق الوقت وفقًا لما هو محدّد في معلَمة طلب بحث عنوان URL، وترسل النتيجة في استجابة HTTP.

تشغيل دالة باستخدام طلب HTTP

استخدِم functions.https لإنشاء دالة تعالج أحداث HTTP. ينتظر معالِج الأحداث لواحدة من وظائف HTTP حدث onRequest()، الذي يتيح استخدام أجهزة التوجيه والتطبيقات التي تديرها إطار عمل الويب Express.

استخدام عناصر الطلب والاستجابة في Express

عند استخدامه كوسيطات للعنصر onRequest()، يمنحك كائن Request إمكانية الوصول إلى سمات طلب HTTP الذي أرسله العميل، ويمنحك كائن Response طريقة لإرسال استجابة إلى العميل.

exports.date = functions.https.onRequest((req, res) => {
  // ...
});

استخدام تطبيقات Express الحالية

باستخدام التطبيق كوسيطة للدالة 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

إذا واجهت أخطاء في الأذونات عند نشر الدوال، تأكَّد من تعيين أدوار "إدارة الهوية وإمكانية الوصول" المناسبة للمستخدم الذي يُشغِّل أوامر النشر.

باستخدام ميزة "توجيه التطبيقات السريع"، تتم إضافة اسم الدالة كبادئة إلى مسارات عناوين URL في التطبيق الذي تحدّده. على سبيل المثال، عنوان URL لاستدعاء دالة الاستدعاء في مثال تطبيق Express أعلاه يبدو كما يلي:

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

إذا كنت تستدعي وظائف HTTP من خلف جدار حماية أو فلتر عناوين IP، يمكنك البحث عن عناوين IP التي تستخدمها Google لعرض وظائف HTTP.

استخدام وحدات البرمجيات الوسيطة مع Cloud Functions

إذا كنت بحاجة إلى إدراج تبعيات الوسيط لاستخدام ميزات مثل إتاحة ملفات تعريف الارتباط أو CORS، يمكنك استدعاء هذه الميزات ضمن الدالة. على سبيل المثال، لتفعيل ميزة مشاركة الموارد المتعدّدة المصادر (CORS)، أضِف الوحدة التالية:

// Enable CORS using the `cors` express middleware.
cors(req, res, () => {
  // ...
});

قراءة القيم من الطلب

ويتم إجراء هذا التحليل باستخدام أدوات تحليل النص الأساسي التالية:

• أداة تحليل نص JSON
• أداة تحليل نص الطلب
• أداة تحليل نص الرسالة
• أداة تحليل محتوى النموذج المشفَّر بعنوان URL

افترض أنه يتم استدعاء الدالة مع الطلب التالي:

curl -X POST -H "Content-Type:application/json" -H "X-MyHeader: 123" YOUR_HTTP_TRIGGER_ENDPOINT?foo=baz -d '{"text":"something"}'

بعد ذلك، سيتمّ إنشاء البيانات المُرسَلة ضمن:

في مثال الدالة date()، تختبر الدالة كلّ من مَعلمة عنوان URL و النص بحثًا عن قيمة format لضبط تنسيق التاريخ/الوقت المراد استخدامه:

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

إنهاء وظائف 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);
index.js

ربط وظائف HTTP بـ Firebase Hosting

يمكنك ربط دالة HTTP بـ Firebase Hosting. يمكن تمثيل الطلبات على موقعك الإلكتروني Firebase Hosting من خلال وظائف HTTP محدّدة. ويتيح لك ذلك أيضًا استخدام نطاقك الخاص مع دالة HTTP. مزيد من المعلومات حول ربط "Cloud Functions" بتطبيق "Firebase Hosting"