Creare un'app PHP nell'ambiente flessibile di App Engine

ID regione

REGION_ID è un codice abbreviato assegnato da Google in base alla regione selezionata al momento della creazione dell'app. Il codice non corrispondono a un paese o a una provincia, anche se potrebbero essere visualizzati alcuni ID regione in modo simile ai codici paese e provincia di uso comune. Per le app create dopo febbraio 2020, REGION_ID.r è incluso negli URL di App Engine. Per le app esistenti create prima di questa data, l'ID regione è facoltativo nell'URL.

Scopri di più sugli ID regione.

Questa guida rapida mostra come creare ed eseguire il deployment di un'app che visualizza un breve messaggio. Puoi utilizzare l'applicazione di esempio in questa guida introduttiva per qualsiasi versione supportata di PHP, specificando la versione del runtime e il sistema operativo nel file app.yaml.

Prima di iniziare

  1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

  2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

  3. Make sure that billing is enabled for your Google Cloud project.

  4. Enable the Cloud Build API.

    Enable the API

  5. Install the Google Cloud CLI.

  6. To initialize the gcloud CLI, run the following command: 

    gcloud init

  7. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

  8. Make sure that billing is enabled for your Google Cloud project.

  9. Enable the Cloud Build API.

    Enable the API

  10. Install the Google Cloud CLI.

  11. To initialize the gcloud CLI, run the following command: 

    gcloud init

Prerequisiti aggiuntivi

  1. Inizializza la tua app App Engine con il tuo progetto e scegli la relativa area geografica:

    gcloud app create --project=[YOUR_PROJECT_ID]

    Quando richiesto, seleziona la regione in cui vuoi individuare la tua applicazione App Engine.

  2. Installa quanto segue sulla tua macchina locale:

Località App Engine

App Engine è regionale, il che significa che l'infrastruttura che esegue le tue app che si trovano in una regione specifica e Google la gestisce in modo che sia disponibile in modo ridondante tutte le zone all'interno di quella regione.

Soddisfare i requisiti di latenza, disponibilità o durabilità è uno dei fattori principali per la scelta della regione in cui vengono eseguite le app. In genere puoi selezionare la regione più vicina agli utenti della tua app, ma devi prendere in considerazione le località in cui è disponibile App Engine, nonché le località degli altri prodotti e servizi Google Cloud utilizzati dalla tua app. L'utilizzo di servizi in più località può influire sulla latenza e sul prezzo della tua app.

Non puoi modificare la regione di un'app dopo averla impostata.

Se hai già creato un'applicazione App Engine, puoi visualizzarne la regione effettuando una delle seguenti operazioni:

Questa guida rapida presuppone che tu abbia familiarità con il linguaggio di programmazione PHP.

scarica l'app Hello World

Abbiamo creato un'app Hello World per App Engine, così potrai rapidamente avere un'idea generale del deployment di un'app in Google Cloud.

  1. Clona il repository dell'app di esempio Hello World sulla tua macchina locale.

    git clone https://github.com/GoogleCloudPlatform/php-docs-samples.git

    In alternativa puoi scaricare l'esempio come file ZIP ed estrarlo.

  2. Passa alla directory che contiene il codice campione.

       cd php-docs-samples/appengine/flexible/helloworld

Esegui Hello World sul computer locale

Per eseguire l'applicazione Hello World nel computer locale:

  1. Installare le dipendenze.

    composer install

  2. Avvia un server web locale.

    php -S localhost:8080 -t web/

  3. Nel browser web, inserisci il seguente indirizzo:

    http://localhost:8080

Nella pagina viene visualizzato il messaggio Hello World dell'app di esempio. Nel tuo premi Ctrl+C per uscire dal server web.

Esegui il deployment di Hello World e avviala in App Engine

Per eseguire il deployment dell'app nell'ambiente flessibile di App Engine:

  1. Esegui il deployment dell'app Hello World eseguendo il comando seguente dalla directory appengine/flexible/helloworld: 

    gcloud app deploy

    Scopri di più sui flag facoltativi.

    Flag dei comandi gcloud comuni

    • Includi il flag --version per specificare un ID univoco identifica la versione dell'app, altrimenti ne viene generata una per te. Esempio: --version [YOUR_VERSION_ID]
    • Includi il flag --project per specificare un ID progetto Google Cloud alternativo rispetto a quello inizializzato come predefinito nello strumento gcloud. Esempio: --project [YOUR_PROJECT_ID]

    Esempio:

    gcloud app deploy --version pre-prod-5 --project my-sample-app

    Per scoprire di più sul deployment della tua app dalla riga di comando, vedi Test e deployment dell'app di Google. Per un elenco di tutti i flag dei comandi, vedi gcloud app deploy riferimento.

  2. Avvia il browser per visualizzare l'app all'indirizzo https://PROJECT_ID.REGION_ID.r.appspot.com 

    gcloud app browse
     dove PROJECT_ID rappresenta il tuo Google Cloud dell'ID progetto.

Questa volta, la pagina che mostra il messaggio Hello World viene pubblicata da un server web in esecuzione su un'istanza App Engine.

Complimenti! Hai eseguito il deployment della tua prima app App Engine nell'ambiente flessibile di App Engine.

Se hai riscontrato errori durante il deployment dell'applicazione, consulta i suggerimenti per la risoluzione dei problemi.

Consulta le sezioni seguenti per informazioni sulla pulizia e sui possibili passaggi successivi da intraprendere.

Esegui la pulizia

Per evitare addebiti, puoi eliminare il tuo progetto Google Cloud per interrompere la fatturazione per tutte le risorse utilizzate al suo interno.

  1. In the Google Cloud console, go to the Manage resources page.

    Go to Manage resources

  2. In the project list, select the project that you want to delete, and then click Delete.
  3. In the dialog, type the project ID, and then click Shut down to delete the project.

Passaggi successivi

Impara a conoscere l'intera piattaforma

Ora che sai com'è sviluppare ed eseguire il deployment delle app di App Engine, puoi esplorare il resto di Google Cloud. Hai già Google Cloud CLI installato, che ti offre gli strumenti per interagire come Cloud SQL, Cloud Storage, Firestore e altro ancora.

Scopri di più sull'ambiente flessibile di App Engine

Ecco alcuni argomenti che ti aiuteranno a continuare a imparare su App Engine:

Revisione del codice Hello World

Hello World è l'app App Engine più semplice possibile, in quanto contiene un solo servizio, ha una sola versione e tutto il codice si trova nella directory principale dell'app. Questa sezione descrive in dettaglio ogni file dell'app.

index.php

Il file index.php contiene il codice PHP per avviare un server e rispondere alle richieste. Questo esempio utilizza Slim, ma puoi utilizzare altri framework web PHP.

Questo codice crea un nuovo oggetto Application Slim e poi definisce due diversi percorsiGET:

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

use Psr\Http\Message\ServerRequestInterface as Request;
use Psr\Http\Message\ResponseInterface as Response;
use Slim\Factory\AppFactory;

// Create App
$app = AppFactory::create();

// Display errors
$app->addErrorMiddleware(true, true, true);

$app->get('/', function (Request $request, Response $response) {
    $response->getBody()->write('Hello World');
    return $response;
});

$app->get('/goodbye', function (Request $request, Response $response) {
    $response->getBody()->write('Goodbye World');
    return $response;
});

// @codeCoverageIgnoreStart
if (PHP_SAPI != 'cli') {
    $app->run();
}
// @codeCoverageIgnoreEnd

return $app;

app.yaml

Il file app.yaml descrive la seguente configurazione per la tua app:

  • Imposta env: flex, a indicare che la tua app utilizza Ambiente flessibile di App Engine.

  • Specifica il runtime utilizzato dall'app. 

    runtime: php
env: flex

runtime_config:
  document_root: web
  operating_system: ubuntu22
  runtime_version: 8.3

# This sample incurs costs to run on the App Engine flexible environment.
# The settings below are to reduce costs during testing and are not appropriate
# for production use. For more information, see:
# https://cloud.google.com/appengine/docs/flexible/php/configuring-your-app-with-app-yaml
manual_scaling:
  instances: 1
resources:
  cpu: 1
  memory_gb: 0.5
  disk_size_gb: 10

    composer.json

    composer.json viene utilizzato per dichiarare, installare e aggiornare le dipendenze dell'applicazione:

    {
  "require": {
    "slim/slim": "^4.0",
    "slim/psr7": "^1.3"
  }
}