Como usar a API Modules

Essa API é compatível com os ambientes de execução de primeira geração e pode ser usada ao fazer upgrade para os ambientes de execução de segunda geração correspondentes. Se você estiver atualizando para o ambiente de execução do PHP 7 ou 8 no App Engine, consulte o guia de migração para saber mais sobre as opções de migração para serviços incluídos no pacote.

A API Modules oferece funções que retornam informações sobre o ambiente operacional atual (módulo, versão e instância).

A API Modules também tem funções que recuperam o endereço de um módulo, uma versão ou uma instância. Isso permite que um aplicativo envie solicitações de uma instância para outra nos ambientes de desenvolvimento e de produção.

Adicione a seguinte instrução de uso à parte superior do seu arquivo:

use google\appengine\api\modules\ModulesService;

Veja na seguinte amostra de código como saber o nome do módulo e o código da instância para uma solicitação:

$module = ModulesService::getCurrentModuleName();
$instance = ModulesService::getCurrentInstanceId();

O ID da instância de um módulo com escalonamento automático será retornado como um valor exclusivo com codificação base64, por exemplo e4b565394caa.

É possível estabelecer comunicação entre os módulos no mesmo app, buscando o nome do host do módulo de destino:

use google\appengine\api\modules\ModulesService;

$url = 'http://' . ModulesService::getHostname('my-backend') . '/';
$result = file_get_contents($url);

Também é possível usar o serviço Busca de URL.