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 il giorno
Febbraio 2020, REGION_ID.r
è incluso in
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 illustra come creare ed eseguire il deployment di un'app che visualizza
un breve messaggio. Puoi utilizzare l'applicazione di esempio in questa guida rapida per qualsiasi versione supportata di PHP, specificando la versione del runtime e il sistema operativo nel file app.yaml
.
Prima di iniziare
- 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.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Make sure that billing is enabled for your Google Cloud project.
-
Enable the Cloud Build API.
- Install the Google Cloud CLI.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Make sure that billing is enabled for your Google Cloud project.
-
Enable the Cloud Build API.
- Install the Google Cloud CLI.
-
To initialize the gcloud CLI, run the following command:
gcloud init
Prerequisiti aggiuntivi
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.
Installa i seguenti prerequisiti:
- Scarica e installare Git.
- Installa PHP
Per gestire le dipendenze, scarica Composer e assicurati che l'eseguibile di Composer sia installato a livello globale.
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à è fondamentale i fattori necessari per selezionare la regione in cui vengono eseguite le tue app. In genere, puoi seleziona la regione più vicina agli utenti della tua app, ma devi considerare località in cui è disponibile App Engine nonché le località dell'altro Prodotti e servizi Google Cloud utilizzati dalla tua app. Utilizzo dei servizi in più località può influire sulla latenza dell'app e sulle sue determinati del prezzo.
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:
Esegui il comando
gcloud app describe
.Apri l'app Dashboard di App Engine nella console Google Cloud. L'area viene visualizzata vicino alla parte superiore della pagina.
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.
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.
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:
Installa le dipendenze.
composer install
Avvia un server web locale.
php -S localhost:8080 -t web/
Nel browser web, inserisci il seguente indirizzo:
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 in App Engine, procedi nel seguente modo: in un ambiente flessibile:-
Esegui il deployment dell'app Hello World eseguendo questo dalla directory
appengine/flexible/helloworld
:gcloud app deploy
Scopri di più sulla e i flag facoltativi.
Flag dei comandi
gcloud
comuni-
Includi il flag
--version
per specificare un ID che identifichi in modo univoco la versione della tua app, altrimenti ne verrà generato uno per te. Esempio:--version [YOUR_VERSION_ID]
-
Includi il flag
--project
per specificare un'alternativa dall'ID progetto Google Cloud a quello che hai inizializzato come per impostazione predefinita nello strumentogcloud
. 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. -
Includi il flag
-
Avvia il browser per visualizzare l'app all'indirizzo
https://PROJECT_ID.REGION_ID.r.appspot.com
dovegcloud app browse
PROJECT_ID
rappresenta il tuo Google Cloud dell'ID progetto.
Questa volta la pagina che visualizza il messaggio Hello World viene consegnata da un in esecuzione su un'istanza di App Engine.
Complimenti! Hai eseguito il deployment della tua prima app di App Engine 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 arrestare e la fatturazione per tutte le risorse utilizzate all'interno del progetto.
- In the Google Cloud console, go to the Manage resources page.
- In the project list, select the project that you want to delete, and then click Delete.
- 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 conoscere 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 nel dettaglio ogni file dell'app.
index.php
Il file index.php
contiene il codice PHP per avviare un server e rispondere a
richieste. Questo esempio utilizza
Sottile
ma puoi utilizzare altri
Framework web PHP.
Questo codice crea un nuovo oggetto Application
Slim e definisce quindi due diversi
GET
route:
app.yaml
La 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.
Per ulteriori informazioni sul funzionamento del runtime PHP, consulta: Il runtime di PHP.
Per ulteriori dettagli su come progettare l'app in modo da sfruttare le versioni e i servizi, consulta Panoramica di App Engine.
Per ulteriori dettagli sulle impostazioni di configurazione per App Engine, vedi Configurazione dell'app con app.yaml.
composer.json
composer.json
viene utilizzato per dichiarare, installare e aggiornare le dipendenze dell'applicazione: