Con App Engine puoi creare applicazioni web utilizzando il linguaggio di programmazione PHP. L'applicazione PHP viene eseguita sull'infrastruttura scalabile di Google e utilizza servizi e archiviazione permanente su larga scala.
Selezione del runtime PHP
App Engine esegue l'applicazione web PHP utilizzando un interprete PHP 5.5.34. Nota: su Linux devi anche installare PHP localmente per eseguire le tue app PHP.
Per impostare l'app in modo che utilizzi il runtime PHP, aggiungi quanto segue al file app.yaml
:
runtime: php55
api_version: 1
...
Il primo elemento, runtime
, seleziona l'ambiente di runtime PHP.
Il secondo elemento, api_version
, seleziona la versione dell'ambiente di runtime PHP da utilizzare. Al momento della stesura di questo articolo, App Engine ha una sola versione
dell'ambiente PHP, 1
. Se in futuro verranno apportate modifiche che potrebbero non essere compatibili con le versioni precedenti, il team di App Engine utilizzerà un nuovo identificatore di versione. L'app continuerà a utilizzare la versione selezionata finché non cambierai
l'impostazione api_version
e caricherai l'app.
Per ulteriori informazioni sul file app.yaml
e su come eseguire il deployment dell'app in App Engine, consulta gli argomenti Guida di riferimento a app.yaml
e Eseguire il deployment di un'app PHP.
La sandbox
Per consentire ad App Engine di distribuire le richieste per le applicazioni su più server web e per impedire a un'applicazione di interferire con un'altra, l'applicazione viene eseguita in un ambiente "sandbox" limitato. In questo ambiente, l'applicazione può eseguire codice, utilizzare la posta di App Engine, recuperare gli URL e i servizi per gli utenti, esaminare la richiesta web dell'utente e preparare la risposta.
Un'applicazione App Engine non può:
scrivere nel file system. Le applicazioni PHP possono utilizzare Google Cloud Storage per memorizzare i file permanenti. La lettura dal file system è consentita e tutti i file dell'applicazione caricati con l'applicazione sono disponibili.
risponde lentamente. Una richiesta web a un'applicazione deve essere gestita entro pochi secondi. I processi che richiedono molto tempo per rispondere vengono interrotti per evitare di sovraccaricare il server web.
effettuare altri tipi di chiamate di sistema.
Caricamento automatico dei corsi
Sia le classi della libreria PHP standard (SPL) sia le eventuali classi che fanno parte dell'SDK per App Engine vengono caricate automaticamente quando necessario. Ciò significa che non devi utilizzare istruzioni include
o require
nella parte superiore degli script PHP.
Per impostazione predefinita, il caricamento automatico delle classi avviene solo per le classi definite nei file
che si trovano nella home directory dell'SDK per App Engine (e, se è stato specificato da --php_executable_path
, nella tua installazione PHP locale).
Per aggiungere altri percorsi da cercare per il caricamento automatico delle classi, utilizza
set_include_path
nello script PHP.
set_include_path('my_additional_path' . PATH_SEPARATOR . get_include_path());
Estensioni attivate
Le seguenti estensioni sono state attivate nel runtime PHP per App Engine:
- apc
- bcmath
- calendario
- Nucleo
- ctype
- data
- dom
- ereg
- exif
- filtro
- ftp
- gd
- hash
- iconv
- json
- libxml
- mailparse
- mbstring
- mcrypt
- memcache
- memcached
- mysql
- mysqli
- mysqlnd
- OAuth
- openssl
- pcre
- PDO
- pdo_mysql
- Riflessione
- sessione
- shmop
- SimpleXML
- sapone
- socket (per le app con fatturazione abilitata)
- SPL
- standard
- tokenizzatore
- xml
- xmlreader
- xmlwriter
- xsl
- zip
- zlib
Estensioni caricabili dinamicamente
Le seguenti estensioni sono caricabili dinamicamente configurando php.ini
.
- cURL: questa estensione utilizza il servizio socket per effettuare richieste ed è soggetta alle quote e alle limitazioni di questi servizi. Per ulteriori informazioni, consulta la sezione Richieste in uscita.
- MongoDB: questa estensione consente a un sviluppatore di connettersi a un'istanza MongoDB esistente. Utilizza il servizio socket per effettuare richieste ed è soggetto alle quote e alle limitazioni di questi servizi.
- ImageMagick
- intl
- fileinfo
Per attivare queste estensioni, aggiungi le relative direttive nel file php.ini
in extension
nel seguente modo:
extension = "curl.so"
extension = "mongo.so"
extension = "imagick.so"
extension = "intl.so"
extension = "fileinfo.so"
Sessioni
La maggior parte delle applicazioni web ha bisogno di un modo per conservare le informazioni sullo stato dell'utente tra le richieste. PHP fornisce un pratico livello di gestione delle sessioni. Le sessioni in App Engine funzionano in modo molto simile alle sessioni in qualsiasi altra applicazione PHP.
Impostazione di una variabile nella sessione di un utente:
session_start();
$_SESSION['Foo'] = 'Bar';
Su una richiesta successiva dello stesso utente:
session_start();
print $_SESSION['Foo']; // prints Bar
Per impostazione predefinita, il runtime di App Engine utilizzerà memcache per memorizzare le informazioni sulla sessione utilizzando la classe MemcacheSessionHandler
. Puoi modificare questo comportamento specificando il tuo gestore della sessione utilizzando il metodo session_set_save_handler()
di PHP. Memcache consente di salvare e recuperare rapidamente i dati della sessione, il che significa che il sovraccarico della richiesta è minimo. Tuttavia, i dati nella cache memorizzata di App Engine potrebbero essere svuotati periodicamente, il che significa che tutte le informazioni sulla sessione andranno perse. Per sessioni più durature, può essere preferibile utilizzare un servizio di archiviazione alternativo come Cloud SQL.
Chiavi speciali $_SERVER
PHP rende disponibile l'array speciale $_SERVER[]
nell'ambito della richiesta. Oltre ai parametri CGI standard, App Engine aggiunge alcune chiavi utili aggiuntive.
APPLICATION_ID
: l'app_id dell'applicazione impostato al momento della creazione dell'app, ad esempio my-wordpressAUTH_DOMAIN
: il dominio utilizzato per autenticare gli utenti con l'API Users. Le app ospitate su appspot.com hanno un valore AUTH_DOMAIN di gmail.com e accettano qualsiasi Account Google. Le app ospitate su un dominio personalizzato che utilizzano Google Workspace hanno un valore AUTH_DOMAIN uguale al dominio personalizzatoCURRENT_VERSION_ID
: la versione maggiore e minore dell'applicazione attualmente in esecuzione, ad esempio "X.Y". Il numero di versione principale ("X") è specificato nel file app.yaml dell'app. Il numero della versione secondaria ("Y") viene impostato automaticamente quando ogni versione dell'app viene caricata su App Engine. Sul server web di sviluppo, la versione minore è sempre "1".DEFAULT_VERSION_HOSTNAME
: il nome host della versione predefinita di questa applicazione, ad esempio my-php-app.uc.r.appspot.com.HTTP_X_APPENGINE_CITY
: il nome della città da cui ha avuto origine la richiesta. Ad esempio, una richiesta dalla città di Mountain View potrebbe avere il valore dell'intestazione mountain view.HTTP_X_APPENGINE_CITYLATLONG
- Latitudine e longitudine della città da cui ha avuto origine la richiesta. Questa stringa potrebbe essere "37.386051,-122.083851" per una richiesta da Mountain View.HTTP_X_APPENGINE_COUNTRY
- Il paese da cui ha avuto origine la richiesta, come codice paese ISO 3166-1 alpha-2. App Engine determina questo codice dall'indirizzo IP del client.HTTP_X_APPENGINE_REGION
: il nome della regione da cui ha avuto origine la richiesta. Questo valore ha senso solo nel contesto del paese inX-Appengine-Country
. Ad esempio, se il paese è "US" e la regione è "ca", "ca" significa "California", non Canada.USER_EMAIL
: restituisce l'indirizzo email dell'utente, se è stato autenticato utilizzando l'API Users. Le applicazioni devono utilizzare il nickname per i nomi visualizzabili.USER_ID
: se l'indirizzo email è associato a un Account Google, user_id restituisce l'ID permanente univoco dell'utente, una stringa. Se l'utente è stato autenticato utilizzando l'API Users. Questo ID è sempre lo stesso per l'utente, indipendentemente dal fatto che l'utente modifichi il proprio indirizzo email.USER_IS_ADMIN
- 1 se l'utente che ha eseguito l'accesso è anche un amministratore dell'applicazione e se è stato autenticato utilizzando l'API Users. 0 in caso contrario.USER_NICKNAME
: per gli utenti con Account Google, il nickname è la parte "nome" dell'indirizzo email dell'utente se l'indirizzo si trova nello stesso dominio dell'applicazione oppure l'indirizzo email completo dell'utente in caso contrario.USER_ORGANIZATION
: un'applicazione che utilizza l'impostazione Account Google può determinare se l'utente che ha eseguito l'accesso sta utilizzando un Account Google personale o un account gestito da un dominio Google Workspace.
Comportamento aggiornato di PHP_SELF
e SCRIPT_NAME
nella versione 1.9.0
L'implementazione di $_SERVER['SCRIPT_NAME']
e $_SERVER['PHP_SELF'
] precedente alla versione 1.9.0 è molto diversa da quella successiva alla versione 1.9.0. Le modifiche sono state apportate per essere coerenti con l'implementazione di Apache generalmente prevista dalle applicazioni PHP.
I seguenti esempi mostrano la differenza.
Prima della versione 1.9.0 | Dopo la versione 1.9.0 |
---|---|
app.yaml: - url: /.* script: index.php |
|
REQUEST_URI: / SCRIPT_FILENAME: /path/to/index.php SCRIPT_NAME: / PHP_SELF: / |
REQUEST_URI: / SCRIPT_FILENAME: /path/to/index.php SCRIPT_NAME: /index.php PHP_SELF: /index.php |
REQUEST_URI: /bar SCRIPT_FILENAME: /path/to/index.php SCRIPT_NAME: /bar PHP_SELF: /bar |
REQUEST_URI: /bar SCRIPT_FILENAME: /path/to/index.php SCRIPT_NAME: /index.php PHP_SELF: /index.php |
REQUEST_URI: /index.php/foo/bar SCRIPT_FILENAME: /path/to/index.php SCRIPT_NAME: /index.php/foo/bar PHP_SELF: /index.php/foo/bar |
REQUEST_URI: /index.php/foo/bar SCRIPT_FILENAME: /path/to/index.php SCRIPT_NAME: /index.php PHP_SELF: /index.php/foo/bar |
REQUEST_URI: /test.php/foo/bar SCRIPT_FILENAME: /path/to/index.php SCRIPT_NAME: /test.php/foo/bar PHP_SELF: /test.php/foo/bar |
REQUEST_URI: /test.php/foo/bar SCRIPT_FILENAME: /path/to/index.php SCRIPT_NAME: /index.php PHP_SELF: /index.php |
app.yaml: - url: /.* script: foo/index.php |
|
REQUEST_URI: /bar SCRIPT_FILENAME: /path/to/foo/index.php SCRIPT_NAME: /bar PHP_SELF: /bar |
REQUEST_URI: /bar SCRIPT_FILENAME: /path/to/foo/index.php SCRIPT_NAME: /foo/index.php PHP_SELF: /foo/index.php |
Direttive con nuove impostazioni predefinite di inizializzazione
Questa tabella specifica le direttive di cui i valori predefiniti di inizializzazione sono diversi da quelli forniti con l'interprete PHP standard disponibile su php.net. Puoi eseguire l'override di queste direttive predefinite includendole in un file php.ini per la tua applicazione.
Direttiva | Valore predefinito in App Engine |
---|---|
detect_unicode |
false |
session.gc_maxlifetime |
600 |
session.cookie_secure |
600 |
session.cookie_httponly |
1 |
session.use_only_cookies |
1 |
display_errors |
0 |
display_startup_errors |
0 |
html_errors |
0 |
log_errors |
1 |
file_uploads |
0 |
upload_max_filesize |
262144 |
max_file_uploads |
0 |
date.timezone |
UTC |
sendmail_path |
null |
allow_url_fopen |
1 |
allow_url_include |
0 |
enable_dl |
0 |
expose_php |
Off |
register_globals |
Off |
magic_quotes_gpc |
0 |
mysqlnd.collect_statistics |
0 |
mysql.allow_local_infile |
0 |
mysqli.allow_local_infile |
0 |
Funzioni disattivate
Per motivi di sicurezza o per compatibilità con l'ambiente di esecuzione di App Engine, alcune funzioni PHP sono state disattivate. Alcune di queste funzioni possono essere riattivate esplicitamente nel file php.ini per la tua applicazione.
Funzioni disattivate definitivamente
Le seguenti funzioni sono state disattivate definitivamente in App Engine:
disk_free_space()
disk_total_space()
diskfreespace()
escapeshellarg() and escapeshellcmd()
exec()
highlight_file()
lchgrp(), lchown(), link(), and symlink()
passthru()
pclose() and popen()
proc_close(), prog_get_status(), proc_nice(), proc_open(), and proc_terminate()
set_time_limit()
shell_exec()
show_source()
system()
App Engine non include l'estensione pcntl, pertanto le funzioni fornite da pcntl
non sono disponibili per le app PHP in esecuzione in App Engine.
Assistenza tempnam()
e sys_get_temp_dir()
Le app App Engine vengono eseguite in una sandbox di sicurezza che non consente di scrivere nel filesystem locale. Per questo motivo, la versione di tempnam()
di App Engine restituisce un file temporaneo in memoria che può essere scritto in una soluzione di archiviazione permanente come i bucket Google Cloud Storage in un secondo momento.
Ecco un esempio di scrittura nel file temporaneo in memoria utilizzando
file_put_contents()
e fwrite()
.
<?php
$dir = sys_get_temp_dir();
$tmp = tempnam($dir, “foo”);
file_put_contents($tmp, “hello”)
$f = fopen($tmp, “a”);
fwrite($f, “ world”);
fclose($f)
echo file_get_contents($tmp);
L'output previsto dall'esempio sarà quindi:
hello world
Funzioni parzialmente limitate
Il runtime App Engine per PHP non supporta il modificatore di pattern /e
delle funzioni preg_replace()
e mb_ereg_replace()
. Consulta la documentazione di PREG_REPLACE_EVAL
per la notifica di ritiro e un esempio di come aggiornare il codice in modo da utilizzare preg_replace_callback()
.
Funzioni che possono essere attivate manualmente
Questo elenco specifica la funzione PHP che deve essere attivata manualmente utilizzando la direttiva google_app_engine.enable_functions
nel file php.ini per l'applicazione.
gc_collect_cycles()
,gc_enable()
,gc_disable()
egc_enabled()
getmypid()
getmyuid()
egetmygid()
getrusage()
getmyinode()
get_current_user()
libxml_disable_entity_loader()
*parse_str()
phpinfo()
phpversion()
php_uname()
php_sapi_name()
Puoi anche disattivare manualmente le funzioni utilizzando la direttiva disable_functions
nel file php.ini della tua applicazione.
Funzionalità che richiedono l'abilitazione della fatturazione
Le seguenti funzioni utilizzano i socket e sono quindi disponibili solo per le app con fatturazione abilitata.
- Tutte le funzioni di rete tranne
gethostname()
- Tutte le funzioni Sockets
- Tutte le funzioni FTP
- cURL, a meno che non utilizzi cURL Lite
Connessioni TCP/IP ai server MySQL (Cloud SQL può essere utilizzato solo con un socket UNIX)
Assistenza per gli stream
Wrapper dello stream I/O PHP supportati
Sono supportati i seguenti wrapper stream di I/O PHP:
- php://input
- php://output
- php://memory
- php://temp
Wrapper di stream
Molte funzioni in PHP, come fopen()
o file_get_contents()
, sfruttano
l'interfaccia degli stream di PHP per supportare diversi protocolli.
Di seguito è riportato un elenco di wrapper dello stream integrati che vengono registrati automaticamente e sono disponibili nel runtime di App Engine.
file://
glob://
http://
(si comporta come il gestore dello stream HTTP incorporato di PHP, ma utilizza il servizio URLfetch di App Engine)https://
(viene utilizzato il servizio URLfetch di App Engine)ftp://
gs://
(l'handler dello stream per Google Cloud Storage)zlib://
Di seguito è riportato un elenco di gestori di stream integrati non supportati in App Engine e che non sono stati registrati.
data://
expect://
ogg://
phar://
rar://
ssh2://
Trasporti di stream disattivati
I seguenti trasporti di stream sono stati disattivati.
ssl
sslv2
sslv3
tcp
tls
udg
udp
unix
PHP puro
Tutto il codice per l'ambiente di runtime PHP deve essere PHP puro. App Engine non ti consente di caricare le tue estensioni C.
L'ambiente include la libreria standard PHP. Alcune estensioni sono state disabilitate perché le loro funzioni di base non sono supportate da App Engine, ad esempio la rete e la scrittura nel file system.
Puoi includere altre librerie PHP pure nella tua applicazione inserendo il codice nella directory dell'applicazione, ovvero la stessa directory che contiene il file app.yaml
.
Ad esempio, puoi creare un link simbolico nella directory dell'applicazione che rimandi alla directory di una libreria. Il link viene seguito e la raccolta viene inclusa nell'applicazione quando esegui il deployment in App Engine.
Puoi anche includere le librerie PHP specificando le direttive php.ini
e includendo le istruzioni PHP include
nel codice. Tuttavia, l'alternativa preferita è utilizzare uno strumento di gestione delle dipendenze PHP come Composer.
Esempi:
Se includi la directory principale dell'applicazione nella direttiva
include_path
del filephp.ini
:include_path=".:/[ROOT_DIR]/myapp"
Puoi quindi utilizzare le istruzioni
include
oinclude_once
per includere i file PHP relativi al tuoinclude_path
:include_once 'myfile.php';
Se scegli di utilizzare Composer per includere le tue librerie PHP pure, puoi semplicemente includere un singolo file dopo l'installazione delle dipendenze:
require_once 'vendor/autoload.php';
Quando utilizzi Composer per installare le dipendenze dell'applicazione, tutti i pacchetti vengono aggiunti nella directory dell'applicazione in
vendor
, dove viene generato anche il fileautoload.php
.
Strumenti
L'SDK per App Engine include strumenti per testare l'applicazione e caricare i file dell'applicazione.
Il server di sviluppo esegue la tua applicazione sul computer locale per testarla.
Lo strumento gcloud
gestisce tutte le interazioni a riga di comando con l'applicazione in esecuzione su App Engine. Utilizza gcloud app deploy
per caricare l'applicazione su App Engine o per aggiornare i singoli file di configurazione. Puoi anche visualizzare i dati dei log della tua app, in modo da analizzare il rendimento dell'app utilizzando i tuoi strumenti.
Codice sorgente dell'interprete PHP
Puoi scaricare il codice sorgente dell'interprete PHP di App Engine dal repository appengine-php in GitHub.
Concorrenza e latenza
La latenza dell'applicazione ha l'impatto maggiore sul numero di istanze necessarie per gestire il traffico. Se elabori le richieste rapidamente, una singola istanza può gestire molte richieste.
Variabili di ambiente
Le seguenti variabili di ambiente vengono impostate dal runtime:
Variabile di ambiente | Descrizione |
---|---|
GAE_APPLICATION
|
L'ID della tua applicazione App Engine. Questo ID è preceduto da "region code~", ad esempio "e~" per le applicazioni di cui è stato eseguito il deployment in Europa. |
GAE_DEPLOYMENT_ID |
L'ID del deployment corrente. |
GAE_ENV |
L'ambiente App Engine. Imposta su standard . |
GAE_INSTANCE |
L'ID dell'istanza su cui è attualmente in esecuzione il servizio. |
GAE_RUNTIME |
Il runtime specificato nel file app.yaml . |
GAE_SERVICE |
Il nome del servizio specificato nel file app.yaml . Se non viene specificato alcun nome di servizio, viene impostato su default . |
GAE_VERSION |
L'etichetta della versione corrente del servizio. |
GOOGLE_CLOUD_PROJECT |
L'ID progetto Google Cloud associato alla tua applicazione. |
PORT |
La porta che riceve le richieste HTTP. |
Puoi definire variabili di ambiente aggiuntive nel file app.yaml
, ma i valori riportati sopra non possono essere sostituiti.