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

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

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

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

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

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

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

composer install

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

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

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

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

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

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

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

ספריית הלקוח של Google Cloud ל-PHP היא ספריית לקוח לגישה לשירותי Google Cloud 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>"
        }
    }
}