Il runtime PHP è lo stack software responsabile dell'installazione del codice e delle sue dipendenze e dell'esecuzione del servizio.
Per specificare PHP 7/8 per l'ambiente standard di App Engine, dichiara il runtime nel file app.yaml
. Ad esempio:
runtime: phpVERSION
Dove VERSION è il numero di versione PHP MAJOR MINOR
. Ad esempio, PHP
8.3 utilizza 83
.
Per le altre versioni PHP supportate e la versione di Ubuntu corrispondente alla tua versione PHP, consulta la pianificazione del supporto dell'esecuzione.
Versione PHP
Il runtime PHP utilizza l'ultima release stabile della versione specificata nel file app.yaml
. App Engine si aggiorna automaticamente alle nuove versioni di release
della patch, ma non aggiorna automaticamente la versione secondaria.
Ad esempio, è possibile che il deployment dell'app sia stato eseguito in PHP 7.3.0 e in seguito venga aggiornata automaticamente alla versione 7.3.1, ma non alla versione PHP 7.4.0.
Avvio dell'app
Dovrai eseguire il deployment di un controller frontale per gestire tutti il routing delle richieste.
I seguenti esempi mostrano diversi modi per pubblicare la tua app:
Se l'app contiene un file
public/index.php
oindex.php
, App Engine utilizza questo file per pubblicare l'app.Ti consigliamo di utilizzare un framework, ad esempio Laravel, Symfony o Slim, perché offre un routing leggero per la scrittura e il deployment rapido delle app PHP. Guarda un esempio di controller frontale Slim.
Tuttavia, se esegui la migrazione di un'app legacy, guarda il seguente file
index.php
di esempio per importare i file PHP di cui hai bisogno e implementare manualmente il front controller:Se specifichi l'elemento
entrypoint
facoltativo nel fileapp.yaml
, App Engine utilizza il comando nell'elementoentrypoint
per pubblicare la tua app anziché utilizzarepublic/index.php
oindex.php
:entrypoint: serve path/to/my/front/controller.php
Il campo
entrypoint
utilizza il comandoserve
integrato, un programma all'interno dei runtime PHP 7/8 che avvia l'implementazionephp-fpm
e un webserver in background. Questo server web instrada tutto il traffico al file PHP fornito utilizzando il pattern di progettazione del front controller.Il comando
serve
ha due flag facoltativi:--workers=N
: specifica il numero N diphp-fpm
worker. Se non imposti il flag--workers
, il comandoserve
indovina il numero di worker in base alla quantità di memoria disponibile. Per ottenere risultati ottimali, imposta i valori del flag--workers
nel comandoserve
e dell'elementomax_concurrent_requests
in modo che siano uguali.--enable-dynamic-workers
: specifica che vuoi che i workerphp-fpm
vengano generati solo secondo le necessità. L'impostazione predefinita prevede l'utilizzo di un criterio statico per i workerphp-fpm
. Puoi modificare il numero massimo di worker generati utilizzando il flag--workers=N
. Per impostazione predefinita, il numero massimo di worker generati è impostato in modo predefinito dal criterio statico.
I flag facoltativi devono precedere il percorso del front controller:
entrypoint: serve --workers=2 --enable-dynamic-workers path/to/index.php
Puoi eseguire il deployment di un processo worker a lunga esecuzione impostando l'elemento
entrypoint
sul percorso file del processo worker:entrypoint: php long-running-worker-file.php
Se l'elemento
entrypoint
esegue uno script con un processo a lunga esecuzione, ad esempio un worker Pub/Sub iscritto a un argomento, non utilizzare il comandoserve
.
Per maggiori informazioni, consulta la documentazione di riferimento di app.yaml
.
Estensioni attivate
Le seguenti estensioni sono state abilitate nei runtime PHP 7/8 per App Engine:
BCMath
bz2
Calendar
core
cgi
ctype
cURL
date
dba
dom
enchant
Exif
fcgi
fileinfo
filter
FTP
GD
gettext
GMP
hash
iconv
intl
json
LDAP
libxml
mbstring
MYSQLi
mysqlnd
MySQL (PDO)
OPcache
OpenSSL
PCNTL
pcre
PDO
pgsql
Phar
posix
PostgreSQL (PDO)
Reflection
session
Shmop
SimpleXML
SOAP
Sockets
sodium (PHP 8.x only, not available for PHP 7.x)
SPL
SQLite (PDO)
SQLite3
standard
test
tidy
tokenizer
XML
XMLreader
XMLrpc (PHP 7.x only, not available for PHP 8.x)
XMLwriter
XSL
zend
Zip
Zlib
Estensioni caricabili dinamicamente
Le seguenti estensioni possono essere caricate dinamicamente configurando php.ini
:
Per attivare queste estensioni, aggiungi le relative istruzioni nel file php.ini
in extension
, ad esempio:
extension=memcached.so
extension=grpc.so
extension=protobuf.so
extension=mongodb.so
extension=imagick.so
extension=opencensus.so
extension=redis.so
Variabili di ambiente
Le seguenti variabili di ambiente sono impostate dal runtime:
Variabile di ambiente | Descrizione |
---|---|
GAE_APPLICATION
|
L'ID della tua applicazione App Engine. Questo ID è preceduto dal prefisso "region code~", ad esempio "e~" per le applicazioni di cui è stato eseguito il deployment in Europa. |
GAE_DEPLOYMENT_ID |
L'ID del deployment attuale. |
GAE_ENV |
L'ambiente App Engine. Impostato su standard . |
GAE_INSTANCE |
L'ID dell'istanza su cui è attualmente in esecuzione il servizio. |
GAE_MEMORY_MB |
La quantità di memoria disponibile per il processo di applicazione, in MB. |
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 del 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. |
NODE_ENV (disponibile solo nel runtime Node.js) |
Imposta su production quando viene eseguito il deployment del servizio. |
Puoi definire altre variabili di ambiente nel file app.yaml
, ma i valori precedenti non possono essere sostituiti, ad eccezione di NODE_ENV
.
HTTPS e proxy di inoltro
App Engine termina le connessioni HTTPS al bilanciatore del carico e inoltra le richieste alla tua applicazione. Alcune applicazioni devono determinare
l'IP e il protocollo della richiesta originale. L'indirizzo IP dell'utente è disponibile
nell'intestazione X-Forwarded-For
standard. Le applicazioni che richiedono queste informazioni devono configurare il proprio framework web in modo da considerare attendibile il proxy.
Filesystem
Il runtime include una directory /tmp
scrivibile, mentre tutte le altre directory hanno accesso di sola lettura. La scrittura in /tmp
occupa memoria di sistema. Per ulteriori informazioni, consulta l'assistenza tempnam()
e sys_get_temp_dir()
.
Server metadati
Ogni istanza dell'applicazione può utilizzare il server metadati di App Engine per eseguire query sulle informazioni sull'istanza e sul progetto.
Puoi accedere al server metadati tramite i seguenti endpoint:
http://metadata
http://metadata.google.internal
Le richieste inviate al server dei metadati devono includere l'intestazione della richiesta Metadata-Flavor: Google
. Questa intestazione indica che la richiesta è stata inviata con l'intento di recuperare i valori dei metadati.
Nella tabella seguente sono elencati gli endpoint in cui è possibile effettuare richieste HTTP per metadati specifici:
Endpoint dei metadati | Descrizione |
---|---|
/computeMetadata/v1/project/numeric-project-id |
Il numero di progetto assegnato al progetto. |
/computeMetadata/v1/project/project-id |
L'ID progetto assegnato al progetto. |
/computeMetadata/v1/instance/region |
La regione in cui è in esecuzione l'istanza. |
/computeMetadata/v1/instance/service-accounts/default/aliases |
|
/computeMetadata/v1/instance/service-accounts/default/email |
L'indirizzo email dell'account di servizio predefinito assegnato al progetto. |
/computeMetadata/v1/instance/service-accounts/default/ |
Elenca tutti gli account di servizio predefiniti per il tuo progetto. |
/computeMetadata/v1/instance/service-accounts/default/scopes |
Elenca tutti gli ambiti supportati per gli account di servizio predefiniti. |
/computeMetadata/v1/instance/service-accounts/default/token |
Restituisce il token di autenticazione che può essere utilizzato per autenticare l'applicazione su altre API Google Cloud. |
Ad esempio, per recuperare il tuo ID progetto, invia una richiesta a http://metadata.google.internal/computeMetadata/v1/project/project-id
.
Di seguito è riportato un esempio di come chiamare gli endpoint di metadati utilizzando cURL o la libreria client di Google Cloud:
Sessioni
PHP fornisce un livello di gestione delle sessioni che consente alle app web di conservare le informazioni sullo stato dell'utente tra le richieste. Le sessioni in App Engine funzionano in modo molto simile a quelle in qualsiasi altra app PHP.
Per impostare una variabile nella sessione di un utente, puoi utilizzare il seguente codice:
session_start();
$_SESSION['Foo'] = 'Bar';
Il seguente codice stamperà Bar
, su una successiva richiesta dello stesso utente:
session_start();
print $_SESSION['Foo']; // prints Bar
Per le sessioni più lunghe, utilizza un servizio di archiviazione alternativo, come Cloud SQL.
Chiavi speciali $_SERVER
PHP rende disponibile l'array $_SERVER[]
speciale nell'ambito della richiesta. Oltre ai parametri CGI standard, App Engine aggiunge altre utili chiavi:
GAE_APPLICATION
: ID progetto Google Cloud dell'app attuale.GAE_DEPLOYMENT_ID
: ID del codice sorgente di cui è stato eseguito il deployment.GAE_ENV
: l'ambiente App Engine (standard o flessibile) in cui viene eseguita la tua app.GAE_INSTANCE
: nome dell'istanza attualmente in esecuzione.GAE_MEMORY_MB
: quantità di memoria disponibile per il processo dell'app, in MB.GAE_RUNTIME
: il runtime specificato nel fileapp.yaml
, ad esempio php72.GAE_SERVICE
: nome del servizio di cui è stato eseguito il deployment.GAE_VERSION
: nome della versione attualmente di cui è stato eseguito il deployment.GOOGLE_CLOUD_PROJECT
: ID progetto Google Cloud.HTTP_X_APPENGINE_CITY
: nome della città da cui ha avuto origine la richiesta. Ad esempio, una richiesta dalla città di Mountain View potrebbe avere l'intestazione valore montagna vista.HTTP_X_APPENGINE_CITYLATLONG
: latitudine e longitudine della città da cui ha avuto origine la richiesta. La stringa potrebbe avere il seguente aspetto: "37.386051,-122.083851" per una richiesta da Mountain View.HTTP_X_APPENGINE_COUNTRY
: il paese da cui ha avuto origine la richiesta, indicato come codice paese ISO 3166-1 alpha-2. App Engine determina questo codice dall'indirizzo IP del client.HTTP_X_APPENGINE_HTTPS
- Verifica l'utilizzo di HTTPS.HTTP_X_APPENGINE_REGION
- 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 in Canada.HTTP_X_APPENGINE_USER_IP
: l'indirizzo IP del client. Tieni presente che$_SERVER['HTTP_X_APPENGINE_USER_IP']
è l'unico modo in cui la tua app può recuperare l'indirizzo IP del client. La variabile$_SERVER['REMOTE_ADDR']
non è disponibile in App Engine.
Istruzioni con nuovi valori predefiniti di inizializzazione
La seguente tabella specifica istruzioni le cui impostazioni predefinite di inizializzazione differiscono da quelle fornite con l'interprete PHP standard disponibile in php.net. Per trovare i valori predefiniti per le istruzioni non specificate nella seguente tabella, consulta le istruzioni php.ini.
Istruzione | Valore predefinito in App Engine |
---|---|
expose_php |
Off |
memory_limit |
-1 |
max_execution_time |
0 |
error_reporting |
E_ALL & ~E_DEPRECATED & ~E_STRICT |
display_errors |
Off |
display_startup_errors |
Off |
log_errors |
On |
log_errors_max_len |
0 |
ignore_repeated_errors |
Off |
ignore_repeated_source |
Off |
html_errors |
Off |
opcache.enable |
On |
opcache.validate_timestamps |
Off |
opcache.memory_consumption |
32 |
Esegui l'override di queste istruzioni predefinite includendole in un file php.ini
per la tua app.
Assistenza tempnam()
e sys_get_temp_dir()
Le app di App Engine vengono eseguite in una sandbox per la sicurezza in cui solo la directory /tmp
è scrivibile e archiviata nella RAM dell'istanza. Per questo motivo, la versione di App Engine di tempnam()
restituisce un file temporaneo in memoria che può essere scritto in una soluzione di archiviazione permanente come i bucket Cloud Storage.
Ecco un esempio di come scrivere 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 dell'esempio sarebbe quindi:
hello world
Gestione delle dipendenze con Composer
Per ulteriori informazioni, consulta la pagina Specifica delle dipendenze.