📘 תיעוד 220

תחילת עבודה

עודכן לאחרונה: 21 באפריל 2026 | הצגה כ-Markdown | הגדרת סוכן

המדריך הזה ינחה אותך ביצירה ובפריסה של Pages Function.

#דרישות מוקדמות

חייב להיות לך פרויקט Pages שמוגדר במחשב המקומי שלך, או שנפרס בלוח הבקרה של Cloudflare. כדי ליצור פרויקט Pages, עיין בתחילת עבודה.

#יצירת Function

כדי להתחיל ביצירת Pages Function, צור תיקיית /functions. ודא שתיקיית /functions נמצאת בשורש פרויקט ה-Pages שלך (ולא בשורש הסטטי, כמו /dist).

מצב מתקדם

ביישומים קיימים שבהם ניתוב מובנה לפי נתיב קובץ ומערכת ה-middleware של Pages Functions אינם רצויים, השתמש במצב מתקדם. מצב מתקדם מאפשר לפתח Pages Functions באמצעות קובץ _worker.js במקום תיקיית /functions.

כתיבת קובצי ה-Functions בתיקיית /functions תיצור אוטומטית Worker עם פונקציונליות מותאמת אישית בנתיבים שנקבעו מראש.

העתק והדבק את הקוד הבא לקובץ helloworld.js שתיצור בתיקיית /functions:

export function onRequest(context) {
	return new Response("Hello, world!");
}

בקוד לדוגמה שלמעלה, המטפל onRequest מקבל אובייקט context של הבקשה. המטפל חייב להחזיר Response או Promise של Response.

ה-Function הזה ירוץ בנתיב /helloworld ויחזיר "Hello, world!". ה-Function זמין בנתיב הזה כי שם הקובץ הוא helloworld.js. באותו אופן, אם הקובץ היה נקרא howdyworld.js, הפונקציה הזו הייתה רצה ב-/howdyworld.

עיין בניתוב למידע נוסף על התאמה של נתיבים.

#תכונות זמן הריצה

תכונות זמן הריצה של Workers ניתנות להגדרה ב-Pages Functions, כולל תאימות לתת קבוצה של ממשקי Node.js והיכולת להגדיר תאריך תאימות או דגל תאימות.

הגדר את ההגדרות האלה על ידי העברת ארגומנט לפקודת Wrangler, או על ידי הגדרתן בלוח הבקרה. כדי להגדיר דגלי תאימות של Pages בלוח הבקרה של Cloudflare:

1. היכנס ללוח הבקרה של Cloudflare ↗︎ ובחר את החשבון שלך.
2. בחר Workers & Pages ובחר את פרויקט ה-Pages שלך.
3. בחר Settings > Functions > Compatibility Flags.
4. הגדר את דגלי התאימות של Production ושל Preview לפי הצורך.

בנוסף, השתמש במוצרי Cloudflare אחרים כמו D1 (מסד נתונים ללא שרת) ו-R2 מתוך פרויקט ה-Pages שלך על ידי הגדרת bindings.

#פריסת ה-Function

אחרי שהגדרת את ה-Function, פרוס את פרויקט ה-Pages שלך. פרוס את הפרויקט באחת מהדרכים הבאות:

• חיבור ספק ה-Git שלך.
• שימוש ב-Wrangler משורת הפקודה.

זהירות

Direct Upload מלוח הבקרה של Cloudflare אינו נתמך כרגע עם Functions.

#משאבים קשורים

• התאם את הניתוב של ה-Function
• עיין בהפניה ל-API
• למד איך לנפות שגיאות ב-Function