סביבת זמן הריצה של PHP

הפונקציה של Cloud Run פועלת בסביבה שמורכבת מגרסת מערכת הפעלה עם חבילות תוספים, תמיכה בשפה וספריית PHP Functions Framework שתומכת בפונקציה ומפעילה אותה. הסביבה הזו מזוהה לפי גרסת השפה, והיא נקראת מזהה זמן הריצה.

הכנת הפונקציה

אפשר להכין פונקציה ישירות ממסוף Google Cloud או לכתוב אותה במחשב המקומי ולהעלות אותה. כדי להכין את המחשב המקומי לפיתוח PHP, אפשר לעיין במאמר בנושא שימוש ב-PHP ב- Google Cloud.

זמני ריצה נתמכים של PHP ותמונות בסיס

זמן ריצה	המזהה של סביבת זמן הריצה	מקבצים	תמונת הבסיס בזמן הריצה
PHP 8.5	php85	‫google-24-full (ברירת מחדל)	google-24-full/php85
PHP 8.4	php84	‫google-22-full (ברירת מחדל)	google-22-full/php84
PHP 8.3	php83	‫google-22-full (ברירת מחדל)	google-22-full/php83
PHP 8.2	php82	‫google-22-full (ברירת מחדל)	google-22-full/php82
PHP 8.1	php81	google-18-full	google-18-full/php81
PHP 7.4	php74	google-18-full	google-18-full/php74

בחירת זמן הריצה

במהלך הפריסה, אפשר לבחור אחת מסביבות זמן הריצה של PHP שנתמכות בפונקציה.

אפשר לבחור גרסת זמן ריצה באמצעות מסוף Google Cloud או ה-CLI של gcloud. לוחצים על הכרטיסייה עם ההוראות לשימוש בכלי הרצוי:

gcloud

מציינים את תמונת הבסיס של PHP לפונקציה באמצעות הדגל --base-image, בזמן פריסת הפונקציה. לדוגמה:

gcloud run deploy FUNCTION \
    --source . \
    --function FUNCTION_ENTRYPOINT \
    --base-image php84

מחליפים את:

• ‫FUNCTION בשם הפונקציה שאתם פורסים. אפשר להשמיט את הפרמטר הזה לגמרי, אבל אם תשמיטו אותו, תתבקשו לציין את השם.

• ‫FUNCTION_ENTRYPOINT עם נקודת הכניסה לפונקציה בקוד המקור. זה הקוד ש-Cloud Run מריץ כשהפונקציה פועלת. הערך של הדגל הזה צריך להיות שם של פונקציה או שם מלא של מחלקה שקיימים בקוד המקור.

הוראות מפורטות לפריסת פונקציה באמצעות ה-CLI של gcloud מופיעות במאמר פריסת פונקציות ב-Cloud Run.

המסוף

אפשר לבחור גרסת זמן ריצה כשיוצרים או מעדכנים פונקציית Cloud Run במסוף Google Cloud . הוראות מפורטות לפריסת פונקציה זמינות במאמר פריסת פונקציות ב-Cloud Run.

כדי לבחור סביבת ריצה במסוף Google Cloud כשיוצרים פונקציה, פועלים לפי השלבים הבאים:

1. במסוף Google Cloud , נכנסים לדף Cloud Run:

   כניסה ל-Cloud Run

2. לוחצים על כתיבת פונקציה.

3. ברשימה Runtime בוחרים גרסת PHP runtime.

4. לוחצים על Create ומחכים ש-Cloud Run ייצור את השירות באמצעות עדכון placeholder.

5. המסוף יפנה אתכם לכרטיסייה מקור, שבה תוכלו לראות את קוד המקור של הפונקציה. לוחצים על שמירה ופריסה מחדש.

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

מבנה קוד המקור

כדי שפונקציות Cloud Run יוכלו למצוא את ההגדרה של הפונקציה, קוד המקור צריך להיות במבנה מסוים. מידע נוסף זמין במאמר בנושא כתיבה של פונקציות Cloud Run.

הגדרת PHP

מגדירים את פונקציית ה-PHP באמצעות קובץ php.iniבתיקיית השורש של הפונקציה. אפשר להציג את הגדרות ה-PHP הקיימות באמצעות הפונקציה phpinfo(), כמו בדוגמת הקוד הבאה:

use Psr\Http\Message\ServerRequestInterface;

function phpInfoDemo(ServerRequestInterface $request): string
{
    // phpinfo() displays its output directly in the function's
    // HTTP response, so we don't need to explicitly return it
    //
    // Note: we recommend deleting the deployed Cloud Function once you no
    // longer need it, as phpinfo() may broadcast potential security issues.
    phpinfo();
    return '';
}

ציון יחסי תלות

‫PHP משתמש ב-Composer כדי לנהל יחסי תלות. כדי לציין את התלויות של הפונקציה, מוסיפים אותן לקובץ פרויקט שנקרא composer.json.

בזמן הריצה של PHP בפונקציות Cloud Run, צריך להגדיר את Functions Framework כתלות מפורשת. כדי להוסיף את Functions Framework כתלות, מריצים את הפקודה הבאה בספרייה שמכילה את קוד הפונקציה (הספרייה הזו צריכה להכיל גם את הקובץ composer.json):

composer require google/cloud-functions-framework

הפעולה הזו מוסיפה את Functions Framework ל-composer.json ומתקינה את החבילה בספרייה vendor/.

קובץ autoload.php

אחד מהקבצים שנמצאים בספרייה vendor/ הוא autoload.php.

מוסיפים את השורה הבאה לחלק העליון של סקריפטים של PHP כדי לדרוש את הקובץ autoload.php, שבאופן אוטומטי require את התלויות האחרות של הפונקציה:

require_once __DIR__ . '/vendor/autoload.php';

כברירת מחדל, המערכת מתעלמת מהספרייה vendor/ בקובץ .gcloudignore שנוצר, כדי לצמצם את מספר הקבצים שנשלחים בפריסה.