Specifica delle dipendenze

Puoi dichiarare le dipendenze per 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 Il runtime PHP.

Installazione ed esecuzione in locale

Utilizza composer per installare le dipendenze localmente:

composer install

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

Puoi testare la tua applicazione utilizzando il server web che preferisci. L'ambiente flessibile di App Engine utilizza NGINX in produzione. Per eseguire rapidamente la tua applicazione, puoi utilizzare il server web integrato 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 usare qualsiasi framework web con gli ambienti flessibili di App Engine, tra cui:

Per utilizzare un framework web specifico, è sufficiente aggiungerlo a composer.json:

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

Installazione delle librerie client di Cloud

La libreria client di Google Cloud per PHP è una libreria client per l'accesso ai servizi Google Cloud che riduce il codice boilerplate da scrivere. La libreria fornisce astrazioni API di alto livello e facilmente comprensibili. Supporta le espressioni idiomatiche di PHP, funziona bene con la libreria standard e ha un'integrazione più stretta con il codebase. Tutto questo significa che potrai dedicare più tempo alla creazione del codice che conta per te.

  1. Installa la libreria localmente:

    composer require google/cloud
    
  2. Puoi gestire l'autenticazione in locale utilizzando Google Cloud CLI. Se vuoi che l'applicazione locale utilizzi temporaneamente le tue credenziali utente per l'accesso all'API, esegui:

    gcloud auth application-default login
    

    Per maggiori dettagli sulla configurazione delle librerie client di Cloud per PHP per la gestione automatica dell'autenticazione, vedi Autenticazione nei servizi Cloud utilizzando le librerie client.

Utilizzo dei repository privati

Per utilizzare le librerie in 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 dall'interfaccia utente amministrativa di GitHub.

Ecco 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>"
            }
        }
    }