Utilizzo delle librerie PHP

Puoi dichiarare le dipendenze di PHP in un file composer.json standard. Ad esempio:

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

In App Engine puoi utilizzare qualsiasi pacchetto PHP compatibile con Linux. Il runtime cerca un file composer.json nella directory di origine dell'applicazione e utilizza composer per installare le dipendenze prima di avviare l'applicazione.

Per informazioni sulle versioni PHP supportate in questo runtime, consulta PHIT Runtime.

Installazione ed esecuzione in locale

Utilizza Composer per installare le dipendenze in locale.

composer install

Per bloccare le dipendenze nella versione corrente, esegui il commit del file composer.lock nell'applicazione.

Puoi testare l'applicazione utilizzando un server web di tua scelta. L'ambiente flessibile di App Engine utilizza NGINX in produzione. Per eseguire rapidamente l'applicazione, puoi utilizzare il server web incorporato di PHP.

Installazione di un framework web

Per impostazione predefinita, NGINX è configurato per gestire tutte le richieste tramite index.php. Un framework non è obbligatorio, ma è consigliato. Puoi utilizzare qualsiasi framework web con gli ambienti flessibili di App Engine, inclusi:

Per utilizzare un determinato framework web, devi solo aggiungerlo a composer.json:

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

Installazione della libreria client di Google Cloud

La libreria client di Google Cloud per PHP è una libreria client per accedere ai servizi Google Cloud che riduce il codice boilerplate che devi scrivere. La libreria fornisce astrazioni API di alto livello e facili da comprendere. Accetta le espressioni idiomatiche di PHP, funziona bene con la libreria standard e offre una migliore integrazione con il codebase. Ciò significa che dovrai dedicare più tempo alla creazione del codice che ti interessa.

Per installare la libreria localmente:

composer require google/cloud

Puoi gestire l'autenticazione in locale utilizzando l'interfaccia a riga di comando di Google Cloud. Se vuoi che la tua applicazione locale utilizzi temporaneamente le tue credenziali utente per l'accesso all'API, esegui:

gcloud auth application-default login

Per gestire manualmente l'autenticazione o per ulteriori informazioni, consulta la sezione Fornire credenziali per l'applicazione.

Utilizzo dei repository privati

Per utilizzare le librerie nei repository privati, devi completare le seguenti attività:

  • Configura il repository.
  • Fornisci a composer il secret per accedere al repository privato.

L'esempio seguente illustra come accedere a un repository privato in GitHub.

  1. Configura il repository in composer.json utilizzando vcs per il tipo:

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

  2. Crea un file denominato auth.json nella directory principale del progetto:

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

Puoi ottenere il token di autenticazione GitHub dalla UI amministrativa di GitHub.

Un altro esempio che illustra come accedere a un repository privato per Bitbucket.

  1. Configura il repository in composer.json utilizzando vcs per il tipo:

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

  2. Crea un file denominato auth.json nella directory principale del progetto:

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