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

אפשר להצהיר על יחסי תלות של PHP בקובץ composer.json רגיל. לדוגמה:

{
    "require": {
        "google/cloud": "^0.72"
    }
}

אפשר להשתמש בכל חבילת PHP שתואמת ל-Linux ב-App Engine. סביבת זמן הריצה מחפשת קובץ composer.json בספריית המקור של האפליקציה ומשתמשת ב-composer כדי להתקין את כל התלות לפני הפעלת האפליקציה.

מידע על גרסאות PHP שנתמכות ב-Runtime הזה זמין במאמר PHP Runtime.

התקנה והפעלה באופן מקומי

משתמשים ב-composer כדי להתקין את יחסי התלות באופן מקומי:

composer install

כדי להצמיד את יחסי התלות לגרסה הנוכחית שלהם, צריך לבצע קומיט של הקובץ composer.lock באפליקציה.

אפשר לבדוק את האפליקציה באמצעות שרת האינטרנט שתבחרו. הסביבה הגמישה של App Engine משתמשת ב-NGINX בסביבת הייצור. כדי להריץ את האפליקציה במהירות, אפשר להשתמש בשרת האינטרנט המובנה של PHP.

התקנה של מסגרת אינטרנט

כברירת מחדל, NGINX מוגדר להעביר את כל הבקשות דרך index.php. לא נדרש שימוש במסגרת, אבל מומלץ לעשות זאת. אפשר להשתמש בכל מסגרת אינטרנט בסביבות גמישות של App Engine, כולל המסגרות הבאות:

כדי להשתמש במסגרת אינטרנט מסוימת, פשוט מוסיפים אותה ל-composer.json:

{
    "require": {
        "symfony/symfony": " ^3.0"
    }
}

התקנת ספריות לקוח של Cloud

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

  1. מתקינים את הספרייה באופן מקומי:

    composer require google/cloud

  2. אפשר לטפל באימות באופן מקומי באמצעות Google Cloud CLI. אם רוצים שהאפליקציה המקומית תשתמש באופן זמני בפרטי הכניסה של המשתמש לצורך גישה ל-API, מריצים את הפקודה:

    gcloud auth application-default login

    במאמר אימות לשירותי Cloud באמצעות ספריות לקוח מוסבר איך להגדיר את ספריות הלקוח של Cloud ל-PHP כך שיטפלו באימות באופן אוטומטי.

שימוש במאגרים פרטיים

כדי להשתמש בספריות במאגרי מידע פרטיים, צריך לבצע את המשימות הבאות:

  • מגדירים את המאגר.
  • נותנים ל-composer את הסוד כדי לגשת למאגר הפרטי.

בדוגמה הבאה אפשר לראות איך ניגשים למאגר פרטי ב-GitHub.

  1. מגדירים את המאגר ב-composer.json באמצעות vcs לסוג:

    "repositories": [
    {
        "type": "vcs",
        "url": "https://github.com/username/private_package"
    }
]

  2. יוצרים קובץ בשם auth.json בתיקיית השורש של הפרויקט:

    {
    "github-oauth": {
        "github.com": "<your-github-auth-token>"
    }
}

אפשר לקבל את אסימון האימות של GitHub מממשק המשתמש הניהולי של GitHub.

הנה דוגמה נוספת שממחישה איך לגשת למאגר פרטי ב-Bitbucket.

  1. מגדירים את המאגר ב-composer.json באמצעות vcs לסוג:

    "repositories": [
    {
        "type": "vcs",
        "url":  "https://bitbucket.org/username/private_git"
    }
]

  2. יוצרים קובץ בשם auth.json בתיקיית השורש של הפרויקט:

    {
    "bitbucket-oauth": {
        "bitbucket.org": {
            "consumer-key": "<your-oauth-consumer-key>",
            "consumer-secret": "<your-oauth-consumer-secret>"
        }
    }
}