Questa pagina contiene le istruzioni per eseguire la migrazione dai runtime PHP di prima generazione a quella di seconda generazione. Per eseguire l'upgrade della tua app di seconda generazione al fine di utilizzare l'ultima versione supportata di PHP, consulta l'articolo Eseguire l'upgrade di un'applicazione esistente.
Il supporto di PHP 5 è terminato il 30 gennaio 2024. Le applicazioni PHP 5 esistenti continueranno a essere eseguite e a ricevere traffico. Tuttavia, App Engine potrebbe bloccare il nuovo deployment di applicazioni che utilizzano runtime dopo la data di fine dell'assistenza. Ti consigliamo di eseguire la migrazione al runtime PHP più recente supportato seguendo le linee guida in questa pagina.
La migrazione a un runtime PHP di seconda generazione supportato ti consente di utilizzare funzionalità linguistiche aggiornate e di creare app più portabili, con codice idiomatico.
Problemi di compatibilità tra PHP 5.5 e i runtime PHP di seconda generazione
La documentazione ufficiale di PHP fornisce informazioni sulla migrazione da diverse versioni PHP:
- Migrazione da PHP 5.5.x a PHP 5.6.x
- Migrazione da PHP 5.6.x a PHP 7.0.x
- Migrazione da PHP 7.0.x a PHP 7.1.x
- Migrazione da PHP 7.1.x a PHP 7.2.x
- Migrazione da PHP 7.2.x a PHP 7.3.x
- Migrazione da PHP 7.3.x a PHP 7.4.x
- Migrazione da PHP 7.4.x a PHP 8.0.x
- Migrazione da PHP 8.0.x a PHP 8.1.x
Differenze principali tra PHP 5.5 e i runtime PHP di seconda generazione
Di seguito è riportato un riepilogo delle differenze tra i runtime PHP 5.5 e PHP di seconda generazione nell'ambiente standard di App Engine:
Differenze di utilizzo della memoria
Per i runtime di seconda generazione, la base di utilizzo della memoria è maggiore rispetto ai runtime di prima generazione. Ciò è dovuto a più fattori, ad esempio diverse versioni delle immagini di base e alle differenze nel modo in cui le due generazioni calcolano l'utilizzo della memoria.
I runtime di seconda generazione calcolano l'utilizzo della memoria dell'istanza come somma di ciò che viene usato da un processo di applicazione e del numero di file dell'applicazione memorizzati nella cache in modo dinamico. Per evitare che le applicazioni che consumano molta memoria subiscano arresti delle istanze a causa del superamento dei limiti di memoria, esegui l'upgrade a una classe di istanza più grande con più memoria.
Differenze di utilizzo della CPU
I runtime di seconda generazione possono notare una base di utilizzo della CPU più elevata in caso di avvio a freddo delle istanze. A seconda della configurazione di scalabilità di un'applicazione, questo potrebbe avere effetti collaterali involontari, ad esempio un numero di istanze più elevato del previsto se un'applicazione è configurata per la scalabilità in base all'utilizzo della CPU. Per evitare questo problema, esamina e testa le configurazioni di scalabilità delle applicazioni per assicurarti che il numero di istanze sia accettabile.
Differenze nell'intestazione delle richieste
I runtime di prima generazione consentono di inoltrare all'applicazione le intestazioni delle richieste con trattini bassi (ad es. X-Test-Foo_bar
). I runtime
di seconda generazione introducono Nginx nell'architettura host. A seguito di questa modifica, i runtime di seconda generazione sono configurati in modo da rimuovere automaticamente le intestazioni con trattini bassi (_
). Per evitare problemi dell'applicazione, evita di utilizzare i trattini bassi nelle intestazioni delle richieste dell'applicazione.
Migrazione del file app.yaml
in corso...
Devi posizionare un front controller per gestire tutti i percorsi nell'applicazione. Per maggiori informazioni, consulta Avvio dell'applicazione.
I runtime PHP di seconda generazione non consentono la personalizzazione dell'elemento gestore script
. L'unico valore valido è auto
, perché tutto il traffico viene gestito utilizzando il comando del punto di ingresso. Tutti i gestori di URL non statici devono includere script: auto
per eseguire correttamente il deployment.
Il comportamento di alcuni elementi del file di configurazione app.yaml
è stato modificato:
Elemento | Tipo di modifica | Descrizione |
---|---|---|
entrypoint | Aggiunta | Facoltativamente, utilizza questo campo per specificare il comando che verrà eseguito all'avvio dell'app. |
threadsafe | Deprecata | Si presume che tutte le applicazioni siano threadsafe, il che significa che un'istanza può gestire più richieste contemporaneamente. |
api_version | Deprecata | Precedentemente obbligatoria, ma non necessaria nei runtime PHP di seconda generazione. |
application_readable | Deprecata | |
builtins | Deprecata | |
libraries | Deprecata | Le dipendenze di terze parti arbitrarie possono essere installate utilizzando un file di metadati composer.json . |
handlers | Modificata |
|
Se utilizzi uno dei campi deprecati, si verificherà un errore durante il deployment dell'app.
Per saperne di più, consulta la documentazione di riferimento di app.yaml
.
Limitazioni di runtime ridotte
I runtime PHP di seconda generazione hanno meno restrizioni rispetto al runtime PHP 5.5.
- Installa dipendenze di terze parti.
- Il runtime include un file system completo.
- Creare thread o processi in background che esulano dall'ambito della richiesta durante l'esecuzione dell'istanza.
- Utilizza la libreria client di Google Cloud per PHP per integrare le app con altri servizi Google Cloud. Per ulteriori informazioni, consulta la pagina Installazione della libreria client di Google Cloud.
Per ulteriori informazioni, consulta l'articolo sull'ambiente di runtime dei file PHP.
Migrazione dall'SDK PHP di App Engine
Per ridurre lo sforzo e la complessità della migrazione del runtime, l'ambiente standard di App Engine consente di accedere a molti servizi e API in bundle legacy nel runtime PHP di seconda generazione, come Memcache. L'app PHP di seconda generazione può chiamare le API dei servizi in bundle tramite l'SDK di App Engine e accedere alla maggior parte delle stesse funzionalità del runtime PHP 5. Non tutti i servizi in bundle legacy disponibili per PHP 5 hanno un servizio corrispondente nei runtime PHP di seconda generazione. Per l'elenco completo delle API dei servizi in bundle legacy disponibili per i runtime PHP di seconda generazione, consulta la documentazione sui riferimenti delle API dei servizi in bundle legacy.
Hai anche la possibilità di utilizzare prodotti Google Cloud che offrono funzionalità simili a quelle dei servizi in bundle legacy. Questi prodotti Google Cloud forniscono una libreria client di Google Cloud CLI idiomatica. Per i servizi in bundle legacy che non sono disponibili come prodotti separati in Google Cloud, ad esempio la ricerca, puoi utilizzare provider di terze parti o altre soluzioni alternative. Per scoprire di più sulla migrazione a servizi non in bundle, consulta Migrazione dai servizi in bundle.
Esecuzione dell'applicazione in locale
Per testare la tua applicazione ed eseguirla localmente:
Installa localmente una versione di PHP corrispondente a un runtime PHP di seconda generazione disponibile nell'ambiente standard di App Engine.
Installa un server web e utilizzalo per gestire la tua app localmente.
Ad esempio, avvia il server HTTP eseguendo questo comando:
php -S localhost:8080
Quindi, visualizza l'applicazione nel browser web all'indirizzo http://localhost:8080.